الحصول على بيانات السوق

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

التهيئة

الحقول

يحتوي إجراء الحصول على بيانات السوق على الحقول التالية:

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

هذا مثال على استعلام للحصول على جميع الأسواق النشطة:

status:ACTIVE

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

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

• قائمة عوامل تصفية السوق المتاحة

• يجب أن تتبع الاستعلامات صياغة معينة

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

• يمكنك تشغيل أو اختبار استعلام في متجرك باستخدام تطبيق Shopify GraphiQL.

• انتبه لما يحدث إذا فشل استعلامك. غالباً ما تُرجع API جميع النتائج (بدلاً من لا شيء).

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

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

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

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

{% for single_market in GetMarketData %}
    * {{ single_market.name }}
    {% endfor %}

المشغّلات

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

مرجع API

لمزيد من المعلومات حول API المُستخدمة في هذا الإجراء، راجع استعلام الأسواق.