Error yang Biasa Terjadi

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

google.rpc.ErrorInfo
ACCESS_TOKEN_SCOPE_INSUFFICIENT
RingkasanToken akses OAuth 2.0 tidak memiliki cakupan yang diperlukan.
Penyebab umum Permintaan ditolak karena token akses yang diberikan tidak menyertakan cakupan OAuth 2.0 Google Ads API.
Cara menangani Pastikan token akses memiliki cakupan yang diperlukan. Penyebab umum error ini adalah Anda menggunakan kembali token akses yang ada yang dibuat menggunakan kumpulan cakupan OAuth yang berbeda. Lihat parameter otorisasi OAuth untuk mengetahui contoh cara membuat token akses baru dengan cakupan yang diperlukan.
Tips pencegahan Pastikan token akses memiliki cakupan yang diperlukan. Autentikasi ulang pengguna Anda dengan cakupan yang diperlukan untuk mendapatkan akses dengan cakupan yang diperlukan. Jika aplikasi Anda menggunakan beberapa cakupan OAuth, Anda mungkin perlu menerapkan izin OAuth Granular.

google.auth.exceptions.RefreshError
invalid_grant
RingkasanMasa berlaku token telah habis atau token telah 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 habis dalam 7 hari.
Cara menangani Status publikasi project Google Anda adalah Testing sehingga token refresh akan habis 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 agar masa berlaku token refresh tidak habis dalam 7 hari.
Tips pencegahan Lihat Aplikasi yang belum diverifikasi.

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID
RingkasanClient customer ID bukan angka.
Penyebab umum Menggunakan client customer ID yang tidak tepat.
Cara menangani T/A
Tips pencegahan 123-456-7890 seharusnya 1234567890. Lihat bagian Memulai untuk mengetahui detailnya
CLIENT_CUSTOMER_ID_IS_REQUIRED
RingkasanClient customer ID tidak ditentukan di header HTTP.
Penyebab umum Tidak menentukan client customer ID 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 tersebut akan menangani hal ini untuk Anda.
CUSTOMER_NOT_FOUND
RingkasanTidak ada akun yang ditemukan untuk customer ID yang diberikan di header.
Penyebab umum Mencoba mengakses akun yang baru 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 mengirim permintaan ke akun tersebut.
RingkasanToken akses di header permintaan tidak valid atau telah habis masa berlakunya.
Penyebab umum Token akses telah dibatalkan.
Cara menangani Minta token baru. Jika Anda menggunakan salah satu library klien kami, lihat dokumentasinya tentang cara memperbarui token.
Tips pencegahan Simpan dan gunakan kembali token akses hingga masa berlakunya habis.
NOT_ADS_USER
RingkasanAkun Google yang digunakan untuk membuat token akses tidak terkait 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 Anda teruskan 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 token akses tertukar dengan token refresh dan kode otorisasi. Jika Anda ingin mendapatkan kredensial yang dapat mengakses semua akun klien di bawah akun pengelola, pastikan Anda mendapatkan token refresh untuk akun pengelola. Lihat panduan autentikasi pengguna.
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN
RingkasanToken developer sudah dikaitkan dengan organisasi Google Cloud dan tidak dapat dikaitkan dengan organisasi lain.
Penyebab umum Token developer tidak dikaitkan dengan project Google Cloud di organisasi Google Cloud yang sama dengan project Google Cloud yang digunakan untuk membuat permintaan.
Cara menangani Pastikan client ID OAuth dikaitkan dengan project Google Cloud di organisasi Google Cloud yang sama jika Anda telah membuat permintaan API dengan token developer.
Tips pencegahan Pastikan semua project Google Cloud Anda dikaitkan dengan organisasi Google Cloud yang sama. Project Google Cloud hanya dapat dikaitkan dengan satu token developer, tetapi token developer dapat dikaitkan dengan beberapa project di organisasi.
DEVELOPER_TOKEN_INVALID
RingkasanToken developer tidak valid.
Penyebab umum Penyebab umum error ini mencakup salah ketik pada token developer, atau salah menetapkan token developer di header permintaan yang berbeda.
Cara menangani Pastikan Anda menyalin token developer dari pusat API untuk menghindari salah ketik. Anda dapat menemukan pusat API di akun pengelola Google Ads. Selain itu, pastikan Anda menetapkan token developer di header yang benar. Token developer terkadang tertukar dengan token refresh OAuth dan kode otorisasi. Baca selengkapnya tentang header permintaan yang berbeda di sini.
Tips pencegahan T/A

AuthorizationError
CUSTOMER_NOT_ENABLED
RingkasanAkun pelanggan tidak dapat diakses karena tidak dalam status aktif.
Penyebab umum Hal ini terjadi jika 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 secara proaktif memeriksa apakah akun pelanggan dinonaktifkan dengan memeriksa status CANCELLED.
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 Anda 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 dapat dikaitkan dengan token developer dari hanya satu akun pengelola. Setelah Anda membuat permintaan Google Ads API, token developer akan dipasangkan secara permanen ke project Konsol Google API. Jika Anda 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 bawah akun pengelola baru, Anda harus membuat project Konsol API Google baru untuk permintaan Google Ads API yang menggunakan token pengelola baru.
USER_PERMISSION_DENIED
RingkasanPelanggan yang diberi otorisasi tidak memiliki akses ke pelanggan operasi.
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.

Sebelumnya
Menangani error
Berikutnya
Langkah-langkah berikutnya