توضّح صفحة المرجع هذه واجهة برمجة التطبيقات Intermediate iframe API، والتي تُستخدَم لتضمين طلب One Tap في صفحات الويب باستخدام إطار iframe.
راجِع مقالة دمج One Tap باستخدام إطار iframe للحصول على مزيد من المعلومات حول استخدام إطارات iframe الوسيطة.
تحميل مكتبة JavaScript الخاصة بإطار iframe الوسيط
ضَع مقتطف الرمز التالي في أي صفحات HTML تريد أن تعرض فيها ميزة "النقر على Google One":
<script src="https://accounts.google.com/gsi/intermediate"></script>
HTML API
يمكنك تحميل إطار iframe الوسيط من خلال تضمين عنصر HTML مع ضبط سمة المعرّف على g_id_intermediate_iframe. اطّلِع على مقتطف الرمز النموذجي التالي:
<script src="https://accounts.google.com/gsi/intermediate"></script>
<div id="g_id_intermediate_iframe"
data-src="https://example.com/onetap_iframe.html">
</div>
العنصر الذي يحمل المعرّف "g_id_intermediate_iframe"
يمكنك وضع سمات بيانات iframe الوسيطة في أي عناصر مرئية أو غير مرئية، مثل <div> و<span>. الشرط الوحيد هو ضبط معرّف العنصر على g_id_intermediate_iframe. لا تضع رقم التعريف هذا على عناصر متعددة.
يسرد الجدول التالي سمات البيانات مع أوصافها:
| السمة | |
|---|---|
data-src |
معرّف الموارد المنتظم (URI) لإطار One Tap الوسيط |
data-done |
طريقة رد اتصال JavaScript يتم تشغيلها عند اكتمال تجربة المستخدم الخاصة بميزة "النقرة الواحدة". |
data-src
هذه السمة هي معرّف الموارد المنتظم (URI) لإطار iframe الوسيط في ميزة "النقرة الواحدة". اطّلِع على الجدول التالي لمزيد من المعلومات:
| النوع | مطلوب | مثال |
|---|---|---|
| سلسلة | نعم | data-src="https://example.com/onetap_iframe.html" |
data-done
هذه السمة هي طريقة رد اتصال JavaScript يتم تشغيلها عند اكتمال تجربة المستخدم في One Tap.
بشكلٍ تلقائي، تتم إعادة تحميل صفحة المحتوى عند اكتمال تجربة المستخدم في One Tap. يمكنك إلغاء السلوك التلقائي من خلال تقديم دالة معاودة الاتصال الخاصة بك. اطّلِع على الجدول التالي لمزيد من المعلومات:
| النوع | مطلوب | مثال |
|---|---|---|
| الوظيفة | اختياري | data-done="onOneTapSuccess" |
JavaScript API
يمكنك تحميل إطار iframe الوسيط عن طريق استدعاء إحدى طرق JavaScript.
الطريقة: google.accounts.id.initializeIntermediate
تحمّل الطريقة google.accounts.id.initializeIntermediate إطار iframe الوسيط استنادًا إلى عنصر الإعدادات. في ما يلي مثال على الرمز البرمجي الخاص بطريقة العرض:
google.accounts.id.initializeIntermediate(IntermediateConfig)
ينفّذ مثال الرمز البرمجي التالي طريقة
google.accounts.id.initializeIntermediate باستخدام الدالة onload:
<script>
window.onload = function () {
google.accounts.id.initializeIntermediate({
src: 'https://example.com/intermediate'
});
};
</script>
نوع البيانات: IntermediateConfig
يسرد الجدول التالي الحقول مع أوصافها:
| الحقل | |
|---|---|
src |
معرّف الموارد المنتظم (URI) لإطار One Tap الوسيط |
done |
طريقة ردّ اتصال JavaScript سيتم تشغيلها عندما تكون تجربة مستخدم One Tap هي إحدى الطرق. |
src
هذا الحقل هو معرّف الموارد المنتظم (URI) لإطار iframe الوسيط الخاص بميزة "النقرة الواحدة". اطّلِع على الجدول التالي لمزيد من المعلومات:
| النوع | مطلوب | مثال |
|---|---|---|
| سلسلة | نعم | src: "https://example.com/onetap_iframe.html" |
تم
هذا الحقل هو طريقة رد الاتصال في JavaScript التي سيتم تشغيلها عند اكتمال تجربة المستخدم في One Tap.
بشكلٍ تلقائي، تتم إعادة تحميل صفحة المحتوى عند اكتمال تجربة المستخدم في One Tap. يمكنك إلغاء السلوك التلقائي من خلال تقديم دالة معاودة الاتصال الخاصة بك. اطّلِع على الجدول التالي لمزيد من المعلومات:
| النوع | مطلوب | مثال |
|---|---|---|
| الوظيفة | اختياري | done: onOneTapSuccess |