واجهة برمجة تطبيقات مصادقة الويب

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

يجب أن يحدّد مضيف الويب طلبات الويب على الأجهزة الجوّالة في مقابل طلبات الويب على أجهزة الكمبيوتر المكتبي استنادًا إلى قيمة عنوان وكيل المستخدم. يجب أن تكون الصفحة التي يتم عرضها في طلبات الويب على الأجهزة الجوّالة متوافقة مع الويب على الأجهزة الجوّالة على نظامَي التشغيل Android وiOS. بالإضافة إلى قيمة عنوان وكيل المستخدم، لن يقدم لك العميل أي تلميح آخر بشأن البيئة التي يجري فيها هذا المستخدم الطلب (سطح المكتب أو الويب).

يجب أن يستخدم الخادم بروتوكول HTTPS باستخدام GET. يمكن لشركة الدمج تحديد المسار والمضيف. يجب أن تتيح وحدة الدمج طول عناوين URL التي تبلغ 2,048 حرفًا. يتضمن ذلك المخطط والمضيف والمنفذ والمسار والمعلمات.

وسيتمّ ترميز كل المَعلمات بترميز UTF-8 قبل ترميز عنوان URL.

الطلب

تقدِّم Google ما يلي عند الطلب كمَعلمات عناوين URL:

الحقول
gspMajorVersion int

رقم الإصدار الرئيسي لهذا الطلب.

gspAuthenticationRequest AuthenticationRequest

طلب مصادقة.

gspAssociationId string

وعند توفّر هذه السمة، تحتوي على معرّف تستخدمه جهة الدمج للبحث عن بيانات الاعتماد الخاصة بالمستخدم المطلوب إجراء عملية الدمج. في حال عدم توفّر هذه السمة، يمكن للمستخدم تغيير تعريف الحساب.

gspCallbackUrl string

عنوان URL لإعادة توجيه المستخدم إليه من أجل إنهاء عملية المصادقة على Google. هذه القيمة مرمّزة في عنوان URL.

الإجابة

عند اكتمال المصادقة، يجب إعادة توجيه المستخدم إلى gspCallbackUrl باستخدام HTTPS GET. يجب أن يحتوي عنوان URL هذا على معلمات طلب البحث التالية:

الحقول
gspResult int

100
تمت المصادقة بنجاح.
201 ألغى المستخدم المسار يدويًا ويجب إلغاء هذا التدفق.
202 تعذّرت المصادقة لسبب خطير ويجب إلغاء التدفق.

gspAuthenticationResponse AuthenticationResponse

استجابة المصادقة.