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

حسابات الخدمة هي حسابات 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 APIs ومكّنه.
   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 Application أو باستخدام مسار حساب الخدمة مباشرةً. توضح نماذج Content API for Shopping كيفية استخدام التدفقين لبيانات اعتماد حساب الخدمة بكل لغة برمجة مدعومة. يُرجى مراجعة نماذج الرموز لتجربة حساب الخدمة الجديد ومعرفة التغييرات التي ستحتاج إليها لاستخدام حسابات الخدمة في شفرتك.

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

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

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

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

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