Pemecahan masalah

Ada banyak skenario yang mungkin menyebabkan Anda mengalami error saat menggunakan Display & Video 360 API. Hal ini dapat berkaitan dengan bug dalam kode Anda, input pengguna yang tidak valid, atau bahkan masalah pada API itu sendiri. Apa pun alasannya, mengetahui cara memecahkan kesalahan adalah bagian penting dari proses pengembangan. Panduan ini akan memberikan beberapa tips praktik terbaik untuk membantu Anda memulai.

Meninjau dasar-dasarnya

1. Tinjau panduan prasyarat. Pastikan Anda memiliki akses ke Display & 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 panduan Menyiapkan Aplikasi Anda untuk mengetahui detail tentang cara membuat kredensial autentikasi. Anda juga dapat meneruskan token akses ke endpoint tokeninfo Google OAuth2 API untuk memverifikasi bahwa token tersebut diterbitkan ke project API yang benar dan diotorisasi untuk 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 mengalami error, API biasanya akan menampilkan respons JSON yang berisi objek error. Objek ini memberikan konteks tambahan tentang error tertentu yang ditemukan.

{
 "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 objek error, ada kemungkinan error tersebut tidak berasal dari Display & Video 360 API. Harap lihat kembali bagian tentang meninjau dasar-dasar sebelum melanjutkan.

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

Meneliti kesalahan

1. Lihat bagian error umum, yang memberikan detail tentang beberapa error yang paling sering terjadi.

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

3. Jika Anda menemukan error yang tidak terdokumentasi, harap beri tahu kami.

Poin Penting: Jika error yang Anda alami berkaitan dengan validasi kolom atau batas partner/pengiklan, tinjau pusat bantuan Display & Video 360 untuk mendapatkan informasi selengkapnya. Aturan dan batas ini diwarisi dari Display & Video 360 dan tidak diterapkan oleh Display & Video 360 API itu sendiri.

Mengidentifikasi akar masalah

Pada tahap ini, Anda telah mengidentifikasi kesalahan dan memahami artinya. Jika tidak, kembali ke memahami error atau langsung mendapatkan bantuan jika Anda yakin menemukan error dalam API yang tidak dapat diperbaiki sendiri.

Sebelum error dapat diperbaiki, Anda harus mengidentifikasi penyebabnya. Sering kali hal ini menjadi bug dalam kode Anda atau nilai input yang tidak valid.

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

Memeriksa permintaan HTTP adalah cara bermanfaat lainnya untuk mengidentifikasi potensi bug, serta kasus input yang tidak valid. Banyak library klien resmi dapat dikonfigurasi untuk mencatat permintaan dan respons HTTP ke dalam log. Tinjau dokumentasi library pilihan Anda untuk mengetahui detail lebih lanjut. Proxy HTTP seperti Charles, Squid, atau Fiddler juga dapat digunakan untuk mengambil log permintaan dan respons. Setelah mendapatkan log ini, tinjau untuk memastikan bahwa nilai parameter permintaan yang disediakan oleh aplikasi Anda sudah benar dan sesuai dengan yang Anda harapkan.

Setelah Anda mengidentifikasi bug atau input tidak valid yang menyebabkan error, perbaikan akan terlihat jelas. Namun, jika Anda mengalami kesulitan atau tidak yakin cara terbaik untuk memperbaiki masalah tersebut, Anda dapat menggunakan informasi yang telah dikumpulkan sejauh ini saat mendapatkan bantuan.

Mendapatkan bantuan

Jika tidak dapat mengatasi error sendiri, Anda dapat menghubungi tim dukungan kami melalui formulir ini yang ada di pusat bantuan Display & Video 360.

Saat mengisi formulir ini, Anda harus menyertakan sebanyak mungkin informasi tentang masalah yang Anda hadapi dan langkah-langkah pemecahan masalah yang telah Anda lakukan. Informasi yang berguna untuk disertakan:

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

Memperbaiki masalah

Setelah Anda mengidentifikasi penyebab masalah dan menemukan solusinya, sekarang saatnya menerapkan perbaikan. Jika memungkinkan, uji perbaikan Anda di lingkungan terkontrol (seperti partner atau pengiklan yang dikonfigurasi khusus untuk pengujian) terhadap berbagai input yang baik dan buruk sebelum men-deploy ke produksi.