Bu referans sayfasında, sonraki kullanıcı deneyimindeki ara iframe'i değiştirebilmenizi sağlayan Orta Düzey Iframe Desteği JavaScript API'si açıklanmaktadır.
Ara iframe'lerin nasıl kullanılacağını öğrenmek için One Tap'i Iframe kullanarak entegre etme kılavuzuna bakın.
Aşağıdaki tabloda tüm kullanılabilir yöntemler ve davranışları listelenmektedir.
| Yöntemler | |
|---|---|
verifyParentOrigin |
üst kaynak doğrulamasını gerçekleştirir |
notifyParentClose |
üst çerçeveye One Tap kullanıcı deneyimi akışının atlandığını bildirir |
notifyParentDone |
One Tap kullanıcı deneyimi akışının tamamlandığını üst çerçeveye bildirir |
notifyParentResize |
üst çerçeveye ara iframe'i yeniden boyutlandırması gerektiğini bildirir |
notifyParentTapOutsideMode |
kullanıcı ara iframe'in dışına tıkladığında ara iframe'in iptal edilip edilmeyeceğini üst çerçeveye bildirir |
Orta Düzey iFrame Desteği JavaScript Kitaplığı'nı Yükle
Aşağıdaki kod snippet'ini, ara iframe'i yüklemek istediğiniz tüm HTML sayfalarına yerleştirin:
<script src="https://accounts.google.com/gsi/intermediatesupport"></script>
Yöntem: google.accounts.id.intermediate.verifyParentOrigin
google.accounts.id.intermediate.verifyParentOrigin yöntemi, üst kaynak doğrulamasını gerçekleştirir. Yöntemin aşağıdaki kod örneğine bakın:
google.accounts.id.intermediate.verifyParentOrigin(
origins, verifiedCallback, verificationFailedCallback)
Aşağıdaki kod örneğinde, yalnızca üst kaynak doğrulandıktan sonra kullanıcı arayüzünün nasıl gösterileceği gösterilmektedir:
<script>
window.onload = () => {
google.accounts.id.intermediate.verifyParentOrigin(
"https://example.com", showUI, showError);
};
</script>
Aşağıdaki tabloda parametreler listelenmiştir:
| Parametre | |
|---|---|
origins |
Ara iframe'i yerleştirmesine izin verilen kaynaklar. |
verifiedCallback |
Mevcut üst kaynağın ara iframe'i yerleştirmesine izin verildiğinde tetiklenen JavaScript geri çağırma yöntemi. |
verificationFailedCallback |
Mevcut üst kaynağın ara iframe'i yerleştirmesine izin verilmediğinde tetiklenen JavaScript geri çağırma yöntemi. |
kaynaklar
Ara iframe'i yerleştirmesine izin verilen kaynaklar. Daha fazla bilgi için aşağıdaki tabloya bakın:
| Tür | Zorunlu | Örnek |
|---|---|---|
| dize, dize dizisi veya işlev | İsteğe bağlı | allowed_parent_origin: "https://example.com" |
Aşağıdaki tabloda, desteklenen değer türleri ve bunların açıklamaları listelenmiştir.
| Değer Türleri | ||
|---|---|---|
string |
Tek bir alan URI'sı. | "https://example.com" |
string array |
Alan URI'leri dizisi. | "https://haber.example.com,https://yerel.example.com" |
doğrulanmışgeri arama
Bu alan, mevcut üst kaynağın ara iframe'i yerleştirmesine izin verildiğinde tetiklenen bir JavaScript geri çağırma yöntemidir.
doğrulamaBaşarısız geri arama
Bu alan, mevcut üst kaynağın ara iframe'i yerleştirmesine izin verilmediğinde tetiklenen bir JavaScript geri çağırma yöntemidir.
Yöntem: google.accounts.id.intermediate.notifyParentClose
google.accounts.id.intermediate.notifyParentClose yöntemi, One Tap kullanıcı deneyimi akışı atlandığında üst çerçeveye ara iframe'i kapatması gerektiğini bildirir. Yöntemin aşağıdaki kod örneğine bakın:
google.accounts.id.intermediate.notifyParentClose()
Yöntem: google.accounts.id.intermediate.notifyParentDone
google.accounts.id.intermediate.notifyParentClose yöntemi, üst çerçeveyi ara iframe'i kapatması ve giriş durumunu yenilemesi için bildirir. Yöntemin aşağıdaki kod örneğine bakın:
google.accounts.id.intermediate.notifyParentDone()
Yöntem: google.accounts.id.intermediate.notifyParentResize
google.accounts.id.intermediate.notifyParentResize yöntemi, ara iframe'i yeniden boyutlandırması için üst çerçeveyi bilgilendirir. Yöntemin aşağıdaki kod örneğine bakın:
google.accounts.id.intermediate.notifyParentResize(height)
yükseklik
Piksel cinsinden yeni yükseklik. Bu alanının doldurulması zorunludur. Değer, negatif olmayan bir sayı olmalıdır.
Yükseklik parametresi 0'dan büyükse ara iframe yeni yüksekliğe ayarlanır. Yükseklik parametresi 0 ise ara iframe görünmez hale gelir. Gizli bir iframe kapatılmamış. Bu ad, daha sonra başka bir yeniden boyutlandırma yöntemi çağrısıyla gösterilebilir.
Yöntem: google.accounts.id.intermediate.notifyParentTapOutsideMode
google.accounts.id.intermediate.notifyParentTapOutsideMode yöntemi, kullanıcı ara iframe'in dışına tıkladığında ara iframe'in iptal edilip edilmeyeceğini üst çerçeveye bildirir. Yöntemin aşağıdaki kod örneğine bakın:
google.accounts.id.intermediate.notifyParentTapOutsideMode(cancel)
cancel
Bu gerekli boole değeri, kullanıcı ara iframe'in dışını tıkladığında ara iframe'in iptal edilip edilmeyeceğini gösterir.