نقل البيانات من صفحة "تسجيل الدخول بحساب Google"

يساعدك هذا الدليل في فهم التغييرات والخطوات اللازمة ل نقل مكتبات JavaScript بنجاح من مكتبة منصّة Google Sign-In الأقدم إلى مكتبة Google Identity Services الأحدث من أجل المصادقة.

إذا كان العميل يستخدم مكتبة برامج Google API لتطبيقات JavaScript أو مكتبات أقدم أخرى للسماح، يُرجى الاطّلاع على مقالة نقل البيانات إلى خدمات Google Identity Services للحصول على مزيد من المعلومات.

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

المصادقة والتفويض

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

مثل مكتبة منصة Google Sign-In السابقة، تم تصميم مكتبة Google Identity Services الجديدة لدعم كل من عمليات المصادقة والتفويض.

ومع ذلك، تفصل المكتبة الجديدة بين العمليتَين لتقليل تعقيد دمج المطوّرين لحسابات Google مع تطبيقك.

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

إذا كانت حالة الاستخدام تتضمن التفويض، اقرأ آلية عمل تفويض المستخدم ونقل البيانات إلى خدمات Google Identity للتأكّد من استخدام تطبيقك لواجهات برمجة التطبيقات الجديدة والمحسّنة.

التغييرات التي أُجريت

بالنسبة إلى المستخدمين، توفّر مكتبة Google Identity Services الجديدة العديد من تحسينات usability. تشمل أهم الميزات ما يلي:

• عمليات تسجيل دخول جديدة سهلة باستخدام ميزة "تسجيل الدخول بنقرة واحدة" وميزة "تسجيل الدخول تلقائيًا" مع خطوات شخصية أقل
• زر تسجيل دخول معدَّل يتيح للمستخدم تخصيصه
• العلامة التجارية المتسقة وسلوك تسجيل الدخول الموحّد عبر الويب يحسن الفهم والثقة،
• الوصول سريعًا إلى المحتوى، ويمكن للمستخدمين الاشتراك وتسجيل الدخول مباشرةً من أي مكان على موقعك الإلكتروني بدون الحاجة إلى الانتقال إلى صفحة تسجيل الدخول أو صفحة الحساب

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

• خيار إضافة ميزة تسجيل دخول المستخدمين إلى المحتوى الثابت لموقعك الإلكتروني باستخدام HTML فقط
• فصل مصادقة تسجيل الدخول عن التفويض ومشاركة بيانات المستخدمين، لم تعُد هناك حاجة إلى تعقيد عملية دمج OAuth 2.0 لتسجيل المستخدمين في موقعك الإلكتروني،
• لا يزال كل من وضعَي النافذة المنبثقة وإعادة التوجيه متاحَين، ولكنّ بنية OAuth 2.0 الأساسية في Google تعيد الآن التوجيه إلى نقطة نهاية تسجيل الدخول في خادم الخلفية.
• دمج الإمكانات من مكتبتَي Google Identity وGoogle API JavaScript الأقدم في مكتبة جديدة واحدة
• بالنسبة إلى استجابات تسجيل الدخول، يمكنك الآن تحديد ما إذا كنت تريد استخدام Promise أو لا، وقد تمت إزالة التوجيه غير المباشر من خلال وظائف نمط أسلوب الجلب للتبسيط.

مثال على نقل بيانات تسجيل الدخول

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

المكتبات والإعدادات

لم يعُد apis.google.com/js/platform.js، ومكتبة برامج Google APIs للغة JavaScript: gapi.client، مطلوبة لمصادقة المستخدم وتفويضه. وتم استبدالها بمكتبة JavaScript جديدة واحدة من Google Identity Services: accounts.google.com/gsi/client.

يتم تحميل وحدات JavaScript الثلاث السابقة: api وclient وplatform المستخدَمة في تسجيل الدخول من apis.google.com. لمساعدتك في تحديد المواقع الجغرافية التي قد يتم تضمين المكتبة السابقة فيها في موقعك الإلكتروني، إليك الخطوات التي يجب اتّباعها عادةً:

• يتم تحميل زر تسجيل الدخول التلقائي apis.google.com/js/platform.js.
• يتم تحميل رسم زر مخصّص apis.google.com/js/api:client.js،
• الاستخدام المباشر لـ gapi.client ويحمّل apis.google.com/js/api.js.

في معظم الحالات، يمكنك مواصلة استخدام بيانات اعتماد معرّف العميل لتطبيق الويب الحالي. كجزء من عملية نقل البيانات، ننصحك بمراجعة سياسات OAuth 2.0 واستخدام وحدة تحكّم واجهة برمجة تطبيقات Google لتأكيد إعدادات العميل التالية وتعديلها إذا لزم الأمر:

• استخدام تطبيقاتك التجريبية والتطبيقات العلنية لمشاريع منفصلة وامتلاكها لمعرّفات العملاء الخاصة بها
• نوع معرِّف عميل OAuth 2.0 هو "تطبيق ويب"،
• يُستخدَم بروتوكول HTTPS لمصادر JavaScript المسموح بها ومعرّفات الموارد المنتظمة لإعادة التوجيه.

تحديد الرمز البرمجي المتأثر واختباره

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

في التطبيقات الكبيرة أو المعقّدة، قد يكون من الصعب العثور على كل الرموز البرمجية المتأثّرة بمحاولة إيقاف وحدة gapi.auth2 نهائيًا. لتسجيل الاستخدام الحالي للإمكانات التي سيتم إيقافها نهائيًا قريبًا في وحدة التحكّم، اضبط قيمة ملف تعريف الارتباط G_AUTH2_MIGRATION على informational. يمكنك اختياريًا إضافة نقطتَين تليها قيمة مفتاح لتسجيل الجلسة أيضًا إلى تخزين الجلسة. بعد تسجيل الدخول وتلقّي بيانات الاعتماد، يُرجى مراجعتها أو إرسال السجلات التي تم جمعها إلى الخلفية لتحليلها لاحقًا. على سبيل المثال، يحفظ informational:showauth2use المصدر وعنوان URL في مفتاح تخزين الجلسة باسم showauth2use.

للتحقّق من سلوك التطبيق عندما يتوقّف تحميل وحدة gapi.auth2، اضبط قيمة ملف تعريف الارتباط G_AUTH2_MIGRATION على enforced. يتيح ذلك اختبار السلوك بعد الإيقاف النهائي قبل تاريخ التنفيذ.

قيم ملفّ تعريف الارتباط G_AUTH2_MIGRATION المحتمَلة:

• enforced لا تحمِّل وحدة gapi.auth2.
• informational تسجيل استخدام الإمكانات المتوقّفة نهائيًا في وحدة تحكّم JavaScript سجِّل أيضًا في مساحة تخزين الجلسة عند ضبط اسم مفتاح اختياري: informational:key-name.

للحدّ من تأثير المستخدم، ننصحك أولاً بإعداد ملف تعريف الارتباط هذا محليًا أثناء التطوير والاختبار، قبل استخدامه في بيئات الإنتاج.

HTML وJavaScript

في سيناريو تسجيل الدخول هذا الذي يعتمد على المصادقة فقط، يتم عرض مثال على الرمز البرمجي وصور ل زر "تسجيل الدخول باستخدام حساب Google" الحالي. يمكنك الاختيار من بين وضع "النافذة المنبثقة" أو "إعادة التوجيه" للاطّلاع على الاختلافات في كيفية التعامل مع استجابة المصادقة إما عن طريق استدعاء JavaScript أو من خلال إعادة التوجيه الآمنة إلى نقطة نهاية تسجيل الدخول إلى خادم الخلفية.

الطريقة السابقة

وضع النافذة المنبثقة

اعرض زر "تسجيل الدخول بحساب Google" واستخدِم ميزة معاودة الاتصال لمعالجة عملية تسجيل الدخول من متصفّح المستخدم مباشرةً.

<html>
  <body>
    <script src="https://apis.google.com/js/platform.js" async defer></script>
    <meta name="google-signin-client_id" content="YOUR_CLIENT_ID">
    <div class="g-signin2" data-onsuccess="handleCredentialResponse"></div>
  </body>
</html>

وضع إعادة التوجيه

عرض زر "تسجيل الدخول بحساب Google" الذي ينتهي بطلب AJAX من متصفّح المستخدم إلى نقطة نهاية تسجيل الدخول إلى خوادم الخلفية

<html>
  <body>
    <script src="https://apis.google.com/js/platform.js" async defer></script>
    <meta name="google-signin-client_id" content="YOUR_CLIENT_ID">
    <div class="g-signin2" data-onsuccess="handleCredentialResponse"></div>
    <script>
      function handleCredentialResponse(googleUser) {
        ...
        var xhr = new XMLHttpRequest();
        xhr.open('POST', 'https://yourbackend.example.com/tokensignin');
        xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
        xhr.onload = function() {
          console.log('Signed in as: ' + xhr.responseText);
        };
        xhr.send('idtoken=' + id_token);
      }
    </script>
  </body>
</html>

تم عرضها

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

يُعدّل نص الزر حالة تسجيل دخول المستخدم.

الطريقة الجديدة

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

وضع النافذة المنبثقة

استخدِم دالة استدعاء لمعالجة تسجيل الدخول مباشرةً من متصفّح المستخدم.

<html>
  <body>
    <script src="https://accounts.google.com/gsi/client" async defer></script>
    <div id="g_id_onload"
         data-client_id="YOUR_CLIENT_ID"
         data-callback="handleCredentialResponse">
    </div>
    <div class="g_id_signin" data-type="standard"></div>
  </body>
</html>

وضع إعادة التوجيه

تستدعي Google نقطة نهاية تسجيل الدخول على النحو المحدّد في السمة data-login_url. في السابق، كنت مسؤولاً عن عملية POST واسم المَعلمة. تنشر المكتبة الجديدة الرمز المميّز لرقم التعريف في نقطة النهاية في معلَمة credential. أخيرًا، عليك التحقّق من صحة رمز التعريف على الخادم في الخلفية.

<html>
  <body>
    <script src="https://accounts.google.com/gsi/client" async defer></script>
    <div id="g_id_onload"
         data-client_id="YOUR_CLIENT_ID"
         data-ux_mode="redirect"
         data-login_uri="https://www.example.com/your_login_endpoint">
    </div>
    <div class="g_id_signin" data-type="standard"></div>
  </body>
</html>

تم عرضها

استخدِم السمات المرئية لتخصيص زر "تسجيل الدخول باستخدام حساب Google"، مثل الحجم والشكل واللون. يمكنك عرض النافذة المنبثقة لميزة "النقرة الواحدة" مع الزر المخصّص لتحسين معدّل تسجيل الدخول.

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

ملاحظة: استخدِم أداة إنشاء الرموز البرمجية لتصميم زرّك الجديد بشكل تفاعلي.

في هذا المثال المخصّص للمصادقة فقط، تحلّ مكتبة accounts.google.com/gsi/client وصف g_id_signin وعنصر g_id_onload الجديدان محلّ مكتبة apis.google.com/js/platform.js وعنصر g-signin2 السابقَين.

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

على الرغم من أنّه لا يُنصح باستخدام هذا الزر بسبب الصعوبات المرتبطة بعملية تسجيل الدخول، يمكن عرض الزرّ المخصّص الجديد بمفرده بدون عرض مربّع حوار "نقرة واحدة" في الوقت نفسه. ولإجراء ذلك، اضبط السمة data-auto_prompt على false.

واجهات برمجة تطبيقات HTML وJavaScript

يوضّح المثال السابق كيفية استخدام واجهة برمجة تطبيقات HTML الجديدة لإضافة بيانات تسجيل الدخول إلى موقعك الإلكتروني. بدلاً من ذلك، يمكنك استخدام JavaScript API المكافئة من الناحية الوظيفية، أو مزج واجهات برمجة تطبيقات HTML وJavaScript معًا في موقعك الإلكتروني.

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

تسجيل الدخول من أي صفحة باستخدام ميزة "نقرة واحدة"

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

لتفعيل تسجيل الدخول من أي صفحة، ننصحك بتضمين g_id_onload في عنوان أو تذييل مشترَك أو عنصر آخر مضمّن في موقعك الإلكتروني بأكمله.

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

ملاحظة: أثناء التطوير، إذا أغلقت النافذة المنبثقة لميزة "النقرة الواحدة"، وبالتالي فعّلت موقّت فترة الانتظار المتزايدة وأوقفت عرض ميزة "النقرة الواحدة"، يمكنك التبديل إلى "وضع التصفّح المتخفي" لإعادة ضبط حالة فترة الانتظار.

ردّ الرمز المميّز

لم يعُد تسجيل دخول المستخدم يتطلّب منك فهم رموز التفويض أو الرموز المميّزة للوصول أو الرموز المميّزة لإعادة التحميل في OAuth 2.0 أو التعامل معها. وبدلاً من ذلك، يتم استخدام الرمز المميّز الخاص بمعرّف رمز JSON للويب (JWT) لمشاركة حالة تسجيل الدخول والملف الشخصي للمستخدم. وكأحد ميزات التبسيط المتقدّمة، لم يعُد عليك استخدام أساليب الأسلوب "getter" للوصول إلى البيانات من أجل العمل مع بيانات الملف الشخصي للمستخدم.

يتم عرض بيانات اعتماد رمز مميز لمعرّف JWT آمنة وموقَّعة من Google إما:

• إلى معالِج معاودة اتصال JavaScript المستند إلى المتصفّح لدى المستخدم في الوضع المنبثق، أو
• إلى خادم الخلفية من خلال إعادة توجيه Google إلى نقطة نهاية تسجيل الدخول عند ضبط زر "تسجيل الدخول باستخدام حساب Google" ux_mode على redirect.

في كلتا الحالتَين، عدِّل معالِجات عمليات الردّ الحالية عن طريق إزالة ما يلي:

• المكالمات إلى googleUser.getBasicProfile()
• الإشارات إلى BasicProfile، وطلب البيانات المرتبط بها إلى طُرق getId()، getName()، getGivenName()، getFamilyName()، getImageUrl()، getEmail()
• استخدام الكائن AuthResponse.

بدلاً من ذلك، استخدِم إشارات مباشرة إلى الحقول الفرعية credential في عنصر JWT الجديد CredentialResponse للعمل مع بيانات الملف الشخصي للمستخدم.

بالإضافة إلى ذلك، وبالنسبة إلى وضع "إعادة التوجيه" فقط، احرص على منع تزوير الطلبات من مواقع إلكترونية مختلفة (CSRF) وإثبات ملكية الرمز المميّز لمعرّف Google على خادم الخلفية.

لفهم كيفية تفاعل المستخدمين مع موقعك الإلكتروني بشكل أفضل، يمكن استخدام الحقل select_by في CredentialResponse لتحديد نتيجة موافقة المستخدم وعملية تسجيل الدخول المحدّدة المستخدَمة.

موافقة المستخدم وإلغاء الإذن

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

يمكن للمستخدمين إلغاء الأذونات وفصل تطبيقك عن حساباتهم على Google من خلال الانتقال إلى https://myaccount.google.com/permissions. وبدلاً من ذلك، قد ينقطع الاتصال بتطبيقك مباشرةً عن طريق تفعيل طلب بيانات من واجهة برمجة التطبيقات الذي تنفذه. تم استبدال طريقة disconnect السابقة بطريقة revoke الأحدث.

عندما يحذف مستخدم حسابه على منصتك، من الأفضل استخدام "revoke" لإلغاء ربط تطبيقك بحسابه على Google.

في السابق، كان يمكن استخدام auth2.signOut() للمساعدة في إدارة تسجيل خروج المستخدم من تطبيقك. يجب إزالة أي استخدام لـ auth2.signOut()، ويجب أن يدير تطبيقك مباشرةً حالة جلسة كل مستخدم وحالة تسجيل الدخول.

حالة الجلسة وأدوات الاستماع

لا تحتفظ المكتبة الجديدة بحالة تسجيل الدخول أو حالة الجلسة لتطبيق الويب.

يُعدّ كل من حالة تسجيل الدخول لحساب Google وحالة جلسة التطبيق وحالة تسجيل الدخول مفهومَين منفصلَين منفصلَين.

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

عندما تتضمّن ميزة "تسجيل الدخول باستخدام حساب Google" أو "نقرة واحدة" أو "تسجيل الدخول تلقائيًا" على موقعك الإلكتروني، على المستخدمين أولاً تسجيل الدخول إلى حساباتهم على Google لإجراء ما يلي:

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

قد يظلّ المستخدمون في وضع تسجيل الدخول أو الخروج أو التبديل إلى حساب مختلف على Google مع الحفاظ على تسجيل الدخول في جلسة نشطة على موقعك الإلكتروني.

أصبحت الآن مسؤولاً عن إدارة حالة تسجيل الدخول لمستخدمي تطبيق الويب الخاص بك مباشرةً. في السابق، كانت ميزة "تسجيل الدخول باستخدام حساب Google" تساعد في مراقبة حالة جلسة المستخدم.

أزِل أي إشارات إلى auth2.attachClickHandler() ومعالجات callback المسجّلة.

في السابق، كان يتم استخدام المستمعِين لمشاركة التغييرات في حالة تسجيل الدخول لحساب أحد المستخدِمين على Google. لم تعُد ميزة "المستمعين" متاحة.

أزِل أيّ إشارات إلى listen() وauth2.currentUser و auth2.isSignedIn.

بسكويت

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

لم يعُد يتم استخدام ملف تعريف الارتباط G_ENABLED_IDPS الذي تم ضبطه من خلال الإصدار السابق من Google Sign-in Platform Library.

قد تضبط مكتبة "خدمات هوية Google" الجديدة بشكل اختياري ملفات تعريف الارتباط هذه على جميع النطاقات استنادًا إلى خيارات الإعداد:

• تخزِّن متغير g_state حالة تسجيل خروج المستخدم ويتم ضبطه عند استخدام النافذة المنبثقة لميزة "نقرة واحدة" أو ميزة "تسجيل الدخول تلقائيًا".

• g_csrf_token هو ملف تعريف ارتباط لعمليات الإرسال المضاعفة يُستخدَم لمنع هجمات CSRF، ويُضبط عند استدعاء نقطة نهاية تسجيل الدخول. يمكن ضبط قيمة معرف الموارد المنتظم (URI) لتسجيل الدخول بشكل صريح أو قد يتم ضبطها تلقائيًا على معرّف الموارد المنتظم (URI) للصفحة الحالية. قد يتم طلب نقطة نهاية تسجيل الدخول وفقًا لهذه الشروط عند استخدام:

  • HTML API مع data-ux_mode=redirect أو عند ضبط data-login_uri

  • JavaScript API مع ux_mode=redirect وحيث google.accounts.id.prompt() لا يتم استخدامه لعرض ميزة "النقرة الواحدة" أو تسجيل الدخول تلقائيًا

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

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

مرجع نقل بيانات تسجيل دخول المستخدمين

الإصدار القديم	جديد	ملاحظات
مكتبات JavaScript
apis.google.com/js/platform.js	accounts.google.com/gsi/client	استبدِل المحتوى القديم بمحتوى جديد.
apis.google.com/js/api.js	accounts.google.com/gsi/client	استبدِل المحتوى القديم بمحتوى جديد.
عنصر GoogleAuth والطُرق المرتبطة به:
GoogleAuth.attachClickHandler()	IdConfiguration.callback لـ data-callback باستخدام JavaScript وHTML	استبدِل المحتوى القديم بمحتوى جديد.
GoogleAuth.currentUser.get()	CredentialResponse	استخدِم CredentialResponse بدلاً من ذلك، لأنّه لم يعُد ضروريًا.
GoogleAuth.currentUser.listen()		إزالة. لا تتوفّر حالة تسجيل دخول المستخدم الحالية على Google. يجب أن يكون المستخدمون مسجّلين الدخول إلى Google للموافقة على "لحظات تسجيل الدخول". يمكن استخدام الحقل select_by في CredentialResponse لتحديد نتيجة موافقة المستخدم إلى جانب طريقة تسجيل الدخول المستخدَمة.
GoogleAuth.disconnect()	google.accounts.id.revoke	استبدِل المحتوى القديم بمحتوى جديد. يمكن أيضًا إلغاء الأذونات من https://myaccount.google.com/permissions.
GoogleAuth.grantOfflineAccess()		إزالة. حلّ رمز التعريف محلّ رموز الوصول والنطاقات في OAuth 2.0.
GoogleAuth.isSignedIn.get()		إزالة. لا تتوفّر حالة تسجيل دخول المستخدم الحالية على Google. يجب أن يكون المستخدمون مسجّلين الدخول إلى Google للموافقة على "لحظات تسجيل الدخول".
GoogleAuth.isSignedIn.listen()		إزالة. لا تتوفّر حالة تسجيل دخول المستخدم الحالية على Google. يجب أن يكون المستخدمون مسجّلين الدخول إلى Google للموافقة على "لحظات تسجيل الدخول".
GoogleAuth.signIn()		إزالة. يؤدي تحميل HTML DOM للعنصر g_id_signin أو طلب JS إلى google.accounts.id.renderButton إلى تسجيل دخول المستخدم إلى حساب Google.
GoogleAuth.signOut()		إزالة. إنّ حالة تسجيل دخول المستخدم إلى تطبيقك وإلى حساب Google مستقلة. لا تدير Google حالة الجلسة لتطبيقك.
GoogleAuth.then()		إزالة. تم إيقاف GoogleAuth نهائيًا.
عنصر GoogleUser والطُرق المرتبطة به:
GoogleUser.disconnect()	google.accounts.id.revoke	استبدِل المحتوى القديم بمحتوى جديد. يمكن أيضًا إلغاء الأذونات من https://myaccount.google.com/permissions.
GoogleUser.getAuthResponse()
GoogleUser.getBasicProfile()	CredentialResponse	استخدِم credential والحقول الفرعية مباشرةً بدلاً من طرق BasicProfile.
GoogleUser.getGrantedScopes()		إزالة. حلّ رمز التعريف محلّ رموز الوصول والنطاقات في OAuth 2.0.
GoogleUser.getHostedDomain()	CredentialResponse	واستخدِم credential.hd مباشرةً بدلاً من ذلك.
GoogleUser.getId()	CredentialResponse	بدلاً من ذلك، استخدِم credential.sub مباشرةً.
GoogleUser.grantOfflineAccess()		إزالة. حلّ رمز التعريف محلّ رموز الوصول والنطاقات في OAuth 2.0.
GoogleUser.grant()		إزالة. تم استبدال رموز الدخول والنطاقات في OAuth 2.0 برمز مميّز للمعرّف.
GoogleUser.hasGrantedScopes()		إزالة. تم استبدال رموز الدخول والنطاقات في OAuth 2.0 برمز مميّز للمعرّف.
GoogleUser.isSignedIn()		إزالة. لا تتوفّر حالة تسجيل دخول المستخدم الحالية على Google. يجب أن يكون المستخدمون مسجّلين الدخول إلى Google للموافقة على "لحظات تسجيل الدخول".
GoogleUser.reloadAuthResponse()		إزالة. حلّ رمز التعريف محلّ رموز الوصول والنطاقات في OAuth 2.0.
عنصر gapi.auth2 والطُرق المرتبطة به:
عنصر gapi.auth2.AuthorizeConfig		إزالة. حلّ رمز التعريف محلّ رموز الوصول والنطاقات في OAuth 2.0.
عنصر gapi.auth2.AuthorizeResponse		إزالة. حلّ رمز التعريف محلّ رموز الوصول والنطاقات في OAuth 2.0.
عنصر gapi.auth2.AuthResponse		إزالة. تم استبدال رموز الدخول والنطاقات في OAuth 2.0 برمز مميّز للمعرّف.
gapi.auth2.authorize()		إزالة. تم استبدال رموز الدخول والنطاقات في OAuth 2.0 برمز مميّز للمعرّف.
gapi.auth2.ClientConfig()		إزالة. تم استبدال رموز الدخول والنطاقات في OAuth 2.0 برمز مميّز للمعرّف.
gapi.auth2.getAuthInstance()		إزالة. تم استبدال رموز الدخول والنطاقات في OAuth 2.0 برمز مميّز للمعرّف.
gapi.auth2.init()		إزالة. حلّ رمز التعريف محلّ رموز الوصول والنطاقات في OAuth 2.0.
الكائن gapi.auth2.offlineAccessOptions		إزالة. حلّ رمز التعريف محلّ رموز الوصول والنطاقات في OAuth 2.0.
عنصر gapi.auth2.SignInOptions		إزالة. تم استبدال رموز الدخول والنطاقات في OAuth 2.0 برمز مميّز للمعرّف.
عنصر gapi.signin2 والطُرق المرتبطة به:
gapi.signin2.render()		إزالة. يؤدي تحميل HTML DOM للعنصر g_id_signin أو طلب JS إلى google.accounts.id.renderButton إلى تسجيل دخول المستخدم إلى حساب Google.