Memantau error Penautan Akun di project Google Console Anda

Google melakukan panggilan ke endpoint OAuth2 Anda selama proses penautan akun. Panggilan ini dapat gagal karena berbagai alasan. Informasi mendetail untuk error ini dicatat dalam log dan Anda dapat memantaunya di halaman Logs Explorer pada project konsol cloud Anda.

Memfilter error Penautan Akun

Di halaman Logs Explorer, tetapkan filter kueri ke berikut ini, lalu klik tombol Run Query:

  • Resource: Pilih Google Assistant Action Project jika Anda membuat project melalui Konsol Actions on Google; jika tidak, pilih opsi Google Project.
  • Nama Log: Pilih opsi Error Penautan Akun Google.
  • Severity: Tetapkan ke error; semua entri penautan akun dikategorikan sebagai error.

Anda juga dapat memfilter menurut tanggal dengan memperbarui rentang waktu di bagian atas halaman Logs Explorer, seperti yang ditunjukkan pada screenshot berikut:

Gambar 1. Filter kueri Logs Explorer

Anda dapat menemukan informasi selengkapnya tentang cara menggunakan Logs Explorer di dokumentasi Logs Explorer.

Konten data error

Data error penautan akun terdapat dalam properti jsonPayload entri error. Data tersebut mencakup kolom berikut:

  • @type (String): Selalu tetapkan ke type.googleapis.com/google.identity.accountlinking.type.AccountLinkingError.
  • step (String): Langkah penautan saat error terjadi. Tetapkan ke salah satu nilai berikut:
    • ACCOUNT_LINKING_STEP_UNDEFINED: Langkah yang tidak ditentukan.
    • AUTH_CODE_EXCHANGE: Langkah untuk menukar kode autentikasi dengan token akses atau refresh.
    • REFRESH_ACCESS_TOKEN: Langkah untuk memuat ulang token akses.
    • TOKEN_REVOCATION: Langkah untuk mencabut token.
    • USERINFO: Langkah untuk mengambil informasi pengguna dengan token akses.
    • ASSERTION: Langkah untuk membuat link berdasarkan pernyataan.
  • response (String, optional): Merepresentasikan respons HTTP:
    • status: Status respons HTTP.
    • body: Deskripsi error dan string error.
  • request (String, optional): Merepresentasikan permintaan HTTP dan berisi parameter permintaan HTTP berikut: metode, isi, URI, dan header.

Kolom request dan response bersifat opsional karena terkadang dipisahkan menjadi 2 entri berbeda dalam log viewer.

Saat menerapkan server OAuth Penautan Akun Google dan server OAuth Penautan Akun Google yang Disederhanakan, Anda diharuskan menggunakan kode respons HTTP spesifik untuk berbagai status. Nilai yang Anda tampilkan harus sesuai dengan status yang benar yang tercantum dalam dokumentasi.