Kesalahan Umum
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Halaman ini menjelaskan error yang paling sering terjadi, yang ditampilkan oleh Google Ad Manager API. Error ditampilkan dalam format
Error.REASON:
EntityChildrenLimitReachedError
- Ringkasan
- Jumlah maksimum turunan yang diizinkan telah tercapai untuk entitas dan tidak ada lagi turunan yang dapat ditambahkan ke entitas tersebut.
- Tips penanganan yang direkomendasikan
- Buat jenis entitas baru yang telah mencapai jumlah turunan maksimum yang diizinkan, lalu tambahkan entitas turunan yang ingin Anda buat ke entitas baru.
Misalnya, jika Anda menerima LINE_ITEM_LIMIT_FOR_ORDER_REACHED,
Anda harus membuat pesanan baru dan menambahkan item baris yang Anda coba
buat ke pesanan baru tersebut.
QuotaError.EXCEEDED_QUOTA
- Ringkasan
- Jumlah permintaan yang dibuat per detik terlalu tinggi dan telah melampaui
batas yang diizinkan.
- Tips penanganan yang direkomendasikan
-
- Gunakan metode batch, seperti updateLineItems dengan
mengumpulkan perubahan secara lokal dan membuat satu permintaan untuk memenuhi perubahan tersebut
sekaligus.
- Tunggu sekitar 5 detik, lalu coba lagi permintaan tersebut. Perhatikan bahwa hal ini
tidak menjamin permintaan akan berhasil. Jika gagal lagi, coba tingkatkan
waktu tunggu. Hal ini direkomendasikan untuk aplikasi interaktif yang terintegrasi dengan Ad
Manager yang digunakan secara real time.
- Batasi permintaan ke 2 per detik untuk jaringan Ad Manager, atau 8 per
detik untuk jaringan Ad Manager 360. Sekali lagi, hal ini tidak menjamin bahwa setiap permintaan akan berhasil, tetapi dapat membantu mengurangi berapa kali Anda menerima error ini. Hal ini direkomendasikan untuk aplikasi yang terintegrasi dengan Ad Manager
yang tidak memiliki interaksi real-time, seperti menjalankan laporan setiap malam.
AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK
- Ringkasan
- Pengguna mencoba membuat jaringan pengujian menggunakan akun yang sudah
dikaitkan dengan jaringan.
- Penyebab umum
- Pengguna tidak membuat Akun Google baru terlebih dahulu sebelum memanggil
NetworkService.makeTestNetwork().
- Tips penanganan yang direkomendasikan
- Buat akun baru sebelum memanggil
NetworkService.makeTestNetwork(). Lihat cara membuat jaringan pengujian untuk mengetahui informasi selengkapnya.
AuthenticationError.NETWORK_CODE_REQUIRED
- Ringkasan
- Pengguna tidak memberikan
networkCode. Untuk membuat permintaan,
diperlukan kode jaringan.
- Penyebab umum
- Kode jaringan diperlukan untuk semua permintaan kecuali
NetworkService.getAllNetworks() dan
NetworkService.makeTestNetwork().
- Tips penanganan yang direkomendasikan
- Sertakan kode jaringan yang sedang ditangani dalam header
permintaan. Hanya gunakan kode jaringan yang tersedia untuk login akun Anda. Anda dapat menemukan
kode di situs Ad Manager untuk akun Anda, di halaman Admin > Setelan
Jaringan di samping "Kode jaringan". Informasi selengkapnya tentang menyetel
kode jaringan dapat ditemukan di halaman header respons dan
permintaan XML SOAP.
AuthenticationError.NETWORK_NOT_FOUND
- Ringkasan
- Permintaan tidak dapat dibuat karena kode jaringan yang disediakan dalam
konfigurasi tidak ditemukan di server.
- Penyebab umum
- Anda telah menetapkan kode jaringan yang salah dalam konfigurasi.
- Tips penanganan yang direkomendasikan
- Kolom "pemicu" di log error sering kali menyarankan jaringan yang tepat untuk pengguna.
AuthenticationError.NO_NETWORKS_TO_ACCESS
- Ringkasan
- Pengguna tidak terkait dengan jaringan apa pun.
- Penyebab umum
- Anda belum mengaktifkan akun produksi untuk akses API.
- Tips penanganan yang direkomendasikan
- Aktifkan akses API ke lingkungan produksi Anda. Lihat Mengaktifkan Akses API untuk mengetahui informasinya.
AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS
- Ringkasan
- Pelanggan tidak diizinkan untuk mengakses API.
- Penyebab umum
- Jaringan Anda tidak diizinkan untuk produksi, tetapi Anda memberikan kode jaringan di Header SOAP.
-
- Tips penanganan yang direkomendasikan
- Aktifkan akses API.
-
PermissionError.PERMISSION_DENIED
- Ringkasan
- Pengguna tidak memiliki izin yang diperlukan untuk permintaan.
- Penyebab umum
-
- Anda mencoba mengakses objek yang ada di jaringan lain.
- Anda mencoba mengakses objek yang ada di jaringan, tetapi Anda tidak memiliki izin untuk membaca atau mengupdate.
- Anda telah mencoba melakukan tugas yang memerlukan fitur tambahan untuk diaktifkan di akun Anda.
- Tips penanganan yang direkomendasikan
-
- Jika Anda membuat UI, tunjukkan kepada pengguna bahwa mereka tidak memiliki
izin untuk melakukan tindakan ini dan untuk berbicara dengan
Administratornya.
- Jika Anda mencoba melakukan tugas, seperti yang melibatkan fitur khusus premium
yang izin aksesnya tidak dimiliki jaringan Anda, hubungi
Account Manager Anda untuk mengaktifkan fitur ini.
- Ingat, secara default jaringan pengujian bukan jaringan Ad Manager 360,
yang berarti jaringan tersebut tidak memiliki fitur premium yang ada di jaringan
Ad Manager 360. Hubungi Account Manager Anda untuk mengaktifkan fitur di jaringan pengujian Anda.
ApiVersionError.UPDATE_TO_NEWER_VERSION
- Ringkasan
- Aplikasi: memulai permintaan yang memerlukan versi yang lebih baru
agar berhasil; atau memulai permintaan ke versi yang tidak digunakan lagi.
- Penyebab umum
-
- Versi panggilan API sudah tidak digunakan lagi. Anda dapat berlangganan blog kami untuk mendapatkan pengumuman penghentian penggunaan.
- Permintaan yang Anda buat memerlukan versi API yang lebih baru agar berhasil.
Hal ini sering kali terjadi saat fitur diperkenalkan di UI
dan agar API dapat mengirim objek dengan benar, API memerlukan
versi API yang lebih baru.
- Tips penanganan yang direkomendasikan
-
- Dapatkan info terbaru tentang versi API; rencanakan upgrade secara berkala.
- Berlangganan blog kami untuk mendapatkan notifikasi tentang penghentian penggunaan.
Kesalahan 404
- Ringkasan
- Permintaan Anda tidak sampai ke server.
- Penyebab umum
- Koneksi internet atau proxy Anda mungkin salah dikonfigurasi. Versi
API yang Anda panggil juga dapat dihentikan.
-
- Tips penanganan yang direkomendasikan
- Periksa konfigurasi internet atau proxy Anda, dan pastikan Anda menggunakan
API versi terbaru. Anda mungkin juga perlu mengupgrade library klien ke versi terbaru.
-
- Tips pencegahan
- Berlanggananlah ke forum Ad Manager API dan lihat blog kami untuk terus mendapatkan berita terbaru mengenai Ad Manager API.
Kesalahan Unmarshalling
- Ringkasan
- XML SOAP dalam permintaan Anda tidak sesuai dengan spesifikasi WSDL.
- Penyebab umum
- Permintaan berisi kolom atau entitas yang tidak disertakan dalam spesifikasi WSDL, atau dalam namespace yang salah.
-
- Ada ketidakcocokan jenis dalam permintaan (misalnya kolom bilangan bulat memiliki nilai string).
-
- Tips penanganan yang direkomendasikan
- Pastikan permintaan Anda sesuai dengan spesifikasi WSDL.
-
- Gunakan library klien untuk membuat
SOAP yang valid, dan gunakan ini sebagai perbandingan. Semua library klien mendukung logging permintaan dan respons SOAP.
-
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-21 UTC.
[null,null,["Terakhir diperbarui pada 2025-08-21 UTC."],[[["\u003cp\u003eThis page lists common Google Ad Manager API errors and offers troubleshooting tips.\u003c/p\u003e\n"],["\u003cp\u003eErrors are categorized by type, such as authentication, permission, and quota errors.\u003c/p\u003e\n"],["\u003cp\u003eEach error description includes a summary, common causes, and recommended handling tips.\u003c/p\u003e\n"],["\u003cp\u003eUsers are encouraged to stay updated on API versions and subscribe to the Ad Manager API forum and blog for the latest news.\u003c/p\u003e\n"],["\u003cp\u003eUtilizing client libraries for generating valid SOAP requests is recommended to avoid unmarshalling errors.\u003c/p\u003e\n"]]],[],null,["# Common Errors\n\nThis page describes the most frequently encountered errors returned by the\nGoogle Ad Manager API. Errors are returned in the format\n`Error.REASON`:\n\n- [`EntityChildrenLimitReachedError`](#EntityChildrenLimitReachedError)\n- [`QuotaError.EXCEEDED_QUOTA`](#QuotaError.EXCEEDED_QUOTA)\n- [`AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK`](#AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK)\n- [`AuthenticationError.NETWORK_CODE_REQUIRED`](#AuthenticationError.NETWORK_CODE_REQUIRED)\n- [`AuthenticationError.NETWORK_NOT_FOUND`](#AuthenticationError.NETWORK_NOT_FOUND)\n- [`AuthenticationError.NO_NETWORKS_TO_ACCESS`](#AuthenticationError.NO_NETWORKS_TO_ACCESS)\n- [`AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS`](#AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS)\n- [`PermissionError.PERMISSION_DENIED`](#PermissionError.PERMISSION_DENIED)\n- [`ApiVersionError.UPDATE_TO_NEWER_VERSION`](#ApiVersionError.UPDATE_TO_NEWER_VERSION)\n- [404 Error](#404Error)\n- [Unmarshalling Errors](#Unmarshalling)\n\n[Entity limit errors](/ad-manager/api/reference/latest/LineItemService.EntityChildrenLimitReachedError)\n-------------------------------------------------------------------------------------------------------\n\n### `EntityChildrenLimitReachedError`\n\nSummary\n: The maximum number of allowed children has been reached for the entity\n and no more children can be added to that entity.\n\nRecommended handling tips\n: Create a new type of the entity that has reached the max allowed number\n of children and add the child entity you are trying to create to the new one.\n For example if you receive [LINE_ITEM_LIMIT_FOR_ORDER_REACHED](/ad-manager/api/reference/latest/LineItemService.EntityChildrenLimitReachedError.Reason#LINE_ITEM_LIMIT_FOR_ORDER_REACHED),\n then you will need to create a new order and add the line item you are trying\n to create to that new order.\n\n[Quota errors](/ad-manager/api/reference/latest/NetworkService.QuotaError)\n--------------------------------------------------------------------------\n\n### `QuotaError.EXCEEDED_QUOTA`\n\nSummary\n: The number of requests made per second is too high and has exceeded the\n allowable limit.\n\nRecommended handling tips\n:\n - Use batch methods such as [updateLineItems](/ad-manager/api/reference/latest/LineItemService#updateLineItems) by gathering changes locally and making a single request to fulfill those changes all at once.\n - Wait about 5 seconds and then retry the request. Note that this does not guarantee the request will succeed. If it fails again, try increasing the wait time. This is recommended for interactive applications integrating with Ad Manager that are used in real time.\n - Limit requests to 2 per second for Ad Manager networks, or 8 per second for Ad Manager 360 networks. Once again this does not guarantee that every request will succeed, but may help reduce the number of times you receive this error. This is recommended for applications integrating with Ad Manager that do not have real time interaction, such as running nightly reports.\n\n[Authentication errors](/ad-manager/api/reference/latest/NetworkService.AuthenticationError)\n--------------------------------------------------------------------------------------------\n\n### `AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK`\n\nSummary\n: The user tried to create a test network using an account that already is\n associated with a network.\n\nCommon causes\n: The user did not create a new Google account first before calling\n `NetworkService.makeTestNetwork()`.\n\nRecommended handling tips\n: Create a brand new account before calling\n `NetworkService.makeTestNetwork()`. See [how to create a test network](/ad-manager/api/start#enable_api) for more\n information.\n\n### `AuthenticationError.NETWORK_CODE_REQUIRED`\n\nSummary\n: The user did not provide a `networkCode`. To make the request,\n a network code is required.\n\nCommon causes\n: Network codes are required for all requests except\n `NetworkService.getAllNetworks()` and\n `NetworkService.makeTestNetwork()`.\n\nRecommended handling tips\n: Include the network code of the network being addressed in the request\n header. Only use a network code available to your account login. You can find\n the code on the Ad Manager website for your account, on the Admin \\\u003e Network\n Settings page next to \"Network code\". More information about setting your\n network code can be found on the [SOAP XML request and\n response headers](/ad-manager/api/soap_xml) page.\n\n### `AuthenticationError.NETWORK_NOT_FOUND`\n\nSummary\n: The request could not be made because the network code provided in the\n configuration is not found on the server.\n\nCommon causes\n: You have specified an incorrect network code in your configuration.\n\nRecommended handling tips\n: The \"trigger\" field of the error log will often suggest the correct\n network for the user.\n\n### `AuthenticationError.NO_NETWORKS_TO_ACCESS`\n\nSummary\n: The user is not associated with any network.\n\nCommon causes\n: You have not enabled your production account for API access.\n\nRecommended handling tips\n: Enable API access to your production environment. See [Enabling API Access](/ad-manager/api/start#enable_api) for information.\n\n### `AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS`\n\nSummary\n: The customer is not whitelisted for API access.\n\nCommon causes\n: Your network is not whitelisted for production, but you provided a [network code](/ad-manager/api/soap_xml) in the SOAP Header.\n:\n\nRecommended handling tips\n: Enable [API access](/ad-manager/api/start#enable_api).\n:\n\n[Permission errors](/ad-manager/api/reference/latest/NetworkService.PermissionError)\n------------------------------------------------------------------------------------\n\n### `PermissionError.PERMISSION_DENIED`\n\nSummary\n: The user does not have the required permission for the request.\n\nCommon causes\n:\n - You tried to access an object that exists in another network.\n - You tried to access an object that exists in your network, but you don't have permission to read or update.\n - You tried to perform a task that requires an additional feature to enabled on your account.\n\nRecommended handling tips\n:\n - If you are creating a UI, indicate to the user that they did not have permission to perform this action and to speak to their Administrator.\n - If you tried performing a task, such as one involving a premium-only feature that your network does not have permission to do, speak to your account manager about enabling this feature.\n - Remember, test networks are, by default, not Ad Manager 360 networks, meaning that they do not have the premium features found in Ad Manager 360 networks. Speak to your account manager to enable features on your test network.\n\n[Version errors](/ad-manager/api/reference/latest/NetworkService.ApiVersionError)\n---------------------------------------------------------------------------------\n\n### `ApiVersionError.UPDATE_TO_NEWER_VERSION`\n\nSummary\n: The application either: initiated a request that requires a newer version\n to succeed; or initiated a request to a deprecated version.\n\nCommon causes\n:\n - The version of the API call has been deprecated. Please subscribe to our [blog](//ads-developers.googleblog.com/search/label/ad_manager_api) for deprecation announcements.\n - The request you made requires a newer version of the API to succeed. This is often the case where a feature has been introduced in the UI and in order for the API to send the object correctly, it needs a newer version of the API.\n\nRecommended handling tips\n:\n - Stay up to date on API versions; plan on upgrading regularly.\n - Subscribe to our [blog](//ads-developers.googleblog.com/search/label/ad_manager_api) to be notified about deprecations.\n\n404 Error\n---------\n\nSummary\n: Your request did not reach the server.\n\nCommon causes\n: Your internet connection or proxy may be misconfigured. The version of\n the API you are calling may also be sunsetted.\n:\n\nRecommended handling tips\n: Check your internet or proxy configuration and make sure you are using a\n recent version of the API. You may want to upgrade your client library to\n the most recent version as well.\n:\n\nPrevention tips\n: Subscribe to the [Ad\n Manager API forum](//groups.google.com/group/google-doubleclick-for-publishers-api) and check our [blog](//ads-developers.googleblog.com/search/label/ad_manager_api)\n to stay updated on the latest Ad Manager API news.\n\nUnmarshalling Error\n-------------------\n\nSummary\n: The SOAP XML in your request did not conform to the WSDL\n specification.\n\nCommon causes\n: The request contains fields or entities not included in the WSDL\n specification, or in the wrong namespace.\n:\n: There is a type mismatch in the request (e.g., an integer field has a\n string value).\n:\n\nRecommended handling tips\n: Ensure that your request conforms to the WSDL specification.\n:\n: Use a [client library](/ad-manager/api/clients) to generate\n valid SOAP, and use this for comparison. All client libraries support\n logging of SOAP requests and responses.\n:"]]
