الحصول على بيانات عقد الاشتراك

في مسارات العمل التي تستخدم بيانات عقد الاشتراك، يمكنك استخدام إجراء Get subscription contract data لاسترداد معلومات عقد الاشتراك من متجرك.

في هذه الصفحة

التكوين

الحقول

يحتوي إجراء Get subscription contract data على الحقول التالية، والتي تُستخدم لإنشاء الاستعلام:

الحقول المستخدمة في إجراءات Get data.
الحقل	الوصف
فرز البيانات حسب	مطلوب. المَعلمات التي يتم من خلالها فرز البيانات المُرجعة بواسطة استعلام البحث.
الحد الأقصى لعدد النتائج	مطلوب. الحد الأقصى لعدد النتائج التي يمكن أن يُرجعها استعلام البحث الذي تحدده. يمكنك إرجاع ما يصل إلى 100 نتيجة في كل مرة.
استعلام	مطلوب. اختر من الاستعلامات الشائعة أو حدّد متقدم لإنشاء استعلامك الخاص.

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

هذا مثال على استعلام للحصول على عقود اشتراك بحالة ACTIVE:

status: ACTIVE

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

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

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

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

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

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

للوصول إلى البيانات المُرجعة في الخطوات التي تلي هذا الإجراء، استخدِم المتغير المسمى Get subscription contact data، وهو عبارة عن قائمة بعقود الاشتراكات. يمكنك استخدام هذا المتغير في كلٍ من الشروط والإجراءات. على سبيل المثال، يمكنك إرسال قائمة الطلبات في إجراء Send internal email على النحو التالي:

{% for single_contract in GetSubscriptionContractData %}
* {{ single_contract.name }}
{% endfor %}

المُشغّلات

يمكنك استخدام هذا الإجراء في أي مسار عمل، بما في ذلك مُشغّل Scheduled time. في مسار العمل الذي يستخدم مُشغّل Scheduled time، يبدأ مسار العمل في وقت تحدده أنت، بدلًا من أن يبدأ كنتيجة لحدث معين. نظرًا لعدم وجود حدث معين في متجرك أو من أحد التطبيقات لبدء تشغيل مسار العمل، لا يتم تضمين أي بيانات تلقائيًا.