รับข้อมูลบัตรของขวัญ

ในเวิร์กโฟลว์ที่ต้องใช้ข้อมูลบัตรของขวัญ คุณสามารถใช้การดำเนินการ “รับข้อมูลบัตรของขวัญ” เพื่อเรียกดูข้อมูลบัตรของขวัญจากร้านค้าของคุณได้

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

การกำหนดค่า

ฟิลด์

การดำเนินการ “รับข้อมูลบัตรของขวัญ” ประกอบด้วยฟิลด์ต่อไปนี้ ซึ่งใช้ในการสร้างคำค้นหา

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

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

นี่คือตัวอย่างคำค้นหาสำหรับรับบัตรของขวัญที่มีการอัปเดตในวันล่าสุด

created_at:<='{{ scheduledAt }}' AND created_at:>'{{ scheduledAt | date_minus: "1 day" }}'

ตัวแปร created_at คือตัวกรองที่ใช้ได้ในคำค้นหาบัตรของขวัญ และสามารถใช้ซ้ำหลายครั้งหรือใช้ร่วมกับตัวแปรอื่นๆ ได้ ตัวแปร Liquid scheduledAt จะมีให้ใช้งานในเวิร์กโฟลว์ที่ใช้ทริกเกอร์ตามเวลาที่กำหนด ส่วนแท็ก Liquid date_minus คือแท็กพิเศษของ Flow ที่ให้คุณลบเวลาออกจากวันที่ได้

ข้อควรรู้เกี่ยวกับการค้นหาข้อมูลมีดังนี้

  • รายการตัวกรองบัตรของขวัญที่มีอยู่

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

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

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

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

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

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

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

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

{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.name }}
{% endfor %}

ทริกเกอร์

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

รายละเอียด API