รับข้อมูลสัญญาการสมัครใช้งาน
คุณสามารถใช้การดำเนินการ “รับข้อมูลสัญญาการสมัครใช้งาน” ในขั้นตอนการทำงานที่จำเป็นต้องใช้ข้อมูลสัญญาการสมัครใช้งาน เพื่อดึงข้อมูลเหล่านั้นจากร้านค้าของคุณได้
ในหน้านี้
การกำหนดค่า
ช่อง
การดำเนินการ “รับข้อมูลสัญญาการสมัครใช้งาน” จะมีช่องดังต่อไปนี้ซึ่งใช้เพื่อสร้างคำค้นหา:
| ช่อง | คำอธิบาย |
|---|---|
| จัดเรียงข้อมูลตาม | จำเป็นต้องมี พารามิเตอร์ที่ทำให้ระบบจัดเรียงข้อมูลส่งกลับจากคำค้นหา |
| จํานวนผลลัพธ์สูงสุด | ต้องระบุ จํานวนผลลัพธ์สูงสุดที่ระบบสามารถส่งคืนจากคำค้นหาที่คุณเลือกคุณสามารถส่งคืนได้สูงสุดครั้งละ 100 รายการ |
| คำค้นหา | ต้องระบุ เลือกจากคำค้นหาทั่วไปหรือเลือก “Advanced” เพื่อสร้างคำค้นหาของคุณเอง |
สตริงคำค้นหา
นี่คือตัวอย่างคำค้นหาเก ี่ยวกับการรับสัญญาการสมัครใช้งานที่มีสถานะเป็น ACTIVE:
status: ACTIVEตัวแปร status คือตัวกรองที่มีอยู่ในคำค้นหาเกี่ยวกับสัญญาการสมัครใช้งานและสามารถใช้งานได้หลายครั้ง
เมื่อค้นหาข้อมูลจะมีข้อควรทราบดังนี้:
- รายการตัวกรองที่พร้อมใช้งาน - คำค้นหาต้องเป็นไปตามโครงสร้างทางไวยากรณ์บางรูปแบบ
- คุณสามารถดูชื่อช่องคำค้นหาของคำค้นหาทั้งหมดได้ในเอกสารสำหรับผู้พัฒนาของอ็อบเจกต์ QueryRoot
- ระบบไม่ได้บันทึกค่าช่องคำค้นหา เสมอไป ในบางกรณี คุณสามารถดูค่าได้โดยไปที่เอกสาร API หรือคุณจะค้นหาค่าช่องข้อมูลใน URL ต่างๆ ในส่วนผู้ดูแลเมื่อทำการกรอง ตัวอย่างเช่น หากต้องการค้นหาค่าคำค้นหาเกี่ยวกับ “Order” ให้กรองหน้า “คำสั่งซื้อ” ในส่วนผู้ดูแล จากนั้นจึงตรวจสอบ URL
- คุณสามารถเรียกใช้หรือทดสอบคำค้นหาในร้านค้าของคุณได้โดยใช้แอป Shopify GraphiQL
- โปรดระวังสิ่งที่จะเกิดขึ้นหากดำเนินการค้นหาไม่สำเร็จ API มักจะส่งคืนผลลัพธ์ทั้งหมด (แทนไม่มี)
ข้อมูลที่ส่งคืน
การดำเนินการ “Get data” ทั้งหมดจะส่งคืนรายการแหล่งข้อมูลตั้งแต่ 0 ถึง 100 รายการ คุณสามารถใช้ข้อมูลนี้ในรูปแบบต่างๆ ตามกรณีการใช้งานของคุณดังต่อไปนี้:
- หากคุณต้องจัดการรายการสินค้าแต่ละรายการแยกกัน เช่น เพิ่มแท็กของแต่ละรายการ คุณสามารถใช้การดำเนินการ “For each” ได้
- หากคุณต้องการรวมข้อมูล เช่น จํานวนผลลัพธ์ที่ถูกส่งคืน คุณสามารถใช้การดําเนินการ “Count” หรือ “Sum” ได้
- หากคุณต้องการส่งออกรายการ เช่น ส่งอีเมลพร้อมรายการสินค้าทั้งหมด คุณสามารถใช้ “returned data” ได้โดยตรงในการดำเนินการครั้งถัดไป
หากต้องการเข้าถึงข้อมูลที่ส่งคืนแล้วในขั้นตอนที่เป็นไปตามการดำเนินการนี้ ให้ใช้ตัวแปรชื่อ “รับข้อมูลสัญญาการสมัครใช้งาน” ซึ่งเป็นรายการสัญญาการสมัครใช้งาน คุณสามารถใช้ตัวแปรนี้ได้ทั้งในเงื่อนไขและการดำเนิน การ ตัวอย่างเช่น คุณสามารถส่งรายการคำสั่งซื้อในการดำเนินการ “ส่งอีเมลภายใน” ดังต่อไปนี้ได้:
{% for single_contract in GetSubscriptionContractData %}
- {{ single_contract.name }}
{% endfor %}ทริกเกอร์
โดยคุณสามารถใช้ การดำเนินการนี้ในขั้นตอนการทำงานใดก็ได้ รวมถึงทริกเกอร์ “เวลาที่กำหนดไว้” ซึ่งขั้นตอนการทำงานที่ใช้ทริกเกอร์ “เวลาที่กำหนดไว้” จะเริ่มต้น ณ เวลาที่คุณระบุไว้ ไม่ใช่เป็นผลลัพธ์ของเหตุการณ์ใดเหตุการณ์หนึ่ง และเนื่องจากไม่มีเหตุการณ์เฉพาะเจาะจงในร้านค้าของคุณหรือจากแอปที่เริ่มขั้นตอนการทำงานดังกล่าว ระบบจึงจะไม่ได้รวมข้อมูลใดๆ ไว้โดยอัตโนมัติ