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