Halaman ini diterjemahkan oleh Cloud Translation API.

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 dilakukan 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, serta status kode RPC Google:

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

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

Code	RPC	Tindakan yang Disarankan
`400`	`INVALID_ARGUMENT`	Ada 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. Verifikasi bahwa 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 dan kemudian 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 mengetahui informasi lebih lanjut, lihat halaman kami tentang Pengoptimalan Kuota. Jika operasi tidak dapat diselesaikan sesuai kuota harian yang diberikan, Anda dapat meminta kuota tambahan.
`500`	`INTERNAL`	API mengalami error internal. Tunggu beberapa detik, lalu coba lagi permintaan tersebut. Jika error berlanjut, hubungi dukungan.
`504`	`DEADLINE_EXCEEDED`	API membutuhkan waktu yang 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). Oleh karena itu, error yang ditampilkan selama pembuatan SDF akan ditampilkan dalam tugas download SDF yang sudah selesai. Tugas download SDF yang selesai dalam error ditandai sebagai selesai, tetapi memiliki kolom error yang terisi, bukan nama resource media di kolom response, seperti yang terlihat pada contoh terpotong ini:

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

Jika menerima pesan error yang dapat ditindaklanjuti saat mencoba membuat SDF, sebaiknya ikuti pesan error tersebut. 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 dalam filter sudah akurat, sesuai dengan jenis resource yang diinginkan, dan berada dalam konteks ID root 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 Non-Pemblokiran

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 sepenuhnya mencegahnya.

Pencegahan

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

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

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

Monitoring

Masalah yang menyebabkan peringatan non-pemblokiran dapat muncul saat item baris sedang ditayangkan. Untuk memastikan item baris Anda ditayangkan dengan benar, pantau item baris yang aktif untuk melihat 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 dampak pada penayangan.

Masalah dapat muncul meskipun setelan atau penargetan item baris tidak berubah. Contohnya termasuk menjeda atau mengakhiri perjanjian pemasangan iklan induk dan penghentian daftar pengguna atau penargetan lainnya.