Uwaga: przeglądasz dokumentację interfejsu REST interfejsu API. Większość oficjalnych bibliotek klienta używa gRPC. Więcej informacji znajdziesz we wprowadzeniu do REST.
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Architektura interfejsu Google Ads API różni się od tradycyjnej architektury REST, ponieważ używa on głównie metod niestandardowych, takich jak search i mutate,, zamiast bardziej tradycyjnych metod list, get, create, update i delete.
Działania te są wyrażane w adresach URL REST za pomocą mapowania HTTP, w którym używa się znaku : do oddzielenia niestandardowego czasownika od reszty adresu URL.
Na przykład wywołanie interfejsu API mutate kampanii korzysta z tego adresu URL:
Jednym z powodów, dla których interfejs API używa metod niestandardowych, jest umożliwienie wykonywania wielu operacji zbiorczo w ramach jednego żądania API. Ścisła semantyka REST pozwala na aktualizowanie tylko jednej kampanii naraz. Tradycyjne żądanie REST
update dotyczące np. kampanii wymagałoby wysłania 1 żądania HTTP PATCH na każdy zasób kampanii.
Aby umożliwić łączenie wielu operacji w jednym treści żądania, interfejs Google Ads API definiuje niestandardową metodę mutate dla większości zasobów.
Podobnie, aby umożliwić odczytywanie zbiorcze (pobieranie wielu obiektów naraz) z interfejsu API, interfejs API używa niestandardowej metody search z podobnym do SQL językiem zapytań Google Ads.
Na stronie Typowe metody znajdziesz szczegółowe informacje o najczęściej używanych metodach w Google Ads API.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-09-05 UTC."],[],["The Google Ads API uses custom methods like `search` and `mutate` instead of standard REST methods (e.g., `list`, `get`). This is indicated in URLs by a `:` separator. `Mutate` enables batching multiple operations into one request, unlike standard `update`, which handles one campaign at a time. Similarly, `search` allows fetching multiple objects in a single request, utilizing a SQL-like query language. This deviates from REST conventions to facilitate efficient batch processing and querying.\n"],null,[]]
