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 dicatat untuk error ini dan Anda dapat memantaunya di halaman Logs Explorer untuk project cloud console.

Memfilter kesalahan Penautan Akun

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

  • Resource: Pilih Project Action Asisten Google jika Anda membuat project melalui Actions on Google Console; jika tidak, pilih opsi Google Project.
  • Log Name: Pilih opsi Error Penautan Akun Google.
  • Keparahan: 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 di 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 dimuat dalam properti jsonPayload dari entri error. Data tersebut mencakup kolom berikut:

  • @type (String): Selalu tetapkan ke type.googleapis.com/google.identity.accountlinking.type.AccountLinkingError.
  • step (String): Langkah penautan tempat error terjadi. Tetapkan ke salah satu nilai berikut:
    • ACCOUNT_LINKING_STEP_UNDEFINED: Langkah yang belum ditentukan.
    • AUTH_CODE_EXCHANGE: Langkah untuk menukarkan kode autentikasi dengan akses atau token refresh.
    • REFRESH_ACCESS_TOKEN: Langkah untuk memperbarui 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): Mewakili 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 yang berbeda di penampil log.

Saat menerapkan server OAuth Penautan Akun Google dan Server OAuth Penautan Akun Google yang Efisien, Anda harus menggunakan kode respons HTTP tertentu untuk status yang berbeda. Nilai yang Anda tampilkan harus sesuai dengan status yang benar yang tercantum dalam dokumentasi.