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:

Atrybut
data-src	Identyfikator URI pośredniego elementu iframe One Tap
data-done	Metoda wywołania zwrotnego JavaScriptu, która ma być wywoływana po zakończeniu działania interfejsu One Tap.

data-src

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

Typ	Wymagane	Przykład
ciąg znaków	Tak	data-src="https://example.com/onetap_iframe.html"

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:

Typ	Wymagane	Przykład
Funkcja	Opcjonalny	data-done="onOneTapSuccess"

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:

Pole
src	Identyfikator URI pośredniego elementu iframe One Tap
done	Metoda wywołania zwrotnego JavaScriptu, która ma być wywoływana, gdy interfejs One Tap UX jest jeden.

src

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

Typ	Wymagane	Przykład
ciąg znaków	Tak	src: "https://example.com/onetap_iframe.html"

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:

Typ	Wymagane	Przykład
Funkcja	Opcjonalny	done: onOneTapSuccess