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