Hatalar ve Uyarılar

Bu sayfada, Display & Video 360 API'yi kullanırken karşılaşabileceğiniz farklı hata ve uyarı türleri ele alınmaktadır.

API Hataları

API'ye gönderilen ve tamamlanamayan istekler hata mesajı döndürür. Hata döndüren istekler, kullanıcı kotasına dahil edilir ve ek kota istekleri incelenirken dikkate alınır. Gelecekte hata oluşmaması için hata yanıtları işlenmeli ve ele alınmalıdır.

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

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

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

Kod TBG Önerilen işlem
400 INVALID_ARGUMENT İsteğinizle ilgili bir sorun var. Hata yanıtındaki mesaj alanını inceleyin ve isteğinizi buna göre değiştirin.
401 UNAUTHENTICATED İsteğinizin kimliği doğrulanamadı. İsteğinize geçerli OAuth kimlik bilgilerini eklediğinizi doğrulayın. Bu konuda daha fazla bilgi için lütfen Başlangıç Kılavuzumuzu inceleyin.
403 PERMISSION_DENIED İsteğinizi tamamlamak için gerekli izinlere sahip değilsiniz. Kullanıcı hesabınızın ilgili iş ortağı veya reklamveren için gerekli izinlere sahip olduğunu doğrulayın.
404 NOT_FOUND Almaya çalıştığınız kaynak bulunamıyor. Kullandığınız kimliğin doğru olduğundan ve alınan kaynak türüne ait olduğundan emin olun.
409 ABORTED Değiştirmeye çalıştığınız kaynak başka bir yerde değiştiriliyor. Birkaç saniye bekleyip isteği yeniden deneyin.
429 RESOURCE_EXHAUSTED Hız sınırınızı veya günlük istek kotanızı aştınız. Google API Konsolu'nu kullanarak API kullanımınızı inceleyin ve iş akışınızı mevcut kota sınırları dahilinde çalışacak şekilde değiştirin. Daha fazla bilgi için lütfen Kota Optimizasyonu sayfamıza bakın.
500 INTERNAL API'de dahili bir hata oluştu. Birkaç saniye bekleyip 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. Hata devam ederse destek ekibiyle iletişime geçin.

SDF Hataları

Display & Video 360 API, yapılandırılmış veri dosyaları (SDF'ler) oluşturmak ve indirmek için asenkron bir yöntem kullanır. Bu nedenle, SDF oluşturma işlemi sırasında ortaya çıkan hatalar, tamamlanmış SDF indirme görevinde döndürülür. error tarihinde tamamlanan bir SDF indirme görevi tamamlandı olarak işaretlenir ancak response alanında medya kaynağı adı yerine doldurulmuş bir hata alanı bulunur. Bu durum, kısaltılmış örnekte görüldüğü gibidir:

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

SDF oluşturmaya çalışırken uygulanabilir bir hata mesajı alırsanız ilgili talimatları uygulamanız gerekir. Hata mesajında açıkça uygulanabilir bir işlem yoksa aşağıdaki işlemleri yapmanızı öneririz:

  • Kullanıcınızın üst iş ortağı veya reklamveren kaynakları için uygun izinlere sahip olduğunu doğrulayın.
  • Filtrede sağlanan kimliklerin doğru, amaçlanan kaynak türüne karşılık gelen ve belirtilen kök kimlik bağlamında olduğunu onaylayın.
  • Kullanıcı başına yirmi eşzamanlı SDF indirme görevi sınırını aşmadığınızdan emin olun.

Hata almaya devam ederseniz sorununuzu bildirmek için destek ekibiyle iletişime geçin.

Engellemeyen Uyarılar

Engelleme olmayan uyarılar, bir satır öğesinin yayınlanmasını etkileyebilecek bir sorunu belirtmek için satır öğelerine atanır. Benzer uyarılar, kullanıcı arayüzünde bir bildirim banner'ı aracılığıyla iletilir. Bu uyarılar pasiftir ve bir satır öğesinin warningMessages alanında listelenir.

Bu uyarılara neden olan sorunlar pasif olsa da bir satır öğesinin yayınlanmasını tamamen engelleyecek kadar etkileyebilir.

Korunma

Engellemeyen uyarılara neden olan birçok sorun, aşağıdakiler de dahil olmak üzere satır öğesi ayarlarının doğru şekilde yapılandırılmasıyla önlenebilir:

  • Yayın aralığı: Bir satır öğesinin yayın aralığı geçersizse veya üst kampanya siparişinin yayın aralığının süresi dolmuşsa satır öğesi uyarı oluşturur ve yayınlanmaz. İkinci sorunu önlemek için bir satır öğesinin yayınının, üst öğesinin kampanya siparişinin yayınından daha geç bitmediğinden emin olun.
  • Atanan reklam öğeleri: Bir satır öğesine atanmış geçerli bir reklam öğesi yoksa satır öğesi uyarı oluşturur ve yayınlanmaz.
  • Hedefleme: Bir satır öğesinin hedeflemesi düzgün şekilde atanmamışsa satır öğesi uyarı oluşturabilir ve yayın etkilenebilir ya da tamamen engellenebilir.

Mevcut bir satır öğesindeki yapılandırmaları kopyalıyorsanız mevcut satır öğesinin beklenmedik uyarılar oluşturmadığından emin olun.

İzleme

Engellemeyen uyarılara neden olan sorunlar, bir satır öğesi yayınlanırken ortaya çıkabilir. Satır öğelerinizin doğru şekilde yayınlandığından emin olmak için etkin satır öğelerinizi yeni oluşturulan uyarılar açısından izleyin. Satır öğeleri, advertisers.lineItems.list işlevi kullanılarak toplu olarak alınabilir. Bir satır öğesi beklenmedik bir uyarı oluşturuyorsa yayın üzerindeki etkisini azaltmak için sorunu hemen gidermeniz gerekir.

Bir satır öğesinin ayarları veya hedeflemesi değişmemiş olsa bile sorunlar ortaya çıkabilir. Üst kampanya siparişinin duraklatılması veya süresinin dolması ve kullanıcı listelerinin ya da diğer hedeflemelerin kullanımdan kaldırılması buna örnek gösterilebilir.