Halaman ini diterjemahkan oleh Cloud Translation API.

Kesalahan Umum

Halaman ini berisi daftar error umum serta memberikan tips untuk mencegah dan menanganinya. Untuk mengetahui daftar lengkap error, tinjau referensi error. Untuk mendapatkan dukungan lebih lanjut, kunjungi forum kami.

`google.auth.exceptions.RefreshError`

invalid_grant

Ringkasan	Token telah habis masa berlakunya atau dicabut.
Penyebab umum	Project Google Cloud Platform dengan layar izin OAuth yang dikonfigurasi untuk jenis pengguna eksternal dan status publikasi `Testing` akan diberi token refresh yang masa berlakunya akan berakhir dalam 7 hari.
Cara menangani	Status publikasi project Google Anda adalah `Testing`, sehingga masa berlaku token refresh berakhir setiap 7 hari dan menerima error `invalid_grant`. Buka Konsol API Google lalu buka layar izin OAuth. Kemudian, ubah status publikasi menjadi `In production` dengan mengikuti petunjuk ini agar masa berlaku token refresh tidak berakhir dalam 7 hari.
Tips pencegahan	Lihat Aplikasi yang belum diverifikasi.

`AuthenticationError`

CLIENT_CUSTOMER_ID_INVALID

Ringkasan	ID pelanggan klien bukan angka.
Penyebab umum	Menggunakan ID pelanggan klien yang tidak tepat.
Cara menangani	T/A
Tips pencegahan	123-456-7890 harus menjadi 1234567890. Lihat Memulai untuk mengetahui detailnya.

CLIENT_CUSTOMER_ID_IS_REQUIRED

Ringkasan	ID pelanggan klien tidak ditentukan pada header HTTP.
Penyebab umum	Tidak menentukan ID pelanggan klien di header HTTP.
Cara menangani	T/A
Tips pencegahan	ID pelanggan klien diperlukan untuk semua panggilan, jadi pastikan Anda telah menentukannya di header HTTP. Pertimbangkan untuk menggunakan library klien kami saat mereka menangani hal ini untuk Anda.

CUSTOMER_NOT_FOUND

Ringkasan	Tidak ada akun yang ditemukan untuk ID pelanggan yang diberikan di header.
Penyebab umum	Mencoba mengakses akun yang baru saja dibuat sebelum akun dibuat di backend.
Cara menangani	Tunggu lima menit awal, lalu coba lagi setiap 30 detik.
Tips pencegahan	Tunggu beberapa menit setelah akun dibuat sebelum mengajukan permintaan untuk akun tersebut.

GOOGLE_ACCOUNT_COOKIE_INVALID

Ringkasan	Token akses di header permintaan tidak valid atau sudah tidak berlaku.
Penyebab umum	Token akses telah dibatalkan.
Cara menangani	Minta token baru. Jika Anda menggunakan salah satu library klien kami, baca dokumentasinya tentang cara me-refresh token.
Tips pencegahan	Simpan dan gunakan kembali token akses hingga masa berlakunya habis.

NOT_ADS_USER

Ringkasan	Akun Google yang digunakan untuk membuat token akses tidak dikaitkan dengan akun Google Ads mana pun.
Penyebab umum	Informasi login yang diberikan sesuai dengan akun Google yang tidak mengaktifkan Google Ads.
Cara menangani	Pastikan Anda login dengan akun Google Ads yang valid (biasanya akun pengelola Anda) untuk alur OAuth. Anda juga dapat mengundang akun Google untuk mengakses akun Google Ads yang sudah ada dengan login ke akun pengelola, memilih akun pelanggan atau akun pengelola yang dimaksud, membuka `Tools and Settings > Access and security`, lalu menambahkan alamat email Akun Google.
Tips pencegahan	T/A

OAUTH_TOKEN_INVALID

Ringkasan	Token akses OAuth di header tidak valid.
Penyebab umum	Token akses yang diteruskan dengan header HTTP tidak benar.
Cara menangani	T/A
Tips pencegahan	Pastikan Anda telah meneruskan token akses yang benar yang terkait dengan akun Anda. Terkadang disalahartikan sebagai token refresh dan kode otorisasi. Jika ingin mendapatkan kredensial yang dapat mengakses semua akun klien dalam akun pengelola, pastikan Anda mendapatkan token pembaruan untuk akun pengelola. Untuk mengetahui detail selengkapnya, lihat panduan kami tentang token akses dan token refresh serta OAuth2.

`AuthorizationError`

CUSTOMER_NOT_ENABLED

Ringkasan	Akun pelanggan tidak dapat diakses karena tidak dalam status diaktifkan.
Penyebab umum	Hal ini terjadi ketika akun pelanggan belum menyelesaikan pendaftaran atau telah dinonaktifkan.
Cara menangani	Login ke UI Google Ads dan pastikan Anda telah menyelesaikan proses pendaftaran untuk akun ini. Untuk akun yang dinonaktifkan, lihat Mengaktifkan kembali akun Google Ads yang dibatalkan.
Tips pencegahan	Anda dapat memeriksa secara proaktif apakah akun pelanggan dinonaktifkan dengan memeriksa status DIBATALKAN.

DEVELOPER_TOKEN_NOT_APPROVED

Ringkasan	Token developer hanya disetujui untuk digunakan dengan akun pengujian dan dicoba untuk mengakses akun non-pengujian.
Penyebab umum	Token developer pengujian digunakan untuk mengakses akun non-pengujian.
Cara menangani	Pastikan bahwa Anda benar-benar ingin mengakses akun non-pengujian. Jika ya, Anda harus mengajukan permohonan agar token developer Anda diupgrade ke akses Standar atau Dasar.
Tips pencegahan	T/A

DEVELOPER_TOKEN_PROHIBITED

Ringkasan	Token developer tidak diizinkan dengan project yang dikirim dalam permintaan.
Penyebab umum	Setiap project Konsol API Google dapat dikaitkan dengan token developer hanya dari satu akun pengelola. Setelah Anda mengajukan permintaan Google Ads API, token developer disambungkan secara permanen ke project Konsol API Google. Jika tidak menggunakan project Konsol API Google baru, Anda akan mendapatkan error `DEVELOPER_TOKEN_PROHIBITED` saat membuat permintaan.
Cara menangani	T/A
Tips pencegahan	Jika beralih ke token developer dengan akun pengelola baru, Anda harus membuat project Konsol API Google baru untuk permintaan Google Ads API yang menggunakan token pengelola baru.

USER_PERMISSION_DENIED

Ringkasan	Pelanggan yang diotorisasi tidak memiliki akses ke pelanggan yang beroperasi.
Penyebab umum	Mengautentikasi sebagai pengguna yang memiliki akses ke akun pengelola, tetapi tidak menentukan `login-customer-id` dalam permintaan.
Cara menangani	T/A
Tips pencegahan	Tentukan `login-customer-id` sebagai ID akun pengelola tanpa tanda hubung (`-`). Library klien memiliki dukungan bawaan untuk hal ini.