ليقرأ ناشر منتجاتك، يحتاج إلى إذن من متجرك على شوبيفاي. تمنحه هذا الإذن بإنشاء تطبيق خاص صغير داخل حسابك على شوبيفاي. يستغرق ذلك نحو 5 دقائق ولا تحتاج إلى مطوّر.
ما يجب معرفته قبل البدء:
- التطبيق يقرأ منتجاتك فقط. لا يستطيع تغيير متجرك ولا رؤية طلباتك ولا رؤية عملائك.
- التطبيق ملكك. يمكنك إزالته من متجرك في أي وقت، ويتوقف ناشر عن القراءة فورًا.
- يجب أن تكون مالك المتجر، أو موظفًا له دور App developer (مطوّر تطبيقات).
- تُستورد المنتجات التي حالتها نشط (Active) فقط. المسودات والمنتجات المؤرشفة لا تُستورد.
ستنسخ ثلاث قيم إلى ناشر: عنوان المتجر، ومعرّف العميل (Client ID)، وسرّ العميل (Client secret).
الخطوة 1: اعرف عنوان متجرك
- افتح لوحة التحكم في شوبيفاي.
- افتح Settings (الإعدادات)، ثم Domains (النطاقات).
- ابحث عن العنوان الذي ينتهي بـ
.myshopify.com، مثلyour-store.myshopify.com. هذا هو العنوان الذي يحتاجه ناشر، حتى إن كان متجرك يستخدم نطاقًا آخر.
الخطوة 2: أنشئ التطبيق
- في لوحة شوبيفاي، افتح Settings (الإعدادات)، ثم Apps (التطبيقات).
- اضغط Develop apps (تطوير التطبيقات)، ثم Build apps in Dev Dashboard. تفتح لوحة المطوّرين.
- اضغط Create app (إنشاء تطبيق).
- اختر Start from Dev Dashboard.
- سمِّ التطبيق
nashirواضغط Create (إنشاء).
الخطوة 3: امنح التطبيق صلاحية قراءة منتجاتك
- في صفحة التطبيق، افتح Versions (النسخ) وأنشئ نسخة جديدة.
- في خانة Scopes (الصلاحيات)، الصق هذا السطر كما هو:
read_products,read_locales,read_translations
- اترك الخانات الأخرى كما هي. وإذا كانت خانة App URL فارغة فاكتب فيها
https://shopify.dev/apps/default-app-home. - اضغط Release (إصدار).
الغرض من كل صلاحية:
| الصلاحية | ما يقرؤه ناشر بها |
|---|---|
read_products | منتجاتك وخياراتها وأسعارها ومخزونها وصورها. مطلوبة. |
read_locales | اللغات المنشور بها متجرك. |
read_translations | أسماء منتجاتك بلغة ثانية، مثل العربية والإنجليزية. |
إذا كان متجرك بلغة واحدة فقط، فتكفي read_products وحدها.
الخطوة 4: ثبّت التطبيق على متجرك
- في صفحة التطبيق، اضغط Install app (تثبيت التطبيق).
- اختر متجرك.
- اضغط Install (تثبيت).
تعرض شاشة التثبيت ما يستطيع التطبيق رؤيته. قد تجد فيها، إلى جانب منتجاتك، السطر View staff and contributor data (عرض بيانات الموظفين). يعرض شوبيفاي هذا السطر تلقائيًا لهذا النوع من التطبيقات. لم يطلبه ناشر ولا يقرأ تلك البيانات.
الخطوة 5: انسخ معرّف العميل وسرّ العميل
- في صفحة التطبيق، افتح Settings (الإعدادات).
- انسخ Client ID (معرّف العميل).
- أظهر Client secret (سرّ العميل) وانسخه. تعامل معه ككلمة مرور: لا ترسله في محادثة أو بريد إلكتروني.
الخطوة 6: اربط المتجر في ناشر
- افتح صفحة المتاجر في ناشر:
- افتح شوبيفاي، ثم املأ عنوان المتجر ومعرّف العميل وسرّ العميل، واختر النشاط التجاري.
- اضغط فحص المتجر. يعرض ناشر عدد المنتجات التي وجدها وأولها كما قرأها. لا يُستورد شيء بعد.
- اضغط الربط والاستيراد. إذا كان في النشاط منتجات أضفتها بنفسك، يعرض ناشر عدد المنتجات التي ستُستبدل ويطلب تأكيدك أولًا.
بعد أول استيراد، يقرأ ناشر منتجاتك من جديد كل 6 ساعات تلقائيًا. تُضاف المنتجات الجديدة، وتُحدَّث الأسعار والتوفر، وتُؤرشف المنتجات التي حذفتها أو حوّلتها إلى مسودة. للتحديث فورًا، اضغط إعادة الاستيراد في البطاقة.
إذا حدثت مشكلة
| ما يقوله ناشر | ما تفعله |
|---|---|
| لم يقبل شوبيفاي معرّف العميل أو سرّ العميل | انسخهما من جديد من صفحة Settings للتطبيق، وتأكد من عدم وجود مسافة قبلهما أو بعدهما. |
| التطبيق غير مثبَّت على متجرك | أعد الخطوة 4. |
التطبيق لا يملك الصلاحية read_products | أعد الخطوة 3، ثم وافق على الصلاحية الجديدة في متجرك. |
| هذا التطبيق لا يتبع المؤسسة نفسها التي يتبعها المتجر | أُنشئ التطبيق في حساب شوبيفاي آخر. أنشئه من متجرك نفسه بدءًا من الخطوة 2. |
| متجرك على شوبيفاي مجمَّد، أو مغلق أو متوقف مؤقتًا | عالج ذلك من لوحة شوبيفاي (سدِّد الفاتورة أو أعد فتح المتجر)، ثم اضغط إعادة الاستيراد. |
| لا يوجد في المتجر أي منتج نشط | اجعل منتجاتك نشطة (Active) في شوبيفاي ثم أعد الفحص. |
إذا أنشأت سرّ عميل جديدًا لاحقًا، يتوقف القديم عن العمل. اضغط فصل المتجر في البطاقة في ناشر، ثم اربطه من جديد بالسرّ الجديد. تعود منتجاتك كما كانت.
إذا فشلت المزامنة فلا يتغيّر أي شيء في كتالوجك ولا يُحذف. وبعد 3 محاولات فاشلة متتالية تعرض البطاقة تنبيهًا ويصل بريد إلكتروني إلى مالك الفريق.