حسابات الخدمة

حسابات الخدمة هي حسابات Google خاصة يمكن استخدامها من قِبل التطبيقات للوصول إلى Google APIs آليًا من خلال بروتوكول OAuth 2.0. يستخدم حساب الخدمة عملية OAuth 2.0 التي لا تتطلّب تفويضًا من أحد الأشخاص. بدلاً من ذلك، يستخدم ملف مفتاح يمكن لتطبيقك فقط الوصول إليه. يتناول هذا الدليل كيفية الوصول إلى Content API for Shopping باستخدام حسابات الخدمة.

ملاحظة: لا يمكن للتطبيقات التي تستخدم حسابات الخدمة للمصادقة الوصول إلا إلى حسابك على Merchant Center. إذا كنت بصدد تطوير تطبيق تابع لجهة خارجية يحتاج إلى الوصول إلى حسابات Merchant Center الخاصة بعملاءك، يُرجى الاطّلاع على دليل الطلبات المُصرَّح بها بدلاً من ذلك.

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

• حساب على Merchant Center

خطوات استخدام حساب خدمة للوصول إلى Content API for Shopping

1. أنشئ بيانات اعتماد حساب الخدمة أو يمكنك الوصول إلى بيانات الاعتماد العامة التي سبق لك إنشاؤها. ستحتاج إلى إنشاء معرِّف عميل OAuth 2.0 والحصول على ملف مفتاح خاص *.json:
   1. انتقِل إلى وحدة التحكم في واجهة Google API.
   2. اختَر مشروعًا من القائمة المنسدلة في أعلى الصفحة. إذا لم يكن لديك مشروع، أنشئ مشروعًا بالنقر على مشروع جديد.
   3. إذا لم يسبق لك تفعيل Content API for Shopping لهذا المشروع، ابحث عنها في قائمة واجهات برمجة تطبيقات Google وفعِّلها.
   4. في الشريط الجانبي على يمين الصفحة، اختَر بيانات الاعتماد. قد تحتاج إلى النقر على السهم المتّجه لليسار في أعلى يمين الصفحة للاطّلاع على هذا الخيار.
   5. لإعداد حساب خدمة، اختَر إنشاء بيانات اعتماد، ثم حساب الخدمة.
      
   6. حدِّد اسمًا لحساب الخدمة الجديد. ويُستخدَم هذا الاسم أيضًا كاسم المستخدم التلقائي لملف تعريف رقم تعريف حساب الخدمة. سجِّل رقم تعريف حساب الخدمة، بما في ذلك الجزء الذي يليه الرمز "@"، لاستخدامه لاحقًا. انقر على إنشاء، ثم اتّبِع الخطوات الاختيارية لمنح إذن الوصول إلى المشروع والمستخدمين، وانقر على تم.

      لن يؤثر اختيار دور حساب الخدمة في نوع الطلبات التي يمكن إجراؤها إلى Content API، إذ يتم تحديد إمكانية الوصول إلى طرق Content API بدلاً من الدور المرتبط برقم تعريف حساب الخدمة في Merchant Center. إذا لم تكن متأكدًا من الخيار الذي تريده، ما عليك سوى اختيار المشروع > المُشاهد.

   7. سيتم توجيهك إلى صفحة "حسابات الخدمة" التي يمكن من خلالها الوصول إلى حساب الخدمة الجديد.
   8. للحصول على مفتاح خاص بتنسيق JSON، انقر على حساب الخدمة، ثم على علامة التبويب المفاتيح. انقر على إضافة مفتاح > إنشاء مفتاح جديد ثم اختَر JSON كنوع المفتاح. انقر على إنشاء لتنزيل المفتاح الخاص على جهاز الكمبيوتر.
2. أضِف حساب الخدمة الجديد بصفته مستخدمًا إلى حسابك على Merchant Center. إذا كنت مطوّرًا تابعًا لجهة خارجية، عليك أن تطلب من عميلك تنفيذ هذه الخطوة نيابةً عنك.
   1. انتقِل إلى حسابك على Merchant Center.
   2. انتقِل إلى الوصول إلى الحساب في إعدادات حسابك على Merchant Center.
   3. انقر على + إضافة مستخدم واستخدِم رقم تعريف حساب الخدمة كعنوان البريد الإلكتروني للمستخدم الجديد.

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

   4. حدِّد الإعدادات المفضّلة لكلّ من وصول المستخدم والإشعارات عبر البريد الإلكتروني لحساب الخدمة. يُرجى العِلم أنّ استخدام Accounts يتطلّب إذن وصول المشرف.
   5. انقر على إضافة مستخدم لحفظ الإعدادات المفضّلة والرجوع إلى قائمة المستخدِمين. يجب إدراج معرّف حساب الخدمة مع دور المستخدم الذي تم اختياره.
   6. كرِّر العملية لجميع حسابات الخدمة الأخرى التي تريد إضافتها.
3. يمكنك الآن الوصول إلى حسابك على Merchant Center باستخدام حساب الخدمة إما باستخدام عملية تطبيق Google بيانات الاعتماد التلقائية أو باستخدام عملية حساب الخدمة مباشرةً. توضِّح عيّنات Content API for Shopping كيفية استخدام كل من عمليتَي المصادقة لحساب الخدمة في كل لغة برمجة متوافقة. يُرجى الاطّلاع على نماذج الرموز البرمجية لتجربة حساب الخدمة الجديد ومعرفة التغيُّرات التي ستحتاج إليها لاستخدام حسابات الخدمة في الرمز البرمجي الخاص بك.

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

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

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

ما هي الوتيرة التي يجب أن أُعيد فيها تحميل الرموز المميّزة لحساب الخدمة؟

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