รับข้อมูลรายการสินค้าคงคลัง
ในเวิร์กโฟลว์ที่ต้องการข้อมูลรายการสินค้าคงคลัง คุณสามารถใช้การดำเนินการ รับข้อมูลรายการสินค้าคงคลัง เพื่อดึงข้อมูลรายการสินค้าคงคลังจากร้านค้าของคุณได้ รายการสินค้าคงคลังจะแสดงถึงหน่วยของสต็อกสินค้าจริงที่มีการติดตามสำหรับตัวเลือกสินค้า
การกำหนดค่า
ช่อง
การดำเนินการ รับข้อมูลรายการสินค้าคงคลัง ประกอบด้วยช่องต่อไปนี้
| ช่อง | คำอธิบาย |
|---|---|
| จัดเรียงข้อมูลตาม | ต้องระบุ พารามิเตอร์ที่ใช้ในการจัดเรียงข้อมูลที่ส่งคืนโดยคำค้นหา |
| จำนวนผลลัพธ์สูงสุด | ต้องระบุ จำนวนผลลัพธ์สูงสุดที่สามารถส่งคืนได้โดยคำค้นหาที่คุณเลือก คุณสามารถส่งคืนได้สูงสุดครั้งละ 100 รายการ |
| คิวรี | ต้องระบุ เลือกจากคิวรีทั่วไปหรือเลือก ขั้นสูง เพื่อสร้างคิวรีของคุณเอง |
สตริงคิวรี
ตัวอย่างคิวรีสำหรับรับรายการสินค้าคงคลังที่มีการติดตามมีดังนี้
tracked:trueตัวแปร tracked เป็นตัวกรองที่มีให้ใช้ในคิวรี Inventory items และสามารถใช้ได้หลายครั้งหรือใช้ร่วมกับตัวแปรอื่นๆ
เมื่อมีการคิวรีข้อมูล สิ่งที่มีประโยชน์ที่ควรทราบมีดังนี้
คิวรีต้องเป็นไปตามรูปแบบไวยากรณ์ที่กำหนด
ค่าของช่องในคิวรีไม่ได้มีระบุไว้ในเอกสารเสมอไป ในบางกรณี คุณสามารถดูค่าได้ในเอกสารอ้างอิง API หรือโดยส่วนใหญ่คุณสามารถหาค่าของช่องได้จาก URL ในแผงผู้ดูแลเมื่อคุณใช้ตัวกรอง ตัวอย่างเช่น หากต้องการค้นหาค่าคิวรีของคำสั่งซื้อ ให้กรองหน้าคำสั่งซื้อในแผงผู้ดูแล แล้วตรวจสอบ URL
คุณสามารถรันหรือทดสอบคิวรีในร้านค้าของคุณได้โดยใช้แอป Shopify GraphiQL
โปรดระวังสิ่งที่จะเกิดขึ้นหากคิวรีของคุณล้มเหลว บ่อยครั้งที่ API จะส่งคืนผลลัพธ์ทั้งหมด (แทนที่จะไม่ส่งคืนเลย)
ข้อมูลที่ส่งคืน
การดำเนินการ รับข้อมูล ทั้งหมดจะส่งคืนรายการทรัพยากรตั้งแต่ 0 ถึง 100 รายการ โดยขึ้นอยู่กับกรณีการใช้งานของคุณ ซึ่งคุณอาจต้องการใช้ข้อมูลนี้ในรูปแบบที่แตกต่างกันดังนี้
- หากคุณจำเป็นต้องจัดการรายการแต่ละรายการแยกกัน เช่น การเพิ่มแท็กให้กับแต่ละรายการ คุณสามารถใช้การดำเนินการ สำหรับแต่ละรายการ ได้
- หากคุณต้องการรวบรวมข้อมูล เช่น นับจำนวนผลลัพธ์ที่ส่งคืน คุณสามารถใช้การดำเนินการ นับ หรือ ผลรวม ได้
- หากคุณต้องการแสดงผลรายการ เช่น ส่งอีเมลพร้อมรายการทั้งหมด คุณสามารถใช้ข้อมูลที่ส่งคืนในการดำเนินการถัดไปได้โดยตรง
หากต้องการเข้าถึงข้อมูลที่ส่งคืนในขั้นตอนที่ตามหลังการดำเนินการนี้ ให้ใช้ตัวแปรที่ชื่อ Get inventory item data ซึ่งเป็นรายการสินค้าคงคลัง โดยคุณสามารถใช้ตัวแปรนี้ได้ทั้งในเงื่อนไขและการดำเนินการ ตัวอย่างเช่น คุณสามารถส่งรายการสินค้าคงคลังในการดำเนินการ Send internal email ที่มีลักษณะดังนี้
{% for single_inventory_item in getInventoryItemData %}
* SKU: {{ single_inventory_item.sku }} - Cost: {{ single_inventory_item.unitCost.amount }}
{% endfor %}ทริกเกอร์
คุณสามารถใช้การดำเนินการนี้ในเวิร์กโฟลว์ใดก็ได้ รวมถึงทริกเกอร์ Scheduled time ในเวิร์กโฟลว์ที่ใช้ทริกเกอร์ Scheduled time เวิร์กโฟลว์จะเริ่มต้นในเวลาที่คุณระบุแทนที่จะเป็นผลลัพธ์จากเหตุการณ์ เนื่องจากไม่มีเหตุการณ์เฉพาะในร้านค้าของคุณหรือจากแอปที่เริ่มต้นเวิร์กโฟลว์ จึงไม่มีข้อมูลที่รวมอยู่โดยอัตโนมัติ
ข้อมูลอ้างอิง API
หากต้องการข้อมูลเพิ่มเติมเกี่ยวกับ API ที่ใช้ในการดำเนินการนี้ โปรดดูคิวรีรายการสินค้าคงคลัง