Shopify Flow وGraphQL Admin API

يستخدم تطبيق Flow واجهة برمجة التطبيقات Shopify GraphQL Admin API لإنشاء عمليات أتمتة وعمليات دمج توسّع وتعزّز مسؤول Shopify. يستخدم تطبيق Flow الإصدار 2026-01 من API لتقييم الشروط والمتغيرات في مسارات سير العمل بالإضافة إلى اتخاذ إجراءات في متجر Shopify الخاص بك. نظرًا لأن تطبيق Flow يصل إلى بيانات المتجر من خلال استدعاء API، فإنك تتمتع بإمكانية الوصول إلى جميع الحقول المتاحة في API تقريبًا من تطبيق Flow.

نظرًا لأن منصة Shopify تُصدر إصدارات جديدة من API كل 3 أشهر، فقد يلزم تحديث بعض مسارات سير العمل عند تغيير الحقول أو إيقافها.

استخدام GraphQL Admin API في مسارات سير العمل

تستخدم معظم الإجراءات في تطبيق Flow واجهة برمجة التطبيقات GraphQL Admin API لإجراء تغييرات على متجر Shopify الخاص بك. على سبيل المثال، يستخدم إجراء إضافة علامات الطلب عملية التعديل tagsAdd. يمكن أن يستخدم إجراء إرسال طلب Admin API معظم عمليات التعديل، بما في ذلك تلك التي لم تتوافر بعد كإجراءات في تطبيق Flow.

أثناء قيامك بإنشاء مسارات سير عمل، ستصادف غالبًا أسماء حقول وأوصاف تستند إلى بناء جملة GraphQL Admin API. على سبيل المثال، لتحديد إجمالي الكمية القابلة للبيع لمتغير في سير العمل، يمكنك استخدام المتغير variants_item.inventoryQuantity. وكمثال آخر، لتحديد الموقع الذي اشترك فيه العميل في رسالتك الإخبارية عبر البريد الإلكتروني، يمكنك استخدام المتغير emailSubscriptionMethod.

لست بحاجة إلى أن تكون محترفًا في استخدام API لإنشاء مسارات سير عمل باستخدام تطبيق Flow، ولكن فهم القليل عن أسماء المتغيرات وتعريفاتها يمكن أن يساعدك في بناء منطق سير العمل المحدد الذي تريده. على سبيل المثال، معرفة الفرق بين displayName (اسم العرض) وfirstName (الاسم الأول) للعميل يمكن أن يساعد سير عملك على الوصول إلى البيانات الصحيحة اعتمادًا على ما تريد استخدامها من أجله. يتم تضمين التعريفات مع كل متغير أثناء قيامك بإنشاء سير العمل الخاص بك، ويمكنك النقر فوق للتعرف على المزيد حول أي متغير أو تعريف.

بيانات المتجر وGraphQL Admin API

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

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

قد تحتاج إلى معاينة البيانات أو مراجعة وثائق API لفهم ما يتم إخراجه بواسطة API واستخدامه في Flow، ولضمان أن سير عملك يُخرج البيانات التي تتوقعها.

وسيطات الحقل وGraphQL Admin API

تتطلب بعض حقول GraphQL Admin API وسيطات (معلمات إضافية) تضيّق نطاق البيانات التي يتم إرجاعها. على سبيل المثال، يحتاج الحقل product.inCollection إلى وسيطة id للمجموعة لمعرفة المجموعة التي يجب التحقق منها. بدونها، لا يمكن للحقل إرجاع نتيجة.

في تطبيق Flow، يمكنك إنشاء متغيرات من هذه الحقول من خلال توفير قيمة الوسيطة المطلوبة، والتي يمكن استخدامها بعد ذلك في سير العمل. يمكنك أيضًا تعيين اسم مخصص للمتغير لتسهيل الرجوع إليه في الخطوات اللاحقة، على سبيل المثال، تسمية product.inCollection(id: "gid://shopify/Collection/123456") باسم product.inSummerBestsellers.

تعرّف على المزيد حول إنشاء متغيرات من الحقول التي تحتوي على وسيطات.

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

إصدارات API

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

• عندما تتم إزالة حقول دون توفير بديل لها، مما قد يؤثر على كيفية تقييم الشروط أو Liquid.
• عندما تصبح الحقول قابلة لتلقي قيمة فارغة (nullable)، مما قد يؤثر على كيفية تقييم الشروط أو Liquid.
• عندما تتغير قيم العد (enum) أو تتم إضافة أنواع اتحاد (union) أو واجهة (interface) جديدة، مما قد يؤثر على Liquid أو التعليمات البرمجية.
• عندما تتغير وسيطات التعديل، مما قد يؤثر على تكوين إجراءات إرسال طلب Admin API.

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

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