الحصول على بيانات الكتالوج

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

التكوين

الحقول

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

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

فيما يلي مثال على استعلام للحصول على جميع الكتالوجات النشطة:

status:ACTIVE

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

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

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

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

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

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

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

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

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

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

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

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% endfor %}

المشغّلات

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

مرجع API

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