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