Architektura interfejsu Google Ads API różni się od tradycyjnej architektury REST, ponieważ używa on głównie metod niestandardowych, takich jak search i mutate,, zamiast bardziej tradycyjnych metod list, get, create, update i delete.
Działania te są wyrażane w adresach URL REST za pomocą mapowania HTTP, w którym używa się znaku : do oddzielenia niestandardowego czasownika od reszty adresu URL.
Na przykład wywołanie interfejsu API mutate kampanii korzysta z tego adresu URL:
https://googleads.googleapis.com/v21/customers/1234567890/campaigns:mutate
Jednym z powodów, dla których interfejs API używa metod niestandardowych, jest umożliwienie wykonywania wielu operacji zbiorczo w ramach jednego żądania API. Ścisła semantyka REST pozwala na aktualizowanie tylko jednej kampanii naraz. Tradycyjne żądanie REST
update dotyczące np. kampanii wymagałoby wysłania 1 żądania HTTP PATCH na każdy zasób kampanii.
Aby umożliwić łączenie wielu operacji w jednym treści żądania, interfejs Google Ads API definiuje niestandardową metodę mutate dla większości zasobów.
Podobnie, aby umożliwić odczytywanie zbiorcze (pobieranie wielu obiektów naraz) z interfejsu API, interfejs API używa niestandardowej metody search z podobnym do SQL językiem zapytań Google Ads.
Na stronie Typowe metody znajdziesz szczegółowe informacje o najczęściej używanych metodach w Google Ads API.