إحضار بيانات محاولة فوترة الاشتراك

في مسارات العمل التي تتطلب بيانات محاولة فوترة الاشتراك، يمكنك استخدام إجراء إحضار بيانات محاولة فوترة الاشتراك لاسترداد معلومات الطلب من متجرك.

التكوين

الحقول

يحتوي الإجراء إحضار بيانات محاولة فوترة الاشتراك على الحقول التالية، والتي تُستخدم لإنشاء الاستعلام:

سلسلة الاستعلام

هذا مثال على استعلام لإحضار محاولات فوترة الاشتراك التي تم إنشاؤها في الأيام الثلاثة الماضية:

created_at:>'{{ createdAt | date_minus: "3 day" }}'

المتغير created_at هو عامل تصفية متاح في استعلام محاولة فوترة الاشتراك ويمكن استخدامه لتحديد رسالة خطأ معينة لمحاولات فوترة الاشتراك.

عند الاستعلام عن البيانات، من المفيد معرفة ما يلي:

• قائمة عوامل التصفية المتاحة لمحاولة فوترة الاشتراك
• يجب أن تتبع الاستعلامات بنية معينة
• قيم حقول الاستعلام ليست موثقة دائمًا. في بعض الحالات، يمكن العثور على القيم من خلال الاطلاع على مستندات API. كبديل، يمكنك غالبًا العثور على قيم الحقول في عناوين URL في المسؤول عند التصفية. على سبيل المثال، للعثور على بعض قيم استعلام الطلبات، قم بتصفية صفحة الطلبات في المسؤول، ثم تحقق من عنوان URL.
• يمكنك تشغيل أو اختبار استعلام في متجرك باستخدام تطبيق Shopify GraphiQL.
• كن على دراية بما يحدث إذا فشل استعلامك. غالبًا ما تُرجع API جميع النتائج (بدلًا من عدم إرجاع أي شيء).

البيانات المُرجَعة

تُرجع جميع إجراءات إحضار البيانات قائمة تتراوح بين 0 و100 مورد. بناءً على حالة الاستخدام الخاصة بك، قد ترغب في استخدام هذه البيانات بطرق مختلفة:

• إذا كنت بحاجة إلى التعامل مع كل عنصر في القائمة بشكل فردي، مثل إضافة علامة لكل منها، فيمكنك استخدام الإجراء لكل.
• إذا كنت بحاجة إلى تجميع البيانات، مثل حساب عدد النتائج المُرجَعة، فيمكنك استخدام الإجراء حساب أو مجموع.
• إذا كنت بحاجة إلى إخراج القائمة، مثل إرسال بريد إلكتروني بجميع العناصر، فيمكنك استخدام البيانات المُرجَعة مباشرةً في الإجراءات اللاحقة.

للوصول إلى البيانات المُرجَعة في الخطوات التي تلي هذا الإجراء، استخدم المتغير المسمى إحضار بيانات محاولة فوترة الاشتراك، وهو عبارة عن قائمة بمحاولات فوترة الاشتراك. يمكنك استخدام هذا المتغير في كل من الشروط والإجراءات. على سبيل المثال، يمكنك إرسال قائمة بمحاولات فوترة الاشتراك في إجراء إرسال بريد إلكتروني داخلي على النحو التالي:

{% for getSubscriptionBillingAttemptData_item in getSubscriptionBillingAttemptData %}
  {{getSubscriptionBillingAttemptData_item.errorMessage}}
{% endfor %}

مثال

على سبيل المثال، تمت جدولة تشغيل مسار عمل كل يوم أحد في الساعة 9:00 صباحًا. يُستخدَم إجراء Get subscription billing attempt data لجمع بيانات محاولات فوترة الاشتراكات التي تم إنشاؤها في الأسبوع الماضي. إذا كانت تتضمن رسالة خطأ، فأرسل محاولات الفوترة عبر البريد الإلكتروني.

مرجع API

• مورد محاولة فوترة الاشتراك
• عوامل تصفية استعلام محاولة فوترة الاشتراك