Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Error yang biasa terjadi

Panduan ini mencantumkan error API umum dan menawarkan strategi untuk mencegah dan menanganinya.

Untuk mengetahui daftar lengkap semua jenis error, lihat referensi error Google Ads API. Jika Anda memerlukan bantuan tambahan, ajukan pertanyaan di forum Google Ads API.

`google.rpc.ErrorInfo`

ACCESS_TOKEN_SCOPE_INSUFFICIENT

Ringkasan	Token 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 serangkaian 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. Lakukan 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 terperinci.

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 menerbitkan token refresh yang akan berakhir 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` untuk menghindari masa berlaku token refresh berakhir dalam 7 hari.
Tips pencegahan	Lihat Aplikasi yang belum diverifikasi.

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 1234567890. Lihat bagian Memulai untuk mengetahui detailnya.

CLIENT_CUSTOMER_ID_IS_REQUIRED

Ringkasan	ID pelanggan klien tidak ditentukan di 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. Sebaiknya gunakan library klien kami karena library ini akan menanganinya 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 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 mengirimkan permintaan terhadap 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, lihat dokumentasinya tentang cara memperbarui 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 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 sudah 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

Ringkasan	Token akses OAuth di header tidak valid.
Penyebab umum	Token akses Anda 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. ID klien terkadang disamakan 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. Lihat panduan autentikasi pengguna.

CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION

Ringkasan	Project Google Cloud hanya memiliki akses Pengujian dan tidak dapat digunakan untuk mengakses akun produksi.
Penyebab umum	Project Google Cloud dengan tingkat akses Pengujian digunakan untuk membuat permintaan terhadap akun Google Ads non-pengujian (produksi). (Pada API versi v24 dan yang lebih lama, kondisi ini menampilkan `AuthorizationError.ACTION_NOT_PERMITTED`.)
Cara menangani	Jika Anda sedang melakukan pengujian, pastikan permintaan Anda menargetkan akun pengujian. Jika Anda ingin mengakses akun Google Ads produksi, periksa tingkat akses project Google Cloud Anda di halaman Ringkasan Google Ads API dan upgrade tingkat akses project Anda ke akses Explorer, Dasar, atau Standar.
Tips pencegahan	T/A

CUSTOMER_NOT_ENABLED

Ringkasan	Akun pelanggan tidak dapat diakses karena tidak dalam status aktif.
Penyebab umum	Hal ini terjadi saat 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 DIBATALKAN.

USER_PERMISSION_DENIED

Ringkasan	Pelanggan yang diberi otorisasi tidak memiliki akses ke pelanggan operasi.
Penyebab umum	Melakukan autentikasi 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.