كيف تحصل على مفتاح واجهة Shopify لنقل متجرك

ما هذا المفتاح، ولماذا تنشئه أنت

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

ينتج عن ذلك أمران، كلاهما في مصلحتك:

أنت من يقرر ما نراه. لا نحصل إلا على الأذونات التي تحدِّدها. نطلب إذن القراءة، ولا نطلب شيئًا يكتب في متجر Shopify.
يمكنك القطع في أي لحظة. احذف التطبيق في Shopify فيتوقف الرمز عن العمل فورًا، دون إشعار لأحد.

متجر Shopify يعمل طوال الوقت كالمعتاد. لا شيء مما نفعله يغيّره.

الخطوة ١ — افتح إعدادات التطبيقات

في لوحة Shopify اذهب إلى الإعدادات ← التطبيقات وقنوات البيع ← تطوير التطبيقات.

إذا ظهر زر السماح بتطوير التطبيقات المخصصة فاضغطه. تسأل Shopify عن ذلك مرة واحدة لكل متجر، ولا يستطيعه إلا مالك المتجر.

الخطوة ٢ — أنشئ التطبيق

اضغط إنشاء تطبيق، وسمِّه اسمًا تعرفه لاحقًا — «نقل Omniterra» يفي بالغرض — ثم أكِّد.

التطبيق فارغ الآن، ولا يستطيع قراءة أي شيء بعد.

الخطوة ٣ — حدِّد الأذونات

افتح تبويب التهيئة، ثم تكامل Admin API ← تعديل.

حدِّد إذن القراءة لكل ما تريد نقله:

ما تريد نقله	الإذن المطلوب
المنتجات والمتغيرات والصور	`read_products`
المجموعات	`read_products`
العملاء	`read_customers`
الطلبات	`read_orders`, `read_all_orders`
الخصومات	`read_discounts`, `read_price_rules`
الصفحات ومقالات المدونة	`read_content`
القوائم	`read_online_store_navigation`
عمليات إعادة التوجيه (مهمة لتحسين الظهور)	`read_online_store_pages`
الملفات والصور	`read_files`
المخزون والمواقع	`read_inventory`, `read_locations`

اضغط حفظ.

يعرض Omniterra القائمة نفسها في شاشة الاستيراد أيضًا، جاهزة للنسخ، ويخبرك بما ينقص منها إذا عاد الاتصال ناقصًا.

الخطوة ٤ — ثبِّت التطبيق وانسخ الرمز

اذهب إلى تبويب بيانات اعتماد API واضغط تثبيت التطبيق.

تعرض Shopify الآن رمز الوصول إلى Admin API، وهو سلسلة تبدأ بـ `shpat_`. انسخه.

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

الخطوة ٥ — الصقه في Omniterra

في لوحة Omniterra اذهب إلى المنتجات ← استيراد / تصدير، واختر Shopify، واكتب عنوان متجرك (`my-store.myshopify.com`) ثم الصق الرمز.

اضغط اتصال. نقرأ كتالوجك ونعرض عليك ما وجدناه قبل كتابة أي شيء: كم منتجًا وعميلًا وطلبًا وصفحة. لا يتحرك شيء حتى تأذن أنت.

إذا قال إن هناك أذونات ناقصة

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

الحل هو إعادة التثبيت: التهيئة ← تكامل Admin API ← تعديل، حدِّد الناقص، احفظ، ثم بيانات اعتماد API ← إعادة تثبيت التطبيق. يبقى الرمز نفسه.

إذا أنشأت التطبيق في Dev Dashboard

بعض المتاجر لديها تطبيق أُنشئ على `dev.shopify.com` بدل لوحة المتجر. الفكرة نفسها، مع تفصيلين إضافيين:

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

ما الذي ينتقل، وما الذي لا يمكن نقله

المنتجات بمتغيراتها، والصور، والمجموعات، والعملاء، والطلبات، والخصومات، والصفحات، ومقالات المدونة، والقوائم، وعمليات إعادة التوجيه، والملفات — كلها تنتقل.

وهناك أشياء لا يمكن نقلها، ونقولها لك قبل البدء لا بعده: رموز بطاقات الهدايا (لا تكشفها Shopify أبدًا)، وبيانات البطاقات المحفوظة (تخص مزوّد الدفع لا متجرك)، وتطبيقات الطرف الثالث المثبَّتة بما تحتفظ به داخلها من بيانات.

إذا وصلت منتجات أقل مما توقّعت

ثلاثة أمور تفسّر معظم الحالات، ولا يعني أيٌّ منها أن الاستيراد فشل.

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

المنتجات بلا سعر أو بلا متغيّر تُتخطّى، لأنها بهذه الحال لا تُباع. تظهر في التقرير النهائي بأسمائها، لترى بالضبط أيها ولماذا.

الإذن الذي تحدده بعد التثبيت لا يسري حتى تعيد تثبيت التطبيق؛ وهو الفخ نفسه المذكور أعلاه. أعد التثبيت ثم اضغط «أعد الفحص» في شاشة الاستيراد — نقرأ كتالوجك مرة أخرى دون أن نمسّ ما وصل من قبل.

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

كم يستغرق

كتالوج من بضع مئات من المنتجات يكتمل عادة في دقيقتين. المتاجر الكبيرة تُنقل على دفعات، ويمكنك مغادرة الصفحة — يستمر الاستيراد وترى تقدّمه حين تعود.

الأسئلة الشائعة

هل يغيّر هذا شيئًا في متجر Shopify؟

لا. نحن نقرأ فقط. الأذونات التي تمنحها للقراءة وحدها، ويستمر متجر Shopify في البيع تمامًا كما كان بينما تجرّب Omniterra.

ماذا لو فقدت الرمز؟

ألغِ تثبيت التطبيق في Shopify وأعد تثبيته — بيانات اعتماد API ← إلغاء التثبيت، ثم تثبيت التطبيق. تعرض Shopify رمزًا جديدًا. ويتوقف القديم عن العمل لحظة إلغاء التثبيت.

هل أستطيع منعكم من قراءة متجري لاحقًا؟

نعم، في أي وقت. احذف التطبيق من Shopify ← الإعدادات ← التطبيقات وقنوات البيع ← تطوير التطبيقات. يموت الرمز معه فورًا.

حدَّدت الأذونات ومع ذلك يقول إنها ناقصة.

تمنح Shopify الأذونات وقت التثبيت، لا عند حفظ التهيئة. أعد تثبيت التطبيق فتصبح سارية.

هل أحتاج إلى مطوّر لهذا؟

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

مفتاح Shopify الذي ينقل متجرك