Metode Layanan

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/v16/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.