تتطلّب Merchant API المصادقة بشكل صارم. يمكنك المصادقة باستخدام بيانات اعتماد OAuth 2.0 أو حساب خدمة أو بيانات الاعتماد التلقائية للتطبيق (ADC) (شائع الاستخدام للاختبار والتطوير على الجهاز).
يمكنك استخدام حساب خدمة للسماح لـ Merchant API بالوصول إلى حسابك على Merchant Center. يُرجى الاطّلاع على تفويض وصول التطبيقات الخارجية إلى حسابات Merchant Center إذا كان تطبيقك يحتاج إلى الوصول إلى حسابات عملائك على Merchant Center.
حساب الخدمة هو نوع خاص من الحسابات التي يستخدمها عادةً التطبيق، وليس شخصًا. يتم تحديد حساب الخدمة من خلال عنوان بريده الإلكتروني الفريد.
يجب أن يكون لديك حساب على Merchant Center لتتمكّن من إكمال هذه الخطوات.
إنشاء حساب خدمة
أنشئ بيانات اعتماد حساب الخدمة أو انتقِل إلى بيانات الاعتماد العامة التي سبق لك إنشاؤها، ثم أنشئ معرّف عميل OAuth 2.0:
- انتقِل إلى وحدة التحكم في واجهة Google API.
- اختَر مشروعًا من القائمة المنسدلة في أعلى الصفحة، أو انقر على مشروع جديد لإنشاء مشروع.
- ابحث عن Merchant API في قائمة Google APIs، وتأكَّد من تفعيلها لهذا المشروع.
- انقر على إدارة.
- في الشريط الجانبي على يمين الصفحة، اختَر بيانات الاعتماد. قد تحتاج إلى النقر على السهم المتّجه لليسار في أعلى يمين الصفحة للاطّلاع على بيانات الاعتماد.
- انقر على إنشاء بيانات اعتماد، ثم على حساب الخدمة.
- أدخِل اسمًا لحساب الخدمة. هذا هو اسم المستخدم الافتراضي لرقم تعريف حساب الخدمة. احفظ رقم تعريف حساب الخدمة، بما في ذلك الجزء الذي يلي الرمز "@"، لاستخدامه لاحقًا.
انقر على إنشاء، واتّبِع الخطوات الاختيارية لمنح إذن الوصول إلى المشروع والمستخدمين، ثم انقر على تم.
الحصول على مفتاح خاص بتنسيق JSON
أنشئ مفتاح JSON خاصًا لحساب الخدمة في وحدة تحكّم Google API:
- انقر على حساب الخدمة، ثم اختَر علامة التبويب المفاتيح.
- انقر على إضافة مفتاح > إنشاء مفتاح جديد.
- اختَر JSON كنوع المفتاح.
- انقر على إنشاء لتنزيل المفتاح الخاص. ملاحظة: يمكنك تنزيل المفتاح الخاص عند إنشائه فقط. لا يمكنك العودة إلى هذه الخطوة لاحقًا.
منح حساب الخدمة إذن الوصول إلى حسابك على Merchant Center
أضِف حساب الخدمة الجديد كمستخدم إلى حسابك على Merchant Center:
- سجِّل الدخول إلى Merchant Center.
- انقر على الإعدادات الإعدادات.
- في القائمة المنسدلة، انقر على الوصول والخدمات.
- ضمن علامة التبويب "المستخدمون وأذونات الوصول"، انقر على إضافة مستخدم.
أدخِل رقم تعريف حساب الخدمة كعنوان البريد الإلكتروني للمستخدم الجديد.
إذا لم تحفظ رقم تعريف حساب الخدمة، انتقِل إلى صفحة إدارة حسابات الخدمة واختَر مشروعك.
حدِّد الإعدادات المفضّلة لكلّ من وصول المستخدم والإشعارات عبر البريد الإلكتروني لحساب الخدمة.
انقر على إضافة مستخدم للحفظ والعودة إلى قائمة المستخدمين. من المفترض أن يظهر الآن رقم تعريف حساب الخدمة مع دور المستخدم الذي تم اختياره.
يمكنك تكرار هذه الخطوات لجميع حسابات الخدمة التي تحتاج إلى الوصول إلى بيانات حسابك على Merchant Center.
الأسئلة الشائعة
- هل يمكنني تسجيل الدخول إلى واجهة مستخدم Merchant Center باستخدام حساب الخدمة؟
- لا، حسابات الخدمة ليست حسابات Google عادية ولا يمكنها الوصول إلى واجهة مستخدم Merchant Center.
- كم مرة أحتاج إلى إعادة تحميل رموز الدخول إلى حساب الخدمة؟
- تنتهي صلاحية رموز الدخول بعد ساعة واحدة من إصدارها من قِبل خادم التفويض Google OAuth 2.0. عند انتهاء صلاحية رمز الدخول، يجب أن يستخدم التطبيق مكتبة العميل للحصول على رمز دخول آخر. لتحديث الرمز المميّز يدويًا، احذف ملف
stored-token.jsonوأعِد المصادقة.