لضمان أمان البيانات وفرض التحكّم في الوصول والحفاظ على سلامة النظام، يجب مصادقة جميع طلبات البيانات من Merchant API. تستخدم واجهة برمجة التطبيقات الهوية التي تمت مصادقتها لتحديد الإجراءات التي يملك المتصل الإذن بتنفيذها. على سبيل المثال، قد يكون لدى بعض المتصلين إذن بالقراءة فقط لبيانات المنتجات، بينما يمكن للآخرين تعديل إعدادات الحساب في Merchant Center.
هذا المستند هو جزء من سلسلة متعدّدة الأجزاء حول بدء استخدام Merchant API. إذا سبق لك إعداد المصادقة باستخدام Merchant API، يمكنك الانتقال إلى القسم التالي: التسجيل كمطوّر
تفويض الطلبات إلى Merchant API
يجب أن يتضمّن كل طلب يتم إرساله إلى Merchant API رمز تفويض مميزًا لتعريف تطبيقك لدى Google. لإعداد المصادقة والتفويض، اختَر حالة الاستخدام التي تصف بشكل أفضل الطريقة التي تخطّط بها للعمل مع Merchant API:
هل تعمل على إنشاء تطبيق لتستخدمه أنشطة تجارية أخرى؟
إذا كانت الإجابة بنعم، يعني ذلك أنّك تستخدم تفويض OAuth 2.0. اختَر تفويض OAuth 2.0 في الحالات التالية:
- أنت مقدّم خدمة أو وكالة تابعة لجهة خارجية: أنت بصدد إنشاء تطبيق، مثل منصة SaaS، ستستخدمه أنشطة تجارية أخرى لإدارة بياناتها في Merchant Center.
- إذا كنت بحاجة إلى إدارة العديد من الحسابات الخارجية: إذا أردت استخدام تطبيق واحد للعمل على حسابات متعددة ومستقلة على Merchant Center يملكها عملاء مختلفون. يمنح عملاؤك الأذونات من خلال تسجيل الدخول إلى حساباتهم على Google والنقر على "السماح" في شاشة طلب الموافقة.
هل تنشئ تطبيقًا لمؤسستك؟
إذا كانت الإجابة "نعم"، يمكنك استخدام تفويض حساب الخدمة للوصول إلى Merchant API. اختَر تفويض حساب الخدمة في الحالات التالية:
- أنت تنشئ تطبيقًا داخليًا خاصًا بك: أنت تطوّر أداة خصيصًا لنشاطك التجاري لإدارة بيانات Merchant Center الخاصة بك ، أو تريد أن تنتمي بيانات الاعتماد إلى التطبيق نفسه بدلاً من مستخدم فردي معيّن.
- تحتاج إلى التشغيل الآلي بدون تسجيل دخول المستخدم: ينفّذ تطبيقك مهامًا في الخلفية، مثل تعديلات المستودع الآلية أو مهام "cron".
تفويض OAuth 2.0
إذا كنت مقدّم خدمة خارجيًا أو وكالة تدير حسابات عملاء متعددة، يجب أن يستخدم تطبيقك OAuth 2.0 للسماح بالطلبات. اتّبِع الخطوات التالية لإعداد OAuth 2.0 في Merchant API:
- أنشئ بيانات اعتماد OAuth 2.0 في واجهات برمجة التطبيقات والخدمات في وحدة تحكّم Google Cloud.
- نزِّل بيانات اعتماد عميل OAuth2 إلى الملف، مثل
client-secrets.json - إضافة حساب البريد الإلكتروني كمستخدم إلى Merchant Center: تأكَّد من أنّ حساب Google الذي تستخدمه لمنح الإذن بالطلبات مُدرَج كمستخدم في Merchant Center. لمزيد من التفاصيل، يُرجى الاطّلاع على المقالة كيفية إضافة مستخدم أو إزالته من Merchant Center.
- يجب إسناد دور
Adminإليه لإجراء عملية التسجيل. لمزيد من المعلومات حول الأدوار، يُرجى الاطّلاع على مقالة إدارة المستخدِمين ومستويات الوصول في Merchant Center. - إعداد المصادقة باستخدام عيّنات التعليمات البرمجية: اتّبِع الإرشادات الواردة في قسم إعداد المصادقة ونموذج الإعداد ضمن مستندات عيّنات التعليمات البرمجية الرسمية.
لمزيد من المعلومات حول تفويض OAuth 2.0، يُرجى الاطّلاع على تفويض وصول التطبيقات الخارجية إلى حساب Merchant Center و استخدام بروتوكول OAuth 2.0 للوصول إلى Google APIs.
تفويض حساب الخدمة
يمكنك استخدام حساب خدمة لمنح Merchant API الإذن بالوصول إلى حسابك على Merchant Center. اتّبِع الخطوات التالية لإعداد تفويض حساب الخدمة في Merchant API:
- إنشاء بيانات اعتماد حساب الخدمة في واجهات برمجة التطبيقات والخدمات في Google Cloud Console
- تنزيل المفتاح الخاص: أنشئ المفتاح الخاص ونزِّله بتنسيق JSON لحساب الخدمة. أعِد تسمية الملف إلى
service-account.json - إضافة حساب الخدمة إلى Merchant Center: انسخ عنوان البريد الإلكتروني الفريد لحساب الخدمة، مثل
sa@project.iam.gserviceaccount.com، وأضِفه كمستخدم جديد في حسابك على Merchant Center. لمزيد من التفاصيل، يُرجى الاطّلاع على كيفية إضافة مستخدم أو إزالته من Merchant Center. - امنحها إذن الوصول إلى
Admin. لمزيد من المعلومات حول مستويات الوصول، يُرجى الاطّلاع على مقالة إدارة المستخدِمين ومستويات الوصول في Merchant Center - إعداد المصادقة باستخدام عيّنات التعليمات البرمجية: اتّبِع الإرشادات الواردة في قسم إعداد المصادقة ونموذج الإعداد ضمن مستندات عيّنات التعليمات البرمجية الرسمية.
لمزيد من المعلومات حول تفويض حساب الخدمة، يُرجى الاطّلاع على تفويض الوصول إلى حسابك على Merchant Center ونظرة عامة على حسابات الخدمة.