Uwaga: przeglądasz dokumentację interfejsu REST interfejsu API. Większość oficjalnych bibliotek klienta używa gRPC. Więcej informacji znajdziesz we wprowadzeniu do REST.

Metody usługi

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Projekt interfejsu Google Ads API różni się od tradycyjnej architektury REST, ponieważ używa głównie metod niestandardowych, takich jak search i mutate,, zamiast tradycyjnych metod list, get, create, update i delete. Te działania są wyrażone w adresach URL typu REST za pomocą konwencji mapowania HTTP w postaci :, która oddziela czasownik niestandardowy od reszty adresu URL.

Na przykład wywołanie interfejsu API mutacji do kampanii wykorzystuje ten adres URL:

https://googleads.googleapis.com/v12/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 API. Ścisła semantyka REST pozwoliłaby na aktualizowanie tylko jednej kampanii naraz. Tradycyjne logowanie REST update do kampanii wymagałoby jednego żądania PATCH HTTP na zasób kampanii.

Aby umożliwić łączenie wielu operacji w jedne żądanie, interfejs Google Ads API definiuje niestandardową metodę mutate dla większości zasobów. 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 podobnym do SQL.

Na stronie Typowe metody znajdziesz szczegółowe informacje o najczęściej używanych metodach w interfejsie Google Ads API.