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ı

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

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

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

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

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

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

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

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

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

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

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