Interfejs Google Ads API różni się od tradycyjnej architektury REST
ponieważ wykorzystuje głównie metody niestandardowe, takie jak search
i mutate,
bardziej tradycyjnych metod list
, get
, create
, update
i delete
.
Te działania są wyrażone w adresach URL typu REST za pomocą mapowania HTTP.
:
, służący do oddzielania czasownika niestandardowego od reszty adresu URL.
Na przykład wywołanie interfejsu API mutacji kampanii używa takiego 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
w jednym żądaniu do interfejsu API. Ścisła semantyka REST pozwoliłaby
aktualizowania po jednej kampanii. Tradycyjny typ REST
update
na
kampanii wymagałoby na przykład wysłania jednego żądania HTTP PATCH na kampanię.
.
Aby można było połączyć wiele operacji w jednej treści żądania,
interfejs Google Ads API definiuje niestandardową metodę mutate
dla większości zasobów.
Podobnie, aby włączyć odczyty wsadowe (pobieranie wielu obiektów naraz) z interfejsu API,
interfejs API korzysta z niestandardowej metody search
z zapytaniami Google Ads podobnymi do SQL
Język.
Na stronie Typowe metody znajdziesz szczegółowe informacje o z najczęściej stosowanych metod w interfejsie Google Ads API.