مرجع واجهة برمجة التطبيقات لإطار 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 على g_id_intermediate_iframe. لا تضع هذا المعرف في عناصر متعددة.

يسرد الجدول التالي سمات البيانات وأوصافها:

data-src

هذه السمة هي معرف الموارد المنتظم (URI) لإطار iframe المتوسط بميزة "نقرة واحدة". اطّلِع على الجدول التالي لمزيد من المعلومات:

data-done

هذه السمة هي طريقة ردّ اتصال JavaScript يتم تفعيلها عند اكتمال تجربة المستخدم في ميزة "النقرة الواحدة".

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

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

هذا الحقل هو معرّف الموارد المنتظم لإطار iframe الوسيط في ميزة "النقرة الواحدة". اطّلِع على الجدول التالي لمزيد من المعلومات:

تم

هذا الحقل هو طريقة ردّ اتصال JavaScript التي سيتم تفعيلها عند اكتمال تجربة المستخدِم في ميزة "النقرة الواحدة".

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