Hatalar ve Uyarılar

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

API Hataları

API'ye yapılan, tamamlanmayan 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. Hata yanıtları işlenmeli ve gelecekteki hataların önüne geçmek için ele alınmalıdır.

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

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

Aşağıda, yaygın API hatalarının bir listesi ve döndürülmesi durumunda yapılması önerilen işlemler verilmiştir:

Kod RPC Ö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 düzgün bir şekilde doğrulanamadı. İsteğinize geçerli OAuth kimlik bilgilerini eklediğinizi doğrulayın. Bu konu hakkında daha fazla bilgi edinmek için lütfen Başlangıç kılavuzumuza bakın.
403 PERMISSION_DENIED İsteğinizi tamamlamak için gereken izinlere sahip değilsiniz. Kullanıcı hesabınızın ilgili iş ortağı veya reklamveren için uygun 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 ve alınan kaynak türü için olduğunu doğrulayın.
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 Ücret 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 hakkındaki sayfamıza bakın.

İşlemleriniz size verilen günlük kota dahilinde tamamlanamazsa ek kota isteyebilirsiniz.
500 INTERNAL API dahili bir hatayla karşılaştı. 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ını (SDF'ler) oluşturmak ve indirmek için eşzamansız bir yöntem kullanır. Bu nedenle, SDF oluşturma sırasında bildirilen hatalar, tamamlanmış SDF indirme görevinde döndürülür. Aşağıdaki kısaltılmış örnekte gösterildiği gibi error konumunda tamamlanan bir SDF indirme görevi tamamlandı olarak işaretlenmiş, ancak response alanında medya kaynağı adı yerine doldurulmuş bir hata alanı var:

{
  ...
  "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 bu mesajı uygun şekilde takip etmeniz gerekir. Hata mesajıyla ilgili işlem açıkça yapılamazsa 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 olduğundan, amaçlanan kaynak türüne karşılık geldiğinden ve belirtilen kök kimliğin bağlamında olduğundan emin olun.
  • Kullanıcı başına yirmi eş zamanlı SDF indirme görevi sınırını aşmadığınızdan emin olun.

Hatalarla karşılaşmaya devam ediyorsanız sorununuzu bildirmek için destek ekibiyle iletişime geçin.

Engellemeyen Uyarılar

Engellemeyen uyarılar, satır öğesinin yayını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 bildirilir. Bu uyarılar pasiftir ve satır öğesinin warningMessages alanında listelenir.

Pasif olsa da bu uyarılara neden olan sorunlar, satır öğesinin yayınlanmasını tamamen engellenecek şekilde etkileyebilir.

Korunma

Engellemeyen uyarılara neden olan birçok sorun, satır öğesi ayarlarının doğru yapılandırılmasıyla önlenebilir. Bunlardan bazıları şunlardır:

  • Aralıklarla reklam yayını: Bir satır öğesinin aralığı geçersizse veya üst kampanya siparişinin yayını sona erdiyse satır öğesi bir uyarı oluşturur ve yayınlanmaz. İkinci sorunu önlemek için bir satır öğesinin yayınının, üst kampanya siparişinin yayınından daha sonra sona ermediğinden emin olun.
  • Atanan reklam öğeleri: Satır öğesine atanmış geçerli bir reklam öğesi yoksa satır öğesi bir uyarı oluşturur ve sunulmaz.
  • Hedefleme: Bir satır öğesinin hedeflemesi doğru şekilde atanmazsa satır öğesi bir uyarı oluşturabilir ve yayın bu durumdan etkilenebilir veya tamamen engellenebilir.

Yapılandırmaları mevcut bir satır öğesinden çoğaltıyorsanız mevcut satır öğesinin beklenmedik uyarılar oluşturmadığından emin olun.

İzleme

Bir satır öğesi yayındayken, engellemeyen uyarılara neden olan sorunlar ortaya çıkabilir. Satır öğelerinizin doğru şekilde yayınlandığından emin olmak için etkin satır öğelerinizde yeni oluşturulan uyarıları 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ınlama üzerindeki etkiyi azaltmak için sorunu hemen gidermeniz gerekir.

Satır öğesinin ayarları veya hedeflemesi değişmemiş olsa bile sorunlar ortaya çıkabilir. Örnekler arasında üst kampanya siparişinin duraklatılması veya süresinin sona ermesi ve kullanıcı listeleri veya diğer hedeflemelerin kullanımdan kaldırılması yer alır.