Interfejs Google Ads API różni się od tradycyjnej architektury REST, ponieważ zamiast bardziej tradycyjnych metod list, get, create, update i delete używa głównie metod niestandardowych, takich jak search i mutate,.
Te działania są wyrażane w adresach URL REST za pomocą konwencji mapowania HTTP, która polega na oddzieleniu niestandardowego czasownika od reszty adresu URL za pomocą znaku :.
Na przykład wywołanie interfejsu API do modyfikowania kampanii używa tego adresu URL:
https://googleads.googleapis.com/v19/customers/1234567890/campaigns:mutate
Jedną z przyczyn, dla których interfejs API używa metod niestandardowych, jest umożliwienie grupowania wielu operacji w jednym żądaniu interfejsu API. Restrykturowa semantyka REST umożliwiałaby aktualizowanie tylko jednej kampanii naraz. Tradycyjne żądanie REST
update do kampanii wymagałoby wysłania 1 żądania HTTP PATCH na zasób kampanii.
Aby umożliwić grupowanie wielu operacji w jednym ciele żądania, interfejs Google Ads API zamiast tego definiuje niestandardową metodę mutate dla większości zasobów.
Podobnie, aby umożliwić zbiorcze odczyty (pobieranie wielu obiektów naraz) z interfejsu API, interfejs API używa niestandardowej metody search z językiem zapytań Google Ads przypominającym SQL.
Na stronie Popularne metody znajdziesz szczegółowe informacje o najczęściej używanych metodach w interfejsie Google Ads API.