لاستخدام Merchant API بفعالية، من المهم فهم مفاهيم التسجيل والمصادقة والتفويض. وتخدم هذه الأدوار أغراضًا مختلفة في ضمان الوصول الآمن والصحيح إلى بيانات Merchant Center.
المصطلحات
تتعلّق التسجيل والمصادقة والتفويض ببعضها، ولكن لكل منها معنى وغرض مختلفان.
- المصادقة: في هذه العملية، تتحقّق الخدمة من هوية المستخدم أو التطبيق الذي يرسل طلبًا إلى واجهة برمجة التطبيقات. تستخدم Merchant API آليات Google العادية، مثل OAuth 2.0. لمزيد من المعلومات، يُرجى الاطّلاع على المصادقة على الطلبات والمصادقة بصفتك صاحب الحساب.
- التفويض: تحدّد هذه العملية الإجراءات التي يُسمح للمستخدم أو التطبيق الذي تمّت المصادقة عليهما بتنفيذها باستخدام حساب على Merchant Center. وهي تجيب عن السؤال: "ما هي الإجراءات التي يمكنك اتّخاذها؟" استنادًا إلى الأدوار والأذونات الممنوحة للمستخدم الذي تمت مصادقته ضمن حساب Merchant Center. على سبيل المثال، قد يكون لدى المستخدم إذن بقراءة بيانات المنتج، ولكن ليس بتعديل إعدادات الحساب.
- التسجيل: في ما يتعلق بواجهة Merchant API، هذه عملية إعداد لمرة واحدة تتيح لشركة Google إرسال إشعارات مهمة عن الخدمة إلى حسابات التجّار التي تديرها. تؤدي عملية التسجيل إلى إضافة عناوين البريد الإلكتروني الخاصة بالمطوّرين إلى حسابك الرئيسي على Merchant Center وربطه بمعرّفات المشاريع على Google Cloud التي تستخدمها للمصادقة. يتيح هذا الربط لتطبيقك تلقّي إشعارات الخدمة لجميع حسابات التجّار التي تديرها. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء مشروع على Google Cloud.
التسجيل
تُعدّ عملية التسجيل ضرورية لتمكين تطبيقك من استخدام Merchant API. في ما يلي المعلومات التي يجب معرفتها:
المتطلبات الأساسية
يتطلّب التسجيل لاستخدام Merchant API ما يلي:
- حساب Merchant Center: يجب أن يكون لديك حساب حالي على Merchant Center.
- إذن الوصول الإداري: يجب أن يكون لحساب مستخدم Google الذي تستخدمه لبدء طلب التسجيل امتيازات إدارية في حساب Merchant Center الذي تسجّله.
- مشروع Google Cloud: يجب ربط تطبيقك بمشروع على Google Cloud. يوفّر هذا المشروع بيانات الاعتماد اللازمة (مثل معرّفات عملاء OAuth 2.0) لتطبيقك من أجل المصادقة.
أسباب عدم إمكانية تسجيل مشروع Google Cloud مشترك
تستخدم أدوات مثل Google OAuth Playground وAPIs Explorer مشاريع Google Cloud مشترَكة تملكها Google. لا يمكنك التسجيل باستخدام مشاريع مشتركة للأسباب التالية:
- وهي مخصّصة للاختبار والاستكشاف، وليس لتحديد هوية التطبيق في بيئة الإنتاج.
- ويعني تسجيلها إنشاء رابط بين الأداة المشترَكة وبياناتك المحدّدة في Merchant Center، ما قد يؤدي إلى تلقّي رسائل غير مرغوب فيها.
يحتاج تطبيقك إلى مشروع Google Cloud مخصّص حتى تظل مراسلات Merchant API التي ترسلها إليك Google ذات صلة باستخدامك الفعلي.
ومع ذلك، يمكنك استخدام تطبيقات الويب OAuth Playground وAPI Explorer لاستخدام Merchant API في التجارب وحالات الاستخدام غير الإنتاجية.
العثور على رقم تعريف مشروعك على Google Cloud
يمكنك العثور على رقم تعريف المشروع ورقم المشروع في Google Cloud Console. لمزيد من التفاصيل، يُرجى الاطّلاع على العثور على اسم المشروع ورقمه ومعرّفه.
إجراء مكالمة التسجيل
سجِّل باستخدام طريقة
registerGcp
ضمن واجهة برمجة التطبيقات الفرعية Accounts. يربط هذا الطلب رقم مشروعك على Google Cloud بحساب Merchant Center.
أثناء العملية، عليك تقديم عنوان بريد إلكتروني مرتبط بمستخدم فردي تستخدمه لاستدعاء واجهة برمجة التطبيقات. يجب أن يكون هذا البريد الإلكتروني ملكًا لمستخدم لديه إذن وصول إداري إلى حساب Merchant Center.
لمحة عن حقل البريد الإلكتروني
التواصل الفعّال هو مفتاح النجاح. ترسل Google إشعارات مهمة وتنبيهات إلزامية عن الخدمة واستطلاعات للمطوّرين وفرصًا أخرى ذات صلة بواجهة Merchant API. وتضمن إدارة جهات الاتصال بشكل سليم وصول هذه الرسائل إلى الأشخاص المناسبين.
- الغرض: تستخدم Google عنوان البريد الإلكتروني هذا كوسيلة الاتصال الأساسية لتلقّي المراسلات المتعلقة بواجهات برمجة التطبيقات.
- البريد الإلكتروني الخاص بمن؟: يجب أن يكون هذا البريد الإلكتروني خاصًا بمطوّر فردي أو بجهة اتصال فنية رئيسية مسؤولة عن عملية دمج واجهة برمجة التطبيقات.
- أفضل الممارسات:
- يجب: استخدام عنوان البريد الإلكتروني للشركة الخاص بالفرد.
- لا تستخدِم أسماء مستعارة عامة للمجموعات أو عناوين البريد الإلكتروني لحسابات الخدمة. نرسل الرسائل إلى مستلمين من البشر.
المورد users لإدارة جهات الاتصال
في حين أنّ عنوان البريد الإلكتروني في طلب التسجيل يحدّد جهة اتصال أولية، فإنّ الطريقة الأكثر فعالية لإدارة جهات الاتصال والأذونات هي استخدام مورد Merchant API
accounts.users
أو إعدادات إدارة المستخدمين في واجهة مستخدم Merchant Center. لمزيد من المعلومات حول استخدام Merchant Center، يُرجى الاطّلاع على إدارة المستخدمين في حسابك.
يمكنك الاستفادة من هذه الميزات باتّباع الخطوات التالية:
- إضافة جميع المطوّرين: أضِف المطوّرين الذين يعملون على دمج واجهة برمجة التطبيقات كمستخدمين لحساب Merchant Center.
- إسناد دور
API_DEVELOPER: بالإضافة إلى الأدوار العادية (المشرف والمستخدم العادي)، يمكنك إسناد دورAPI_DEVELOPERإلى المستخدمين. على وجه الخصوص، يجب منح هذا الدور للمستخدمين الذين من المفترض أن يتلقّوا الرسائل المتعلقة بواجهات برمجة التطبيقات. يمكنك الجمع بين هذا الدور وأدوار أخرى. - المزايا:
- الفصل الواضح: يتم فصل إدارة جهات الاتصال في واجهة برمجة التطبيقات عن عملية التسجيل لمرة واحدة.
- المرونة: يمكنك تعديل جهات الاتصال عند تغيير أعضاء الفريق.
- التواصل المستهدَف: يضمن وصول الأخبار الخاصة بواجهة برمجة التطبيقات إلى الأشخاص المعنيين.
حتى إذا قدّمت عنوان بريد إلكتروني أثناء التسجيل، ننصحك بشدّة بإدارة جهات اتصال واجهة برمجة التطبيقات من خلال إضافة مستخدمين لديهم دور API_DEVELOPER.
المراجع
لمزيد من المعلومات، يُرجى الاطّلاع على ما يلي: