ดึงข้อมูลความพยายามเรียกเก็บค่าสมัครใช้งาน
ในเวิร์กโฟลว์ที่ต้องใช้ข้อมูลความพยายามเรียกเก็บค่าสมัครใช้งาน คุณสามารถใช้การดำเนินการ ดึงข้อมูลความพยายามเรียกเก็บค่าสมัครใช้งาน เพื่อดึงข้อมูลคำสั่งซื้อจากร้านค้าของคุณได้
การกำหนดค่า
ฟิลด์
การดำเนินการ ดึงข้อมูลความพยายามเรียกเก็บค่าสมัครใช้งาน มีฟิลด์ต่อไปนี้ซึ่งใช้ในการสร้างคิวรี
| ฟิลด์ | คำอธิบาย |
|---|---|
| จัดเรียงข้อมูลตาม | จำเป็น พารามิเตอร์ที่ใช้จัดเรียงข้อมูลซึ่งส่งคืนโดยคำค้นหา |
| จำนวนผลลัพธ์สูงสุด | จำเป็น จำนวนผลลัพธ์สูงสุดที่สามารถส่งคืนโดยคำค้นหาที่คุณเลือก คุณสามารถส่งคืนได้สูงสุดครั้งละ 100 รายการ |
| คิวรี | จำเป็น เลือกจากคิวรีทั่วไปหรือเลือกขั้นสูงเพื่อสร้างคิวรีของคุณเอง |
สตริงคิวรี
นี่คือตัวอย่างคิวรีสำหรับรับความพยายามเรียกเก็บค่าสมัครใช้งานที่สร้างขึ้นในสามวันที่แล้ว
created_at:>'{{ createdAt | date_minus: "3 day" }}'ตัวแปร created_at คือตัวกรองที่พร้อมใช้งานในคิวรีความพยายามเรียกเก็บค่าสมัครใช้งาน และสามารถใช้เพื่อเลือกข้อความแสดงข้อผิดพลาดที่เฉพาะเจาะจงสำหรับความพยายามเรียกเก็บค่าสมัครใช้งานได้
เมื่อทำการคิวรีข้อมูล สิ่งที่ควรทราบมีดังนี้
- รายการตัวกรองความพยายามเรียกเก็บค่าสมัครใช้งานที่พร้อมใช้งาน
- คำค้นหาต้องเป็นไปตามไวยากรณ์ที่กำหนด
- ค่าช่องข้อมูลของคำค้นหาไม่ได้มีระบุไว้ในเอกสารเสมอไป ในบางกรณี สามารถดูค่าเหล่านี้ได้จากเอกสาร API หรืออีกวิธีหนึ่งคือ คุณมักจะพบค่าช่องข้อมูลเหล่านี้ได้ใน URL ของส่วนผู้ดูแลเมื่อคุณใช้ตัวกรอง ตัวอย่างเช่น หากต้องการค้นหาค่าคำค้นหาของคำสั่งซื้อบางรายการ ให้กรองหน้าคำสั่งซื้อในส่วนผู้ดูแล จากนั้นจึงตรวจสอบ URL
- คุณสามารถรันหรือทดสอบคำค้นหาในร้านค้าของคุณได้โดยใช้แอป Shopify GraphiQL
- โปรดทราบถึงสิ่งที่อาจเกิดขึ้นหากคำค้นหาของคุณล้มเหลว โดย API มักจะส่งคืนผลลัพธ์ทั้งหมด (แทนที่จะไม่ส่งคืนผลลัพธ์ใดๆ)
ข้อมูลที่ส่งคืน
การดำเนินการรับข้อมูลทั้งหมดจะส่งคืนรายการทรัพยากรตั้งแต่ 0 ถึง 100 รายการ คุณอาจต้องการใช้ข้อมูลนี้ในรูปแบบต่างๆ กันไปตามกรณีการใช้งานของคุณ ดังนี้
- หากคุณต้องการจัดการแต่ละรายการในลิสต์แยกกัน เช่น การเพิ่มแท็กสำหรับแต่ละรายการ คุณสามารถใช้การดำเนินการสำหรับแต่ละรายการได้
- หากคุณต้องการรวบรวมข้อมูล เช่น การนับจำนวนผลลัพธ์ที่ส่งคืนมา คุณสามารถใช้การดำเนินการนับ หรือผลรวมได้
- หากคุณต้องการแสดงผลลัพธ์ของลิสต์ เช่น ส่งอีเมลพร้อมกับทุกรายการ คุณสามารถใช้ข้อมูลที่ส่งคืนได้โดยตรงในการดำเนินการถัดๆ ไป
หากต้องการเข้าถึงข้อมูลที่ส่งคืนในขั้นตอนที่ตามหลังการดำเนินการนี้ ให้ใช้ตัวแปรชื่อ Get subscription billing attempt data ซึ่งเป็นรายการความพยายามเรียกเก็บเงินค่าสมัครใช้งาน คุณสามารถใช้ตัวแปรนี้ได้ทั้งในเงื่อนไขและการดำเนินการ ตัวอย่างเช่น คุณสามารถส่งรายการความพยายามเรียกเก็บเงินค่าสมัครใช้งานในการดำเนินการ ส่งอีเมลภายใน ได้ดังนี้
{% for getSubscriptionBillingAttemptData_item in getSubscriptionBillingAttemptData %}
{{getSubscriptionBillingAttemptData_item.errorMessage}}
{% endfor %}ตัวอย่าง
ตัวอย่างเช่น เวิร์กโฟลว์มีกำหนดการให้ทำงานทุกวันอาทิตย์ เวลา 9:00 น. โดยจะมีการใช้การดำเนินการ รับข้อมูลความพยายามเรียกเก็บเงินค่าสมัครใช้งาน เพื่อรวบรวมข้อมูลเกี่ยวกับความพยายามเรียกเก็บเงินค่าสมัครใช้งานที่สร้างขึ้นในสัปดาห์ที่แล้ว หากความพยายามเหล่านั้นมีข้อความแสดงข้อผิดพลาด ระบบจะส่งอีเมลแจ้งเกี่ยวกับความพยายามในการเรียกเก็บเงินดังกล่าว