Error dan Peringatan

Halaman ini membahas berbagai jenis error dan peringatan yang mungkin Anda temui saat menggunakan Display & Video 360 API.

Error API

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

Respons error menggunakan format berikut dan menyertakan kode respons HTTP, pesan error, dan status kode RPC Google:

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

Berikut adalah daftar error API umum beserta tindakan yang direkomendasikan untuk dilakukan jika error tersebut ditampilkan:

Kode PPK Tindakan yang Disarankan
400 INVALID_ARGUMENT Ada beberapa masalah dengan permintaan Anda. Tinjau kolom pesan dalam respons error dan ubah permintaan Anda sebagaimana mestinya.
401 UNAUTHENTICATED Permintaan Anda tidak dapat diautentikasi dengan benar. Pastikan Anda menyertakan kredensial OAuth yang valid dalam permintaan. Untuk informasi selengkapnya tentang hal ini, lihat Panduan memulai.
403 PERMISSION_DENIED Anda tidak memiliki izin yang diperlukan untuk menyelesaikan permintaan Anda. Pastikan akun pengguna Anda memiliki izin yang sesuai untuk partner atau pengiklan yang relevan.
404 NOT_FOUND Resource yang Anda coba ambil tidak dapat ditemukan. Pastikan ID yang Anda gunakan sudah benar dan untuk jenis resource yang diambil.
409 ABORTED Resource yang Anda coba ubah sedang diubah di tempat lain. Tunggu beberapa detik, lalu coba lagi permintaan tersebut.
429 RESOURCE_EXHAUSTED Anda telah melampaui batas kapasitas atau kuota permintaan harian. Periksa penggunaan API Anda menggunakan Konsol API Google dan ubah alur kerja Anda agar beroperasi dalam batas kuota yang ada. Untuk informasi selengkapnya, lihat halaman kami tentang Pengoptimalan Kuota.
500 INTERNAL API mengalami error internal. Tunggu beberapa detik, lalu coba lagi permintaan tersebut. Jika error tetap berlanjut, hubungi dukungan.
504 DEADLINE_EXCEEDED API memerlukan 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 metode asinkron untuk membuat dan mendownload file data terstruktur (SDF). Karena alasan ini, error yang ditampilkan selama pembuatan SDF ditampilkan dalam tugas download SDF yang sudah selesai. Tugas download SDF yang selesai di error ditandai sebagai selesai, tetapi memiliki kolom error yang terisi, bukan nama resource media di kolom response, seperti yang terlihat dalam contoh yang 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 error yang dapat ditindaklanjuti saat mencoba membuat SDF, Anda harus mengikutinya dengan benar. Jika pesan error tidak dapat ditindaklanjuti dengan jelas, sebaiknya lakukan tindakan berikut:

  • Pastikan pengguna Anda memiliki izin yang sesuai untuk resource partner atau pengiklan induk.
  • Pastikan ID yang diberikan di filter akurat, sesuai dengan jenis resource yang diinginkan, dan berada dalam konteks root id yang diberikan.
  • Pastikan Anda tidak melebihi batas dua puluh tugas download SDF serentak per pengguna.

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

Peringatan yang Tidak Memblokir

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

Meskipun pasif, masalah yang menyebabkan peringatan ini dapat memengaruhi penayangan item baris hingga mencegahnya sepenuhnya.

Pencegahan

Banyak masalah yang menyebabkan peringatan non-pemblokiran dapat dihindari melalui konfigurasi setelan item baris yang tepat, termasuk hal berikut:

  • Periode tayang: Jika periode tayang item baris tidak valid, atau jika periode tayang pesanan pemasangan induk telah berakhir, item baris akan menampilkan peringatan dan tidak akan ditayangkan. Untuk menghindari masalah yang terakhir, pastikan penerbangan item baris tidak berakhir lebih lambat dari penerbangan urutan penyisipan induknya.
  • Materi iklan yang ditetapkan: Jika tidak ada materi iklan yang valid yang ditetapkan ke item baris, item baris akan menampilkan peringatan dan tidak akan ditayangkan.
  • Penargetan: Jika penargetan item baris tidak ditetapkan dengan benar, item baris tersebut dapat menghasilkan peringatan dan penayangan dapat terpengaruh atau dicegah sama sekali.

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

Pemantauan

Masalah yang menyebabkan peringatan non-blocking dapat muncul saat item baris sedang dikirim. Untuk memastikan item baris ditayangkan dengan benar, pantau item baris aktif Anda untuk menemukan 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 segera mengatasi masalah tersebut untuk mengurangi dampaknya terhadap penayangan.

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