لاستخدام 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 ومستكشف واجهات برمجة التطبيقات مشاريع مشتركة على 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.
المراجع
لمزيد من المعلومات، يُرجى الاطّلاع على ما يلي: