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.auth.exceptions.RefreshError

invalid_grant
RingkasanToken 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 dikeluarkan sebagai 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 dan buka layar izin OAuth. Kemudian, ubah status publikasi menjadi In production dengan mengikuti petunjuk ini untuk menghindari masa berlaku token refresh berakhir dalam 7 hari.
Tips pencegahan Lihat Aplikasi yang belum diverifikasi.

AdError

CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR
RingkasanOperator ini tidak dapat digunakan dengan subclass Iklan.
Penyebab umum Mencoba mengubah atribut selain status dari iklan.
Cara menangani T/A
Tips pencegahan Setelah dibuat, iklan tidak dapat diubah. Jika ingin mengubah iklan, Anda harus membuat iklan baru, lalu menghapus iklan lama. Namun, status iklan dapat diubah menggunakan MutateAdGroupAds.
INVALID_INPUT
RingkasanSalah 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
RingkasanSalah satu kolom dalam iklan lebih panjang dari panjang maksimum yang diizinkan. Lihat Tentang iklan teks.
Penyebab umum Memiliki baris teks yang terlalu panjang.
Cara menangani T/A
Tips pencegahan Memvalidasi panjang baris sebelum membuat permintaan API.

AdGroupAdError

AD_GROUP_AD_LABEL_ALREADY_EXISTS
RingkasanLabel ini sudah dikaitkan dengan beberapa iklan.
Penyebab umum Mencoba mengaitkan label dengan iklan yang telah dikaitkan.
Cara menangani T/A
Tips pencegahan Periksa apakah label yang akan ditambahkan sudah dikaitkan dengan iklan terlebih dahulu.
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD
RingkasanSebuah operasi berusaha memperbarui iklan yang dihapus.
Penyebab umum Setelah dihapus, iklan tidak dapat diperbarui lagi—termasuk perubahan statusnya.
Cara menangani T/A
Tips pencegahan Pastikan kode Anda tidak berupaya memperbarui iklan yang dihapus.

AdGroupCriterionError

INVALID_KEYWORD_TEXT
RingkasanTeks kata kunci berisi karakter yang tidak valid. Lihat Menambahkan kata kunci.
Penyebab umum Teks kata kunci berisi karakter yang tidak valid.
Cara menangani T/A
Tips pencegahan Memvalidasi teks kata kunci di aplikasi Anda sebelum membuat permintaan ke API.

AdGroupError

DUPLICATE_ADGROUP_NAME
RingkasanGrup iklan sedang ditambahkan atau diganti namanya, tetapi namanya digunakan oleh grup iklan lain.
Penyebab umum Membuat grup iklan baru dengan nama grup iklan yang aktif atau dijeda.
Cara menangani Catat error dan tampilkan pesan error kepada pengguna, dengan secara opsional menyarankan nama grup iklan unik atau menampilkan daftar nama yang digunakan.
Tips pencegahan T/A

AssetError

DUPLICATE_ASSET
RingkasanDua operasi dalam satu permintaan berisi operasi pembuatan untuk aset dengan data biner yang sama.
Penyebab umum Permintaan mutasi dengan operasi pembuatan duplikat yang berisi data biner yang sama.
Cara menangani Buat aset dalam permintaan terpisah, lalu tautkan ke permintaan berikutnya; atau, gunakan ID sementara dalam permintaan yang sama.
Tips pencegahan T/A

AuthenticationError

CLIENT_CUSTOMER_ID_INVALID
RingkasanID pelanggan klien bukan angka.
Penyebab umum Penggunaan ID pelanggan klien yang tidak tepat.
Cara menangani T/A
Tips pencegahan 123-456-7890 seharusnya 1234567890. Lihat Panduan memulai untuk mengetahui detailnya.
CLIENT_CUSTOMER_ID_IS_REQUIRED
RingkasanID pelanggan klien tidak ditentukan dalam 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 karena library ini menangani hal ini 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 awal, lalu coba lagi setiap 30 detik.
Tips pencegahan Tunggu beberapa menit setelah akun dibuat sebelum mengajukan permintaan terhadap akun tersebut.
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, baca dokumentasinya tentang cara memperbarui 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 terkait dengan akun Google yang tidak mengaktifkan Google Ads.
Cara menangani Pastikan 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 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
RingkasanToken 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. Terkadang membingungkan dengan token refresh dan kode otorisasi. Jika Anda ingin mendapatkan kredensial yang dapat mengakses semua akun klien dalam akun pengelola, pastikan Anda mendapatkan token refresh untuk akun pengelola. Untuk mengetahui detail selengkapnya, lihat panduan 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 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 bahwa Anda ingin mengakses akun non-pengujian. Jika demikian, Anda perlu 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 dapat dikaitkan dengan token developer hanya dari satu akun pengelola. Setelah Anda membuat permintaan Google Ads API, token developer akan disambungkan secara permanen dengan project Konsol API Google. Jika tidak menggunakan project Konsol API Google yang baru, Anda akan mendapatkan error DEVELOPER_TOKEN_PROHIBITED saat membuat permintaan.
Cara menangani T/A
Tips pencegahan Jika beralih ke token developer di bagian akun pengelola baru, Anda harus membuat project Konsol API Google baru untuk permintaan Google Ads API yang menggunakan token pengelola baru tersebut.
USER_PERMISSION_DENIED
RingkasanPelanggan 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 menangani T/A
Tips pencegahan Tentukan login-customer-id sebagai ID akun pengelola tanpa tanda hubung (-). Library klien telah menyediakan dukungan untuk hal ini.

BiddingError

BID_TOO_MANY_FRACTIONAL_DIGITS
RingkasanNilai bid bukan kelipatan persis dari unit minimum mata uang akun. Misalnya, Rp20.500 (15000 dalam mikro) bukan bid yang valid.
Penyebab umum T/A
Cara menangani T/A
Tips pencegahan Verifikasi bahwa bid adalah kelipatan dari unit minimum untuk mata uang akun.
BID_TOO_BIG
RingkasanError akan ditampilkan meskipun bid sudah sesuai dengan anggaran kampanye.
Penyebab umum T/A
Cara menangani T/A
Tips pencegahan Periksa apakah akun berpartisipasi dalam Google Ad Grants. Jika demikian, batasi bid CPC ke batas maksimum yang ditentukan oleh program.

CampaignBudgetError

MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC
RingkasanJumlah anggaran terlalu kecil.
Penyebab umum T/A
Cara menangani T/A
Tips pencegahan Pastikan jumlah anggaran lebih besar dari atau sama dengan unit minimum untuk mata uang akun.
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT
RingkasanJumlah anggaran akan memiliki terlalu banyak angka desimal yang signifikan saat dikonversi dari jumlah mikro ke jumlah dalam mata uang akun.
Penyebab umum T/A
Cara menangani T/A
Tips pencegahan Verifikasi bahwa jumlah anggaran habis dibagi dengan unit minimum untuk mata uang akun.

CampaignError

DUPLICATE_CAMPAIGN_NAME
RingkasanSebuah 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 yang sudah ada.
Cara menangani Catat error dan tampilkan pesan error kepada pengguna, secara opsional sarankan nama kampanye unik atau tampilkan daftar nama yang digunakan.
Tips pencegahan T/A

CriterionError

KEYWORD_HAS_INVALID_CHARS
RingkasanMenambahkan atau mengedit kata kunci yang berisi karakter yang tidak valid.
Penyebab umum Gunakan karakter khusus seperti ! @ % * di kata kunci.
Cara menangani T/A
Tips pencegahan Pastikan Anda tidak menggunakan karakter yang tidak diizinkan dalam kata kunci. Lihat Menambahkan kata kunci.

DistinctError

DUPLICATE_ELEMENT
RingkasanPermintaan berisi dua parameter yang identik dan redundan.
Penyebab umum T/A
Cara menangani T/A
Tips pencegahan Menghapus duplikat (operasi, parameter, elemen daftar) sebelum membuat permintaan. Cari kolom yang memiliki batasan DistinctElements.

InternalError

DEADLINE_EXCEEDED
RingkasanWaktu permintaan habis dan tidak dapat diselesaikan dengan cukup cepat untuk menampilkan tanggapan.
Penyebab umum Terbuatnya permintaan penelusuran 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 masih berlanjut, coba bagi permintaan tersebut menjadi beberapa permintaan yang lebih kecil dan dapat diselesaikan lebih cepat.
Tips pencegahan Tinjau Segmentasi untuk memahami pengaruhnya terhadap ukuran respons. Perhatikan batasan lapisan transportasi gRPC.
INTERNAL_ERROR
RingkasanTerjadi error tak terduga saat memproses permintaan.
Penyebab umum API tidak berfungsi dengan benar karena bug.
Cara menangani Coba lagi permintaan yang gagal dengan error ini, menggunakan jadwal backoff eksponensial untuk percobaan ulang.
Tips pencegahan T/A
TRANSIENT_ERROR
RingkasanTerjadi 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 yang gagal dengan error ini, menggunakan jadwal backoff eksponensial untuk percobaan ulang.
Tips pencegahan T/A

InvalidGrantError

invalid_grant (malformed auth code)
RingkasanFormat kode otorisasi yang ditukar dengan token OAuth salah.
Penyebab umum Hal ini terjadi saat mencoba membuat token refresh untuk pengguna yang sudah 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 Untuk membuat kembali token refresh bagi kombinasi otorisasi pengguna dan kredensial klien OAuth yang diberikan, cabut token refresh yang ada. Perhatikan bahwa mencabut token akan merendernya, yang tidak dapat digunakan untuk akses Google Ads API, dan membatalkan validasi token akses apa pun yang digunakan untuk membuat token refresh.
Tips pencegahan Pastikan untuk menyimpan token refresh Anda di lokasi yang aman untuk menghindari perlunya pembuatan ulang.

MutateError

RESOURCE_NOT_FOUND
RingkasanPermintaan mengacu ke resource yang tidak dapat ditemukan.
Penyebab umum Permintaan ini mencoba mengubah atau mereferensikan resource yang tidak ada atau telah dihapus. Atau, format nama resource untuk format yang diberikan salah.
Cara menangani Gunakan permintaan penelusuran untuk mengambil nama resource untuk resource yang ada sebelum mengirimkan permintaan mutasi. Tinjau 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.

NotEmptyError

EMPTY_LIST
RingkasanDaftar yang diperlukan kosong.
Penyebab umum Meneruskan daftar operasi yang kosong ke metode mutate.
Cara menangani T/A
Tips pencegahan T/A

QuotaError

RESOURCE_EXHAUSTED
RingkasanBatas frekuensi sistem telah terlampaui.
Penyebab umum T/A
Cara menangani T/A
Tips pencegahan Siapkan penundaan singkat antar-permintaan atau gabungkan lebih banyak operasi dalam lebih sedikit permintaan.

RangeError

TOO_LOW
RingkasanNilai lebih rendah dari nilai minimum yang diizinkan.
Penyebab umum Lupa menentukan ID, yang menyebabkan nilai 0 diteruskan.
Cara menangani T/A
Tips pencegahan Perhatikan setiap batasan rentang yang didokumentasikan dalam referensi API.

RequestError

INVALID_INPUT
RingkasanFormat permintaan salah.
Penyebab umum Format URL atau konten permintaan salah.
Cara menangani T/A
Tips pencegahan T/A
REQUIRED_FIELD_MISSING
RingkasanPermintaan tidak memiliki informasi yang diperlukan.
Penyebab umum Bidang wajib belum diisi saat mencoba menambahkan entitas.
Cara menangani Catat error dan tampilkan pesan error kepada pengguna. Atribut fieldPath untuk error menunjukkan kolom mana yang tidak ada.
Tips pencegahan Lihat referensi API untuk mengetahui kolom mana yang wajib diisi.

ResourceCountLimitExceededError

RESOURCE_LIMIT
RingkasanPermintaan ini mencoba membuat resource yang akan menyebabkan jumlah total resource tersebut melebihi batas yang ditentukan.
Penyebab umum Ada beberapa batasan jumlah resource yang dapat ada dalam konteks tertentu.
Cara menangani Identifikasi batas yang diderita dengan meninjau Batas sistem. Gunakan kembali fasilitas yang ada atau hapus fasilitas untuk membuat ruang bagi fasilitas baru.
Tips pencegahan Gunakan kueri penelusuran untuk memantau jumlah resource yang memiliki batasan.

StringLengthError

TOO_LONG
RingkasanString yang ditetapkan ke kolom yang ditentukan lebih panjang dari batasnya.
Penyebab umum Judul atau deskripsi untuk iklan berisi terlalu banyak teks.
Cara menangani Identifikasi batas yang dialami , ubah string yang sesuai, dan kirim ulang permintaan.
Tips pencegahan Perhatikan batas panjang string.