รับข้อมูลตำแหน่งที่ตั้ง

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

การกำหนดค่า

ช่อง

การดำเนินการ รับข้อมูลตำแหน่งที่ตั้ง มีช่องต่างๆ ดังต่อไปนี้

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

สตริงคำค้นหา

นี่คือตัวอย่างคำค้นหาสำหรับรับตำแหน่งที่ตั้งที่เปิดใช้งานการรับสินค้าที่ร้าน

pickup_in_store:enabled

ตัวแปร pickup_in_store คือตัวกรองที่พร้อมใช้งานในคำค้นหาตำแหน่งที่ตั้ง และสามารถใช้ได้หลายครั้งหรือใช้ร่วมกับตัวแปรอื่นๆ

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

  • รายการตัวกรองตำแหน่งที่ตั้งที่พร้อมใช้งาน

  • คำค้นหาต้องเป็นไปตามไวยากรณ์ที่กำหนด

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

  • คุณสามารถรันหรือทดสอบคำค้นหาในร้านค้าของคุณได้โดยใช้แอป Shopify GraphiQL

  • โปรดระมัดระวังสิ่งที่เกิดขึ้นหากคำค้นหาของคุณล้มเหลว โดยส่วนมากแล้ว API จะส่งคืนผลลัพธ์ทั้งหมด (แทนที่จะไม่ส่งคืนเลย)

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

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

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

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

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

ทริกเกอร์

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

ข้อมูลอ้างอิง API

ดูข้อมูลเพิ่มเติมเกี่ยวกับ API ที่ใช้ในการดำเนินการนี้ได้ที่คำค้นหาตำแหน่งที่ตั้ง