Peringatan: Data ini disediakan menurut Kebijakan Data Pengguna Google . Harap tinjau dan patuhi kebijakan. Kegagalan untuk melakukannya dapat mengakibatkan penangguhan proyek atau akun.

API JavaScript Dukungan Iframe Menengah

Halaman referensi ini menjelaskan API JavaScript Dukungan Iframe Menengah, yang memungkinkan Anda memanipulasi iframe perantara di UX berikutnya.

Tabel berikut mencantumkan semua metode yang tersedia dan perilakunya.

Metode
verifyParentOrigin melakukan verifikasi asal orang tua
notifyParentClose memberi tahu bingkai induk bahwa aliran One Tap UX dilewati
notifyParentDone memberi tahu bingkai induk bahwa aliran One Tap UX selesai
notifyParentResize memberi tahu bingkai induk untuk mengubah ukuran iframe perantara
notifyParentTapOutsideMode memberi tahu bingkai induk apakah akan membatalkan iframe perantara saat pengguna mengeklik di luar iframe perantara

Muat Pustaka JavaScript Dukungan Iframe Menengah

Tempatkan cuplikan kode berikut ke dalam halaman HTML mana pun tempat Anda ingin memuat iframe perantara:

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

Metode: google.accounts.id.intermediate.verifyParentOrigin

Metode google.accounts.id.intermediate.verifyParentOrigin melakukan verifikasi asal induk. Lihat contoh kode metode berikut ini:

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

Contoh kode berikut menunjukkan cara menampilkan UI hanya setelah asal induk diverifikasi:

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

Tabel berikut mencantumkan parameter:

Parameter
origins Asal yang diizinkan untuk menyematkan iframe perantara.
verifiedCallback Metode callback JavaScript yang akan dipicu ketika asal induk saat ini diizinkan untuk menyematkan iframe perantara.
verificationFailedCallback Metode callback JavaScript yang akan dipicu ketika asal induk saat ini tidak diizinkan untuk menyematkan iframe perantara.

asal

Asal yang diizinkan untuk menyematkan iframe perantara. Lihat tabel berikut untuk informasi lebih lanjut:

Tipe Yg dibutuhkan Contoh
string, array string, atau fungsi Pilihan allowed_parent_origin: "https://example.com"

Tabel berikut mencantumkan tipe nilai yang didukung dan deskripsinya.

Jenis Nilai
string URI domain tunggal. "https://example.com"
string array Array URI domain. "https: //news.example.com,https: //local.example.com"

VerifiedCallback

Bidang ini adalah metode panggilan balik JavaScript yang akan dipicu ketika asal induk saat ini diizinkan untuk menyematkan iframe perantara.

verifikasiFailedCallback

Bidang ini adalah metode panggilan balik JavaScript yang akan dipicu ketika asal induk saat ini tidak diizinkan untuk menyematkan iframe perantara.

Metode: google.accounts.id.intermediate.notifyParentClose

Metode google.accounts.id.intermediate.notifyParentClose memberi tahu bingkai induk untuk menutup iframe perantara ketika aliran One Tap UX dilewati. Lihat contoh kode metode berikut ini:

google.accounts.id.intermediate.notifyParentClose()

Metode: google.accounts.id.intermediate.notifyParentDone

Metode google.accounts.id.intermediate.notifyParentClose memberi tahu bingkai induk untuk menutup iframe perantara, dan menyegarkan status masuk. Lihat contoh kode metode berikut ini:

google.accounts.id.intermediate.notifyParentDone()

Metode: google.accounts.id.intermediate.notifyParentResize

Metode google.accounts.id.intermediate.notifyParentResize memberi tahu bingkai induk untuk mengubah ukuran iframe perantara. Lihat contoh kode metode berikut ini:

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

tinggi

Tinggi baru dalam piksel. Ini adalah kolom yang harus diisi. Nilainya harus berupa angka non-negatif.

Jika parameter tinggi lebih besar dari 0, iframe perantara akan disetel ke tinggi baru. Jika parameter tinggi adalah 0, iframe perantara menjadi tidak terlihat. Iframe tersembunyi tidak ditutup. Ini dapat ditampilkan nanti oleh panggilan metode pengubahan ukuran lainnya.

Metode: google.accounts.id.intermediate.notifyParentTapOutsideMode

Metode google.accounts.id.intermediate.notifyParentTapOutsideMode memberi tahu bingkai induk apakah akan membatalkan iframe perantara saat pengguna mengeklik di luar iframe perantara. Lihat contoh kode metode berikut ini:

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

membatalkan

Nilai boolean yang diperlukan ini menunjukkan apakah akan membatalkan iframe perantara saat pengguna mengeklik di luar iframe perantara.