Error yang biasa terjadi

Halaman ini mencantumkan error umum serta memberikan tips untuk mencegah dan menanganinya. Untuk mengetahui daftar lengkap error, tinjau referensi error, panduan Memahami error API, atau panduan Jenis error. Untuk mendapatkan bantuan lebih lanjut, hubungi dukungan 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. Alasan umum terjadinya 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 terperinci.

google.auth.exceptions.RefreshError

invalid_grant

Ringkasan Masa berlaku token telah habis 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 akan habis masa berlakunya dalam 7 hari. Cara menangani Status publikasi project Google Anda adalah Testing sehingga masa berlaku token refresh akan 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 agar masa berlaku token refresh tidak berakhir dalam 7 hari. Tips pencegahan Lihat Aplikasi yang belum diverifikasi.

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR	Ringkasan 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 ingin mengubah iklan, Anda harus membuat iklan baru, lalu menghapus iklan 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 Tentang iklan teks. Penyebab umum Memiliki baris teks yang terlalu panjang. Cara menangani T/A Tips pencegahan Validasi panjang baris sebelum membuat permintaan API.

AdGroupAdError
AD_GROUP_AD_LABEL_ALREADY_EXISTS	Ringkasan Label ini sudah dikaitkan dengan beberapa iklan. Penyebab umum Mencoba mengaitkan label dengan iklan yang sudah dikaitkan. Cara menangani T/A Tips pencegahan Periksa terlebih dahulu apakah label yang akan ditambahkan sudah dikaitkan dengan iklan.
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD	Ringkasan Operasi mencoba memperbarui iklan yang dihapus. Penyebab umum Setelah dihapus, iklan tidak dapat diperbarui lagi, termasuk perubahan pada statusnya. Cara menangani T/A Tips pencegahan Pastikan kode Anda tidak mencoba memperbarui iklan yang dihapus.

AdGroupCriterionError
INVALID_KEYWORD_TEXT	Ringkasan Teks 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 Validasi teks kata kunci di aplikasi Anda sebelum membuat permintaan ke API.

AdGroupError

DUPLICATE_ADGROUP_NAME

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

AssetError
DUPLICATE_ASSET	Ringkasan Dua operasi dalam satu permintaan berisi operasi pembuatan untuk aset dengan data biner yang sama. Penyebab umum Permintaan modifikasi dengan operasi pembuatan duplikat yang berisi data biner yang sama. Cara menangani Buat aset dalam permintaan terpisah, lalu tautkan ke aset tersebut dalam permintaan berikutnya; atau, gunakan ID sementara dalam permintaan yang sama. Tips pencegahan T/A
PARTNER_PROMOTION_ID_TYPE_INCOMPATIBLE	Ringkasan ID promosi partner menggunakan varian oneof (int_value atau string_value) yang tidak diterima oleh integrasi promosi akun. Penyebab umum Menetapkan kolom promotion_asset.external_redeem_info.partner_promotion_id.int_value saat integrasi penukaran pelanggan memerlukan varian string_value, atau menetapkan kolom string_value saat integrasi memerlukan varian int_value. Cara menangani Perbarui permintaan pembuatan untuk mengisi varian ExternalPartnerId (int_value atau string_value) yang diterima oleh integrasi promosi akun. Lihat Melacak penukaran promosi eksternal untuk mengetahui detailnya. Tips pencegahan Konfirmasi format ID promosi (int_value atau string_value) yang digunakan integrasi penukaran di tempat penjualan (POS) Anda sebelum membuat pesan PromotionAsset dengan kolom external_redeem_info.

AuthenticationError
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 berupa 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. Pertimbangkan untuk menggunakan library klien kami karena library tersebut akan 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 tersebut dibuat di backend. Cara menangani Tunggu lima menit pertama, lalu coba lagi setiap 30 detik. Tips pencegahan Tunggu beberapa menit setelah akun dibuat sebelum mengeluarkan 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 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	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. Token akses 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.

AuthorizationError
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). (Di API versi v24 dan yang lebih lama, kondisi ini menampilkan AuthorizationError.ACTION_NOT_PERMITTED.) Cara menangani Jika Anda 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, Basic, atau Standard. Tips pencegahan T/A
CUSTOMER_NOT_ENABLED	Ringkasan Akun 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.
USER_PERMISSION_DENIED	Ringkasan Pelanggan yang diberi otorisasi tidak memiliki akses ke pelanggan yang beroperasi. Penyebab umum Melakukan autentikasi 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.

BiddingError
BID_TOO_MANY_FRACTIONAL_DIGITS	Ringkasan Nilai bid bukan kelipatan persis dari unit minimum mata uang akun. Misalnya, US$ 0,015 (15000 dalam mikro) bukan bid yang valid. Penyebab umum T/A Cara menangani T/A Tips pencegahan Pastikan bid adalah kelipatan dari unit minimum untuk mata uang akun.
BID_TOO_BIG	Ringkasan Error ditampilkan meskipun bid berada dalam anggaran kampanye. Penyebab umum T/A Cara menangani T/A Tips pencegahan Periksa apakah akun tersebut berpartisipasi dalam Google Ad Grants. Jika demikian, batasi bid CPC ke jumlah maksimum yang ditentukan oleh program.

CampaignBudgetError
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC	Ringkasan Jumlah 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	Ringkasan Jumlah 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 Pastikan jumlah anggaran dapat dibagi dengan unit minimum untuk mata uang akun.

CampaignError
DUPLICATE_CAMPAIGN_NAME	Ringkasan Kampanye sedang ditambahkan atau diganti namanya, tetapi nama tersebut sudah digunakan oleh kampanye lain. Penyebab umum Membuat kampanye baru dengan nama kampanye aktif atau dijeda yang sudah ada. Cara menangani Catat error dan tampilkan pesan error kepada pengguna, dengan opsi menyarankan nama kampanye yang unik atau menampilkan daftar nama yang sedang digunakan. Tips pencegahan T/A
CANNOT_SET_CAMPAIGN_KEYWORD_MATCH_TYPE	Ringkasan Mencoba mengubah setelan jenis pencocokan kata kunci tingkat kampanye di kampanye yang mengaktifkan AI Maksimal. Penyebab umum Jika AI Maksimal diaktifkan, setelan pencocokan luas tingkat kampanye tidak digunakan lagi karena semua kata kunci diperlakukan sebagai pencocokan luas secara default. Upaya untuk menetapkan atau mengubah kolom ini akan memicu error. Cara menangani Advise the user to use the ad group level `disable_search_term_matching` parameter instead of setting broad match at the campaign level. Tips pencegahan Hindari menetapkan `keyword_match_type` ke `BROAD` (atau nilai lainnya) di kampanye jika `ai_max_setting.enable_ai_max` ditetapkan ke `true`. Aktifkan/nonaktifkan pencocokan istilah penelusuran di tingkat grup iklan menggunakan `disable_search_term_matching`.

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

DemandGenCampaignError

CANNOT_ACTIVATE_MIGRATED_CAMPAIGN

Ringkasan Kampanye Peningkat Permintaan yang dimigrasikan tidak dapat diaktifkan sebelum kampanye asli dihapus, atau saat kampanye lain yang dimigrasikan untuk kampanye asli yang sama sudah aktif. Penyebab umum Memperbarui status kampanye Peningkat Permintaan yang dimigrasikan ke ENABLED jika kampanye sumber asli tidak dihapus atau kampanye Peningkat Permintaan lain yang dimigrasikan dari kampanye asli yang sama sudah ENABLED. Di API versi v25 dan yang lebih lama, kondisi ini menampilkan RequestError.UNKNOWN. Cara menangani Hapus kampanye sumber asli menggunakan CampaignOperation.remove (sebelumnya atau dalam permintaan mutasi yang sama) sebelum mengaktifkan kampanye Peningkat Permintaan yang dimigrasikan, dan pastikan tidak ada kampanye Peningkat Permintaan lain yang dimigrasikan dari kampanye asli yang sama yang aktif. Lihat Mengaktifkan kampanye yang dimigrasikan untuk mengetahui detailnya. Tips pencegahan Jika Anda melacak ID kampanye sumber asli dan kampanye Peningkat Permintaan yang dimigrasikan, buat kueri campaign.status sebelum menetapkan status ke ENABLED di kampanye yang dimigrasikan, atau sertakan CampaignOperation.remove untuk kampanye asli dalam permintaan modifikasi yang sama.

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

InternalError
DEADLINE_EXCEEDED	Ringkasan Waktu permintaan habis dan tidak dapat diselesaikan dengan cukup cepat untuk menampilkan respons. Penyebab umum Permintaan penelusuran yang dibuat menghasilkan respons yang terlalu besar, atau permintaan modifikasi terlalu besar untuk diproses. Cara menangani Tunggu sekitar 30 detik, lalu coba lagi permintaan tersebut. Jika error berlanjut, coba bagi permintaan menjadi beberapa permintaan yang lebih kecil yang dapat diselesaikan lebih cepat. Tips pencegahan Tinjau Segmentasi untuk memahami pengaruhnya terhadap ukuran respons. Perhatikan batasan lapisan transport gRPC.
INTERNAL_ERROR	Ringkasan Terjadi error tidak 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	Ringkasan Terjadi error internal sementara, dan percobaan ulang harus dilakukan. Penyebab umum Error ini terjadi saat API mengalami masalah sementara secara internal. 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)

Ringkasan Kode otorisasi yang ditukarkan dengan token OAuth memiliki format yang 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 dan pengguna yang memberikan otorisasi yang sama. Cara menangani Untuk membuat ulang token refresh untuk kombinasi tertentu dari pengguna yang memberikan otorisasi dan kredensial klien OAuth, cabut token refresh yang ada. Perhatikan bahwa mencabut token akan membuatnya tidak dapat digunakan untuk akses Google Ads API dan membatalkan token akses apa pun yang dibuat menggunakan token refresh tersebut. Tips pencegahan Pastikan untuk menyimpan token refresh Anda di lokasi yang aman agar tidak perlu dibuat ulang.

MutateError

RESOURCE_NOT_FOUND

Ringkasan Permintaan merujuk ke resource yang tidak dapat ditemukan. Penyebab umum Permintaan tersebut berupaya mengubah atau mereferensikan resource yang tidak ada atau telah dihapus. Atau, nama resource yang diberikan untuk resource tersebut salah format. Cara menangani Gunakan permintaan penelusuran untuk mengambil nama resource untuk resource yang ada sebelum mengirimkan permintaan modifikasi. 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	Ringkasan Daftar yang wajib diisi kosong. Penyebab umum Meneruskan daftar operasi kosong ke metode mutate. Cara menangani T/A Tips pencegahan T/A

QuotaError
RESOURCE_EXHAUSTED	Ringkasan Batas frekuensi sistem telah terlampaui. Penyebab umum T/A Cara menangani T/A Tips pencegahan Siapkan penundaan singkat di antara permintaan atau gabungkan lebih banyak operasi dalam lebih sedikit permintaan.

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

RequestError
INVALID_INPUT	Ringkasan Permintaan salah format. Penyebab umum URL atau konten permintaan salah format. Cara menangani T/A Tips pencegahan T/A
REQUIRED_FIELD_MISSING	Ringkasan Permintaan tidak memiliki informasi yang diperlukan. Penyebab umum Kolom wajib diisi tidak ada saat mencoba menambahkan entity. Cara menangani Mencatat error ke dalam log dan menampilkan pesan error kepada pengguna. Atribut fieldPath error menunjukkan kolom mana yang tidak ada. Tips pencegahan Lihat referensi API untuk mengetahui kolom mana yang wajib diisi.

ResourceCountLimitExceededError

RESOURCE_LIMIT

Ringkasan Permintaan 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 dihadapi dengan meninjau Batas sistem. Gunakan kembali resource yang ada, atau hapus resource untuk mengosongkan ruang bagi resource baru. Tips pencegahan Gunakan kueri penelusuran untuk memantau jumlah resource yang memiliki batasan.

StringLengthError
TOO_LONG	Ringkasan String yang ditetapkan ke kolom yang ditentukan lebih panjang dari batas. Penyebab umum Judul atau deskripsi untuk iklan berisi terlalu banyak teks. Cara menangani Identifikasi batas yang dihadapi , ubah string sebagaimana mestinya, dan kirim ulang permintaan. Tips pencegahan Perhatikan batas panjang string.