Projekt interfejsu Google Ads API różni się od tradycyjnej architektury REST, ponieważ używa głównie metod niestandardowych, takich jak search
oraz mutate,
, a nie bardziej tradycyjnych metod list
, get
, create
, update
i delete
.
Działania te są wyrażone w adresach URL typu REST przy użyciu konwencji mapowania HTTP :
, aby oddzielić niestandardowy czasownik od reszty adresu URL.
Na przykład wywołanie interfejsu API mutacji kampanii korzysta z tego adresu URL:
https://googleads.googleapis.com/v17/customers/1234567890/campaigns:mutate
Jednym z powodów, dla których interfejs API używa metod niestandardowych, jest włączenie grupowania wielu operacji w jedno żądanie interfejsu API. Ścisła semantyka REST pozwoliłaby na aktualizowanie tylko jednej kampanii naraz. Na przykład tradycyjny REST update
w kampanii wymagałby wysłania jednego żądania HTTP PATCH na zasób kampanii.
Aby umożliwić łączenie wielu operacji w obrębie jednego żądania, interfejs Google Ads API definiuje w przypadku większości zasobów niestandardową metodę mutate
.
Podobnie, aby włączyć odczyty zbiorcze (pobieranie wielu obiektów jednocześnie) z interfejsu API, używa on niestandardowej metody search
z językiem zapytań Google Ads przypominającym SQL.
Na stronie Typowe metody znajdziesz szczegółowe informacje o metodach, które są najczęściej używane w interfejsie Google Ads API.