Yaygın Hatalar

Bu sayfada, Google Ad Manager API'nin döndürdüğü en sık karşılaşılan hatalar açıklanmaktadır. Hatalar Error.REASON biçiminde döndürülür:

Varlık sınırı hataları

EntityChildrenLimitReachedError

Özet
İzin verilen maksimum alt öğe sayısına ulaşıldığı için öğeye başka alt öğe eklenemiyor.
Önerilen kullanım ipuçları
İzin verilen maksimum alt öğe sayısına ulaşmış yeni bir öğe türü oluşturun ve oluşturmaya çalıştığınız alt öğeyi yeni öğeye ekleyin. Örneğin, LINE_ITEM_LIMIT_FOR_ORDER_REACHED hatasını 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.

Kota hataları

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 toplayıp bu değişiklikleri tek bir istekle aynı anda yerine getirerek updateLineItems gibi toplu yöntemleri kullanın.
  • Yaklaşık 5 saniye bekleyip isteği yeniden deneyin. Bu işlemin, isteğin başarıyla sonuçlanacağını garanti etmediğini unutmayın. Yine başarısız olursa bekleme süresini artırmayı deneyin. Bu, Ad Manager ile entegre olan ve anlık olarak kullanılan etkileşimli uygulamalar için önerilir.
  • Ad Manager ağları için istekleri saniyede 2, Ad Manager 360 ağları için ise saniyede 8 ile sınırlayın. Bu işlem, her isteğin başarılı olacağını garanti etmese de bu hatayı alma sıklığınızı azaltabilir. Bu, Ad Manager ile entegre olan ve gece rapor çalıştırma gibi gerçek zamanlı etkileşimi olmayan uygulamalar için önerilir.

Kimlik doğrulama hataları

AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK

Özet
Kullanıcı, zaten bir ağla ilişkili olan bir hesabı kullanarak test ağı oluşturmaya çalıştı.
Genel nedenler
Kullanıcı, NetworkService.makeTestNetwork() işlevini çağırmadan önce yeni bir Google Hesabı oluşturmadı.
Önerilen kullanım ipuçları
Aramadan önce yeni bir hesap oluşturun NetworkService.makeTestNetwork(). Daha fazla bilgi için test ağı oluşturma başlıklı makaleyi inceleyin.

AuthenticationError.NETWORK_CODE_REQUIRED

Özet
Kullanıcı networkCode sağlamadı. İsteği göndermek için ağ kodu gerekir.
Genel nedenler
Ağ kodları, NetworkService.getAllNetworks() ve NetworkService.makeTestNetwork() dışındaki tüm istekler için gereklidir.
Önerilen kullanım ipuçları
İstek başlığında, istekte bulunulan ağın ağ kodunu 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ığı için istek gönderilemedi.
Genel nedenler
Yapılandırmanızda yanlış bir ağ kodu belirttiniz.
Önerilen kullanım ipuçları
Hata günlüğünün "tetikleyici" alanı genellikle kullanıcı için doğru ağı önerir.

AuthenticationError.NO_NETWORKS_TO_ACCESS

Özet
Kullanıcı herhangi bir ağla ilişkilendirilmemiş.
Genel nedenler
Üretim hesabınızda API erişimini etkinleştirmemişsinizdir.
Önerilen kullanım ipuçları
Üretim ortamınızda API erişimini etkinleştirin. Bilgi için API erişimini etkinleştirme başlıklı makaleyi inceleyin.

AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS

Özet
Müşteri, API erişimi için izin verilenler listesine eklenmemiştir.
Genel nedenler
Ağınız üretim için izin verilenler listesine eklenmemiş ancak SOAP üstbilgisinde bir ağ kodu sağladınız.
Önerilen kullanım ipuçları
API erişimini etkinleştirin.

İzin hataları

PermissionError.PERMISSION_DENIED

Özet
Kullanıcının istek için gerekli izni yok.
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 yapmaya ç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 izni olmadığını ve yöneticisiyle iletişime geçmesi gerektiğini belirtin.
  • Ağınızın izni olmayan, yalnızca premium abonelere sunulan bir özellik gibi bir görevi gerçekleştirmeyi denediyseniz bu özelliği etkinleştirmek için hesap yöneticinizle görüşün.
  • Test ağlarının varsayılan olarak Ad Manager 360 ağları olmadığını unutmayın. Bu nedenle, Ad Manager 360 ağlarında bulunan premium özelliklere sahip değildirler. Test ağınızda özellikleri etkinleştirmek için hesap yöneticinizle iletişime geçin.

Sürüm hataları

ApiVersionError.UPDATE_TO_NEWER_VERSION

Özet
Uygulama, başarılı olmak için daha yeni bir sürüm gerektiren bir istek başlattı veya desteği sonlandırılan bir sürüm için istek başlattı.
Genel nedenler
  • API çağrısının sürümünün desteği sonlandırıldı. Kullanımdan kaldı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 özellik kullanıma sunulduğunda ve API'nin nesneyi doğru şekilde gönderebilmesi için API'nin daha yeni bir sürümüne ihtiyaç duyduğunda ortaya çıkar.
Önerilen kullanım ipuçları
  • API sürümleriyle ilgili güncel bilgileri takip edin ve düzenli olarak yükseltme yapmayı planlayın.
  • Kullanımdan kaldırma işlemleriyle ilgili 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 yeni bir sürümünü kullandığınızdan emin olun. İstemci kitaplığınızı da en yeni sürüme yükseltmek isteyebilirsiniz.
Korunmayla ilgili ipuçları
En son Ad Manager API haberlerinden haberdar olmak için Ad Manager Yardım Topluluğu'na ve blogumuza göz atın.

Ayrıştırma Hatası

Özet
İsteğinizdeki SOAP XML, WSDL spesifikasyonuna uygun değildi.
Genel nedenler
İstek, WSDL spesifikasyonunda yer almayan veya yanlış ad alanında bulunan alanlar ya da öğeler içeriyor.
İstek türünde uyuşmazlık var (ör. bir tam sayı alanında dize değeri var).
Ö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 karşılaştırma için bunu kullanın. Tüm istemci kitaplıkları, SOAP isteklerinin ve yanıtlarının günlüğe kaydedilmesini destekler.