واجهة برمجة تطبيقات مصادقة الويب
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يجب أن تستخدم الشركات المتكاملة مضيف ويب لإعادة توجيه المستخدمين لأغراض المصادقة. هذه المصادقة هي طريقة مختلفة، ولكن الغرض نفسه منها هو المصادقة التي تقدّمها مصادقة 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
استجابة المصادقة.
|
جميع الحقوق محفوظة. إنّ Java علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Integrators must implement a mobile-friendly web host to redirect users for authentication, similar to Android authentication but utilizing a web-based approach."],["The web host should distinguish between mobile and desktop requests using the user-agent header and deliver a mobile-friendly experience for both Android and iOS."],["The server must use HTTPS GET with a definable path and host, supporting URLs up to 2,048 characters, including parameters encoded in UTF-8 before URL encoding."],["Google provides URL parameters for the request including version, authentication request, association ID (for credential lookup), and a callback URL for redirection after authentication."],["Upon authentication completion, the user is redirected to the provided callback URL with parameters indicating the result (success, cancellation, or failure) and an authentication response."]]],["Integrators must host a mobile-friendly website for user authentication, distinguishing between mobile and desktop requests via the user-agent header. The server must utilize HTTPS GET, with a definable path and host, supporting URLs up to 2,048 characters. Google provides parameters like `gspMajorVersion`, `gspAuthenticationRequest`, `gspAssociationId`, and `gspCallbackUrl` within the request. Upon authentication completion, the user is redirected to `gspCallbackUrl` via HTTPS GET, including `gspResult` and `gspAuthenticationResponse` parameters. All parameters are UTF-8 and URL-encoded.\n"]]