รับข้อมูลแค็ตตาล็อก

ในเวิร์กโฟลว์ที่ต้องใช้ข้อมูลแค็ตตาล็อก คุณสามารถใช้การดำเนินการรับข้อมูลแค็ตตาล็อกเพื่อดึงข้อมูลแค็ตตาล็อก B2B จากร้านค้าของคุณ แค็ตตาล็อกคือกลุ่มของสินค้าที่มีการกำหนดราคาแบบกำหนดเองสำหรับลูกค้า B2B บางรายหรือตำแหน่งที่ตั้งของบริษัทบางแห่ง

การกำหนดค่า

ช่อง

การดำเนินการรับข้อมูลแค็ตตาล็อกมีช่องต่างๆ ดังนี้

ช่องที่ใช้ในการดำเนินการรับข้อมูล
ช่องคำอธิบาย
จัดเรียงข้อมูลตามจำเป็น พารามิเตอร์ที่ใช้จัดเรียงข้อมูลที่คำค้นหาส่งคืน
จำนวนผลลัพธ์สูงสุดต้องระบุ จำนวนผลลัพธ์สูงสุดที่สามารถส่งคืนได้โดยคำค้นหาที่คุณเลือก คุณสามารถส่งคืนได้สูงสุดครั้งละ 100 รายการ
คิวรีต้องระบุ เลือกจากคิวรีทั่วไปหรือเลือก ขั้นสูง เพื่อสร้างคิวรีของคุณเอง

สตริงคิวรี

ตัวอย่างคิวรีสำหรับรับแคตตาล็อกที่ใช้งานอยู่ทั้งหมดมีดังนี้

status:ACTIVE

ตัวแปร status เป็นตัวกรองที่มีให้ใช้ในคิวรี Catalogs และสามารถใช้ได้หลายครั้งหรือใช้ร่วมกับตัวแปรอื่นๆ

เมื่อมีการคิวรีข้อมูล สิ่งที่มีประโยชน์ที่ควรทราบมีดังนี้

  • รายการตัวกรองแคตตาล็อกที่มีให้ใช้

  • คิวรีต้องเป็นไปตามรูปแบบไวยากรณ์ที่กำหนด

  • ค่าของช่องในคิวรีไม่ได้มีระบุไว้ในเอกสารเสมอไป ในบางกรณี คุณสามารถดูค่าได้ในเอกสารอ้างอิง API หรือโดยส่วนใหญ่คุณสามารถหาค่าของช่องได้จาก URL ในแผงผู้ดูแลเมื่อคุณใช้ตัวกรอง ตัวอย่างเช่น หากต้องการค้นหาค่าคิวรีของคำสั่งซื้อ ให้กรองหน้าคำสั่งซื้อในแผงผู้ดูแล แล้วตรวจสอบ URL

  • คุณสามารถรันหรือทดสอบคิวรีในร้านค้าของคุณได้โดยใช้แอป Shopify GraphiQL

  • โปรดระวังสิ่งที่จะเกิดขึ้นหากคิวรีของคุณล้มเหลว บ่อยครั้งที่ API จะส่งคืนผลลัพธ์ทั้งหมด (แทนที่จะไม่ส่งคืนเลย)

ข้อมูลที่ส่งคืน

การดำเนินการ รับข้อมูล ทั้งหมดจะส่งคืนรายการทรัพยากรตั้งแต่ 0 ถึง 100 รายการ โดยขึ้นอยู่กับกรณีการใช้งานของคุณ ซึ่งคุณอาจต้องการใช้ข้อมูลนี้ในรูปแบบที่แตกต่างกันดังนี้

  • หากคุณจำเป็นต้องจัดการรายการแต่ละรายการแยกกัน เช่น การเพิ่มแท็กให้กับแต่ละรายการ คุณสามารถใช้การดำเนินการ สำหรับแต่ละรายการ ได้
  • หากคุณต้องการรวบรวมข้อมูล เช่น นับจำนวนผลลัพธ์ที่ส่งคืน คุณสามารถใช้การดำเนินการ นับ หรือ ผลรวม ได้
  • หากคุณต้องการส่งออกรายการ เช่น การส่งอีเมลที่มีรายการทั้งหมด คุณสามารถใช้ข้อมูลที่ส่งคืนในการดำเนินการลำดับถัดไปได้โดยตรง

หากต้องการเข้าถึงข้อมูลที่ส่งคืนในขั้นตอนตามการดำเนินการนี้ ให้ใช้ตัวแปรที่ชื่อ รับข้อมูลแคตตาล็อก ซึ่งเป็นรายการแคตตาล็อก โดยคุณสามารถใช้ตัวแปรนี้ได้ทั้งในเงื่อนไขและการดำเนินการ ตัวอย่างเช่น คุณสามารถส่งรายการแคตตาล็อกในการดำเนินการ ส่งอีเมลภายใน ที่มีลักษณะดังนี้

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% endfor %}

ทริกเกอร์

คุณสามารถใช้การดำเนินการนี้ในเวิร์กโฟลว์ใดก็ได้ รวมถึงทริกเกอร์เวลาที่กำหนดไว้ด้วย ในเวิร์กโฟลว์ที่ใช้ทริกเกอร์เวลาที่กำหนดไว้ เวิร์กโฟลว์จะเริ่มขึ้นในเวลาที่คุณระบุไว้แทนที่จะเป็นผลลัพธ์จากกิจกรรม เนื่องจากไม่มีกิจกรรมที่เฉพาะเจาะจงในร้านค้าของคุณหรือจากแอปที่จะเริ่มเวิร์กโฟลว์ จึงไม่มีข้อมูลที่รวมอยู่ด้วยโดยอัตโนมัติ

ข้อมูลอ้างอิง API

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ API ที่ใช้ในการดำเนินการนี้ โปรดดูที่คิวรี Catalogs