مرجع میانی iframe API

این صفحه مرجع API میانی iframe را توصیف می کند که برای جاسازی درخواست One Tap در صفحات وب با استفاده از iframe استفاده می شود.

برای اطلاعات بیشتر در مورد کار با iframe های میانی، به Integrate One Tap با استفاده از iframe مراجعه کنید.

کتابخانه جاوا اسکریپت Iframe Intermediate را بارگیری کنید

قطعه کد زیر را در هر صفحه HTML که می‌خواهید Google One Tap نمایش دهد قرار دهید:

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

می‌توانید iframe میانی را با گنجاندن یک عنصر HTML با ویژگی ID که روی 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 میانی One Tap شما
data-done یک روش پاسخ به فراخوان جاوا اسکریپت که پس از اتمام One Tap UX فعال می شود.
data-src

این ویژگی URI iframe میانی One Tap شما است. برای اطلاعات بیشتر به جدول زیر مراجعه کنید:

تایپ کنید مورد نیاز مثال
رشته بله data-src="https://example.com/onetap_iframe.html"
داده های انجام شده

این ویژگی یک روش پاسخ به تماس جاوا اسکریپت است که پس از اتمام One Tap UX فعال می شود.

به‌طور پیش‌فرض، وقتی One Tap UX تمام شد، صفحه محتوا دوباره بارگیری می‌شود. می‌توانید با ارائه تماس‌های انجام‌شده خودتان، رفتار پیش‌فرض را لغو کنید. برای اطلاعات بیشتر به جدول زیر مراجعه کنید:

تایپ کنید مورد نیاز مثال
تابع اختیاری data-done="onOneTapSuccess"
JavaScript API

می‌توانید iframe میانی را با فراخوانی یک متد جاوا اسکریپت بارگیری کنید.

روش: 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 iframe میانی One Tap شما
done یک روش پاسخ به تماس جاوا اسکریپت که زمانی که One Tap UX یکی است، راه اندازی می شود.
src

این فیلد URI iframe میانی One Tap شما است. برای اطلاعات بیشتر به جدول زیر مراجعه کنید:

تایپ کنید مورد نیاز مثال
رشته بله src: "https://example.com/onetap_iframe.html"
انجام شد

این فیلد روش برگشت فراخوانی جاوا اسکریپت است که پس از اتمام One Tap UX فعال می شود.

به‌طور پیش‌فرض، وقتی One Tap UX تمام شد، صفحه محتوا دوباره بارگیری می‌شود. می‌توانید با ارائه تماس‌های انجام‌شده خودتان، رفتار پیش‌فرض را لغو کنید. برای اطلاعات بیشتر به جدول زیر مراجعه کنید:

تایپ کنید مورد نیاز مثال
تابع اختیاری done: onOneTapSuccess