Yaygın Hatalar

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:

Varlık sınırı hataları

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.

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 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.

Kimlik doğrulama hataları

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.

İzin hataları

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.

Sürüm hataları

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.