الحصول على بيانات مجموعة خطط البيع
في مسارات العمل التي تتطلب بيانات مجموعة خطط البيع، يمكنك استخدام إجراء الحصول على بيانات مجموعة خطط البيع لاسترداد معلومات الطلب من متجرك.
التهيئة
الحقول
يحتوي إجراء الحصول على بيانات مجموعة خطط البيع على الحقول التالية، والتي تُستخدم لإنشاء الاستعلام:
| الحقل | الوصف |
|---|---|
| فرز البيانات حسب | مطلوب. المعلمات التي يتم بناءً عليها فرز البيانات التي يُرجعها استعلام البحث. |
| الحد الأقصى لعدد النتائج | مطلوب. الحد الأقصى لعدد النتائج التي يمكن أن يُرجعها استعلام البحث الذي تحدده. يمكنك إرجاع ما يصل إلى 100 نتيجة في المرة الواحدة. |
| الاستعلام | مطلوب. اختر من الاستعلامات الشائعة أو حدّد متقدم لإنشاء استعلامك الخاص. |
سلسلة الاستعلام
فيما يلي مثال على استعلام للحصول على مجموعات خطط البيع التي تم تحديثها في اليوم الأخير:
name='Subscribe & Save'يُعد المتغير category عامل تصفية متاحًا في استعلام مجموعة خطط البيع ويمكن استخدامه لتحديد فئات معينة من مجموعات خطط البيع.
عند الاستعلام عن البيانات، من المفيد معرفة ما يلي:
- قائمة عوامل التصفية المتاحة لمجموعة خطط البيع
- يجب أن تتبع الاستعلامات بنية معينة
- قيم حقول الاستعلام ليست موثقة دائمًا. في بعض الحالات، يمكن العثور على القيم من خلال الاطلاع على مستندات API. كبديل، يمكنك غالبًا العثور على قيم الحقول في عناوين URL في المسؤول عند التصفية. على سبيل المثال، للعثور على بعض قيم استعلام الطلبات، قم بتصفية صفحة الطلبات في المسؤول، ثم تحقق من عنوان URL.
- يمكنك تشغيل أو اختبار استعلام في متجرك باستخدام تطبيق Shopify GraphiQL.
- كن على دراية بما يحدث إذا فشل استعلامك. غالبًا ما تُرجع API جميع النتائج (بدلًا من عدم إرجاع أي شيء).
البيانات المُرجَعة
تُرجع جميع إجراءات إحضار البيانات قائمة تتراوح بين 0 و100 مورد. بناءً على حالة الاستخدام الخاصة بك، قد ترغب في استخدام هذه البيانات بطرق مختلفة:
- إذا كنت بحاجة إلى التعامل مع كل عنصر في القائمة بشكل فردي، مثل إضافة علامة لكل منها، فيمكنك استخدام الإجراء لكل.
- إذا كنت بحاجة إلى تجميع البيانات، مثل حساب عدد النتائج المُرجَعة، فيمكنك استخدام الإجراء حساب أو مجموع.
- إذا كنت بحاجة إلى إخراج القائمة، مثل إرسال بريد إلكتروني بجميع العناصر، فيمكنك استخدام البيانات المُرجَعة مباشرةً في الإجراءات اللاحقة.
للوصول إلى البيانات المُرجَعة في الخطوات التي تلي هذا الإجراء، استخدم المتغير المسمى إحضار بيانات مجموعة خطط البيع، وهو عبارة عن قائمة بمجموعات خطط البيع. يمكنك استخدام هذا المتغير في كل من الشروط والإجراءات. على سبيل المثال، يمكنك إرسال قائمة بمجموعات خطط البيع في إجراء إرسال بريد إلكتروني داخلي على النحو التالي:
{% for getSellingPlanGroupData_item in getSellingPlanGroupData %}
{{getSellingPlanGroupData_item.name}}
{% endfor %}مثال
على سبيل المثال، تمت جدولة سير عمل للتشغيل كل يوم أحد في الساعة 9:00 صباحًا. يتم استخدام الإجراء إحضار بيانات مجموعة خطط البيع لجمع بيانات مجموعات خطط البيع التي تم إنشاؤها في الأسبوع الماضي. إذا كانت المنتجات المرتبطة بمجموعات خطط البيع هي المنتجات الأفضل مبيعًا لديك، فيمكن أن يزداد موضع (position) مجموعة خطط البيع.