Hatalar ve uyarılar

Display & Video 360 API, çeşitli hata ve uyarılarla yanıt verebilir. Sağlıklı bir API çözümü bu hataları işlemelidir.

API hataları

API'ye yapılan ve amaçlanan işlemi gerçekleştiremeyen istekler hata döndürür. Hata yanıtları yakalanıp işlenmelidir.

API hata yanıtında HTTP yanıt kodu, hata mesajı ve Google RPC kodu durumu bulunur. Şu biçimdedir:

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

Aşağıda, sık karşılaşılan API hataları ve önerilen işlemler listelenmiştir:

Hata kodları
`400`	`INVALID_ARGUMENT` İsteğinizle ilgili bir sorun var. Hata yanıtındaki mesaj alanını inceleyin ve isteğinizi buna göre güncelleyin.
`401`	`UNAUTHENTICATED` İsteğiniz düzgün şekilde kimlik doğrulanamadı. İsteğinize geçerli OAuth kimlik bilgilerini eklediğinizi doğrulayın. Daha fazla bilgi için Hızlı başlangıç kılavuzumuza bakın.
`403`	`PERMISSION_DENIED` İsteği 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 olduğunu 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` Hız sınırınızı veya günlük istek kotanızı aştınız. API kullanımınızı incelemek için Google Cloud Console'u kullanın. İş akışınızı mevcut kota sınırları içinde çalışacak şekilde güncelleyin. Daha fazla bilgi için Kullanım Optimizasyonu ile ilgili kılavuzumuza göz atı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 için uzun süren görevleri kullanır. SDF'ler oluşturulurken oluşan hatalar tamamlanmış operation içinde döndürülür. Ayrıntılar error alanında yer alır. Kısaltılmış şu örneğe bakın:

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

Hata mesajı net değilse aşağıdakileri yapmanızı öneririz:

Kullanıcınızın, üst iş ortağı veya reklamveren için en az Standart kullanıcı rolüne sahip olduğunu doğrulayın.
Filtrede sağlanan kimliklerin doğru olduğunu onaylayın. Kimlikler, amaçlanan kaynak türüne karşılık gelmeli ve kök kimliğin alt kaynakları olmalıdır.
Kullanıcınızın yirmi adetten az eşzamanlı SDF indirme görevi olduğundan emin olun.

Hâlâ hata görüyorsanız destek ekibiyle iletişime geçin.

Engellemeyen Uyarılar

Engelleyici olmayan uyarılar, bir satır öğesinin reklam sunumunu etkileyebilecek bir sorunu gösterir. Kullanıcı arayüzünde benzer uyarılar gösterilir. Bu uyarılar pasiftir ve satır öğesinde listelenir.

Bir uyarının temel nedeni, satır öğesinin yayınlanmasını etkileyebilir. Bazı durumlarda reklam yayınını tamamen engelleyebilir.

Korunma

Bazı engelleyici olmayan uyarılar, satır öğesinin yanlış yapılandırılmasından kaynaklanır:

Yayın: Bir satır öğesinin yayını geçersizse veya kampanya siparişinin yayınının süresi dolmuşsa satır öğesi reklam yayınlamaz. Bir satır öğesinin, kampanya siparişi yayın aralığı içinde bir yayına sahip olduğundan emin olun.
Atanan reklam öğeleri: Geçerli bir reklam öğesi atanmamışsa satır öğesi yayınlanamaz.
Hedefleme: Bir satır öğesinin hedeflemesi doğru şekilde atanmazsa reklam sunumu etkilenebilir veya tamamen engellenebilir.

Yapılandırmalarını yeni bir satır öğesinde kullanmadan önce mevcut bir satır öğesinin uyarı oluşturmadığından emin olun.

İzleme

Satır öğesi yayınlanırken engelleyici olmayan uyarılar gösterilebilir. Doğru şekilde yayınlandıklarından emin olmak için etkin satır öğelerinizde yeni uyarılar olup olmadığını kontrol edin. list isteğiyle satır öğelerini toplu olarak alın. Bir satır öğesi beklenmedik bir uyarı döndürürse yayın üzerindeki etkiyi azaltmak için sorunu en kısa sürede çözün.

Ayarlar veya hedefleme değişmemiş olsa bile uyarılar eklenebilir. Buna örnek olarak şunlar verilebilir:

Kampanya siparişi duraklatılır veya süresi dolar.
Bir kullanıcı listesinin veya hedefleme seçeneğinin desteği sonlandırılmıştır.