مرجع تسجيل الدخول باستخدام Google HTML API

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

عنصر برقم التعريف "g_id_onload"

يمكنك وضع سمات بيانات "تسجيل الدخول باستخدام حساب Google" في أي عناصر مرئية أو غير مرئية، مثل <div> و<span>. الشرط الوحيد هو تعيين رقم تعريف العنصر على g_id_onload. لا تضع هذا المعرّف على عناصر متعددة.

سمات البيانات

يسرد الجدول التالي سمات البيانات مع أوصافها:

السمة
data-client_id معرِّف العميل لتطبيقك
data-auto_prompt عرض نقرة Google One
data-auto_select تفعيل التحديد التلقائي بنقرة واحدة في Google.
data-login_uri عنوان URL لنقطة نهاية تسجيل الدخول
data-callback اسم وظيفة معالج الرمز المميز لرقم تعريف JavaScript
data-native_login_uri عنوان URL لنقطة نهاية معالج بيانات اعتماد كلمة المرور
data-native_callback اسم دالة معالج بيانات اعتماد JavaScript
data-native_id_param اسم المعلمة للقيمة credential.id
data-native_password_param اسم المعلمة للقيمة credential.password
data-cancel_on_tap_outside تتحكّم هذه السياسة في ما إذا كان سيتم إلغاء رسالة المطالبة إذا نقر المستخدم خارج رسالة المطالبة.
data-prompt_parent_id معرّف DOM لعنصر حاوية مطالبة One Click
data-skip_prompt_cookie يتم تخطّي النقرة الواحدة إذا كان ملف تعريف الارتباط المحدّد يحتوي على قيمة غير فارغة.
data-nonce سلسلة عشوائية للرموز المميزة للمعرف
data-context العنوان والكلمات في رسالة المطالبة بنقرة واحدة
data-moment_callback اسم الدالة لمستمع إشعار حالة واجهة المستخدم الفوري
data-state_cookie_domain إذا أردت استدعاء One Tap في النطاق الرئيسي والنطاقات الفرعية التابعة له، يجب تمرير النطاق الرئيسي إلى هذه السمة حتى يتم استخدام ملف تعريف ارتباط مشترك واحد.
data-ux_mode تدفق تجربة المستخدم في ميزة "تسجيل الدخول باستخدام حساب Google"
data-allowed_parent_origin الأصول المسموح لها بتضمين إطار iframe الوسيطة. سيتم تشغيل نقرة واحدة في وضع iframe المتوسط في حال توفّر هذه السمة.
data-intermediate_iframe_close_callback تلغي هذه السياسة السلوك التلقائي لإطار iframe عندما يغلق المستخدمون يدويًا نقرة واحدة.
data-itp_support تفعيل تجربة المستخدم التي تمت ترقيتها بنقرة واحدة على متصفحات ITP.

أنواع السمات

تحتوي الأقسام التالية على تفاصيل حول نوع كل سمة ومثال عنها.

معرِّف_البيانات_للعميل

هذه السمة هي معرّف العميل لتطبيقك، والذي يمكن العثور عليه وإنشائه في Google Developers Console. اطلع على الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوب مثال
سلسلة نعم data-client_id="CLIENT_ID.apps.googleusercontent.com"

رسالة مطالبة تلقائية

تحدّد هذه السمة ما إذا كان سيتم عرض نقرة واحدة أم لا. القيمة الافتراضية هي true. لن يتم عرض نقرة Google One عندما تكون هذه القيمة هي false. راجع الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوب مثال
منطقي اختياري data-auto_prompt="true"

تحديد-البيانات_التلقائية

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

النوع مطلوب مثال
منطقي اختياري data-auto_select="true"

data-login_uri

هذه السمة هي معرّف الموارد المنتظم (URI) لنقطة نهاية تسجيل الدخول. قد يتم حذفه إذا كانت الصفحة الحالية هي صفحة تسجيل الدخول، وفي هذه الحالة يتم نشر بيانات الاعتماد على هذه الصفحة بشكلٍ افتراضي.

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

اطلع على الجدول التالي للحصول على مزيد من المعلومات:

النوع اختياري مثال
عنوان URL يتم التعيين تلقائيًا على معرّف الموارد المنتظم للصفحة الحالية أو القيمة التي تحددها.
يتم التجاهل عند ضبط data-ux_mode="popup" و data-callback.
data-login_uri="https://www.example.com/login"

يجب أن تعالج نقطة نهاية تسجيل الدخول طلبات POST التي تحتوي على مفتاح credential يحتوي على قيمة رمز مميّز للمعرّف.

في ما يلي مثال لطلب نقطة نهاية تسجيل الدخول:

POST /login HTTP/1.1
Host: www.example.com
Content-Type: application/x-www-form-urlencoded

credential=ID_TOKEN

رد اتصال البيانات

تمثّل هذه السمة اسم دالة JavaScript التي تعالج الرمز المميّز للمعرّف المعروض. اطلع على الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوب مثال
سلسلة مطلوبة إذا لم يتم ضبط data-login_uri. data-callback="handleToken"

يمكن استخدام إحدى السمتَين data-login_uri وdata-callback. يعتمد ذلك على المكونات التالية وتهيئات وضع تجربة المستخدم:

  • السمة data-login_uri مطلوبة لزر "تسجيل الدخول باستخدام حساب Google" redirect لوضع تجربة المستخدم، الذي يتجاهل السمة data-callback.

  • يجب ضبط إحدى هاتين السمتَين لاستخدام ميزة Google One Tap و"زر تسجيل الدخول" في Google popup. وإذا تم ضبطهما، تكون الأولوية للسمة data-callback.

لا تتوافق واجهة برمجة تطبيقات HTML مع دوال جافا سكريبت ضمن مساحة الاسم. وبدلاً من ذلك، يمكنك استخدام دالة JavaScript عمومية بدون مساحة اسم. على سبيل المثال، استخدم mylibCallback بدلاً من mylib.callback.

data-native_login_uri

هذه السمة هي عنوان URL لنقطة نهاية معالج بيانات اعتماد كلمة المرور. وفي حال ضبط السمة data-native_login_uri أو السمة data-native_callback، تعود مكتبة JavaScript إلى مدير بيانات الاعتماد الأصلي في حال عدم توفّر جلسة على Google. ولا يُسمح لك بضبط السمتَين data-native_callback وdata-native_login_uri. راجع الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوب مثال
سلسلة اختياري data-login_uri="https://www.example.com/password_login"

رد اتصال_الإعلانات المدمجة مع المحتوى

هذه السمة هي اسم وظيفة جافا سكريبت التي تعالج بيانات اعتماد كلمة المرور المعروضة من مدير بيانات الاعتماد الأصلية للمتصفح. في حال ضبط السمة data-native_login_uri أو السمة data-native_callback، تعود مكتبة JavaScript إلى مدير بيانات الاعتماد الأصلي في حال عدم توفّر جلسة على Google. لا يُسمح لك بتعيين كل من data-native_callback وdata-native_login_uri. راجع الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوب مثال
سلسلة اختياري data-native_callback="handlePasswordCredential"

لا تتوافق واجهة برمجة تطبيقات HTML مع دوال جافا سكريبت ضمن مساحة الاسم. وبدلاً من ذلك، يمكنك استخدام دالة JavaScript عمومية بدون مساحة اسم. على سبيل المثال، استخدم mylibCallback بدلاً من mylib.callback.

data-native_id_param

عند إرسال بيانات اعتماد كلمة المرور إلى نقطة النهاية لمعالج بيانات اعتماد كلمة المرور، يمكنك تحديد اسم المعلمة للحقل credential.id. الاسم الافتراضي هو email. اطلع على الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوب مثال
عنوان URL اختياري data-native_id_param="user_id"

data-native_password_param

عند إرسال بيانات اعتماد كلمة المرور إلى نقطة النهاية لمعالج بيانات اعتماد كلمة المرور، يمكنك تحديد اسم المعلمة للقيمة credential.password. الاسم التلقائي هو password. اطلِع على الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوب مثال
عنوان URL اختياري data-native_password_param="pwd"

data-cancel_on_tap_outside

تحدّد هذه السمة ما إذا كان سيتم إلغاء طلب "النقرة الواحدة" إذا نقر المستخدم خارج رسالة المطالبة. القيمة التلقائية هي true. ولتعطيلها، اضبط القيمة على false. اطلع على الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوب مثال
منطقي اختياري data-cancel_on_tap_outside="false"

data-prompt_parent_id

تعيّن هذه السمة رقم تعريف DOM لعنصر الحاوية. وإذا لم يتم تعيين هذا الإعداد، فسيتم عرض رسالة "النقرة الواحدة" في الجانب العلوي الأيسر من النافذة. راجع الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوب مثال
سلسلة اختياري data-prompt_parent_id="parent_id"

تتخطى هذه السمة نقرة واحدة إذا كان ملف تعريف الارتباط المحدد يحتوي على قيمة غير فارغة. راجع الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوب مثال
سلسلة اختياري data-skip_prompt_cookie="SID"

عدم الوصول إلى البيانات

هذه السمة عبارة عن سلسلة عشوائية يستخدمها الرمز المميز ID لمنع هجمات إعادة التشغيل. اطلع على الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوب مثال
سلسلة اختياري data-nonce="biaqbm70g23"

يقتصر الطول غير القياسي على الحد الأقصى لحجم JWT الذي تدعمه بيئتك، والقيود المفروضة على حجم كل من المتصفح والخادم على حدة.

سياق البيانات

تغيّر هذه السمة نص العنوان والرسائل المعروضة في رسالة المطالبة بنقرة واحدة. اطلع على الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوب مثال
سلسلة اختياري data-context="use"

يسرد الجدول التالي السياقات المتاحة وأوصافها:

السياق
signin "تسجيل الدخول باستخدام حساب Google"
signup "الاشتراك باستخدام Google"
use "الاستخدام مع Google"

استرجاع البيانات

هذه السمة هي اسم الوظيفة للمستمع لإشعار حالة واجهة المستخدم. لمزيد من المعلومات، يُرجى الرجوع إلى نوع البيانات PromptMomentNotification. اطلع على الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوب مثال
سلسلة اختياري data-moment_callback="logMomentNotification"

لا تتوافق واجهة برمجة تطبيقات HTML مع دوال جافا سكريبت ضمن مساحة الاسم. وبدلاً من ذلك، يمكنك استخدام دالة JavaScript عمومية بدون مساحة اسم. على سبيل المثال، استخدم mylibCallback بدلاً من mylib.callback.

إذا أردت عرض One Touch في نطاق رئيسي ونطاقاته الفرعية، فمرر النطاق الرئيسي إلى هذه السمة بحيث يتم استخدام ملف تعريف ارتباط واحد مشترك للحالة. اطلع على الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوب مثال
سلسلة اختياري data-state_cookie_domain="example.com"

وضع_بيانات_ux

تضبط هذه السمة خطوات تجربة المستخدم التي يستخدمها الزر "تسجيل الدخول باستخدام حساب Google". القيمة التلقائية هي popup. ليس لهذه السمة أيّ تأثير في تجربة المستخدم التي تتمّ بنقرة واحدة. راجع الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوب مثال
سلسلة اختياري data-ux_mode="redirect"

يسرد الجدول التالي أوضاع تجربة المستخدم المتاحة وأوصافها.

وضع تجربة المُستخدِم
popup إجراء تدفق تجربة المُستخدِم في عملية تسجيل الدخول في نافذة منبثقة
redirect إجراء تدفق تجربة المُستخدِم في تسجيل الدخول من خلال إعادة توجيه الصفحة بالكامل

data-allowed_parent_origin

الأصول المسموح لها بتضمين إطار iframe الوسيطة. سيتم تشغيل "نقرة واحدة" في وضع iframe المتوسط في حال تقديم هذه السمة. راجع الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوب مثال
مصفوفة سلسلة أو سلسلة اختياري data-allowed_parent_origin="https://example.com"

يسرد الجدول التالي أنواع القيم المسموح بها وأوصافها.

أنواع القيم
string عنوان URL مفرد للنطاق. "https://example.com"
string array قائمة بعناوين URL للنطاق المفصول بفواصل. "https://news.example.com,https://local.example.com"

وإذا كانت قيمة السمة data-allowed_parent_origin غير صالحة، سيتعذّر إعداد "إطار iframe" بنقرة واحدة وإيقافه.

يمكن أيضًا استخدام بادئات أحرف البدل. على سبيل المثال، سيطابق "https://*.example.com" example.com ونطاقاته الفرعية على جميع المستويات (مثل news.example.com وlogin.news.example.com). تجدر الإشارة إلى ما يجب وضعه في الاعتبار عند استخدام أحرف البدل:

  • لا يمكن أن تتكون سلاسل الأنماط من حرف بدل ونطاق مستوى أعلى فقط. على سبيل المثال، https://*.com وhttps://*.co.uk غير صالحين. وكما ورد أعلاه، سيطابق "https://*.example.com" example.com والنطاقات الفرعية التابعة له. يمكنك أيضًا استخدام قائمة مفصولة بفواصل لتمثيل نطاقين مختلفين. على سبيل المثال، سيتطابق النطاق "https://example1.com,https://*.example2.com" مع النطاقات example1.com وexample2.com والنطاقات الفرعية للنطاق example2.com.
  • يجب أن تبدأ نطاقات أحرف البدل بنظام https:// آمن. سيتم اعتبار "*.example.com" غير صالح.

data-intermediate_iframe_close_callback

تلغي هذه السياسة السلوك التلقائي لإطار iframe عندما يغلق المستخدمون يدويًا نقرة واحدة من خلال النقر على الزر "X" في واجهة مستخدم One Tap. يتمثل السلوك الافتراضي في إزالة إطار iframe المتوسط من DOM على الفور.

لا يتم تطبيق حقل data-intermediate_iframe_close_callback إلا في وضع iframe المتوسط. ولا يؤثر ذلك إلا في إطار iframe المتوسط، بدلاً من إطار iframe بنقرة واحدة. وتتم إزالة واجهة المستخدم بنقرة واحدة قبل استدعاء معاودة الاتصال.

النوع مطلوب مثال
الدالة اختياري data-intermediate_iframe_close_callback="logBeforeClose"

لا تتوافق واجهة برمجة تطبيقات HTML مع دوال جافا سكريبت ضمن مساحة الاسم. وبدلاً من ذلك، يمكنك استخدام دالة JavaScript عمومية بدون مساحة اسم. على سبيل المثال، استخدم mylibCallback بدلاً من mylib.callback.

دعم data-itp

يحدّد هذا الحقل ما إذا كان يجب تمكين تجربة المستخدم التي تمت ترقيتها بنقرة واحدة على المتصفحات التي تدعم ميزة "منع التتبع الذكي (ITP)". القيمة التلقائية هي false. اطلع على الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوب مثال
منطقي اختياري data-itp_support="true"

عنصر بفئة "g_id_signin"

إذا أضفت g_id_signin إلى السمة class الخاصة بالعنصر، يتم عرض العنصر على شكل زر "تسجيل الدخول باستخدام حساب Google".

يمكنك عرض عدة أزرار "تسجيل الدخول باستخدام حساب Google" في الصفحة نفسها. يمكن أن يكون لكل زر إعداداته المرئية الخاصة. يتم تحديد الإعدادات من خلال سمات البيانات التالية.

سمات البيانات المرئية

يسرد الجدول التالي سمات البيانات المرئية وأوصافها:

السمة
data-type نوع الزر: رمز أو زر قياسي.
data-theme مظهر الزر. على سبيل المثال، fill_blue أو fill_black.
data-size حجم الزر. على سبيل المثال، صغيرة أو كبيرة.
data-text نص الزر. على سبيل المثال، "تسجيل الدخول باستخدام حساب Google" أو "الاشتراك باستخدام Google"
data-shape شكل الزر. على سبيل المثال، مستطيل أو دائري.
data-logo_alignment محاذاة شعار Google: إلى اليسار أو الوسط.
data-width عرض الزر، بالبكسل.
data-locale يتم عرض نص الزر باللغة التي تم تعيينها في هذه السمة.
data-click_listener وفي حال ضبطها، سيتم استدعاء هذه الدالة عند النقر على زر "تسجيل الدخول باستخدام حساب Google".

أنواع السمات

تحتوي الأقسام التالية على تفاصيل حول نوع كل سمة ومثال عنها.

نوع البيانات

نوع الزر. القيمة التلقائية هي standard. راجع الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوب مثال
سلسلة نعم data-type="icon"

يسرد الجدول التالي أنواع الأزرار المتاحة وأوصافها:

النوع
standard زرّ يحتوي على نص أو معلومات مخصّصة:
icon زرّ رمز بدون نص:

مظهر-البيانات

مظهر الزر. القيمة التلقائية هي outline. راجع الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوب مثال
سلسلة اختياري data-theme="filled_blue"

يسرد الجدول التالي المظاهر المتاحة وأوصافها:

المظهر
outline مظهر الزر العادي:
زر عادي بخلفية بيضاء زر رمز بخلفية بيضاء زر مخصص بخلفية بيضاء
filled_blue مظهر الزر المملوء باللون الأزرق:
زر قياسي بخلفية زرقاء زر رمز بخلفية زرقاء زر مخصص بخلفية زرقاء
filled_black مظهر الزر المملوء باللون الأسود:
زر عادي بخلفية سوداء زر رمز بخلفية سوداء زر مخصص بخلفية سوداء

حجم البيانات

حجم الزر. القيمة التلقائية هي large. راجع الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوب مثال
سلسلة اختياري data-size="small"

يسرد الجدول التالي أحجام الأزرار المتاحة وأوصافها.

حجم الملف
large زر كبير:
زر قياسي كبير زر رمز كبير زر كبير ومخصص
medium زر متوسط الحجم:
زر عادي متوسط زر رمز متوسط
small زر صغير:
زر صغير زر رمز صغير

نص البيانات

نص الزر. القيمة التلقائية هي signin_with. لا توجد اختلافات مرئية لنص أزرار الرموز التي تحتوي على سمات data-text مختلفة. والاستثناء الوحيد هو عندما تتم قراءة النص لإمكانية الدخول.

اطلع على الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوب مثال
سلسلة اختياري data-text="signup_with"

يسرد الجدول التالي نصوص الأزرار المتوفرة وأوصافها:

النص
signin_with نص الزر هو "تسجيل الدخول باستخدام حساب Google":
زر عادي يحمل الاسم &quot;تسجيل الدخول باستخدام حساب Google&quot; زرّ رمز لا يتضمّن نصًا مرئيًا
signup_with نص الزر هو "الاشتراك باستخدام Google":
زر قياسي مسمى &quot;الاشتراك باستخدام Google&quot; زرّ رمز لا يتضمّن نصًا مرئيًا
continue_with نص الزر هو "متابعة مع Google":
زر قياسي يحمل الاسم &quot;متابعة مع Google&quot; زرّ رمز لا يتضمّن نصًا مرئيًا
signin نص الزر هو "تسجيل الدخول":
زر قياسي يحمل اسم &quot;تسجيل الدخول&quot; زرّ رمز لا يتضمّن نصًا مرئيًا

شكل البيانات

شكل الزر. القيمة التلقائية هي rectangular. اطلِع على الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوب مثال
سلسلة اختياري data-shape="rectangular"

يسرد الجدول التالي أشكال الأزرار المتاحة وأوصافها:

شكل
rectangular زر على شكل مستطيل. وتكون العلامة هي نفسها السمة square إذا تم استخدامها لنوع الزر icon.
زر قياسي مستطيل زر رمز مستطيل زر مخصص مستطيل
pill زر على شكل حبة. في حال استخدام نوع الزر icon، يكون هو نفسه السمة circle.
زر عادي على شكل حبة زرّ على شكل حبة زر مخصص على شكل حبة
circle زر على شكل دائرة. إذا تم استخدامه لنوع الزر standard، يكون هو نفسه pill.
زر عادي مستدير زر رمز دائري زر مخصص دائري
square الزر على شكل مربع. إذا تم استخدامه لنوع الزر standard، يكون هو نفسه rectangular.
زر قياسي مربع زر رمز مربع زر مربع مخصص

محاذاة_شعار_البيانات

محاذاة شعار Google. القيمة التلقائية هي left. تنطبق هذه السمة على نوع الزر standard فقط. اطلِع على الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوب مثال
سلسلة اختياري data-logo_alignment="center"

يسرد الجدول التالي المحاذاة المتاحة وأوصافها:

محاذاة_الشعار
left محاذاة شعار Google إلى اليسار:
زر عادي مع شعار G على اليمين
center محاذاة شعار Google للوسط:
زر قياسي يحمل شعار G في المنتصف

عرض البيانات

الحد الأدنى لعرض الزر، بالبكسل. الحد الأقصى للعرض هو 400 بكسل.

اطلع على الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوب مثال
سلسلة اختياري data-width=400

لغة البيانات

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

اطلع على الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوب مثال
سلسلة اختياري data-locale="zh_CN"

مستمع قائمة النقرات

يمكنك تحديد دالة JavaScript التي سيتم استدعاؤها عند النقر على زر "تسجيل الدخول باستخدام حساب Google" باستخدام السمة click_listener.

  google.accounts.id.renderButton(document.getElementById("signinDiv"), {
      theme: 'outline',
      size: 'large',
      click_listener: onClickHandler
    });

  
  function onClickHandler(){
    console.log("Sign in with Google button clicked...")
  }
  

في المثال أعلاه، سيتم تسجيل الرسالة تسجيل الدخول باستخدام زر Google الذي تم النقر عليه... في وحدة التحكم عند النقر على زر "تسجيل الدخول باستخدام حساب Google".

التكامل من جانب الخادم

يجب أن تعالج نقاط النهاية من جهة الخادم طلبات HTTP POST التالية.

نقطة نهاية معالج الرمز المميز للمعرّف

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

يحتوي طلب HTTP POST على المعلومات التالية:

الشكل الاسم الوصف
كعكة g_csrf_token سلسلة عشوائية تتغير مع كل طلب إلى نقطة نهاية المعالج.
معلمة الطلب g_csrf_token سلسلة تتطابق مع القيمة السابقة لملف تعريف الارتباط، g_csrf_token.
معلمة الطلب credential الرمز المميز للمعرّف الذي تصدره Google.
معلمة الطلب select_by كيفية اختيار بيانات الاعتماد.

عند فك الترميز، يظهر الرمز المميّز للرقم التعريفي على النحو التالي:

header
{
  "alg": "RS256",
  "kid": "f05415b13acb9590f70df862765c655f5a7a019e", // JWT signature
  "typ": "JWT"
}
payload
{
  "iss": "https://accounts.google.com", // The JWT's issuer
  "nbf":  161803398874,
  "aud": "314159265-pi.apps.googleusercontent.com", // Your server's client ID
  "sub": "3141592653589793238", // The unique ID of the user's Google Account
  "hd": "gmail.com", // If present, the host domain of the user's GSuite email address
  "email": "elisa.g.beckett@gmail.com", // The user's email address
  "email_verified": true, // true, if Google has verified the email address
  "azp": "314159265-pi.apps.googleusercontent.com",
  "name": "Elisa Beckett",
                            // If present, a URL to user's profile picture
  "picture": "https://lh3.googleusercontent.com/a-/e2718281828459045235360uler",
  "given_name": "Eliza",
  "family_name": "Beckett",
  "iat": 1596474000, // Unix timestamp of the assertion's creation time
  "exp": 1596477600, // Unix timestamp of the assertion's expiration time
  "jti": "abc161803398874def"
}

يسرد الجدول التالي القيم المحتملة للحقل select_by. ويُستخدم نوع الزر المستخدَم مع الجلسة وحالة الموافقة لتعيين القيمة،

  • ضغط المستخدم على زر "نقرة واحدة" أو زر "تسجيل الدخول باستخدام حساب Google" أو استخدم عملية تسجيل الدخول التلقائي بدون تلامس.

  • تم العثور على جلسة حالية، أو تم اختيار المستخدم وتسجيل الدخول إلى حساب Google لإنشاء جلسة جديدة.

  • قبل مشاركة بيانات اعتماد الرمز المميّز للرقم التعريفي مع تطبيقك، يمكن للمستخدم أيضًا

    • الضغط على الزر "تأكيد" لمنح موافقتهم على مشاركة بيانات الاعتماد أو
    • منح الموافقة في السابق واستخدم تحديد حساب لاختيار حساب Google.

يتم تعيين قيمة هذا الحقل على أحد هذه الأنواع،

القيمة الوصف
auto تسجيل الدخول التلقائي لمستخدم لديه جلسة حالية سبق له منح موافقته على مشاركة بيانات الاعتماد.
user ضغط مستخدم لديه جلسة حالية سبق له منح الموافقة على الزر "متابعة باسم" بنقرة واحدة لمشاركة بيانات الاعتماد.
user_1tap ضغط مستخدم يملك جلسة حالية على الزر "متابعة باسم" بنقرة واحدة لمنح الموافقة ومشاركة بيانات الاعتماد. ينطبق هذا الإعداد فقط على الإصدار 75 والإصدارات الأحدث من Chrome.
user_2tap ضغط مستخدم بدون جلسة حالية على الزر One 'Continue as' (اختيار باسم) لاختيار حساب ثم ضغط على الزر "تأكيد" في نافذة منبثقة لمنح الموافقة ومشاركة بيانات الاعتماد. ينطبق ذلك على المتصفِّحات غير المستندة إلى Chromium.
btn ضغط مستخدم لديه جلسة حالية سبق له منح الموافقة على الزر "تسجيل الدخول باستخدام حساب Google" واختَر حساب Google من "اختيار حساب" لمشاركة بيانات الاعتماد.
btn_confirm ضغط مستخدم شغّل جلسة حالية على زر "تسجيل الدخول باستخدام حساب Google" ثم ضغط على الزر "تأكيد" لمنح الموافقة ومشاركة بيانات الاعتماد.
btn_add_session ضغط مستخدم لم يسجِّل جلسة وكان قد منح موافقته سابقًا على زر "تسجيل الدخول باستخدام حساب Google" لاختيار حساب على Google ومشاركة بيانات الاعتماد.
btn_confirm_add_session ضغط مستخدم من دون جلسة حالية على زر "تسجيل الدخول باستخدام حساب Google" لاختيار حساب على Google، ثم ضغط على الزر "تأكيد" للموافقة على بيانات الاعتماد ومشاركتها.

نقطة نهاية معالج بيانات اعتماد كلمة المرور

تعالج نقطة نهاية معالج بيانات اعتماد كلمة المرور بيانات اعتماد كلمة المرور التي يستردها مدير بيانات الاعتماد الأصلية.

يحتوي طلب HTTP POST على المعلومات التالية:

الشكل الاسم الوصف
كعكة g_csrf_token سلسلة عشوائية تتغير مع كل طلب إلى نقطة نهاية المعالج.
معلمة الطلب g_csrf_token سلسلة تتطابق مع القيمة السابقة لملف تعريف الارتباط، g_csrf_token.
معلمة الطلب email هذا الرمز المميز للمعرف الذي تصدره Google.
معلمة الطلب password كيفية اختيار بيانات الاعتماد.