Desain Google Ads API berbeda dengan arsitektur REST tradisional
karena utamanya menggunakan metode kustom, seperti search
dan mutate,
, bukan
metode list
, get
, create
, update
, dan delete
yang lebih tradisional.
Tindakan ini dinyatakan dalam URL REST dengan menggunakan konvensi pemetaan HTTP
:
untuk memisahkan kata kerja kustom dari bagian URL lainnya.
Misalnya, panggilan API mutasi kampanye menggunakan URL berikut:
https://googleads.googleapis.com/v17/customers/1234567890/campaigns:mutate
Salah satu alasan API menggunakan metode kustom adalah untuk mengaktifkan pengelompokan beberapa
operasi ke dalam satu permintaan API. Semantik REST yang ketat hanya akan mengizinkan update satu per satu. Misalnya, update
REST tradisional ke kampanye akan memerlukan pengiriman satu permintaan PATCH HTTP per resource kampanye.
Agar banyak operasi dapat dipaketkan dalam satu isi permintaan,
Google Ads API menentukan metode mutate
kustom untuk sebagian besar resource.
Demikian pula, untuk mengaktifkan pembacaan batch (mengambil banyak objek sekaligus) dari API,
API tersebut menggunakan metode search
kustom dengan Bahasa Kueri
Google Ads yang mirip SQL.
Halaman Metode umum menguraikan metode yang paling sering digunakan di Google Ads API.