Kesalahan Umum

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

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 menanganinya 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.

google.auth.exceptions.RefreshError

invalid_grant

Ringkasan Masa 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 mengeluarkan token refresh yang akan berakhir dalam 7 hari. Cara menanganinya Status publikasi project Google Anda adalah Testing, sehingga token refresh akan habis masa berlakunya setiap 7 hari dan menerima error invalid_grant. Buka Konsol Google API dan 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 menanganinya 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 menanganinya 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 menanganinya 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 menanganinya 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 berakhir.
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 menanganinya 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	Ringkasan Token akses OAuth di header tidak valid. Penyebab umum Token akses Anda yang diteruskan dengan header HTTP salah. Cara menanganinya T/A Tips pencegahan Pastikan Anda telah meneruskan token akses yang benar yang terkait dengan akun Anda. ID klien terkadang disalahartikan sebagai 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.
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN	Ringkasan Token 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 awal. Cara menanganinya Pastikan ID klien 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 dalam organisasi.
DEVELOPER_TOKEN_INVALID	Ringkasan Token developer tidak valid. Penyebab umum Penyebab umum error ini mencakup salah ketik pada token developer, atau salah menyetel token developer di header permintaan yang berbeda. Cara menanganinya Pastikan Anda menyalin token developer dari pusat API untuk menghindari salah ketik. Anda dapat menemukan pusat API di akun pengelola Google Ads Anda. Selain itu, pastikan Anda menyetel token developer di header yang benar. Token developer terkadang disamakan dengan token refresh OAuth dan kode otorisasi. Baca selengkapnya tentang berbagai header permintaan di sini. Tips pencegahan T/A

AuthorizationError
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 menanganinya 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.
DEVELOPER_TOKEN_NOT_APPROVED	Ringkasan Token developer hanya disetujui untuk digunakan dengan akun uji coba dan mencoba mengakses akun non-uji coba. Penyebab umum Token developer pengujian digunakan untuk mengakses akun non-pengujian. Cara menanganinya Pastikan Anda benar-benar ingin mengakses akun non-pengujian. Jika demikian, Anda harus mengajukan permohonan untuk mengupgrade token developer Anda 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 dari hanya satu akun pengelola. Setelah Anda membuat permintaan Google Ads API, token developer akan dipasangkan 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 menanganinya 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	Ringkasan Pelanggan yang diberi otorisasi 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 menanganinya T/A Tips pencegahan Tentukan login-customer-id sebagai ID akun pengelola tanpa tanda hubung (-). Library klien memiliki dukungan bawaan untuk hal ini.