مرجع واجهة برمجة التطبيقات لإطار iframe المتوسط

توضّح هذه الصفحة المرجعية كيفية تحميل إطار iframe وسيط في صفحات HTML.

تحميل مكتبة JavaScript لإطار iframe المتوسط

ضَع مقتطف الرمز التالي في أي صفحات HTML تريد عرضها على Google One. انقر لعرضها:

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

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

يمكنك تحميل إطار 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) لإطار iframe المتوسط من ميزة "نقرة واحدة". اطلع على الجدول التالي للحصول على مزيد من المعلومات:

تم الانتهاء من البيانات

هذه السمة هي طريقة استدعاء JavaScript يتم تشغيلها عند الانتهاء من تجربة "تجربة المستخدم بنقرة واحدة".

وفقًا للإعدادات التلقائية، تتم إعادة تحميل صفحة المحتوى عند انتهاء تجربة المستخدم بنقرة واحدة. يمكنك إلغاء السلوك التلقائي من خلال تقديم معاودة الاتصال التي أجريتها. راجِع الجدول التالي لمزيد من المعلومات:

JavaScript API

يمكنك تحميل إطار iframe المتوسط عن طريق استدعاء طريقة JavaScript.

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

تُحمّل الطريقة 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) لإطار iframe المتوسط من ميزة "نقرة واحدة". اطلع على الجدول التالي للحصول على مزيد من المعلومات:

done

هذا الحقل هو طريقة استدعاء JavaScript التي سيتم تشغيلها عند الانتهاء من تجربة "تجربة المستخدم بنقرة واحدة".

وفقًا للإعدادات التلقائية، تتم إعادة تحميل صفحة المحتوى عند انتهاء تجربة المستخدم بنقرة واحدة. يمكنك إلغاء السلوك التلقائي من خلال تقديم معاودة الاتصال التي أجريتها. راجِع الجدول التالي لمزيد من المعلومات: