Error dan Peringatan

Halaman ini membahas berbagai jenis error dan peringatan yang mungkin Anda temukan saat menggunakan antarmuka Video 360 API.

Error API

Permintaan yang dibuat ke API yang tidak dapat diselesaikan menampilkan pesan error. Permintaan yang menampilkan error akan mengurangi kuota pengguna dan akan dipertimbangkan saat meninjau permintaan kuota tambahan. Respons error harus diproses dan ditangani untuk menghindari kesalahan pada masa mendatang.

Respons {i>error<i} mengambil format berikut dan menyertakan kode respons HTTP, pesan error, dan status kode Google RPC:

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

Di bawah ini adalah daftar error API umum beserta tindakan yang disarankan untuk dilakukan jika dikembalikan:

Kode PPK Tindakan yang Disarankan
400 INVALID_ARGUMENT Ada beberapa masalah dengan permintaan Anda. Ulas dalam respons error dan mengubah permintaan Anda.
401 UNAUTHENTICATED Permintaan Anda tidak dapat diautentikasi dengan benar. Pastikan Anda menyertakan OAuth yang valid kredensial yang Anda inginkan dalam permintaan Anda. Untuk informasi lebih lanjut tentang hal ini, lihat Panduan Memulai.
403 PERMISSION_DENIED Anda tidak memiliki izin yang diperlukan untuk menyelesaikan terhadap permintaan Anda. Pastikan bahwa akun pengguna izin yang sesuai untuk mitra yang relevan atau pengiklan.
404 NOT_FOUND Sumber daya yang Anda coba ambil tidak bisa ditemukan. Verifikasi bahwa ID yang Anda gunakan adalah benar dan untuk jenis resource yang diambil.
409 ABORTED Sumber daya yang Anda coba ubah sedang dimodifikasi di tempat lain. Tunggu beberapa detik, lalu ulangi permintaan tersebut.
429 RESOURCE_EXHAUSTED Anda telah melampaui batas kapasitas atau kuota permintaan harian. Periksa penggunaan API Anda menggunakan Konsol API Google dan mengubah atribut untuk beroperasi dalam kuota yang ada batasan data. Untuk informasi selengkapnya, lihat halaman kami tentang Pengoptimalan Kuota.

Jika operasi Anda tidak dapat diselesaikan dalam diberikan kuota harian, Anda mungkin meminta kuota tambahan.
500 INTERNAL API mengalami error internal. Tunggu beberapa lalu mencoba lagi permintaan tersebut. Jika kesalahan berlanjut, hubungi dukungan.
504 DEADLINE_EXCEEDED API membutuhkan waktu terlalu lama untuk menyelesaikan permintaan. Tunggu beberapa detik, lalu coba lagi permintaan tersebut. Jika error tetap berlanjut, hubungi dukungan.

Error SDF

Layar Display & Video 360 API menggunakan metode asinkron untuk membuat dan mendownload file data terstruktur (SDF). Untuk ini alasan, error yang ditampilkan selama pembuatan SDF ditampilkan di SDF yang sudah selesai download tugas. Tugas download SDF yang selesai di error adalah ditandai sebagai selesai, tetapi memiliki kolom error yang terisi, bukan nama resource media di kolom response, seperti yang terlihat dalam contoh terpotong ini:

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

Jika Anda menerima pesan {i>error<i} yang dapat ditindaklanjuti ketika mencoba membuat SDF, Anda harus mengikutinya. Jika pesan error tidak dapat ditindaklanjuti dengan jelas, kami sarankan tindakan berikut:

  • Verifikasi bahwa pengguna Anda memiliki izin yang sesuai untuk orang tua referensi partner atau pengiklan.
  • Pastikan ID yang diberikan dalam filter sudah akurat, sesuai dengan jenis resource yang dimaksudkan, dan berada dalam konteks ID root yang diberikan.
  • Pastikan bahwa Anda tidak melebihi batas dua puluh download SDF serentak tugas per pengguna.

Jika Anda masih mengalami error, hubungi dukungan untuk melaporkan menyelesaikan masalah Anda.

Peringatan Tidak Pemblokiran

Peringatan non-pemblokiran ditetapkan ke item baris untuk menunjukkan yang dapat memengaruhi penayangan item baris. Peringatan serupa disampaikan di UI melalui banner notifikasi. Peringatan ini bersifat pasif dan yang tercantum di kolom warningMessages item baris.

Meskipun pasif, masalah yang menyebabkan peringatan ini dapat berdampak pada penayangan hingga sepenuhnya mencegah item baris tersebut.

Pencegahan

Banyak masalah yang menyebabkan peringatan yang tidak memblokir dapat dihindari dengan melakukan konfigurasi setelan item baris, yang meliputi:

  • Penerbangan: Jika penerbangan item baris tidak valid, atau jika periode pesanan pemasangan iklan induk telah kedaluwarsa, item baris akan membuat peringatan dan tidak akan ditayangkan. Untuk menghindari masalah yang terakhir, pastikan baris penayangan item tidak berakhir lebih lambat dari periode tayang item induknya pesanan.
  • Materi iklan yang ditetapkan: Jika tidak ada materi iklan yang valid ditetapkan ke item baris, item baris tersebut akan menampilkan peringatan dan tidak yang diperlukan.
  • Penargetan: Jika penargetan item baris tidak ditetapkan dengan benar, item baris dapat memberikan peringatan dan penayangan mungkin terpengaruh atau dicegah sepenuhnya.

Jika Anda mereplikasi konfigurasi dari item baris yang sudah ada, pastikan item baris yang ada tidak menghasilkan peringatan tak terduga.

Pemantauan

Masalah yang menyebabkan peringatan yang tidak memblokir dapat muncul saat item baris berada penerbangan. Untuk memastikan item baris ditayangkan dengan benar, pantau item baris aktif untuk peringatan yang baru dibuat. Item baris dapat diambil secara massal menggunakan fungsi advertisers.lineItems.list. Jika item baris menghasilkan peringatan yang tidak terduga, Anda harus mengatasi masalah tersebut segera untuk mengurangi dampaknya terhadap penayangan.

Masalah dapat muncul meskipun setelan atau penargetan item baris tidak berubah. Contohnya mencakup jeda atau berakhirnya perjanjian pemasangan iklan induk dan penghentian daftar pengguna atau penargetan lainnya.