ดึงข้อมูลความพยายามเรียกเก็บค่าสมัครใช้งาน

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

การกำหนดค่า

ฟิลด์

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

ฟิลด์ที่ใช้ในการดำเนินการดึงข้อมูล
ฟิลด์คำอธิบาย
จัดเรียงข้อมูลตามจำเป็น พารามิเตอร์ที่ใช้จัดเรียงข้อมูลซึ่งส่งคืนโดยคำค้นหา
จำนวนผลลัพธ์สูงสุดจำเป็น จำนวนผลลัพธ์สูงสุดที่สามารถส่งคืนโดยคำค้นหาที่คุณเลือก คุณสามารถส่งคืนได้สูงสุดครั้งละ 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 น. โดยจะมีการใช้การดำเนินการ รับข้อมูลความพยายามเรียกเก็บเงินค่าสมัครใช้งาน เพื่อรวบรวมข้อมูลเกี่ยวกับความพยายามเรียกเก็บเงินค่าสมัครใช้งานที่สร้างขึ้นในสัปดาห์ที่แล้ว หากความพยายามเหล่านั้นมีข้อความแสดงข้อผิดพลาด ระบบจะส่งอีเมลแจ้งเกี่ยวกับความพยายามในการเรียกเก็บเงินดังกล่าว

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