Yaygın Hatalar

Bu sayfada, Google Ad Manager API tarafından döndürülen en sık karşılaşılan hatalar açıklanmaktadır. Hatalar şu biçimde döndürülür: Error.REASON:

Varlık sınırı hataları

EntityChildrenLimitReachedError

Özet
Öğe için izin verilen maksimum alt öğe sayısına ulaşıldı ve bu öğeye daha fazla alt öğe eklenemez.
Önerilen kullanım ipuçları
İzin verilen maksimum alt öğe sayısına ulaşan öğenin yeni bir türünü 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
Saniyede 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 tüm bu değişiklikleri tek seferde yerine getirmek için tek bir istekte bulunarak updateLineItems gibi toplu yöntemleri kullanın.
  • Yaklaşık 5 saniye bekleyip isteği yeniden deneyin. Bu, isteğin başarılı olacağını garanti etmez. Yeniden 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.
  • İstekleri Ad Manager ağları için saniyede 2, Ad Manager 360 ağları için saniyede 8 ile sınırlayın. Bu da her isteğin başarılı olacağını garanti etmez ancak bu hatayı alma sıklığınızı azaltabilir. Bu, Ad Manager ile entegre olan ve gerçek zamanlı etkileşimi olmayan uygulamalar (ör. gece raporları çalıştırma) 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() yöntemini ç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 bölümüne bakın.

AuthenticationError.NETWORK_CODE_REQUIRED

Özet
Kullanıcı networkCode sağlamadı. İsteği göndermek için bir ağ kodu gerekir.
Genel nedenler
NetworkService.getAllNetworks() ve NetworkService.makeTestNetwork() hariç tüm istekler için ağ kodları gereklidir.
Önerilen kullanım ipuçları
İstek başlığında, ele alınan 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 yapılamadı.
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ızı API erişimi için etkinleştirmediniz.
Önerilen kullanım ipuçları
Üretim ortamınıza API erişimini etkinleştirin. Bilgi için API erişimini etkinleştirme başlıklı makaleye bakın.

AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS

Özet
Müşteri, API erişimi için izin verilenler listesinde değil.
Genel nedenler
Ağınız üretim için izin verilenler listesinde değil ancak SOAP başlığında 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ı, 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 ancak okuma veya güncelleme izninizin olmadığı bir nesneye erişmeye çalıştınız.
  • 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 izni olmadığını ve yöneticisiyle görüşmesi gerektiğini belirtin.
  • Ağınızın izin vermediği, yalnızca premium'a özel bir özellik içeren 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ı, yani Ad Manager 360 ağlarında bulunan premium özelliklere sahip olmadığını unutmayın. Test ağınızda ö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ı veya desteği sonlandırılmış bir sürüme istek başlattı.
Genel nedenler
  • API çağrısının sürümünün desteği sonlandırıldı. Desteğin sonlandırılmasıyla ilgili 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ü gerekir. 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ç duyulduğunda ortaya çıkar.
Önerilen kullanım ipuçları
  • API sürümlerini takip edin ve düzenli olarak yükseltme yapmayı planlayın.
  • Desteği sonlandırılan özelliklerden haberdar olmak 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. İstemci kitaplığınızı da en son sürüme yükseltmeniz gerekebilir.
Korunmayla ilgili ipuçları
Ad Manager API ile ilgili en son haberleri takip etmek için Ad Manager Yardım Topluluğu'na ve blogumuza göz atın.

Unmarshalling Hatası

Özet
İsteğinizdeki SOAP XML, WSDL spesifikasyonuna uymuyor.
Genel nedenler
İstek, WSDL spesifikasyonuna dahil edilmeyen veya yanlış ad alanında bulunan alanlar ya da öğeler içeriyor.
İstekte tür uyuşmazlığı 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 bir istemci kitaplığı kullanın ve bunu karşılaştırma için kullanın. Tüm istemci kitaplıkları, SOAP isteklerinin ve yanıtlarının günlüğe kaydedilmesini destekler.