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

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

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

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

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

ما هو عدد المرات التي يجب فيها تجديد رموز الوصول إلى حساب الخدمة؟

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