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łujemy się za pomocą ich nazw, a manipulujemy 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 adres URL poniżej można podzielić na poszczególne komponenty zgodnie z tabelą:
https://googleads.googleapis.com/v21/customers/1234567890:mutate
| Prefiks wersji interfejsu API | Nazwa zasobu (względna) | Metoda |
|---|---|---|
https://googleads.googleapis.com/v21
|
customers/1234567890
|
mutate
|
Wszystkie adresy URL REST dla konkretnej wersji interfejsu API (np. v21)
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 tradycyjnych 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.