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