รับรายการเมตาอ็อบเจกต์

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

การกำหนดค่า

ช่อง

การดำเนินการ รับรายการเมตาอ็อบเจกต์ มีเมนูดรอปดาวน์สำหรับระบุคำจำกัดความของเมตาอ็อบเจกต์ รวมถึงช่องต่อไปนี้ที่ใช้ในการสร้างคำค้นหา:

สตริงคิวรี

นี่คือตัวอย่างคิวรีสำหรับการรับรายการเมตาอ็อบเจกต์ หากค่าของฟิลด์ email ตรงกับที่อยู่อีเมลในคำสั่งซื้อ

{{fields.email}}:"{{order.email}}"

นี่คือตัวอย่างคิวรีสำหรับรับรายการเมตาอ็อบเจกต์ที่ได้รับการอัปเดตในวันล่าสุด

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

ตัวแปร updated_at คือตัวกรองที่พร้อมใช้งานในคิวรีเมตาอ็อบเจกต์ และสามารถใช้ได้หลายครั้งหรือใช้ร่วมกับตัวแปรอื่นๆ ส่วนตัวแปร Liquid scheduledAt จะพร้อมใช้งานในเวิร์กโฟลว์ที่ใช้ทริกเกอร์เวลาที่กำหนดไว้ ขณะที่แท็ก Liquid date_minus เป็นแท็กพิเศษของ Flow ที่ให้คุณลบเวลาออกจากวันที่ได้

สิ่งที่ควรทราบเมื่อทำการค้นหาข้อมูล

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

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

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

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

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

{% for getMetaobjectEntries_item in getMetaobjectEntries %}
Key-value pairs for entry:
  {% for fields_item in getMetaobjectEntries_item.system.fields %}
    {{fields_item.key}}:{{fields_item.value}}
  {% endfor %}
{% endfor %}

ทริกเกอร์

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

รายละเอียด API

• ทรัพยากรเมตาอ็อบเจกต์
• ตัวกรองคิวรีเมตาอ็อบเจกต์
• การใช้คิวรีกับเมตาอ็อบเจกต์ตามค่าฟิลด์