รับรายการเมตาอ็อบเจกต์
คุณสามารถใช้การดำเนินการรับรายการเมตาอ็อบเจกต์เพื่อกู้คืนรายการสำหรับเมตาอ็อบเจกต์จากร้านค้าของคุณโดยอิงตามคำค้นหาที่เป็นทางเลือก ดูเอกสารประกอบเมตาอ็อบเจกต์เพื่อหาข้อมูลเพิ่มเติม
ในหน้านี้
การกำหนดค่า
ช่อง
การดำเนินการรับรายการเมตาอ็อบเจกต์จะมีเมนูดรอปดาวน์เพื่อระบุคำจำกัดความของเมตาอ็อบเจกต์ รวมถึงฟิลด์ต่อไปนี้ ซึ่งจะนำมาใช้ในการสร้างคำค้นหา:
ช่อง | คำอธิบาย |
---|---|
จัดเรียงข้อมูลตาม | จำเป็นต้องมี พารามิเตอร์ที่ทำให้ระบบจัดเรียงข้อมูลส่งกลับจากคำค้นหา |
จํานวนผลลัพธ์สูงสุด | ต้องระบุ จํานวนผลลัพธ์สูงสุดที่ระบบสามารถส่งคืนจากคำค้นหาที่คุณเลือกคุณสามารถส่งคืนได้สูงสุดครั้งละ 100 รายการ |
คำค้นหา | ต้องระบุ เลือกจากคำค้นหาทั่วไปหรือเลือก “Advanced” เพื่อสร้างคำค้นหาของคุณเอง |
สตริงคำค้นหา
นี่คือตัวอย่างคำค้นหาสำหรับรับรายการเมตาอ็อบเจกต์ หากค่าของฟิลด์ 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 ต่างๆ ในส่วนผู้ดูแลเมื่อทำการกรอง ตัวอย่างเช่น หากต้องการค้นหาค่าคำค้นหาเกี่ยวกับ “Order” ให้กรองหน้า “คำสั่งซื้อ” ในส่วนผู้ดูแล จากนั้นจึงตรวจสอบ URL
- คุณสามารถเรียกใช้หรือทดสอบคำค้นหาในร้านค้าของคุณได้โดยใช้แอป Shopify GraphiQL
- โปรดระวังสิ่งที่จะเกิดขึ้นหากดำเนินการค้นหาไม่สำเร็จ API มักจะส่งคืนผลลัพธ์ทั้งหมด (แทนไม่มี)
ข้อมูลที่ส่งคืน
การดำเนินการ “Get data” ทั้งหมดจะส่งคืนรายการแหล่งข้อมูลตั้งแต่ 0 ถึง 100 รายการ คุณสามารถใช้ข้อมูลนี้ในรูปแบบต่างๆ ตามกรณีการใช้งานของคุณดังต่อไปนี้:
- หากคุณต้องจัดการรายการสินค้าแต่ละรายการแยกกัน เช่น เพิ่มแท็กของแต่ละรายการ คุณสามารถใช้การดำเนินการ “For each” ได้
- หากคุณต้องการรวมข้อมูล เช่น จํานวนผลลัพธ์ที่ถูกส่งคืน คุณสามารถใช้การดําเนินการ “Count” หรือ “Sum” ได้
- หากคุณต้องการส่งออกรายการ เช่น ส่งอีเมลพร้อมรายการสินค้าทั้งหมด คุณสามารถใช้ “returned data” ได้โดยตรงในการดำเนินการครั้งถัดไป
หากต้องการเข้าถึงข้อมูลที่ส่งคืนแล้วในขั้นตอนที่เป็นไปตามการดำเนินการนี้ ให้ใช้ตัวแปรชื่อ “รับรายการเมตาอ็อบเจกต์” ซึ่งเป็นรายชื่อของรายการเมตาอ็อบเจกต์ คุณสามารถใช้ตัวแปรนี้ได้ทั้งในเงื่อนไขและการดำเนินการ ตัวอย่างเช่น คุณสามารถส่งรายชื่อค่าคีย์ที่เป็นคู่ๆ สำหรับรายการเมตาอ็อบเจกต์ในการดำเนินการ “ส่งอีเมลภายใน” ได้ดังต่อไปนี้:
{% 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 %}
ทริกเกอร์
โดยคุณสามารถใช้การดำเนินการนี้ในขั้นตอนการทำงานใดก็ได้ รวมถึงทริกเกอร์ “เวลาที่กำหนดไว้” ซึ่งขั้นตอนการทำงานที่ใช้ทริกเกอร์ “เวลาที่กำหนดไว้” จะเริ่มต้น ณ เวลาที่คุณระบุไว้ ไม่ใช่เป็นผลลัพธ์ของเหตุการณ์ใดเหตุการณ์หนึ่ง และเนื่องจากไม่มีเหตุการณ์เฉพาะเจาะจงในร้านค้าของคุณหรือจากแอปที่เริ่มขั้นตอนการทำงานดังกล่าว ระบบจึงจะไม่ได้รวมข้อมูลใดๆ ไว้โดยอัตโนมัติ