Dokumentacja API ramki pośredniej

Na tej stronie znajdziesz opis interfejsu API pośredniego elementu iframe, który służy do umieszczania w stronach internetowych prośby o logowanie jednym kliknięciem za pomocą elementu iframe.

Więcej informacji o pracy z pośrednimi elementami iframe znajdziesz w artykule Integrowanie One Tap za pomocą elementu iframe.

Wczytywanie biblioteki JavaScript pośredniego elementu iframe

Umieść ten fragment kodu na wszystkich stronach HTML, na których chcesz wyświetlać Google One:

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

HTML API

Możesz wczytać pośredni element iframe, dodając element HTML z atrybutem ID ustawionym na g_id_intermediate_iframe. Obejrzyj poniższy przykładowy fragment kodu:

<script src="https://accounts.google.com/gsi/intermediate"></script>
<div id="g_id_intermediate_iframe"
     data-src="https://example.com/onetap_iframe.html">
</div>

Element o identyfikatorze „g_id_intermediate_iframe”

Atrybuty danych ramki iframe możesz umieścić w dowolnych widocznych lub niewidocznych elementach, np. <div> i <span>. Jedynym wymaganiem jest ustawienie identyfikatora elementu na g_id_intermediate_iframe. Nie umieszczaj tego identyfikatora w wielu elementach.

W tabeli poniżej znajdziesz listę atrybutów danych wraz z ich opisami:

data-src

Ten atrybut to identyfikator URI pośredniego elementu iframe One Tap. Więcej informacji znajdziesz w tabeli poniżej:

data-done

Ten atrybut to metoda wywołania zwrotnego JavaScriptu, która jest wywoływana po zakończeniu działania interfejsu One Tap UX.

Domyślnie po zakończeniu działania interfejsu One Tap strona z treścią jest ponownie wczytywana. Możesz zastąpić domyślne działanie, podając własną funkcję zwrotną done. Więcej informacji znajdziesz w tabeli poniżej:

JavaScript API

Możesz wczytać pośredni element iframe, wywołując metodę JavaScript.

Metoda: google.accounts.id.initializeIntermediate

Metoda google.accounts.id.initializeIntermediate wczytuje pośredni element iframe na podstawie obiektu konfiguracji. Oto przykład kodu metody:

google.accounts.id.initializeIntermediate(IntermediateConfig)

Poniższy przykład kodu implementuje metodę google.accounts.id.initializeIntermediate za pomocą funkcji onload:

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

Typ danych: IntermediateConfig

W tabeli poniżej znajdziesz listę pól wraz z ich opisami:

src

To pole zawiera identyfikator URI pośredniego elementu iframe One Tap. Więcej informacji znajdziesz w tabeli poniżej:

gotowe

To pole zawiera metodę wywołania zwrotnego JavaScriptu, która ma zostać wywołana po zakończeniu działania interfejsu One Tap UX.

Domyślnie po zakończeniu działania interfejsu One Tap strona z treścią jest ponownie wczytywana. Możesz zastąpić domyślne działanie, podając własną funkcję zwrotną done. Więcej informacji znajdziesz w tabeli poniżej: