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
Jednym z powodów, 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 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.