Mutate
, Search
e SearchStream
sono i metodi più comuni
nell'API Google Ads, ma ce ne sono molti altri per scopi specifici. Tutti i servizi e le relative API sono riportati nella documentazione di riferimento REST.
Mappature del buffer di protocollo da RPC a REST
Tutti gli endpoint di servizio (sia che utilizzi REST che gRPC) vengono definiti in ultima analisi nei file.proto del pacchetto di servizi utilizzando proto3 Interface Definition Language.
Esempio: ListAccessibleCustomers
Ad esempio, il file customer_service.proto
definisce un metodo ListAccessibleCustomers
, oltre al metodo Mutate
standard. L'annotazione google.api.http
descrive il modo in cui il metodo viene mappato a HTTP. Utilizza un GET
HTTP con il verbo personalizzato
listAccessibleCustomers
:
rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) returns (ListAccessibleCustomersResponse) { option (google.api.http) = { get: "/v17/customers:listAccessibleCustomers" }; }
Corrisponde al metodo REST customers.listAccessibleCustomers.
Esempio: CreateCustomerClient
Un altro esempio di customer_service.proto
è
il metodo CreateCustomerClient
. La relativa annotazione google.api.http
descrive un POST
HTTP utilizzando il verbo personalizzato 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"; }
Corrisponde al metodo REST customers.createCustomerClient.