Mutate
, Search
i SearchStream
to najpopularniejsze metody
w interfejsie Google Ads API jest wiele innych, dostosowanych do konkretnych celów. Wszystkie usługi oraz
ich interfejsy API są opisane w
Dokumentacja REST
Mapowania RPC bufora protokołu na REST
Wszystkie punkty końcowe usługi (niezależnie od tego, czy używają REST czy gRPC) są ostatecznie zdefiniowane w Pliki.proto pakietu usług za pomocą Język definiowania interfejsu Proto3.
Przykład: ListAccessibleCustomers
Na przykład plik customer_service.proto
określa metodę ListAccessibleCustomers
, oprócz standardowej metody Mutate
, Adnotacja google.api.http
opisuje,
jak ta metoda jest mapowana na HTTP. Używa HTTP GET
z niestandardowym czasownikiem
listAccessibleCustomers
:
rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) returns (ListAccessibleCustomersResponse) { option (google.api.http) = { get: "/v17/customers:listAccessibleCustomers" }; }
To mapuje na customers.listAccessibleCustomers metody REST.
Przykład: CreateCustomerClient
Inny przykład ze strony customer_service.proto
to
metody CreateCustomerClient
. Adnotacja google.api.http
opisuje
HTTP POST
z niestandardowym czasownikiem createCustomerClient
:
rpc CreateCustomerClient(CreateCustomerClientRequest) returns (CreateCustomerClientResponse) { option (google.api.http) = { post: "/v17/customers/{customer_id=*}:createCustomerClient" body: "*" }; option (google.api.method_signature) = "customer_id,customer_client"; }
Zostaną one przeniesione na customers.createCustomerClient. metody REST.