Desain Google Ads API berbeda dari arsitektur REST tradisional karena API ini terutama menggunakan metode kustom, seperti search
dan mutate,
, bukan metode list
, get
, create
, update
, dan delete
yang lebih tradisional.
Tindakan ini dinyatakan dalam URL REST menggunakan konvensi pemetaan HTTP
dari :
untuk memisahkan kata kerja kustom dari URL lainnya.
Misalnya, panggilan API perubahan kampanye menggunakan URL berikut:
https://googleads.googleapis.com/v21/customers/1234567890/campaigns:mutate
Salah satu alasan API menggunakan metode kustom adalah untuk memungkinkan pengelompokan beberapa operasi ke dalam satu permintaan API. Semantik REST yang ketat hanya akan mengizinkan
pembaruan satu kampanye dalam satu waktu. update
REST tradisional ke kampanye, misalnya, akan memerlukan pengiriman satu permintaan HTTP PATCH per resource kampanye.
Agar banyak operasi dapat digabungkan 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 menggunakan metode search
kustom dengan Bahasa Kueri Google Ads yang mirip SQL.
Halaman Metode umum menjelaskan secara mendetail metode yang paling sering digunakan di Google Ads API.