Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
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.
Operator ini tidak dapat digunakan dengan subclass Iklan.
Penyebab umum
Mencoba mengubah atribut selain status iklan.
Cara menangani
T/A
Tips pencegahan
Setelah dibuat, iklan tidak dapat diubah. Jika Anda ingin mengubah iklan, Anda harus membuat iklan baru, lalu menghapus iklan yang lama. Namun, status iklan dapat diubah menggunakan MutateAdGroupAds.
INVALID_INPUT
Ringkasan
Salah satu kolom dalam iklan berisi karakter yang tidak valid.
Penyebab umum
Menggunakan karakter khusus dalam URL.
Cara menangani
T/A
Tips pencegahan
Validasi URL di aplikasi Anda sebelum membuat permintaan API.
LINE_TOO_WIDE
Ringkasan
Salah satu kolom dalam iklan lebih panjang dari panjang maksimum yang diizinkan. Lihat artikel Tentang iklan teks.
Penyebab umum
Memiliki baris teks yang terlalu panjang.
Cara menangani
T/A
Tips pencegahan
Validasi panjang baris sebelum membuat permintaan API.
Grup iklan telah ditambahkan atau diganti namanya, tetapi namanya sudah digunakan oleh grup iklan lain.
Penyebab umum
Membuat grup iklan baru dengan nama grup iklan yang aktif atau dijeda.
Cara menangani
Catat error tersebut dan tampilkan pesan error kepada pengguna, jika perlu, Anda dapat menyarankan nama grup iklan yang unik atau menampilkan daftar nama yang digunakan.
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.
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.
Sebuah kampanye sedang ditambahkan atau diganti namanya, tetapi namanya sudah digunakan oleh kampanye lain.
Penyebab umum
Membuat kampanye baru dengan nama kampanye yang aktif atau dijeda.
Cara menangani
Catat error tersebut dan tampilkan pesan error kepada pengguna, jika perlu, Anda dapat menyarankan nama kampanye yang unik atau menampilkan daftar nama yang digunakan.
Waktu permintaan habis dan tidak dapat diselesaikan dengan cukup cepat untuk memberikan respons.
Penyebab umum
Permintaan penelusuran dibuat yang menghasilkan respons terlalu besar, atau permintaan mutasi terlalu besar untuk diproses.
Cara menangani
Tunggu sekitar 30 detik, lalu coba lagi permintaan tersebut. Jika error terus berlanjut, coba bagi permintaan menjadi beberapa permintaan yang lebih kecil agar dapat diselesaikan lebih cepat.
Terjadi error yang tidak terduga saat memproses permintaan.
Penyebab umum
API tidak berfungsi dengan benar karena bug.
Cara menangani
Coba lagi permintaan apa pun yang gagal dengan error ini, menggunakan jadwal backoff eksponensial untuk percobaan ulang.
Tips pencegahan
T/A
TRANSIENT_ERROR
Ringkasan
Terjadi error internal sementara, dan percobaan ulang harus dilakukan.
Penyebab umum
Error ini terjadi saat API secara internal mengalami masalah sementara.
Cara menangani
Coba lagi permintaan apa pun yang gagal dengan error ini, menggunakan jadwal backoff eksponensial untuk percobaan ulang.
Tips pencegahan
T/A
InvalidGrantError
invalid_grant (malformed auth code)
Ringkasan
Format kode otorisasi yang ditukarkan dengan token OAuth salah.
Penyebab umum
Hal ini terjadi saat mencoba membuat token refresh untuk pengguna yang telah diberi akses ke aplikasi yang meminta. Misalnya, hal ini dapat terjadi saat menjalankan contoh Buat kredensial Pengguna lebih dari sekali untuk kredensial klien OAuth yang sama dan memberi otorisasi kepada pengguna.
Cara menangani
Agar dapat membuat ulang token refresh untuk kombinasi pemberian otorisasi pengguna dan kredensial klien OAuth, cabut token refresh yang ada. Perhatikan bahwa jika token dicabut, token tersebut tidak dapat digunakan untuk akses Google Ads API dan akan membuat semua token akses yang digunakan dengan token refresh yang digunakan jadi tidak dapat digunakan.
Tips pencegahan
Pastikan untuk menyimpan token refresh di lokasi yang aman untuk menghindari pembuatan ulang.
Permintaan merujuk ke resource yang tidak dapat ditemukan.
Penyebab umum
Permintaan tersebut mencoba mengubah atau merujuk resource yang tidak ada atau telah dihapus. Atau, format nama resource yang diberikan untuk resource salah.
Cara menangani
Gunakan permintaan penelusuran untuk mengambil nama resource untuk resource yang ada sebelum mengirimkan permintaan mutasi. Baca panduan library klien kami, yang mencakup dokumentasi tentang cara membuat nama resource yang valid dalam setiap bahasa yang didukung
Tips pencegahan
Jangan membuat nama resource secara manual. Gunakan salah satu metode bantuan yang ditawarkan oleh library klien kami.
Permintaan tersebut mencoba membuat resource yang akan menyebabkan jumlah total resource tersebut melebihi batas yang ditentukan.
Penyebab umum
Ada beberapa batasan jumlah resource yang bisa ada dalam konteks tertentu.
Cara menangani
Identifikasi batas yang ditemukan dengan meninjau Batas sistem. Gunakan kembali resource yang ada, atau hapus resource untuk membuat ruang bagi resource baru.
Tips pencegahan
Menggunakan kueri penelusuran untuk memantau jumlah resource yang memiliki keterbatasan.