تصف هذه الصفحة المرجعية واجهة برمجة التطبيقات لسمات بيانات تسجيل الدخول باستخدام 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" |
data-skip_prompt_cookie
تتجاوز هذه السمة نقرة واحدة إذا كان ملف تعريف الارتباط المحدد يحتوي على قيمة غير فارغة. اطلِع على الجدول التالي للحصول على مزيد من المعلومات:
| النوع | مطلوبة | مثال |
|---|---|---|
| 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.
data-state_cookie_domain
إذا كنت تريد عرض نقرة واحدة في نطاق رئيسي ونطاقاته الفرعية، عليك تمرير النطاق الرئيسي إلى هذه السمة بحيث يتم استخدام ملف تعريف ارتباط واحد مشترك للحالة. اطلِع على الجدول التالي للحصول على مزيد من المعلومات:
| النوع | مطلوبة | مثال |
|---|---|---|
| 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"
إذا أضفت السمة 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":
|
signup_with |
نص الزر هو "الاشتراك مع Google":
|
continue_with |
نص الزر هو "المتابعة مع Google":
|
signin |
نص الزر هو "تسجيل الدخول":
|
تشكيل البيانات
شكل الزر. القيمة التلقائية هي 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 إلى اليسار:
|
center |
محاذاة إلى وسط شعار Google:
|
عرض البيانات
الحد الأدنى لعرض الزر، بالبكسل. الحد الأقصى للعرض المسموح به هو 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" لمشاركة بيانات الاعتماد. |
user_1tap |
ضغط مستخدم أجرى جلسة حالية على الزر One 'Continue as' لمنح الموافقة أو مشاركة بيانات الاعتماد. ولا ينطبق هذا الإعداد سوى على إصدار Chrome 77 والإصدارات الأحدث. |
user_2tap |
ضغط مستخدم لم يجرِ جلسة حالية على زر One Tap '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 |
كيفية اختيار بيانات الاعتماد. |