Kesalahan Umum

Halaman ini mencantumkan error umum dan memberikan tips untuk mencegah dan menanganinya. Untuk mengetahui daftar lengkap error, tinjau referensi error. Untuk dukungan lebih lanjut, buka forum kami.

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

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID
RingkasanID pelanggan klien bukan angka.
Penyebab umum Menggunakan client ID pelanggan yang tidak tepat.
Cara menangani T/A
Tips pencegahan 123-456-7890 harus 1234567890. Lihat Memulai untuk mengetahui detailnya.
CLIENT_CUSTOMER_ID_IS_REQUIRED
RingkasanID pelanggan klien tidak ditentukan di header HTTP.
Penyebab umum Tidak menentukan ID pelanggan klien di header HTTP.
Cara menangani T/A
Tips pencegahan Client customer ID diperlukan untuk semua panggilan, jadi pastikan Anda telah menentukannya di header HTTP. Pertimbangkan untuk menggunakan library klien kami karena library ini menanganinya untuk Anda.
CUSTOMER_NOT_FOUND
RingkasanTidak 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 pertama, lalu coba lagi setiap 30 detik.
Tips pencegahan Tunggu beberapa menit setelah akun dibuat sebelum mengeluarkan permintaan terhadapnya.
RingkasanToken akses di header permintaan tidak valid atau sudah tidak berlaku.
Penyebab umum Token akses telah dibatalkan validasinya.
Cara menangani Minta token baru. Jika Anda menggunakan salah satu library klien kami, lihat dokumentasi tentang cara memuat ulang token.
Tips pencegahan Menyimpan dan menggunakan kembali token akses hingga masa berlakunya habis.
NOT_ADS_USER
RingkasanAkun 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 untuk 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 ada dengan login ke akun pengelola, memilih akun pelanggan atau pengelola yang dimaksud, membuka Tools and Settings > Access and security, lalu menambahkan alamat email akun Google.
Tips pencegahan T/A
OAUTH_TOKEN_INVALID
RingkasanToken akses OAuth di header tidak valid.
Penyebab umum Token akses yang diteruskan dengan header HTTP salah.
Cara menangani T/A
Tips pencegahan Pastikan Anda telah meneruskan token akses yang benar yang terkait dengan akun Anda. Token ini terkadang tertukar dengan token refresh dan kode otorisasi. Jika Anda ingin mendapatkan kredensial yang dapat mengakses semua akun klien di akun pengelola, pastikan Anda mendapatkan token refresh untuk akun pengelola. Untuk mengetahui detail selengkapnya, lihat panduan kami tentang token akses dan token refresh serta OAuth2.

AuthorizationError
CUSTOMER_NOT_ENABLED
RingkasanAkun pelanggan tidak dapat diakses karena tidak dalam status diaktifkan.
Penyebab umum Hal ini terjadi jika akun pelanggan belum selesai mendaftar 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
RingkasanToken developer hanya disetujui untuk digunakan dengan akun pengujian dan mencoba mengakses akun non-pengujian.
Penyebab umum Token developer pengujian digunakan untuk mengakses akun non-pengujian.
Cara menangani Pastikan Anda memang ingin mengakses akun non-pengujian. Jika ya, Anda harus mengajukan permohonan untuk mengupgrade token developer ke akses Standar atau Dasar.
Tips pencegahan T/A
DEVELOPER_TOKEN_PROHIBITED
RingkasanToken developer tidak diizinkan dengan project yang dikirim dalam permintaan.
Penyebab umum Setiap project Konsol API Google hanya dapat dikaitkan dengan token developer dari satu akun pengelola. Setelah Anda membuat permintaan Google Ads API, token developer akan disambungkan secara permanen ke project Konsol Google API. 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 di akun pengelola baru, Anda harus membuat project Konsol Google API baru untuk permintaan Google Ads API yang menggunakan token pengelola baru.
USER_PERMISSION_DENIED
RingkasanPelanggan resmi tidak memiliki akses ke pelanggan yang beroperasi.
Penyebab umum Mengautentikasi sebagai pengguna dengan 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.