Pemecahan masalah

Ada banyak skenario di mana Anda mungkin mengalami error saat bekerja dengan Layar & Video 360 API. Hal ini bisa berhubungan dengan {i>bug<i} dalam kode Anda, {i>input<i} pengguna yang tidak valid, atau bahkan masalah dengan API itu sendiri. Apa pun alasannya, mengetahui cara memecahkan masalah {i>error<i} adalah bagian penting dari proses pengembangan. Panduan ini akan memberikan beberapa kiat praktik terbaik untuk memulai.

Meninjau dasar-dasar

1. Tinjau panduan prasyarat. Pastikan Anda memiliki akses ke Layar & Video 360 dan project API yang dikonfigurasi dengan benar.
2. Jika respons Anda berisi error HTTP, pastikan Anda meninjaunya dengan cermat dan memastikan bahwa permintaan dibuat ke API dan layanan yang benar.
3. Tinjau panduan otorisasi. Pastikan permintaan Anda berisi kredensial OAuth 2.0 yang diperlukan.

4. Pastikan Anda menggunakan kredensial yang benar. Lihat Menyiapkan Panduan aplikasi Anda untuk mengetahui detail tentang cara membuat kredensial otentikasi. Anda juga dapat meneruskan token akses ke Endpoint tokeninfo Google OAuth2 API untuk memverifikasi bahwa endpoint tersebut diberikan ke proyek API yang benar dan diberi cakupan yang benar:

   POST https://www.googleapis.com/oauth2/v2/tokeninfo?access_token={YOUR_ACCESS_TOKEN}
   
   200 OK
   
   {
    "issued_to": "{API_PROJECT_CLIENT_ID}",
    "audience": "...",
    "scope": "{API_SCOPES}",
    "expires_in": ...
   }
   

Memahami error

Jika menemukan error, API biasanya akan menampilkan respons JSON yang berisi objek error. Objek ini memberikan konteks tambahan tentang yang terjadi.

{
 "error": {
  "code": 404,
  "message": "Resource type LINE_ITEM does not exist: advertisers/1/lineItems/1",
  "status": "NOT_FOUND"
 }
}

Catatan: Jika Anda menerima respons error yang tidak menyertakan error ada kemungkinan error tidak berasal dari opsi Display & Video 360 API. Memohon lihat kembali bagian tentang meninjau dasar-dasar sebelum melanjutkan.

Biasanya konten objek error akan berisi informasi yang cukup untuk membantu Anda mengidentifikasi kesalahan yang ada. Jika tidak, Anda mungkin perlu melakukan beberapa penelitian untuk mencari tahu apa arti kesalahan tersebut.

Meneliti kesalahan

1. Lihat bagian error umum, yang memberikan mengenai beberapa {i>error<i} yang paling sering ditemui.

2. Jika kesalahan tidak tercakup di bagian kesalahan umum, lihat dokumentasi referensi dan coba telusuri kode error, status, dan pesan.

3. Jika Anda menemukan kesalahan yang tidak didokumentasikan, harap beri tahu kami.

Poin Penting: Jika error yang Anda temui berkaitan dengan validasi kolom atau batas partner/pengiklan, tinjau Layar & Pusat bantuan Video 360 untuk mengetahui informasi selengkapnya. Aturan ini dan batas diwarisi dari kampanye Display & Video 360 dan tidak diberlakukan oleh Layar & Video 360 API.

Mengidentifikasi akar masalah

Pada tahap ini, Anda telah mengidentifikasi error dan memahami artinya. Jika tidak, kembali ke bagian memahami kesalahan atau mendapatkan bantuan jika Anda yakin mengalami error di API yang tidak dapat Anda perbaiki sendiri.

Sebelum memperbaiki error, Anda harus mengidentifikasi penyebabnya. Sering ini akan menjadi bug dalam kode Anda atau nilai input yang tidak valid.

Untuk menentukan apakah masalah terkait dengan bug dalam kode, Anda harus terlebih dahulu memverifikasi bahwa kode Anda berfungsi sebagaimana mestinya. Sebagai langkah pertama, pertimbangkan untuk meninjau bagian kode yang menyebabkan kegagalan untuk memeriksa masalah yang jelas. Dalam beberapa kasus, Anda mungkin perlu menggunakan alat debug untuk menelusuri kode baris demi baris guna memastikannya berfungsi dengan benar.

Memeriksa permintaan HTTP adalah cara berguna lain untuk mengidentifikasi potensi {i>bug<i}, karena serta kasus input yang tidak valid. Banyak {i>library<i} klien resmi dapat berupa dikonfigurasi untuk mencatat permintaan dan respons HTTP; meninjau dokumentasi untuk library pilihan untuk detail selengkapnya. {i>Proxy<i} HTTP seperti Charles, Squid, atau Fiddler juga dapat digunakan untuk mengambil log permintaan dan respons. Setelah Anda mendapatkan log, tinjau untuk memastikan bahwa nilai parameter permintaan yang disediakan oleh permohonan Anda sudah benar dan sesuai dengan yang Anda harapkan.

Setelah Anda mengidentifikasi {i>bug<i} atau {i>input<i} yang tidak valid yang menyebabkan kesalahan, perbaikannya diharapkan akan terlihat jelas. Jika Anda mengalami kesulitan atau tidak yakin cara terbaik untuk memperbaiki masalah, namun, Anda dapat menggunakan informasi yang telah Anda kumpulkan sejauh ini mendapatkan bantuan.

Mendapatkan bantuan

Jika Anda tidak dapat menyelesaikan kesalahan sendiri, Anda dapat menghubungi dukungan kami tim Anda melalui formulir ini yang ada di tab Display & Pusat bantuan Video 360.

Saat mengisi formulir ini, Anda harus menyertakan informasi sebanyak mungkin masalah yang Anda hadapi dan langkah-langkah pemecahan masalah yang sudah yang diambil. Informasi bermanfaat untuk disertakan:

• Log permintaan dan respons HTTP. Pastikan untuk menyamarkan informasi sensitif seperti token akses OAuth 2.0, alamat email, dll.
• Cuplikan kode. Jika Anda dapat mengisolasi masalah ke bagian tertentu dari kode atau mencurigai bahwa masalahnya berhubungan dengan bahasa, sertakan cuplikan kecil untuk menggambarkan apa yang Anda lakukan.
• Informasi tambahan, seperti platform dan versi runtime/penerjemah, yang mungkin berguna bagi orang lain yang mencoba mereproduksi masalah tersebut.

Memperbaiki masalah

Setelah mengidentifikasi penyebab masalah dan menemukan solusinya, barulah waktu yang tepat untuk menerapkan perbaikan. Bila memungkinkan, uji perbaikan Anda dalam (seperti partner atau pengiklan yang dikonfigurasi secara khusus untuk pengujian) terhadap berbagai input yang baik dan buruk sebelum menerapkannya ke produksi.