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