Caution: You are viewing documentation for the API's REST interface. Most of our official client libraries use gRPC. See the REST Introduction for details.

Projekt interfejsu REST

Zakładamy, że znasz tę stronę z podręczników dla programistów poświęconych projektowaniu zasobów i zasobom. Uzupełniasz je o szczegóły implementacji interfejsu API Google Ads.

Projekt zorientowany na zasoby

Ogólnie rzecz biorąc, interfejs Google Ads API jest oparty na zasobach opartych na zbiorach zasobów, do których można się kierować, (rzeczowników interfejsu API). Do zasobów odwołuje się ich nazwy i manipuluje nimi za pomocą małego 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ć według tych komponentów zgodnie z poniższą tabelą:

https://googleads.googleapis.com/v11/customers/1234567890:mutate
Prefiks wersji interfejsu API Nazwa zasobu (względna) Metoda
https://googleads.googleapis.com/v11 customers/1234567890 mutate

Wszystkie adresy URL typu REST dla określonej wersji interfejsu API (np. v11) wspólny prefiks wersji interfejsu API. Nazwa i metoda zasobu wspólnie określają, która usługa API jest wywoływana.

W interfejsie Google Ads API intensywnie używane są metody niestandardowe, w przeciwieństwie do większości tradycyjnych interfejsów API REST, które korzystają ze standardowych metod REST, takich jak list, get, create, update czy delete. Przykłady niestandardowych metod 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 interfejsie Google Ads, aby pokazać, jak są one używane do definiowania punktów końcowych interfejsu REST.