Desain Google Ads API berbeda dari arsitektur REST tradisional
karena terutama menggunakan metode kustom, seperti search dan mutate,
dari metode list, get, create, update, dan delete yang lebih tradisional.
Tindakan ini dinyatakan dalam URL REST menggunakan pemetaan HTTP
: untuk memisahkan kata kerja kustom dari 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
ke dalam satu permintaan API. Semantik REST yang ketat hanya
akan memungkinkan
memperbarui kampanye
satu per satu. REST tradisional
update ke
kampanye, misalnya, akan mengharuskan pengiriman satu permintaan PATCH HTTP per kampanye
resource Anda
Untuk memungkinkan banyak operasi dipaketkan bersama 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 khusus dengan Kueri Google Ads seperti SQL
Bahasa.
Halaman Metode umum menjelaskan detail tentang metode yang paling sering digunakan di Google Ads API.