Desain Google Ads API berbeda dengan 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
: untuk memisahkan kata kerja kustom dari URL lainnya.
Misalnya, panggilan API mutasi kampanye menggunakan URL berikut:
https://googleads.googleapis.com/v19/customers/1234567890/campaigns:mutate
Salah satu alasan API menggunakan metode kustom adalah untuk memungkinkan pengelompokan beberapa operasi menjadi 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.
Untuk memungkinkan banyak operasi 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.