استخدام حسابات خدمة OAuth 2.0 مع واجهة برمجة تطبيقات Manufacturer Center

تُعد حسابات الخدمة حسابات خاصة على Google يمكن للتطبيقات استخدامها للوصول إلى Google APIs آليًا عبر OAuth 2.0. يستخدم حساب الخدمة تدفق OAuth 2.0 الذي لا يتطلب تفويضًا إضافيًا. بدلاً من ذلك، فإنه يستخدم ملف مفتاح يمكن لتطبيقك فقط الوصول إليه. يناقش هذا الدليل كيفية الوصول إلى واجهة برمجة تطبيقات Manufacturer Center باستخدام حسابات الخدمة.

المتطلّبات الأساسية

• حساب على Manufacturer Center

الخطوات التي يجب اتّباعها لاستخدام حساب خدمة للوصول إلى Manufacturer Center API

1. يمكنك إنشاء بيانات اعتماد حساب الخدمة أو الوصول إلى بيانات الاعتماد العامة التي أنشأتها. يجب إنشاء معرِّف عميل OAuth 2.0 والحصول على ملف مفتاح خاص بتنسيق *.json:

   1. انتقِل إلى وحدة التحكم في واجهة Google API.

   2. اختَر مشروعًا في القائمة المنسدلة في أعلى الصفحة. وإذا لم يكن لديك مشروع حتى الآن، يمكنك إنشاء مشروع بالنقر على إنشاء مشروع.

   3. إذا لم يسبق لك تفعيل Manufacturer Center API لهذا المشروع، ابحث عنه في قائمة Google APIs وفعِّله.

   4. في الشريط الجانبي على يمين الصفحة، اختَر بيانات الاعتماد.

   5. لإعداد حساب خدمة، اختَر إنشاء بيانات اعتماد، ثم مفتاح حساب الخدمة.

   

   1. في الصفحة التالية، اختَر حساب خدمة جديد من القائمة المنسدلة.

   2. أدخِل اسمًا لحساب الخدمة الجديد. ويعمل هذا أيضًا كاسم المستخدم التلقائي لمعرّف حساب الخدمة. تذكَّر رقم تعريف حساب الخدمة لاستخدامه لاحقًا.

   

   1. اختَر JSON لنوع المفتاح، ثم انقر على إنشاء.

   2. سيتغيّر الزر إنشاء إلى إنشاء...، وبعد انتهاء إنشاء المفتاح، سيتم تلقائيًا تنزيل المفتاح الخاص كملف *.json.

   1. ستتم إعادتك إلى صفحة "بيانات الاعتماد"، وسيظهر لك حساب الخدمة الجديد في قائمة مفاتيح حساب الخدمة الخاص بحسابك.

2. أضِف حساب الخدمة الجديد كمستخدم إلى حسابك على Manufacturer Center. إذا كنت مطوِّر تطبيقات تابعًا لجهة خارجية، يجب أن تطلب من عميلك تنفيذ هذه الخطوة نيابةً عنك.

   1. انتقِل إلى حسابك على Manufacturer Center.

   2. انتقِل إلى قائمة "المستخدمون" في إعدادات حسابك على Manufacturer Center.

   3. انقر على الزر +مستخدم، واستخدِم رقم تعريف حساب الخدمة كعنوان البريد الإلكتروني للمستخدم الجديد.

      

   4. املأ النموذج باستخدام رقم تعريف حساب الخدمة، واختَر أدوار المستخدمين المطلوبة. يجب اختيار موقع واحد على الأقل، ويتطلّب استخدام خدمة Accounts دور المشرف.

   إذا لم يسبق لك تدوين رقم تعريف حساب الخدمة، انتقِل إلى صفحة إدارة حسابات الخدمة واختَر المشروع الذي أنشأته.

   

   1. انقر على الزر حفظ. ستتم إعادتك إلى قائمة المستخدمين، ويجب إدراج رقم تعريف حساب الخدمة مع أدوار المستخدمين المحدّدة.

   2. كرِّر العملية لجميع حسابات الخدمة الأخرى التي تريد إضافتها.

   3. يمكنك الاطّلاع على مستخدمي حساب الخدمة الحاليين من خلال الانتقال إلى علامة التبويب "المستخدمون". سيكون هؤلاء المستخدمون الذين لديهم عنوان بريد إلكتروني ينتهي بـ "gserviceaccount.com".

3. أصبح بإمكانك الآن الوصول إلى حسابك على Manufacturer Center باستخدام حساب الخدمة إمّا من خلال مسار بيانات الاعتماد التلقائية لتطبيق Google أو من خلال مسار حساب الخدمة مباشرةً. توضّح نماذج واجهة برمجة التطبيقات في Manufacturer Center كيفية استخدام كلا المسارَين لبيانات اعتماد حساب الخدمة في كل لغة برمجة متوافقة. يمكنك الاطلاع على نماذج التعليمات البرمجية لتجربة حساب الخدمة الجديد ومعرفة التغييرات التي ستحتاج إليها لاستخدام حسابات الخدمة في الرمز البرمجي الخاص بك.

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

هل يمكنني تسجيل الدخول إلى واجهة مستخدم الويب في Manufacturer Center باستخدام حساب الخدمة الخاص بي؟

لا، حسابات الخدمة ليست حسابات Google عادية ولا يمكنها الوصول إلى واجهة مستخدم الويب Manufacturer Center.

كم مرة أحتاج إلى إعادة تحميل رموز الدخول إلى حساب الخدمة؟

تنتهي صلاحية رموز الدخول بعد ساعة واحدة من إصدارها بواسطة خادم تفويض OAuth 2.0 في Google. عند انتهاء صلاحية رمز الدخول، يجب أن يستخدم التطبيق مكتبة البرامج لجلب رمز دخول آخر.