Yaygın Hatalar
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu sayfada, Google Ad Manager API'si tarafından döndürülen en sık karşılaşılan hatalar açıklanmaktadır. Hatalar Error.REASON biçiminde döndürülür:
EntityChildrenLimitReachedError
- Özet
- Varlık için izin verilen maksimum alt öğe sayısına ulaşıldı ve bu varlığa başka alt öğe eklenemez.
- Önerilen kullanım ipuçları
- İzin verilen maksimum alt varlık sayısına ulaşan yeni bir varlık türü oluşturun ve oluşturmaya çalıştığınız alt varlığı yeni alt öğeye ekleyin.
Örneğin, LINE_ITEM_LIMIT_FOR_ORDER_REACHED alırsanız yeni bir sipariş oluşturmanız ve oluşturmaya çalıştığınız satır öğesini bu yeni siparişe eklemeniz gerekir.
QuotaError.EXCEEDED_QUOTA
- Özet
- Saniye başına yapılan istek sayısı çok yüksek ve izin verilen sınırı aştı.
- Önerilen kullanım ipuçları
-
- Değişiklikleri yerel olarak toplayarak ve bu değişikliklerin tümünü aynı anda gerçekleştirmek için tek bir istekte bulunarak updateLineItems gibi toplu yöntemler kullanın.
- 5 saniye kadar bekleyip isteği yeniden deneyin. Bunun, isteğin başarılı olacağını garanti etmediğini unutmayın. Tekrar başarısız olursa bekleme süresini artırmayı deneyin. Bu, Ad Manager ile entegre olan ve gerçek zamanlı olarak kullanılan etkileşimli uygulamalar için önerilir.
- Ad Manager ağları için istekleri saniyede 2 veya Ad Manager 360 ağları için saniyede 8 ile sınırlayın. Bu yine de her isteğin başarılı olacağını garanti etmez, ancak bu hatayı alma sayınızı azaltmanıza yardımcı olabilir. Bu, Ad Manager ile entegre olan ve gerçek zamanlı etkileşime sahip olmayan (ör. gecelik raporlar çalıştırma) uygulamalar için önerilir.
AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK
- Özet
- Kullanıcı, zaten bir ağla ilişkilendirilmiş hesabı kullanarak test ağı oluşturmaya çalıştı.
- Genel nedenler
- Kullanıcı,
NetworkService.makeTestNetwork() adlı kişiyi aramadan önce yeni bir Google hesabı oluşturmadı.
- Önerilen kullanım ipuçları
NetworkService.makeTestNetwork() adlı kişiyi aramadan önce yepyeni bir hesap oluşturun. Daha fazla bilgi için test ağı oluşturma bölümüne bakın.
AuthenticationError.NETWORK_CODE_REQUIRED
- Özet
- Kullanıcı bir
networkCode sağlamadı. İsteğin yapılması için ağ kodu gerekir.
- Genel nedenler
NetworkService.getAllNetworks() ve NetworkService.makeTestNetwork() dışındaki tüm istekler için ağ kodları gerekir.- Önerilen kullanım ipuçları
- Adresin iletildiği ağın ağ kodunu istek başlığına ekleyin. Yalnızca hesap girişinizde kullanılabilen bir ağ kodu kullanın. Kodu, hesabınızın Ad Manager web sitesinde, Yönetici > Ağ Ayarları sayfasında "Ağ kodu"nun yanında bulabilirsiniz. Ağ kodunuzu ayarlama hakkında daha fazla bilgiyi SOAP XML isteği ve yanıt başlıkları sayfasında bulabilirsiniz.
AuthenticationError.NETWORK_NOT_FOUND
- Özet
- Yapılandırmada sağlanan ağ kodu sunucuda bulunamadığından istek gerçekleştirilemedi.
- Genel nedenler
- Yapılandırmanızda yanlış bir ağ kodu belirttiniz.
- Önerilen kullanım ipuçları
- Hata günlüğündeki "tetikleyici" alanı genellikle kullanıcıya doğru ağı önerir.
AuthenticationError.NO_NETWORKS_TO_ACCESS
- Özet
- Kullanıcı herhangi bir ağla ilişkili değil.
- Genel nedenler
- Üretim hesabınızda API erişimini etkinleştirmediniz.
- Önerilen kullanım ipuçları
- Üretim ortamınıza API erişimini etkinleştirin. Daha fazla bilgi için API Erişimini Etkinleştirme sayfasına bakın.
AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS
- Özet
- Müşteri, API erişimi için izin verilenler listesine eklenmemiş.
- Genel nedenler
- Ağınız üretim için beyaz listeye eklenmemiştir ancak SOAP başlığında bir ağ kodu sağlamışsınızdır.
-
- Önerilen kullanım ipuçları
- API erişimini etkinleştirin.
-
PermissionError.PERMISSION_DENIED
- Özet
- Kullanıcı, istek için gerekli izne sahip değil.
- Genel nedenler
-
- Başka bir ağda bulunan bir nesneye erişmeye çalıştınız.
- Ağınızda bulunan bir nesneye erişmeye çalıştınız ancak okuma veya güncelleme izniniz yok.
- Hesabınızda ek bir özelliğin etkinleştirilmesini gerektiren bir görev gerçekleştirmeye çalıştınız.
- Önerilen kullanım ipuçları
-
- Kullanıcı arayüzü oluşturuyorsanız kullanıcıya bu işlemi gerçekleştirme ve Yöneticisiyle konuşma izni olmadığını belirtin.
- Ağınızın yapma iznine sahip olmadığı yalnızca premium bir özellik içeren bir görev gerçekleştirmeye çalıştıysanız bu özelliğin etkinleştirilmesi konusunda hesap yöneticinizle görüşün.
- Test ağlarının varsayılan olarak Ad Manager 360 ağları olmadığını, yani Ad Manager 360 ağlarında bulunan premium özelliklere sahip olmadığını unutmayın. Test ağınızdaki özellikleri etkinleştirmek için hesap yöneticinizle görüşün.
ApiVersionError.UPDATE_TO_NEWER_VERSION
- Özet
- Uygulama, başarılı olması için daha yeni bir sürüm gerektiren bir istek başlattı ya da kullanımdan kaldırılmış bir sürüme istek başlattı.
- Genel nedenler
-
- API çağrısı sürümü kullanımdan kaldırıldı. Desteği sonlandırma duyuruları için lütfen blogumuza abone olun.
- Yaptığınız isteğin başarılı olması için API'nin daha yeni bir sürümü gerekiyor.
Bu durum genellikle, kullanıcı arayüzünde bir özelliğin kullanıma sunulduğu ve API'nin nesneyi doğru şekilde gönderebilmesi için API'nin daha yeni bir sürümüne ihtiyaç duyması anlamına gelir.
- Önerilen kullanım ipuçları
-
- API sürümleriyle ilgili son gelişmelerden haberdar olun; düzenli olarak yeni sürüme geçmeyi planlayın.
- Kullanımdan kaldırma işlemleri hakkında bildirim almak için blogumuza abone olun.
404 Hatası
- Özet
- İsteğiniz sunucuya ulaşmadı.
- Genel nedenler
- İnternet bağlantınız veya proxy'niz yanlış yapılandırılmış olabilir. Çağırdığınız API'nin sürümü de kullanımdan kaldırılmış olabilir.
-
- Önerilen kullanım ipuçları
- İnternet veya proxy yapılandırmanızı kontrol edin ve API'nin güncel bir sürümünü kullandığınızdan emin olun. Ayrıca, istemci kitaplığınızı en yeni sürüme geçirmek isteyebilirsiniz.
-
- Korunmayla ilgili ipuçları
- En son Ad Manager API haberlerini takip etmek için Ad Manager API forumuna abone olun ve blogumuzu kontrol edin.
Düzenleme Kaldırma Hatası
- Özet
- İsteğinizdeki SOAP XML, WSDL spesifikasyonuna
uygun değildi.
- Genel nedenler
- İstek, WSDL spesifikasyonunda yer almayan ya da yanlış ad alanında bulunan alanlar ya da varlıklar içeriyor.
-
- İstekte bir tür uyuşmazlığı vardır (ör. bir tam sayı alanında dize değeri vardır).
-
- Önerilen kullanım ipuçları
- İsteğinizin WSDL spesifikasyonuna uygun olduğundan emin olun.
-
- Geçerli SOAP oluşturmak için istemci kitaplığı kullanın ve bunu karşılaştırma için kullanın. Tüm istemci kitaplıkları SOAP istekleri ve yanıtlarının günlüğe kaydedilmesini destekler.
-
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-21 UTC.
[null,null,["Son güncelleme tarihi: 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:"]]
