Halaman referensi ini menjelaskan API atribut data Login dengan Google. Anda dapat menggunakan API untuk menampilkan perintah Sekali Ketuk atau tombol Login dengan Google di halaman web Anda.
Elemen dengan ID "g_id_onload"
Anda dapat menempatkan atribut data Login dengan Google di elemen apa pun yang terlihat atau tidak terlihat, seperti <div>
dan <span>
. Satu-satunya persyaratan adalah ID elemen
ditetapkan ke g_id_onload
. Jangan tempatkan ID ini pada beberapa elemen.
Atribut data
Tabel berikut mencantumkan atribut data beserta deskripsinya:
Atribut | |
---|---|
data-client_id |
Client ID aplikasi Anda |
data-auto_prompt |
Ketuk Google Display. |
data-auto_select |
Mengaktifkan pilihan otomatis di Google One Tap. |
data-login_uri |
URL endpoint login Anda |
data-callback |
Nama fungsi pengendali token ID JavaScript |
data-native_login_uri |
URL endpoint pengendali kredensial Anda |
data-native_callback |
Nama fungsi pengendali kredensial sandi JavaScript |
data-native_id_param |
Nama parameter untuk nilai credential.id |
data-native_password_param |
Nama parameter untuk nilai credential.password |
data-cancel_on_tap_outside |
Mengontrol apakah akan membatalkan perintah jika pengguna mengklik di luar perintah. |
data-prompt_parent_id |
ID DOM dari elemen penampung perintah Sekali Ketuk |
data-skip_prompt_cookie |
Melewati Satu Ketuk jika cookie yang ditentukan tidak memiliki nilai. |
data-nonce |
String acak untuk token ID |
data-context |
Judul dan kata dalam perintah Sekali Ketuk |
data-moment_callback |
Nama fungsi pemroses notifikasi status UI perintah |
data-state_cookie_domain |
Jika Anda perlu memanggil Sekali Ketuk di domain induk dan subdomainnya, teruskan domain induk ke atribut ini sehingga satu cookie bersama akan digunakan. |
data-ux_mode |
Alur UX tombol Login dengan Google |
data-allowed_parent_origin |
Asal yang diizinkan untuk menyematkan iframe perantara. Sekali Ketuk akan berjalan dalam mode iframe menengah jika atribut ini ditampilkan. |
data-intermediate_iframe_close_callback |
Mengganti perilaku iframe perantara default saat pengguna menutup Sekali Ketuk secara manual. |
data-itp_support |
Mengaktifkan UX Sekali Ketuk yang diupgrade pada browser ITP. |
Jenis atribut
Bagian berikut berisi detail tentang setiap jenis atribut beserta contohnya.
id_klien-data
Atribut ini adalah client ID aplikasi Anda, yang ditemukan dan dibuat di Google Developers Console. Lihat tabel berikut untuk informasi selengkapnya:
Type | Wajib | Contoh |
---|---|---|
string | Ya | data-client_id="CLIENT_ID.apps.googleusercontent.com" |
data-auto_prompt
Atribut ini menentukan apakah akan menampilkan Sekali ketuk atau tidak. Nilai defaultnya
adalah true
. Ketuk Google One tidak akan ditampilkan jika nilai ini adalah false
. Lihat tabel berikut untuk informasi selengkapnya:
Type | Wajib | Contoh |
---|---|---|
boolean | Opsional | data-auto_prompt="true" |
pilih_otomatis_data
Atribut ini menentukan apakah token ID akan ditampilkan secara otomatis atau tidak,
tanpa interaksi pengguna, jika hanya satu sesi Google yang telah menyetujui aplikasi Anda.
Nilai defaultnya adalah false
. Lihat tabel berikut untuk informasi selengkapnya:
Type | Wajib | Contoh |
---|---|---|
boolean | Opsional | data-auto_select="true" |
data-login_uri
Atribut ini adalah URI endpoint login Anda.
Nilai harus sama persis dengan salah satu URI pengalihan yang diberi otorisasi untuk klien OAuth 2.0, yang Anda konfigurasi di Konsol API dan harus sesuai dengan Aturan validasi URI pengalihan kami.
Atribut ini dapat dihilangkan jika halaman tersebut adalah halaman login Anda, yang dalam hal ini kredensial diposting ke halaman ini secara default.
Respons kredensial token ID diposting ke endpoint login Anda jika tidak ada fungsi callback yang ditentukan, dan pengguna mengklik tombol Login dengan Google atau Sekali Ketuk, atau login otomatis terjadi.
Lihat tabel berikut untuk informasi selengkapnya:
Type | Opsional | Contoh |
---|---|---|
URL | Default-nya adalah URI halaman saat ini, atau nilai yang Anda tentukan. Diabaikan saat data-ux_mode="popup" dan
data-callback ditetapkan. |
data-login_uri="https://www.example.com/login" |
Endpoint login Anda harus menangani permintaan POST yang berisi kunci
credential
dengan nilai token ID dalam isi.
Berikut adalah contoh permintaan ke endpoint login Anda:
POST /login HTTP/1.1
Host: www.example.com
Content-Type: application/x-www-form-urlencoded
credential=ID_TOKEN
callback-data
Atribut ini adalah nama fungsi JavaScript yang menangani token ID yang ditampilkan. Lihat tabel berikut untuk informasi selengkapnya:
Type | Wajib | Contoh |
---|---|---|
string | Wajib jika data-login_uri tidak ditetapkan. |
data-callback="handleToken" |
Salah satu dari atribut data-login_uri
dan data-callback
mungkin digunakan. Hal ini
bergantung pada komponen dan konfigurasi mode UX berikut:
Atribut
data-login_uri
diperlukan untuk tombol UXredirect
Login dengan Google, yang mengabaikan atributdata-callback
.Salah satu dari dua atribut ini harus ditetapkan untuk Google One Ketuk dan tombol Login dengan mode UX
popup
. Jika keduanya ditetapkan, atributdata-callback
memiliki prioritas lebih tinggi.
Fungsi JavaScript dalam namespace tidak didukung oleh HTML API.
Sebagai gantinya, gunakan fungsi JavaScript global tanpa namespace. Misalnya,
gunakan mylibCallback
, bukan mylib.callback
.
data_native_login_data
Atribut ini adalah URL endpoint pengendali kredensial Anda. Jika Anda
menetapkan atribut data-native_login_uri
atau atribut
data-native_callback
, library JavaScript akan kembali ke pengelola kredensial native
saat tidak ada sesi Google. Anda tidak diizinkan untuk menetapkan
atribut data-native_callback
dan data-native_login_uri
. Lihat tabel
berikut untuk informasi selengkapnya:
Type | Wajib | Contoh |
---|---|---|
string | Opsional | data-login_uri="https://www.example.com/password_login" |
callback-native-data
Atribut ini adalah nama fungsi JavaScript yang menangani kredensial
sandi yang ditampilkan dari pengelola kredensial native browser. Jika Anda menetapkan
atribut data-native_login_uri
atau atribut data-native_callback
, library JavaScript akan kembali ke pengelola kredensial native
saat tidak ada sesi Google. Anda tidak diizinkan untuk menetapkan
data-native_callback
dan data-native_login_uri
. Lihat tabel berikut untuk
mengetahui informasi lebih lanjut:
Type | Wajib | Contoh |
---|---|---|
string | Opsional | data-native_callback="handlePasswordCredential" |
Fungsi JavaScript dalam namespace tidak didukung oleh HTML API.
Sebagai gantinya, gunakan fungsi JavaScript global tanpa namespace. Misalnya,
gunakan mylibCallback
, bukan mylib.callback
.
data-native_id_param
Saat mengirimkan kredensial sandi ke endpoint pengendali kredensial, Anda dapat menentukan nama parameter untuk kolom credential.id
. Nama
defaultnya adalah email
. Lihat tabel berikut untuk informasi selengkapnya:
Type | Wajib | Contoh |
---|---|---|
URL | Opsional | data-native_id_param="user_id" |
data-native_password_param
Saat mengirimkan kredensial sandi ke endpoint pengendali kredensial, Anda dapat menentukan nama parameter untuk nilai credential.password
. Nama default-nya adalah password
. Lihat tabel berikut untuk informasi
selengkapnya:
Type | Wajib | Contoh |
---|---|---|
URL | Opsional | data-native_password_param="pwd" |
data-cancel_on_tap_di luar
Atribut ini menetapkan apakah permintaan Ketuk Sekali dibatalkan atau tidak jika pengguna
mengklik di luar perintah. Nilai default-nya adalah true
. Untuk menonaktifkannya, tetapkan nilai ke false
. Lihat tabel berikut untuk informasi selengkapnya:
Type | Wajib | Contoh |
---|---|---|
boolean | Opsional | data-cancel_on_tap_outside="false" |
data-prompt_parent_id
Atribut ini menetapkan ID DOM elemen container. Jika belum disetel, perintah Sekali Ketuk akan ditampilkan di pojok kanan atas jendela. Lihat tabel berikut untuk informasi selengkapnya:
Type | Wajib | Contoh |
---|---|---|
string | Opsional | data-prompt_parent_id="parent_id" |
data-skip_prompt_cookie
Atribut ini melewati One Tap jika cookie yang ditentukan memiliki nilai yang tidak kosong. Lihat tabel berikut untuk informasi selengkapnya:
Type | Wajib | Contoh |
---|---|---|
string | Opsional | data-skip_prompt_cookie="SID" |
non-data
Atribut ini adalah string acak yang digunakan oleh token ID untuk mencegah serangan replay. Lihat tabel berikut untuk informasi selengkapnya:
Type | Wajib | Contoh |
---|---|---|
string | Opsional | data-nonce="biaqbm70g23" |
Panjang nonce dibatasi pada ukuran JWT maksimum yang didukung oleh lingkungan Anda, serta batasan ukuran HTTP browser dan server individual.
konteks-data
Atribut ini mengubah teks judul dan pesan yang ditampilkan dalam perintah Sekali Ketuk. Lihat tabel berikut untuk informasi selengkapnya:
Type | Wajib | Contoh |
---|---|---|
string | Opsional | data-context="use" |
Tabel berikut mencantumkan konteks yang tersedia beserta deskripsinya:
Konteks | |
---|---|
signin |
"Login dengan Google" |
signup |
"Daftar ke Google" |
use |
"Gunakan dengan Google" |
callback-momen-data
Atribut ini adalah nama fungsi pemroses notifikasi status UI
perintah. Untuk informasi selengkapnya, lihat jenis data
PromptMomentNotification
.
Lihat tabel berikut untuk informasi selengkapnya:
Type | Wajib | Contoh |
---|---|---|
string | Opsional | data-moment_callback="logMomentNotification" |
Fungsi JavaScript dalam namespace tidak didukung oleh HTML API.
Sebagai gantinya, gunakan fungsi JavaScript global tanpa namespace. Misalnya,
gunakan mylibCallback
, bukan mylib.callback
.
domain-status_cookie data
Jika Anda perlu menampilkan Sekali Ketuk di domain induk dan subdomainnya, teruskan domain induk ke atribut ini sehingga satu cookie status bersama digunakan. Lihat tabel berikut untuk informasi selengkapnya:
Type | Wajib | Contoh |
---|---|---|
string | Opsional | data-state_cookie_domain="example.com" |
mode-data-ux
Atribut ini menyetel alur UX yang digunakan oleh tombol Login dengan Google. Nilai
defaultnya adalah popup
. Atribut ini tidak berdampak pada UX Sekali Ketuk. Lihat tabel berikut untuk informasi selengkapnya:
Type | Wajib | Contoh |
---|---|---|
string | Opsional | data-ux_mode="redirect" |
Tabel berikut mencantumkan mode UX yang tersedia dan deskripsinya.
Mode UX | |
---|---|
popup |
Melakukan alur UX login di jendela pop-up. |
redirect |
Menjalankan alur UX login dengan pengalihan halaman penuh. |
data-allowed_parent_origin
Asal yang diizinkan untuk menyematkan iframe perantara. Sekali Ketuk akan berjalan dalam mode iframe menengah jika atribut ini ditampilkan. Lihat tabel berikut untuk informasi selengkapnya:
Type | Wajib | Contoh |
---|---|---|
string atau array string | Opsional | data-allowed_parent_origin="https://example.com" |
Tabel berikut mencantumkan jenis nilai yang didukung dan deskripsinya.
Jenis Nilai | ||
---|---|---|
string |
URI domain tunggal. | "https://contoh.com" |
string array |
Daftar URI domain yang dipisahkan koma. | "https://news.example.com,https://local.example.com" |
Jika nilai atribut data-allowed_parent_origin
tidak valid, inisialisasi Sekali Ketuk
pada mode iframe menengah akan gagal dan berhenti.
Awalan karakter pengganti juga didukung. Misalnya, "https://*.example.com"
akan cocok dengan example.com
dan subdomainnya di semua tingkat (mis.news.example.com
, login.news.example.com
). Hal yang perlu diperhatikan saat menggunakan karakter pengganti:
- String pola tidak boleh hanya terdiri dari karakter pengganti dan domain level teratas. Misalnya,
https://*.com
danhttps://*.co.uk
tidak valid; Seperti yang disebutkan di atas,"https://*.example.com"
akan cocok denganexample.com
dan subdomainnya. Anda juga dapat menggunakan daftar yang dipisahkan koma untuk mewakili 2 domain yang berbeda. Misalnya,"https://example1.com,https://*.example2.com"
akan cocok dengan domainexample1.com
,example2.com
, dan subdomain dariexample2.com
- Domain karakter pengganti harus dimulai dengan skema https:// yang aman.
"*.example.com"
akan dianggap tidak valid.
data-intermediate_iframe_close_callback
Mengganti perilaku iframe perantara default saat pengguna menutup secara manual Sekali Ketuk dengan mengetuk tombol 'X' di UI Sekali Ketuk. Perilaku default-nya adalah segera menghapus iframe perantara dari DOM.
Kolom data-intermediate_iframe_close_callback
hanya berlaku dalam
mode iframe menengah. Dan hal ini hanya berdampak pada iframe perantara,
bukan iframe Sekali Ketuk. UI Sekali Ketuk dihapus sebelum callback
dipanggil.
Type | Wajib | Contoh |
---|---|---|
fungsi | Opsional | data-intermediate_iframe_close_callback="logBeforeClose" |
Fungsi JavaScript dalam namespace tidak didukung oleh HTML API.
Sebagai gantinya, gunakan fungsi JavaScript global tanpa namespace. Misalnya,
gunakan mylibCallback
, bukan mylib.callback
.
data-itp_dukungan
Kolom ini menentukan apakah
UX One Tap yang diupgrade harus diaktifkan di browser yang mendukung Intelligent Tracking Prevention (ITP). Nilai defaultnya adalah
false
. Lihat tabel berikut untuk informasi selengkapnya:
Type | Wajib | Contoh |
---|---|---|
boolean | Opsional | data-itp_support="true" |
Elemen dengan class "g_id_signin"
Jika Anda menambahkan g_id_signin
ke atribut class
elemen, elemen ini akan dirender sebagai tombol Login dengan Google.
Anda dapat merender beberapa tombol Login dengan Google di halaman yang sama. Setiap tombol dapat memiliki setelan visualnya sendiri. Setelan ini ditentukan oleh atribut data berikut.
Atribut Data Visual
Tabel berikut mencantumkan atribut data visual dan deskripsinya:
Atribut | |
---|---|
data-type |
Jenis tombol: ikon atau tombol standar. |
data-theme |
Tema tombol. Misalnya, fill_blue atau fill_black. |
data-size |
Ukuran tombol. Misalnya, kecil atau besar. |
data-text |
Teks tombol. Misalnya, "Login dengan Google" atau "Daftar dengan Google". |
data-shape |
Bentuk tombol. Misalnya, persegi panjang atau melingkar. |
data-logo_alignment |
Perataan logo Google: kiri atau tengah. |
data-width |
Lebar tombol, dalam piksel. |
data-locale |
Teks tombol dirender dalam bahasa yang ditetapkan di atribut ini. |
data-click_listener |
Jika ditetapkan, fungsi ini akan dipanggil saat tombol Login dengan Google diklik. |
Jenis atribut
Bagian berikut berisi detail tentang setiap jenis atribut beserta contohnya.
jenis-data
Jenis tombol. Nilai default-nya adalah standard
. Lihat tabel berikut untuk
mengetahui informasi lebih lanjut:
Type | Wajib | Contoh |
---|---|---|
string | Ya | data-type="icon" |
Tabel berikut mencantumkan jenis tombol yang tersedia dan deskripsinya:
Type | |
---|---|
standard |
Tombol dengan teks atau informasi yang dipersonalisasi:
![]() ![]() |
icon |
Tombol ikon tanpa teks:
![]() |
tema-data
Tema tombol. Nilai default-nya adalah outline
. Lihat tabel berikut untuk
mengetahui informasi lebih lanjut:
Type | Wajib | Contoh |
---|---|---|
string | Opsional | data-theme="filled_blue" |
Tabel berikut mencantumkan tema yang tersedia dan deskripsinya:
Tema | |
---|---|
outline |
Tema tombol standar:
![]() ![]() ![]() |
filled_blue |
Tema tombol berwarna biru:
![]() ![]() ![]() |
filled_black |
Tema tombol berwarna hitam:
![]() ![]() ![]() |
ukuran-data
Ukuran tombol. Nilai default-nya adalah large
. Lihat tabel berikut untuk
mengetahui informasi lebih lanjut:
Type | Wajib | Contoh |
---|---|---|
string | Opsional | data-size="small" |
Tabel berikut mencantumkan ukuran tombol dan deskripsinya.
Ukuran | |
---|---|
large |
Tombol besar:
![]() ![]() ![]() |
medium |
Tombol berukuran sedang:
![]() ![]() |
small |
Tombol kecil:
![]() ![]() |
teks-data
Teks tombol. Nilai default-nya adalah signin_with
. Tidak ada perbedaan visual
untuk teks tombol ikon yang memiliki atribut data-text
berbeda. Satu-satunya pengecualian adalah saat teks dibaca untuk aksesibilitas
layar.
Lihat tabel berikut untuk informasi selengkapnya:
Type | Wajib | Contoh |
---|---|---|
string | Opsional | data-text="signup_with" |
Tabel berikut mencantumkan teks tombol yang tersedia dan deskripsinya:
Teks | |
---|---|
signin_with |
Teks tombol adalah “Login dengan Google”:
![]() ![]() |
signup_with |
Teks tombol adalah “Sign up with Google”:
![]() ![]() |
continue_with |
Teks tombol adalah “Lanjutkan dengan Google”:
![]() ![]() |
signin |
Teks tombol adalah “Login”:
![]() ![]() |
bentuk-data
Bentuk tombol. Nilai default-nya adalah rectangular
. Lihat tabel berikut untuk informasi selengkapnya:
Type | Wajib | Contoh |
---|---|---|
string | Opsional | data-shape="rectangular" |
Tabel berikut mencantumkan bentuk tombol yang tersedia dan deskripsinya:
Bentuk | |
---|---|
rectangular |
Tombol berbentuk persegi panjang. Jika digunakan untuk jenis
tombol icon , nilainya sama dengan square .
![]() ![]() ![]() |
pill |
Tombol berbentuk pil. Jika digunakan untuk jenis tombol icon ,
tombol tersebut sama dengan circle .
![]() ![]() ![]() |
circle |
Tombol berbentuk lingkaran. Jika digunakan untuk jenis tombol
standard , nilainya sama dengan pill .
![]() ![]() ![]() |
square |
Tombol berbentuk persegi. Jika digunakan untuk jenis tombol
standard , nilainya sama dengan rectangular .
![]() ![]() ![]() |
data-logo_alignment
Perataan logo Google. Nilai default-nya adalah left
. Atribut ini
hanya berlaku untuk jenis tombol standard
. Lihat tabel berikut untuk informasi
selengkapnya:
Type | Wajib | Contoh |
---|---|---|
string | Opsional | data-logo_alignment="center" |
Tabel berikut mencantumkan perataan yang tersedia dan deskripsinya:
logo_alignment | |
---|---|
left |
Ratakan logo Google:
![]() |
center |
Menyelaraskan tengah logo Google:
![]() |
lebar data
Lebar tombol minimum, dalam piksel. Lebar maksimum yang tersedia adalah 400 piksel.
Lihat tabel berikut untuk informasi selengkapnya:
Type | Wajib | Contoh |
---|---|---|
string | Opsional | data-width=400 |
lokal-data
Opsional. Menampilkan teks tombol menggunakan lokalitas yang ditentukan. Jika tidak, setelan default adalah Akun Google atau browser pengguna. Tambahkan parameter hl
dan kode
bahasa ke perintah src saat memuat library, misalnya: gsi/client?hl=<iso-639-code>
.
Jika tidak ditetapkan, lokalitas default browser atau preferensi pengguna sesi Google akan digunakan. Oleh karena itu, pengguna yang berbeda mungkin melihat versi yang berbeda dari tombol yang dilokalkan, dan mungkin dengan ukuran yang berbeda.
Lihat tabel berikut untuk informasi selengkapnya:
Type | Wajib | Contoh |
---|---|---|
string | Opsional | data-locale="zh_CN" |
pemroses_klik
Anda dapat menentukan fungsi JavaScript yang akan dipanggil saat tombol Login dengan Google diklik menggunakan atribut click_listener
.
google.accounts.id.renderButton(document.getElementById("signinDiv"), { theme: 'outline', size: 'large', click_listener: onClickHandler }); function onClickHandler(){ console.log("Sign in with Google button clicked...") }
Pada contoh di atas, pesan Tombol Login dengan Google diklik... akan dicatat ke konsol saat tombol Login dengan Google diklik.
Integrasi sisi server
Endpoint sisi server Anda harus menangani permintaan POST
HTTP berikut.
Endpoint pengendali token ID
Endpoint pengendali token ID memproses token ID. Berdasarkan status akun yang terkait, Anda dapat memproses login pengguna dan mengarahkan mereka ke halaman pendaftaran atau mengarahkan mereka ke halaman penautan akun untuk mendapatkan informasi tambahan.
Permintaan HTTP POST
berisi informasi berikut:
Format | Nama | Deskripsi |
---|---|---|
Cookie | g_csrf_token |
String acak yang berubah dengan setiap permintaan ke endpoint pengendali. |
Parameter permintaan | g_csrf_token |
String yang sama dengan nilai cookie sebelumnya,
g_csrf_token |
Parameter permintaan | credential |
Token ID yang dikeluarkan Google. |
Parameter permintaan | select_by |
Cara memilih kredensial. |
kredensial
Saat didekode, token ID akan terlihat seperti contoh berikut:
header { "alg": "RS256", "kid": "f05415b13acb9590f70df862765c655f5a7a019e", // JWT signature "typ": "JWT" } payload { "iss": "https://accounts.google.com", // The JWT's issuer "nbf": 161803398874, "aud": "314159265-pi.apps.googleusercontent.com", // Your server's client ID "sub": "3141592653589793238", // The unique ID of the user's Google Account "hd": "gmail.com", // If present, the host domain of the user's GSuite email address "email": "elisa.g.beckett@gmail.com", // The user's email address "email_verified": true, // true, if Google has verified the email address "azp": "314159265-pi.apps.googleusercontent.com", "name": "Elisa Beckett", // If present, a URL to user's profile picture "picture": "https://lh3.googleusercontent.com/a-/e2718281828459045235360uler", "given_name": "Eliza", "family_name": "Beckett", "iat": 1596474000, // Unix timestamp of the assertion's creation time "exp": 1596477600, // Unix timestamp of the assertion's expiration time "jti": "abc161803398874def" }
Kolom sub
berisi ID unik secara global untuk Akun Google.
Dengan menggunakan kolom email
, email_verified
, dan hd
, Anda dapat menentukan apakah Google menghosting dan memberikan otorisasi untuk alamat email. Jika Google adalah pihak yang berwenang, saat ini pengguna diketahui sebagai pemilik akun yang sah.
Kasus saat Google berwenang:
email
memiliki akhiran@gmail.com
, ini adalah akun Gmail.email_verified
bernilai benar danhd
disetel, ini adalah akun Google Workspace.
Pengguna dapat mendaftar ke Akun Google tanpa menggunakan Gmail atau Google Workspace. Jika email
tidak berisi akhiran @gmail.com
dan hd
tidak ada, berarti Google tidak berwenang dan sandi atau metode verifikasi lainnya direkomendasikan untuk memverifikasi pengguna. email_verfied
juga dapat terwujud karena Google awalnya memverifikasi pengguna saat Akun Google dibuat, namun kepemilikan akun email pihak ketiga mungkin telah berubah.
Kolom exp
menampilkan waktu habis masa berlaku untuk Anda memverifikasi token di sisi server.
Perlu waktu satu jam untuk mendapatkan token ID dari Login dengan Google. Anda harus memverifikasi token sebelum habis masa berlakunya. Anda tidak boleh menggunakan exp
untuk pengelolaan sesi. Token ID yang tidak berlaku lagi tidak berarti pengguna telah logout. Aplikasi Anda bertanggung jawab untuk
mengelola sesi pengguna Anda.
pilih_oleh
Tabel berikut mencantumkan kemungkinan nilai untuk kolom select_by
. Jenis tombol yang digunakan bersama dengan sesi dan status izin digunakan untuk menetapkan nilai,
Pengguna menekan tombol Sekali Ketuk atau Login dengan Google atau menggunakan proses login Otomatis tanpa sentuhan.
Sesi yang ada ditemukan, atau pengguna memilih dan login ke Akun Google untuk membuat sesi baru.
Sebelum membagikan kredensial token ID dengan aplikasi, pengguna harus
- menekan tombol Konfirmasi untuk memberikan izin agar dapat membagikan kredensial, atau
- sebelumnya telah memberikan izin dan menggunakan Pilih Akun untuk memilih Akun Google.
Nilai kolom ini ditetapkan ke salah satu jenis ini,
Nilai | Deskripsi |
---|---|
auto |
Login otomatis pengguna dengan sesi yang ada yang sebelumnya telah memberikan izin untuk berbagi kredensial. |
user |
Pengguna dengan sesi yang sudah ada yang sebelumnya memberikan izin menekan tombol 'Lanjutkan sebagai' dengan Sekali Ketuk untuk membagikan kredensial. |
user_1tap |
Pengguna dengan sesi yang ada menekan tombol 'Lanjutkan sebagai' Sekali Ketuk untuk memberikan izin dan membagikan kredensial. Hanya berlaku untuk Chrome v75 dan yang lebih baru. |
user_2tap |
Pengguna tanpa sesi yang sudah ada menekan tombol 'Lanjutkan sebagai' untuk memilih akun, lalu menekan tombol Konfirmasi di jendela pop-up untuk memberikan izin dan membagikan kredensial. Berlaku untuk browser berbasis non-Chromium. |
btn |
Pengguna dengan sesi yang ada yang sebelumnya memberikan izin menekan tombol Login dengan Google dan memilih Akun Google dari 'Pilih Akun' untuk membagikan kredensial. |
btn_confirm |
Pengguna dengan sesi yang ada menekan tombol Login dengan Google dan menekan tombol Konfirmasi untuk memberikan izin dan membagikan kredensial. |
btn_add_session |
Pengguna tanpa sesi yang sudah ada yang sebelumnya memberikan izin menekan tombol Login dengan Google untuk memilih Akun Google dan membagikan kredensial. |
btn_confirm_add_session |
Pengguna tanpa sesi yang sudah ada terlebih dahulu menekan tombol Login dengan Google untuk memilih Akun Google, lalu menekan tombol Konfirmasi untuk mengizinkan dan membagikan kredensial. |
Endpoint pengendali kredensial sandi
Endpoint pengendali kredensial sandi memproses kredensial sandi yang diambil oleh pengelola kredensial native.
Permintaan HTTP POST
berisi informasi berikut:
Format | Nama | Deskripsi |
---|---|---|
Cookie | g_csrf_token |
String acak yang berubah dengan setiap permintaan ke endpoint pengendali. |
Parameter permintaan | g_csrf_token |
String yang sama dengan nilai cookie sebelumnya,
g_csrf_token . |
Parameter permintaan | email |
Token ID ini yang diterbitkan Google. |
Parameter permintaan | password |
Cara memilih kredensial. |