Pemecahan masalah

Ada banyak skenario saat Anda mungkin mengalami error saat menggunakan Display & Video 360 API. Hal ini dapat terkait dengan bug dalam kode Anda, input pengguna yang tidak valid, atau bahkan masalah dengan API itu sendiri. Apa pun alasannya, mengetahui cara memecahkan masalah error adalah bagian penting dari proses pengembangan. Panduan ini akan memberikan beberapa tips praktik terbaik untuk 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 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 diberi otorisasi 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

Saat mengalami error, API biasanya 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 baca kembali bagian tentang meninjau dasar-dasar sebelum melanjutkan.

Biasanya, konten objek error akan berisi informasi yang cukup untuk membantu Anda mengidentifikasi masalahnya. Jika tidak, Anda mungkin perlu melakukan beberapa riset tambahan untuk mengetahui arti error tersebut.

Meneliti error

1. Lihat bagian tentang error umum, yang memberikan detail untuk 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 didokumentasikan, harap beri tahu kami.

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

Mengidentifikasi akar masalah

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

Sebelum dapat memperbaiki error, Anda harus mengidentifikasi penyebabnya. Sering kali, hal ini disebabkan oleh 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 guna memastikannya berfungsi dengan benar.

Memeriksa permintaan HTTP adalah cara lain yang berguna untuk mengidentifikasi potensi bug, serta kasus input yang tidak valid. Banyak library klien resmi yang dapat dikonfigurasi untuk mencatat log permintaan dan respons HTTP; tinjau dokumentasi untuk library pilihan Anda guna mengetahui detail selengkapnya. Proxy HTTP seperti Charles, Squid, atau Fiddler juga dapat digunakan untuk merekam log permintaan dan respons. Setelah Anda mendapatkan log ini, tinjau log tersebut untuk memastikan bahwa nilai parameter permintaan yang diberikan oleh aplikasi Anda sudah benar dan sesuai dengan yang Anda harapkan.

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

Mendapatkan bantuan

Jika tidak dapat menyelesaikan error sendiri, Anda dapat menghubungi tim dukungan kami melalui formulir ini yang terletak 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 bermanfaat yang harus 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 kode tertentu atau mencurigai masalah tersebut bersifat khusus bahasa, sertakan cuplikan kecil untuk menggambarkan tindakan yang Anda lakukan.
• Informasi tambahan, seperti versi runtime/interpreter dan platform, yang mungkin berguna bagi orang lain yang mencoba mereproduksi masalah.

Memperbaiki masalah

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