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