Ara iFrame API referansı

Bu referans sayfasında, iFrame kullanarak Tek Dokunma istemini web sayfalarına yerleştirmek için kullanılan Intermediate iFrame API'si açıklanmaktadır.

Ara iFrame'lerle çalışma hakkında daha fazla bilgi için iFrame kullanarak Tek Dokunma'yı entegre etme başlıklı makaleyi inceleyin.

Aracı iFrame JavaScript kitaplığını yükleme

Aşağıdaki kod snippet'ini, Google One'da göstermek istediğiniz tüm HTML sayfalarına yerleştirin:

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

HTML API

ID özelliği g_id_intermediate_iframe olarak ayarlanmış bir HTML öğesi ekleyerek ara iframe'i yükleyebilirsiniz. Aşağıdaki örnek kod snippet'ine bakın:

<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" kimlikli öğe

Ara iFrame veri özelliklerini <div> ve <span> gibi görünür veya görünmez öğelere yerleştirebilirsiniz. Tek şart, öğe kimliğinin g_id_intermediate_iframe olarak ayarlanmasıdır. Bu kimliği birden fazla öğeye yerleştirmeyin.

Aşağıdaki tabloda, veri özelliklerinin açıklamalarıyla birlikte listesi verilmiştir:

Özellik
data-src Tek Tıkla ara iFrame'inizin URI'si
data-done Tek Dokunma kullanıcı deneyimi tamamlandığında tetiklenecek bir JavaScript geri çağırma yöntemi.

data-src

Bu özellik, tek dokunmayla ödeme ara iframe'inizin URI'sidir. Daha fazla bilgi için aşağıdaki tabloya bakın:

Tür Zorunlu Örnek
dize Evet data-src="https://example.com/onetap_iframe.html"

data-done

Bu özellik, Tek Dokunmayla kullanıcı deneyimi tamamlandığında tetiklenen bir JavaScript geri çağırma yöntemidir.

Varsayılan olarak, tek dokunma kullanıcı deneyimi tamamlandığında içerik sayfası yeniden yüklenir. Kendi done geri aramanızı sağlayarak varsayılan davranışı geçersiz kılabilirsiniz. Daha fazla bilgi için aşağıdaki tabloya bakın:

Tür Zorunlu Örnek
İşlev İsteğe bağlı data-done="onOneTapSuccess"

JavaScript API

Bir JavaScript yöntemini çağırarak ara iFrame'i yükleyebilirsiniz.

Yöntem: google.accounts.id.initializeIntermediate

google.accounts.id.initializeIntermediate yöntemi, yapılandırma nesnesine göre ara iFrame'i yükler. Yöntemin aşağıdaki kod örneğine bakın:

google.accounts.id.initializeIntermediate(IntermediateConfig)

Aşağıdaki kod örneğinde, google.accounts.id.initializeIntermediate yöntemi onload işleviyle uygulanmaktadır:

<script>
  window.onload = function () {
    google.accounts.id.initializeIntermediate({
      src: 'https://example.com/intermediate'
    });
  };
</script>

Veri türü: IntermediateConfig

Aşağıdaki tabloda alanlar ve açıklamaları listelenmiştir:

Alan
src Tek Tıkla ara iFrame'inizin URI'si
done Tek dokunma kullanıcı arayüzü başlatıldığında tetiklenecek bir JavaScript geri çağırma yöntemi.

kyn

Bu alan, tek dokunmayla ödeme ara iframe'inizin URI'sidir. Daha fazla bilgi için aşağıdaki tabloya bakın:

Tür Zorunlu Örnek
dize Evet src: "https://example.com/onetap_iframe.html"

bitti

Bu alan, tek dokunma kullanıcı deneyimi tamamlandığında tetiklenecek JavaScript geri çağırma yöntemidir.

Varsayılan olarak, tek dokunma kullanıcı deneyimi tamamlandığında içerik sayfası yeniden yüklenir. Kendi done geri aramanızı sağlayarak varsayılan davranışı geçersiz kılabilirsiniz. Daha fazla bilgi için aşağıdaki tabloya bakın:

Tür Zorunlu Örnek
İşlev İsteğe bağlı done: onOneTapSuccess