Embora Mutate
, Search
e SearchStream
sejam os métodos mais comuns na API Google Ads, há muitos outros para fins específicos. Todos os serviços e
as respectivas APIs estão documentados na
documentação de referência da REST.
Mapeamentos de RPC de buffer de protocolo para REST
Todos os endpoints de serviço, seja usando REST e gRPC, são definidos nos arquivos.proto do pacote de serviços usando a Linguagem de definição de interface proto3.
Exemplo: ListAccessibleCustomers
Por exemplo, o arquivo customer_service.proto
define um método ListAccessibleCustomers
, além do Mutate
padrão. A anotação google.api.http
descreve
como o método mapeia para HTTP. Ele usa um GET
HTTP com o verbo personalizado
listAccessibleCustomers
:
rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) returns (ListAccessibleCustomersResponse) { option (google.api.http) = { get: "/v17/customers:listAccessibleCustomers" }; }
Isso é mapeado para o método REST customers.listAccessibleCustomers.
Exemplo: CreateCustomerClient
Outro exemplo de customer_service.proto
é
o método CreateCustomerClient
. Sua anotação google.api.http
descreve um
POST
HTTP usando o verbo personalizado 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"; }
Isso é mapeado para o método REST customers.createCustomerClient.