يوضِّح هذا الدليل كيفية استخدام OAuth 2.0 لطلب الوصول إلى حسابات التجار التابعة لأطراف أخرى. إذا كنت مقدّم خدمة تابعًا لجهة خارجية، يمكنك استخدام سير العمل هذا للسماح لتطبيقك بطلب الوصول إلى حسابات التجار الخاصة بعملائك.
إذا كنت تطوِّر تطبيقًا داخليًا يحتاج إلى الوصول إلى حساب التاجر فقط، يمكنك بدلاً من ذلك الاطّلاع على الوصول إلى حسابك.
طلب إثبات ملكية التطبيق
يجب أن تخضع التطبيقات التي يمكنها الوصول إلى Merchant API لعملية مراجعة التحقّق من بروتوكول OAuth. ستتلقّى التطبيقات التي لم يتم التحقّق منها تحذيرات وستكون وظائف محدودة.
التطبيق هو أي جهاز له معرِّف عميل OAuth 2.0 فريد في Google Cloud.
تستغرق عملية إثبات الهوية عادةً من 3 إلى 5 أيام عمل. للتعرّف على مزيد من المعلومات وإرسال طلب لإثبات الملكية، يمكنك الاطّلاع على صفحة إثبات ملكية التطبيقات.
تسري هذه السياسة على جميع التطبيقات. وننصحك بخضوع جميع التطبيقات لعملية إثبات الهوية في أقرب وقت ممكن لتجنّب توقّف الخدمة عن العمل.
الحصول على نطاقات OAuth
يمكنك إعداد التفويض الإضافي لتجنُّب المشاكل المتعلقة باختيار النطاق.
وفقًا للإعدادات التلقائية، يتم إلغاء اختيار جميع نطاقات OAuth في شاشة الموافقة الخاصة بتطبيقك إذا طلبت أكثر من نطاق واحد. عندما يعرض تطبيقك شاشة طلب الموافقة للمستخدم، على المستخدم اختيار كل نطاق يدويًا للسماح بالوصول إليه.
اطّلِع على الردّ الوارد من طلب OAuth للتحقّق من أنّ تطبيقك يتضمّن النطاقات المناسبة.
راجِع سياسات OAuth 2.0 للحصول على مزيد من التفاصيل.
السماح بالطلبات
عندما يرسل تطبيقك طلبًا إلى واجهة برمجة التطبيقات Merchant API، يجب أن يحتوي هذا الطلب على رمز موافقة مميز. ويساعد الرمز المميز محرك البحث Google في التعرّف على تطبيقك.
نبذة عن بروتوكولات التفويض
يجب أن يستخدم تطبيقك OAuth 2.0 للسماح بالطلبات. ولا يُسمح باستخدام أي بروتوكولات أخرى للموافقة على الطلبات. إذا كان تطبيقك يستخدم ميزة تسجيل الدخول باستخدام حساب Google، ستتم معالجة بعض جوانب عملية الموافقة على الطلبات نيابةً عنك.
الموافقة على الطلبات باستخدام OAuth 2.0
يجب أن يصادق مستخدم على كلّ الطلبات الموجّهة إلى Merchant API.
تختلف تفاصيل عملية الموافقة على الطلبات لبروتوكول OAuth 2.0 نوعًا ما حسب نوع التطبيق الذي تكتبه. وتسري العملية العامة التالية على كل أنواع التطبيقات:
- عند إنشاء التطبيق، يجب تسجيله باستخدام وحدة التحكم في واجهة Google API. ويوفر محرك البحث Google المعلومات التي ستحتاجها في ما بعد، مثل معرّف العميل وسر العميل.
- تفعيل Merchant API في وحدة تحكّم Google API (يمكنك تخطّي هذه الخطوة إذا كانت واجهة برمجة التطبيقات غير مدرَجة في وحدة التحكم في واجهة Google API.)
- إذا احتاج التطبيق الدخول إلى بيانات المستخدِم، يطلب التطبيق من Google نطاقًا معينًا للدخول.
- يعرض Google شاشة الموافقة للمستخدم، ويطلب منه السماح لتطبيقك بطلب بعض بياناته.
- عند موافقة المستخدِم، يمنح Google تطبيقك رمز دخول قصير الأجل.
- يطلب تطبيقك بيانات المستخدِم، من خلال إرفاق رمز الدخول بالطلب.
- يعرض Google البيانات المطلوبة بعد تحققه من صلاحية طلبك والرمز المميز.
تستلزم بعض التدفقات إجراء خطوات إضافية، مثل استخدام رموز مميزة للتحديث للحصول على رموز دخول جديدة. لمزيد من المعلومات التفصيلية حول العمليات المتعلقة بمختلف أنواع التطبيقات، راجِع مستندات بروتوكول OAuth 2.0 في Google.
في ما يلي معلومات عن نطاق OAuth 2.0 لواجهة Merchant API:
| النطاق | المعنى |
|---|---|
https://www.googleapis.com/auth/content |
الإذن بالقراءة/الكتابة |
لطلب الدخول باستخدام بروتوكول OAuth 2.0، يحتاج التطبيق معلومات عن النطاق، بالإضافة إلى المعلومات التي يوفّرها Google عند تسجيل التطبيق (مثل معرِّف العميل وسر العميل).
إليك نموذج يمكنك استخدامه للتفويض.