مرجع تسجيل الدخول باستخدام 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 One.
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 Tap
data-skip_prompt_cookie يتم تخطي نقرة واحدة إذا كان ملف تعريف الارتباط المحدد يحتوي على قيمة غير فارغة.
data-nonce سلسلة عشوائية للرموز المميزة للمعرّف
data-context العنوان والكلمات في رسالة المطالبة بنقرة واحدة
data-moment_callback اسم الدالة لأداة معالجة إشعارات حالة واجهة مستخدم المطالبة
data-state_cookie_domain إذا كنت بحاجة إلى الاتصال بنقرة واحدة في النطاق الرئيسي والنطاقات الفرعية، مرّر النطاق الرئيسي إلى هذه السمة بحيث يتم استخدام ملف تعريف ارتباط مشترك واحد.
data-ux_mode مسار تجربة المستخدم لزر تسجيل الدخول باستخدام Google
data-allowed_parent_origin المصادر المسموح لها بتضمين إطار iframe المتوسط. وسيتم تشغيل نقرة واحدة في وضع إطار iframe المتوسط في حال توفّر هذه السمة.
data-intermediate_iframe_close_callback تلغي هذه السياسة سلوك إطار iframe المتوسط التلقائي عندما يغلق المستخدمون نقرة واحدة يدويًا.
data-itp_support تفعِّل ميزة One UX التي تمت ترقيتها على متصفِّحات ITP.

أنواع السمات

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

data-client_id (معرّف_بيانات_العميل)

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

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

data-auto_prompt

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

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

data-auto_select

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

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

data-login_uri

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

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

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

النوع اختيارية مثال
عنوان URL ويتم إعداد الإعدادات التلقائية لمعرّف الموارد المنتظم (URI) للصفحة الحالية أو القيمة التي تحدّدها.
يتم تجاهل السياسة عند ضبط 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 التي تعالج الرمز المميّز لرقم التعريف المعروض. اطلِع على الجدول التالي للحصول على مزيد من المعلومات:

النوع مطلوبة مثال
string مطلوبة إذا لم يتم ضبط 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.

إنّ وظائف JavaScript داخل مساحة الاسم غير متوافقة مع HTML API. بدلاً من ذلك، استخدِم دالة 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. اطلِع على الجدول التالي للحصول على مزيد من المعلومات:

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

data-original_callback

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

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

إنّ وظائف JavaScript داخل مساحة الاسم غير متوافقة مع HTML API. بدلاً من ذلك، استخدِم دالة JavaScript عامة بدون مساحة اسم. على سبيل المثال، يمكنك استخدام mylibCallback بدلاً من mylib.callback.

data-original_id_param

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

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

data-original_password_param

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

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

data-cancel_on_tap_outside

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

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

data-prompt_parent_id

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

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

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

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

بدون بيانات

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

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

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

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

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

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

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

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

data-moment_callback

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

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

إنّ وظائف JavaScript داخل مساحة الاسم غير متوافقة مع HTML API. بدلاً من ذلك، استخدِم دالة JavaScript عامة بدون مساحة اسم. على سبيل المثال، يمكنك استخدام mylibCallback بدلاً من mylib.callback.

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

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

data-ux_mode

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

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

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

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

data-allowed_parent_origin

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

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

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

أنواع القيم
string معرّف موارد منتظم (URI) لنطاق واحد. &https://example.com"
string array قائمة بمعرِّفات الموارد المنتظمة (URI) للنطاقات المفصولة بفواصل. "https://news.example.com,https://local.example.com"

وإذا كانت قيمة السمة data-allowed_parent_origin غير صالحة، سيتعذّر إتمام إعداد One Mode لإطار 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 بنقرة واحدة. تتم إزالة واجهة مستخدم One Tap قبل استدعاء الاستدعاء.

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

إنّ وظائف JavaScript داخل مساحة الاسم غير متوافقة مع HTML API. بدلاً من ذلك، استخدِم دالة JavaScript عامة بدون مساحة اسم. على سبيل المثال، يمكنك استخدام mylibCallback بدلاً من mylib.callback.

data-itp_support

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

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

عنصر يتضمّن الفئة "g_id_signin&quot

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

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

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

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

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

أنواع السمات

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

نوع البيانات

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

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

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

النوع
standard زر يتضمن نصًا أو معلومات مخصصة:
icon زر الرمز بدون نص:

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

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

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

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

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

حجم البيانات

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

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

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

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

نص البيانات

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

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

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

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

مراسلة نصية
signin_with نص الزر هو "تسجيل الدخول باستخدام حساب Google":
زر عادي مُسمى &#39;Sign in with Google&#39; زر يظهر بدون نص مرئي
signup_with نص الزر هو "الاشتراك مع Google":
زر عادي يحمل اسم &#39؛الاشتراك في Google&#39؛ زر يظهر بدون نص مرئي
continue_with نص الزر هو "المتابعة مع Google":
زر عادي يحمل اسم &#39;متابعة مع Google&#39؛ زر يظهر بدون نص مرئي
signin نص الزر هو "تسجيل الدخول":
زر عادي مُسمى &#39;Sign in&#39; زر يظهر بدون نص مرئي

تشكيل البيانات

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

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

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

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

data-logo_محاذاة

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

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

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

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

عرض البيانات

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

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

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

لغة البيانات

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

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

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

التكامل من جهة الخادم

يجب أن تعالج نقاط النهاية من جهة الخادم طلبات 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 ضغط أحد المستخدمين الذين لديهم جلسة حالية وافق على ميزة "نقرة واحدة" &#39؛ "متابعة" و"#39" لمشاركة بيانات الاعتماد.
user_1tap ضغط مستخدم أجرى جلسة حالية على الزر One 'Continue as' لمنح الموافقة أو مشاركة بيانات الاعتماد. ولا ينطبق هذا الإعداد سوى على إصدار Chrome 77 والإصدارات الأحدث.
user_2tap ضغط مستخدم لم يجرِ جلسة حالية على زر One Tap 'Continue as' لاختيار حساب ثم اضغط على زر التأكيد في نافذة منبثقة لمنح الموافقة ومشاركة بيانات الاعتماد. يسري على المتصفحات التي لا تستند إلى Chromium.
btn اضغط على زر "تسجيل الدخول باستخدام Google" لدى مستخدم كان لديه جلسة حالية ووافق على حساب Google من 'اختيار حساب&#39، لمشاركة بيانات الاعتماد.
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 كيفية اختيار بيانات الاعتماد.