الحصول على بيانات الخصم

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

التهيئة

الحقول

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

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

هذا مثال على استعلام للحصول على الخصومات النشطة التي تستخدم كودًا:

method:code AND status:active

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

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

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

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

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

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

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

{% for discount_item in getDiscountData %}
{% if discount_item.discount.__typename == "DiscountAutomaticApp" %}
*  {{discount_item.discount.DiscountAutomaticApp.title}}
{% endif %}
{% endfor %}

المُشغِّلات

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

تفاصيل واجهة برمجة التطبيقات (API)

• مورد الخصم
• عوامل تصفية استعلام الخصم

القوالب

إرسال ملخص أسبوعي عبر البريد الإلكتروني للخصومات النشطة التي تستخدم كودًا

إرسال ملخص للخصومات النشطة التي تستخدم كودًا عبر البريد الإلكتروني. يتم تشغيل سير العمل وفقًا لجدول زمني كل يوم اثنين في الساعة 9 صباحًا. يمكن تخصيص سير العمل لتغيير التوقيت وكيفية استلامك للملخص ونوع الخصومات التي ترغب في تضمينها والوضع. عرض القالب