Na tej stronie założono, że znasz przewodniki dla deweloperów Projektowanie zorientowane na zasoby i Nazwy zasobów. Znajdziesz tu szczegółowe informacje o wdrażaniu interfejsu Google Ads API.
Projektowanie zorientowane na zasoby
Interfejs Google Ads API jest zwykle zaprojektowany w sposób zorientowany na zasoby, które są modelowane jako kolekcje indywidualnie adresowanych zasobów (rzeczowników interfejsu API). Do zasobów odwołuje się za pomocą ich nazw, a manipuluje się nimi za pomocą niewielkiego zestawu metod (nazywanych też czasownikami lub operacjami). Te nazwy zasobów i metody w połączeniu z określonym prefiksem wersji interfejsu API tworzą adresy URL interfejsu REST. Na przykład ten adres URL można podzielić na poszczególne komponenty zgodnie z tabelą poniżej:
https://googleads.googleapis.com/v22/customers/1234567890:mutate
| Prefiks wersji interfejsu API | Nazwa zasobu (względna) | Metoda |
|---|---|---|
https://googleads.googleapis.com/v22
|
customers/1234567890
|
mutate
|
Wszystkie adresy URL REST dla konkretnej wersji interfejsu API (np. v22)
mają wspólny prefiks wersji interfejsu API. Nazwa zasobu i metoda razem określają, która usługa interfejsu API jest wywoływana.
Interfejs Google Ads API w dużym stopniu korzysta z metod niestandardowych, w przeciwieństwie do większości interfejsów API REST, które używają standardowych metod REST, takich jak list, get, create, update i delete. Przykłady metod niestandardowych w interfejsie Google Ads API to search, searchStream i mutate.
Na kolejnych stronach znajdziesz więcej informacji o nazwach zasobów, metodach usług i konwencjach nazewnictwa JSON w Google Ads API. Wyjaśniamy, jak są one używane razem do definiowania punktów końcowych interfejsu REST.
Dokument opisujący
Aby ułatwić i zautomatyzować wykrywanie dostępnych metod w interfejsie Google Ads API, możesz użyć dokumentu wykrywania opublikowanego dla każdej wersji.
Jest dostępny pod adresem https://googleads.googleapis.com/$discovery/rest?version=<API_VERSION>.
Na przykład to jest dokument wykrywania najnowszej wersji interfejsu Google Ads API.
Dokument opisujący zawiera informacje o wszystkich usługach, metodach, zasobach i elementach używanych w interfejsie Google Ads API, takie jak dokumentacja, ale w czytelnym dla komputera formacie JSON.