Hatalar ve Uyarılar

Bu sayfada, karşılaşabileceğiniz farklı hata ve uyarı türleri Görüntülü Reklam Ağı ve Video 360 API.

API Hataları

API'ye yapılan ve tamamlanamayan istekler hata mesajı döndürür. Hata döndüren istekler, kullanıcı kotasından düşülür ve şuna dahil edilir: dikkate almanız gereken noktalardır. Hata yanıtları gelecekteki hataları önlemek için işlenip ele alınması gerekir.

Hata yanıtı aşağıdaki biçimdedir ve HTTP yanıt kodu içerir: bir hata mesajı ve bir Google RPC kodu durumu:

{
  "error": {
    "code": integer,
    "message": string,
    "status": enum (google.rpc.Code)
  }
}

Aşağıda, sık karşılaşılan API hatalarının bir listesi ve yapılması önerilen işlemler verilmiştir döndürülürse:

Kod TBG Önerilen işlem
400 INVALID_ARGUMENT İsteğinizle ilgili bir sorun var. Şu göz atın: hata yanıtındaki mesaj alanını değiştirin ve talebinize uygun şekilde iletilmelidir.
401 UNAUTHENTICATED İsteğiniz düzgün bir şekilde doğrulanamadı. Geçerli OAuth eklediğinizi doğrulayın tercih edebilirsiniz. Okuyucu Gelirleri Yöneticisi'ni daha fazla bilgi için lütfen Başlangıç kılavuzu.
403 PERMISSION_DENIED İşlemi tamamlamak için gereken izinlere sahip değilsiniz talebiniz. Kullanıcı hesabınızda ilgili iş ortağı için uygun izinleri belirlemektir.
404 NOT_FOUND Almaya çalıştığınız kaynak, bulunabilir. Kullandığınız kimliğin şu olduğunu doğrulayın: doğru ve alınan kaynak türü için doğrudur.
409 ABORTED Değiştirmeye çalıştığınız kaynak başka bir yerde değiştirilmiş. Birkaç saniye bekleyin ve isteği tekrar deneyin.
429 RESOURCE_EXHAUSTED Şu limiti aştınız: hız sınırı veya günlük istek kotası hakkında daha fazla bilgi edinin. API kullanımınızı incelemek için Google API Konsolu'na gidin ve mevcut kotayı aşmadan çalışmak için iş akışı anlamına gelir. Daha fazla bilgi için lütfen sayfamıza bakın Kota Optimizasyonu başlıklı bölüme göz atın.

İşlemleriniz belirtilen süre içinde tamamlanamıyorsa günlük kota nedeniyle, ek kota isteme.

500 INTERNAL API dahili bir hatayla karşılaştı. Birkaç dakika bekleyin saniye sonra isteği yeniden deneyin. Hata devam ederse destek ekibiyle iletişime geçin.
504 DEADLINE_EXCEEDED API'nin isteği tamamlaması çok uzun sürdü. Birkaç saniye bekleyip isteği yeniden deneyin. Eğer hata devam ederse destek ekibiyle iletişime geçin.

SDF Hataları

Ekran ve Video 360 API, yapılandırılmış veri dosyaları (SDF'ler) oluşturma ve indirme. Bunun için nedeniyle, SDF oluşturma sırasında gönderilen hatalar, tamamlanan SDF'de döndürülür. görevi indir'i seçin. error içinde tamamlanan bir SDF indirme görevi: tamamlandı olarak işaretlenmiş ancak medya kaynağı adı yerine doldurulmuş bir hata alanı içeriyor şu kısaltılmış örnekte görüldüğü gibi: response alanında:

{
  ...
  "done": true,
  "error": {
    "code": 3,
    "message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
  }
}

SDF oluşturmaya çalışırken işlem yapılabilir bir hata mesajı alırsanız buna göre hareket etmesi gerekir. Hata mesajıyla ilgili net bir işlem yapılamıyorsa aşağıdaki işlemleri yapmanızı öneririz:

  • Kullanıcınızın üst öğe için uygun izinlere sahip olduğunu doğrulayın iş ortağı veya reklamveren kaynaklarını kullanabilirsiniz.
  • Filtrede sağlanan kimliklerin doğru olduğunu onaylayın. amaçlanan kaynak türüne karşılık gelmelidir ve verilen kök kimliği belirtilir.
  • Eş zamanlı SDF indirme sınırını aşmadığınızdan emin olun. görev sayısını değiştirebilirsiniz.

Hatalarla karşılaşmaya devam ederseniz bildirmek için destek ekibiyle iletişime geçin. seçin.

Engellemeyen Uyarılar

Engellemeyen uyarılar, satır öğelerine satır öğesinin yayınlanmasını etkileyebilecek bir sorun vardır. Benzer uyarılar bildiriliyor bir bildirim banner'ı ile özetleyerek. Bu uyarılar pasiftir ve bir satır öğesinin warningMessages alanında listelenir.

Pasif olsa da, bu uyarılara neden olan sorunlar bir satır öğesini tamamen engelleyecek şekilde değiştirin.

Korunma

Engellemeyen uyarılara neden olan birçok sorundan, uygun satır öğesi ayarlarının yapılandırmasını değiştirebilirsiniz.

  • Aralıklarla reklam yayını: Bir satır öğesinin yayını geçersizse veya üst kampanya siparişinin yayını sona erdiğinde, satır öğesi uyarısı alır ve yayınlanmaz. İkinci sorunu önlemek için bir satırın öğenin yayını, üst eklemenin yayınından sonra sona ermiyor sipariş.
  • Atanan reklam öğeleri: Geçerli bir reklam öğesi yoksa bir satır öğesine atandığında, satır öğesi bir uyarı oluşturur ve sunar.
  • Hedefleme: Satır öğesinin hedeflemesi atanması halinde, satır öğesi uyarı oluşturabilir ve satır öğesi veya önlenebilirler.

Mevcut bir satır öğesinden yapılandırmaları çoğaltıyorsanız Mevcut satır öğesi öngörülemeyen herhangi bir uyarı oluşturmamaktadır.

İzleme

Bir satır öğesi etkinken, engellemeyen uyarılara neden olan sorunlar uçuş. Satır öğelerinizin doğru şekilde sunulduğundan emin olmak için etkin satır öğelerinizi kontrol edin. Satır öğeleri alınabilir advertisers.lineItems.list işlevini kullanarak topluca yapabilirsiniz. Eğer Bir satır öğesi beklenmeyen bir uyarı oluşturuyorsa, bu sorunu gidermeniz gerekir. uygulamanın etkisini hemen azaltmaya çalışın.

Satır öğesinin ayarları veya hedeflemesi değişmemiş olsa bile sorunlar ortaya çıkabilir. Buna örnek olarak üst kampanya siparişinin duraklatılması veya süresinin dolması ve desteğinin sonlandırılması.