سيتم نقل "خدمات هوية Google" إلى واجهات برمجة تطبيقات FedCM. يُرجى اتّباع دليل نقل البيانات لمراجعة التغييرات المحتملة وتجنُّب التأثيرات السلبية على تسجيل دخول المستخدمين إلى موقعك الإلكتروني.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

واجهة برمجة تطبيقات JavaScript لدعم Iframe المتوسط

تصف هذه الصفحة المرجعية واجهة برمجة تطبيقات JavaScript لدعم Iframe المتوسط، والتي تتيح لك معالجة إطار iframe المتوسط في تجربة المستخدم اللاحقة.

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

يسرد الجدول التالي جميع الطرق المتاحة وسلوكياتها.

الطُرق
`verifyParentOrigin`	التحقق من المصدر الرئيسي
`notifyParentClose`	يُعلم الإطار الرئيسي بتخطي تدفق تجربة المستخدم بنقرة واحدة
`notifyParentDone`	يُعلم الإطار الرئيسي باكتمال تدفق تجربة المستخدم بنقرة واحدة
`notifyParentResize`	يُعلم الإطار الرئيسي بتغيير حجم إطار iframe المتوسط
`notifyParentTapOutsideMode`	يُعلم الإطار الرئيسي بما إذا كان سيتم إلغاء إطار iframe المتوسط عندما ينقر المستخدم خارج إطار iframe المتوسط

تحميل مكتبة JavaScript لدعم إطار Iframe المتوسط

ضع مقتطف الرمز التالي في أي صفحات HTML تريد تحميل إطار iframe المتوسط فيها:

<script src="https://accounts.google.com/gsi/intermediatesupport"></script>

الطريقة: google.accounts.id.intermediate.verifyParentOrigin

تنفِّذ الطريقة google.accounts.id.intermediate.verifyParentOrigin التحقق من المصدر الرئيسي. اطّلِع على مثال الرمز التالي للطريقة:

google.accounts.id.intermediate.verifyParentOrigin(
    origins, verifiedCallback, verificationFailedCallback)

يوضّح مثال الرمز التالي كيفية عرض واجهة المستخدم فقط بعد إثبات ملكية المصدر الرئيسي:

<script>
  window.onload = () => {
    google.accounts.id.intermediate.verifyParentOrigin(
        "https://example.com", showUI, showError);
  };
</script>

يسرد الجدول التالي المَعلمات:

المَعلمة
`origins`	المصادر التي يُسمح لها بتضمين إطار iframe المتوسط.
`verifiedCallback`	يتم تفعيل طريقة معاودة الاتصال في JavaScript عندما يتم السماح للأصل الرئيسي الحالي بتضمين إطار iframe المتوسط.
`verificationFailedCallback`	يتم تفعيل طريقة معاودة الاتصال في JavaScript عندما لا يكون المصدر الرئيسي الحالي مسموحًا له بتضمين إطار iframe المتوسط.

الأصول

المصادر التي يُسمح لها بتضمين إطار iframe المتوسط. اطلع على الجدول التالي للحصول على مزيد من المعلومات:

النوع	حقل مطلوب	مثال
سلسلة أو مصفوفة سلسلة أو دالة	إجراء اختياري	`allowed_parent_origin: "https://example.com"`

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

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

تم التحقق من صحة الاتصال

هذا الحقل هو طريقة استدعاء JavaScript يتم تشغيلها عندما يتم السماح للأصل الرئيسي الحالي بتضمين إطار iframe المتوسط.

تعذّر معاودة الاتصال

هذا الحقل هو طريقة استدعاء JavaScript يتم تشغيلها عندما يكون الأصل الرئيسي الحالي غير مسموح له بتضمين إطار iframe المتوسط.

الطريقة: google.accounts.id.intermediate.notifyParentClose

ترسل الطريقة google.accounts.id.intermediate.notifyParentClose إشعارًا إلى الإطار الرئيسي بإغلاق إطار iframe المتوسط عند تخطي تدفق تجربة المستخدم بنقرة واحدة. اطّلِع على مثال الرمز التالي للطريقة:

google.accounts.id.intermediate.notifyParentClose()

الطريقة: google.accounts.id.intermediate.notifyParentDone

ترسل الطريقة google.accounts.id.intermediate.notifyParentClose إشعارًا إلى الإطار الرئيسي لإغلاق إطار iframe المتوسط وإعادة تحميل حالة تسجيل الدخول. اطّلع على مثال التعليمة البرمجية التالي للطريقة:

google.accounts.id.intermediate.notifyParentDone()

الطريقة: google.accounts.id.intermediate.notifyParentResize

ترسل الطريقة google.accounts.id.intermediate.notifyParentResize إشعارًا إلى الإطار الأصلي لتغيير حجم إطار iframe المتوسط. انظر مثال التعليمات البرمجية التالي للطريقة:

google.accounts.id.intermediate.notifyParentResize(height)

الطول

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

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

الطريقة: google.accounts.id.intermediate.notifyParentTap خارجMode

تُعلم الطريقة google.accounts.id.intermediate.notifyParentTapOutsideMode الإطار الرئيسي بما إذا كان سيتم إلغاء إطار iframe المتوسط عندما ينقر المستخدم خارج إطار iframe المتوسط. اطّلِع على مثال الرمز التالي للطريقة:

google.accounts.id.intermediate.notifyParentTapOutsideMode(cancel)

إلغاء

تشير هذه القيمة المنطقية المطلوبة إلى ما إذا كان سيتم إلغاء إطار iframe المتوسط عندما ينقر المستخدم خارج إطار iframe المتوسط.