Sebelum mulai mengodekan aplikasi klien pertama Anda, ada beberapa hal yang perlu dilakukan, jika Anda belum melakukannya.
Dapatkan Akun Google
Anda memerlukan Akun Google agar dapat membuat project di Konsol API Google. Jika Anda sudah memiliki akun, berarti Anda sudah siap.
Anda mungkin juga menginginkan Akun Google terpisah untuk tujuan pengujian.
Coba Laporan Pengalaman Iklan Google
Dokumentasi API ini mengasumsikan bahwa Anda telah menggunakan Laporan Pengalaman Iklan Google dan bahwa Anda telah memahami konsep pemrograman web dan format data web.
Jika Anda belum menggunakan Laporan Pengalaman Iklan Google, coba antarmuka pengguna sebelum mulai membuat kode.
Membuat project untuk klien Anda
Sebelum dapat mengirim permintaan ke Laporan Pengalaman Iklan Google, Anda perlu memberi tahu Google tentang klien dan mengaktifkan akses ke API. Anda melakukannya dengan menggunakan Konsol Google API untuk membuat project, yang merupakan kumpulan bernama yang terdiri dari setelan dan informasi akses API, dan mendaftarkan aplikasi Anda.
Mempelajari dasar-dasar REST
Ada dua cara untuk memanggil API:
- Mengirim permintaan HTTP dan menguraikan respons.
- Menggunakan library klien.
Jika memutuskan untuk tidak menggunakan library klien, Anda harus memahami dasar-dasar REST.
REST adalah gaya arsitektur software yang memberikan pendekatan praktis dan konsisten untuk meminta serta mengubah data.
Istilah REST adalah singkatan dari "Representational State Transfer." Dalam konteks Google API, merujuk pada penggunaan kata kerja HTTP untuk mengambil dan memodifikasi representasi data yang disimpan oleh Google.
Dalam sistem RESTful, resource disimpan di penyimpanan data; klien mengirim permintaan agar server melakukan tindakan tertentu (seperti membuat, mengambil, memperbarui, atau menghapus resource), dan server melakukan tindakan serta mengirim respons, sering kali dalam bentuk representasi resource yang ditentukan.
Di RESTful API Google, klien menentukan tindakan menggunakan kata kerja HTTP seperti POST, GET, PUT, atau DELETE. Ini menentukan resource dengan URI yang unik secara global untuk formulir berikut:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Karena semua resource API memiliki URI unik yang dapat diakses HTTP, REST memungkinkan caching data dan dioptimalkan untuk berfungsi dengan infrastruktur terdistribusi web.
Sebaiknya lihat definisi metode dalam dokumentasi standar HTTP 1.1; definisi tersebut menyertakan spesifikasi untuk GET, POST, PUT, dan DELETE.
REST di Google Ad Experience Report API
Operasi Google Ad Experience Report API dipetakan langsung ke kata kerja HTTP REST.
Format spesifik untuk URI Laporan Google Ad Experience API adalah:
https://adexperiencereport.googleapis.com/v1/resourcePath?parameters
Kumpulan lengkap URI yang digunakan untuk setiap operasi yang didukung di API diringkas dalam dokumen Referensi Google Ad Experience Report API.
Mempelajari dasar-dasar JSON
Google Ad Experience Report API menampilkan data dalam format JSON.
JSON (JavaScript Object Notation) adalah format data umum independen bahasa yang memberikan representasi teks sederhana untuk struktur data arbitrer. Untuk mendapatkan informasi lebih lanjut, lihat json.org.