Error dan peringatan

Display & Video 360 API dapat merespons dengan sejumlah error dan peringatan. Solusi API yang berfungsi dengan baik harus menangani error ini.

Error API

Permintaan ke API yang gagal melakukan tindakan yang dimaksudkan akan menampilkan error. Respons error harus ditangkap dan ditangani.

Respons error API memiliki kode respons HTTP, pesan error, dan status kode RPC Google. Formatnya adalah sebagai berikut:

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

Berikut adalah daftar error API umum dan tindakan yang direkomendasikan:

Kode error
`400`	`INVALID_ARGUMENT` Ada masalah dengan permintaan Anda. Tinjau kolom pesan dalam respons error dan perbarui permintaan Anda sesuai dengan itu.
`401`	`UNAUTHENTICATED` Permintaan Anda tidak dapat diautentikasi dengan benar. Pastikan Anda menyertakan kredensial OAuth yang valid dalam permintaan Anda. Untuk mengetahui informasi selengkapnya, lihat Panduan memulai cepat kami.
`403`	`PERMISSION_DENIED` Anda tidak memiliki izin yang diperlukan untuk menyelesaikan permintaan. Pastikan akun pengguna Anda memiliki izin yang tepat untuk partner atau pengiklan yang relevan.
`404`	`NOT_FOUND` Resource yang ingin Anda ambil tidak dapat ditemukan. Pastikan ID yang Anda gunakan sudah benar dan untuk jenis resource yang diambil.
`409`	`ABORTED` Resource yang ingin Anda ubah sedang diubah di tempat lain. Tunggu beberapa detik, lalu coba lagi permintaan tersebut.
`429`	`RESOURCE_EXHAUSTED` Anda telah melampaui batas kecepatan atau kuota permintaan harian. Gunakan Konsol Google Cloud untuk memeriksa penggunaan API Anda. Perbarui alur kerja Anda agar dapat dilakukan dalam batas kuota yang ada. Untuk mengetahui informasi selengkapnya, lihat panduan kami tentang Pengoptimalan Penggunaan.
`500`	`INTERNAL` API mengalami error internal. Tunggu beberapa detik, lalu coba lagi permintaan tersebut. Jika error tetap 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

Display & Video 360 API menggunakan tugas yang berjalan lama untuk membuat File Data Terstruktur (SDF). Error dalam pembuatan SDF ditampilkan dalam operation yang telah selesai. Kolom error akan berisi detailnya. Lihat contoh yang terpotong ini:

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

Jika pesan error tidak jelas, sebaiknya lakukan hal berikut:

Pastikan pengguna Anda memiliki setidaknya peran pengguna Standar untuk partner atau pengiklan induk.
Pastikan ID yang diberikan dalam filter sudah akurat. ID harus sesuai dengan jenis resource yang dimaksud dan harus berupa resource turunan dari ID root.
Pastikan pengguna Anda memiliki kurang dari dua puluh tugas download SDF serentak.

Jika Anda masih melihat error, hubungi tim dukungan.

Peringatan yang Tidak Memblokir

Peringatan non-pemblokiran menunjukkan masalah yang dapat memengaruhi penayangan iklan item baris. Peringatan serupa terlihat di UI. Peringatan ini bersifat pasif dan tercantum di item baris.

Penyebab utama peringatan dapat memengaruhi penayangan item baris. Dalam beberapa kasus, hal ini dapat mencegah penayangan iklan sepenuhnya.

Pencegahan

Beberapa peringatan non-pemblokiran disebabkan oleh kesalahan konfigurasi item baris:

Penayangan: Item baris tidak akan menayangkan iklan jika penayangannya tidak valid atau jika penayangan pesanan penyisipannya telah berakhir. Pastikan item baris memiliki penayangan dalam perjanjian pemasangan iklannya.
Materi iklan yang ditetapkan: Item baris tidak dapat ditayangkan jika materi iklan yang valid tidak ditetapkan ke item baris tersebut.
Penargetan: Penayangan iklan item baris dapat terpengaruh atau dicegah seluruhnya jika penargetannya tidak ditetapkan dengan benar.

Pastikan item baris yang ada tidak memunculkan peringatan apa pun sebelum menggunakan konfigurasinya di item baris baru.

Pemantauan

Peringatan non-pemblokiran dapat muncul saat item baris sedang ditayangkan. Pantau item baris aktif Anda untuk melihat peringatan baru guna memastikan item baris tersebut ditayangkan dengan benar. Dapatkan item baris secara massal dengan permintaan list. Jika item baris menampilkan peringatan yang tidak terduga, selesaikan masalah tersebut sesegera mungkin untuk mengurangi dampak pada penayangan.

Peringatan dapat ditambahkan meskipun setelan atau penargetan tidak berubah. Contohnya mencakup:

Perjanjian pemasangan iklan dijeda atau habis masa berlakunya.
Daftar pengguna atau opsi penargetan tidak digunakan lagi.