إعداد OAuth

أكمِل الخطوات التالية لضبط منصّتك لتنفيذ بروتوكول OAuth 2.0:

1. اضبط مربّع حوار موافقة التاجر.

   عندما يحاول التاجر للمرة الأولى الوصول إلى حسابه على "الملف التجاري على Google" من خلال منصّة الشريك باستخدام واجهات برمجة التطبيقات، يظهر له مربّع حوار طلب موافقة التاجر.

   

   

   بعد منح جهة خارجية إذن الوصول إلى حسابك، ترسل Google إليك إشعارًا إلزاميًا عبر البريد الإلكتروني. يُنبّهك الإشعار، بصفتك مالك الموقع الجغرافي، بأنّه تم إجراء تغيير على المستخدمين الذين يمكنهم الوصول إلى بيانات حسابك.

   يعرض حسابك على Google الآن التطبيقات التي يمكنها الوصول إلى حسابك، مع تفاصيل إضافية حول البيانات التي يمكن للتطبيق التابع لجهة خارجية الوصول إليها على وجه التحديد. يمكنك أيضًا إزالة إذن وصول التطبيق في أي وقت من خلال النقر على الزر إزالة إذن الوصول. بهذه الطريقة، يمكنك التحكّم في إمكانية وصول الجهات الخارجية إلى بيانات حسابك.

   

   يتيح لك مربّع حوار موافقة التاجر، الذي يمكن الوصول إليه في مشروعك على Google Cloud، ضبط معلومات الموافقة التالية حول الشركاء التابعين لجهات خارجية الذين منحتهم إذن الوصول إلى حسابك:

   1. رابط الصفحة الرئيسية للتطبيق: الصفحة الرئيسية للشريك التابع لجهة خارجية الذي منحته إذن الوصول إلى حسابك.
   2. رابط سياسة خصوصية التطبيق: هو رابط يؤدي إلى سياسة خصوصية الشريك.
   3. رابط بنود خدمة التطبيق: هو رابط يؤدي إلى بنود خدمة الشريك.

   

   لمزيد من المعلومات عن ضبط الموافقة، يُرجى الاطّلاع على إعداد OAuth 2.0 > موافقة المستخدِم.

2. اضبط اسم تطبيقك وشعاره.

   يجب أن يكون لدى المورّدين اسم التطبيق وشعاره نفسهما لدى شركائنا، أو مشروع Google Cloud منفصل لتمييزهم عن المشروع التلقائي للشريك.

   

استخدام بروتوكول OAuth حسب المنصات

يمكن للمنصات اتّخاذ إجراءات بالنيابة عن المالكين والمدراء. ويؤدي ذلك إلى تقليل عدد إجراءات التاجر المطلوبة وخفض معدّلات الانسحاب.

على المالكين والمشرفين أولاً تسجيل الدخول إلى منصة الشركاء باستخدام حساباتهم على Google ويجب أن تكون بيانات اعتمادهم محفوظة في ذاكرة التخزين المؤقت. يتم استخدام بيانات اعتماد OAuth 2.0 المخزّنة مؤقتًا ورموز الوصول والرموز المميزة لإعادة التحميل لعرض بيانات الموقع الجغرافي أو تعديلها.

في ما يلي أمثلة شائعة على استخدام منصات OAuth:

• أنشئ المواقع الجغرافية بصفتك التاجر، ما يؤدي إلى ضبط حساب التاجر على Google على أنّه المالك الأساسي.
• يمكن للشركاء الردّ على المراجعات وإنشاء المشاركات بصفتهم مالك النشاط التجاري من خلال دمج مع واجهة برمجة التطبيقات الخاصة بالمنصة.
• يمكن للمدراء الردّ باسم مالك النشاط التجاري عند استخدام واجهات برمجة التطبيقات.
• يمكن للتجّار نقل المواقع الجغرافية تلقائيًا إلى المؤسسات في "الملف التجاري على Google".

• تلقائيًا إضافة مشرف إلى حساب أو موقع جغرافي، مثل مدير

  على سبيل المثال، يتم إنشاء دعوة إلى حساب Google الخاص بمستخدم إدارة باستخدام بيانات اعتماد OAuth 2.0 المخزّنة مؤقتًا. بعد ذلك، يتم قبول الدعوة باستخدام بيانات اعتماد OAuth المخزّنة مؤقتًا لمستخدم حساب الإدارة.

  ملاحظة: ترسل Google إشعارات عبر البريد الإلكتروني إلى التاجر عند إضافة مستخدمين أو إزالتهم من المواقع الجغرافية.

الاستثناءات التي تتطلّب اتّخاذ تاجر إجراء مباشرًا

لا يمكن تنفيذ جميع الإجراءات تلقائيًا من خلال طلبات البيانات من واجهة برمجة التطبيقات التي تستخدِم بيانات اعتماد OAuth للتاجر.

في ما يلي بعض الأمثلة على الاستثناءات التي تتطلّب اتّخاذ تاجر إجراء مباشر:

• على التجّار تسجيل الدخول إلى حساباتهم على Google مرة واحدة على الأقل لكي تخزِّن المنصة بيانات اعتماد OAuth التي يتم استخدامها لاحقًا لإجراء طلبات بيانات من واجهة برمجة التطبيقات وتنفيذ الإجراءات نيابةً عن التاجر.
• على التجّار الموافقة لمرة واحدة على مربّع حوار موافقة بروتوكول OAuth 2.0 الذي يمنح جهة خارجية إذن الوصول إلى بيانات الموقع الجغرافي.
• على التجّار تسجيل الدخول إلى حساباتهم على Google والنقر يدويًا على رابط لبدء مطالبات الملكية وإكمالها.

إبطال إذن الوصول عبر OAuth

إذا أنهى التاجر علاقته التجارية بشريك، يمكن للتاجر إلغاء إذن الوصول الذي منحه للشريك من خلال بروتوكول Oauth إلى حسابه على Google. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إدارة الوصول إلى حسابك على Google.