Metody usługi

Interfejs Google Ads API różni się od tradycyjnej architektury REST, ponieważ zamiast bardziej tradycyjnych metod list, get, create, updatedelete używa głównie metod niestandardowych, takich jak searchmutate,. 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 searchję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.