Outros métodos

Mutate, Search e SearchStream são os métodos mais comuns na API Google Ads, há muitos outros para fins específicos. Todos os serviços e as APIs estão documentadas Documentação de referência da REST.

Mapeamentos de RPC para REST no buffer de protocolo

Todos os endpoints de serviço (seja usando REST e gRPC) são definidos por fim. no Arquivos.proto do pacote de serviços usando o 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 HTTP GET com o verbo personalizado listAccessibleCustomers:

rpc ListAccessibleCustomers(ListAccessibleCustomersRequest)
    returns (ListAccessibleCustomersResponse) {
  option (google.api.http) = {
    get: "/v17/customers:listAccessibleCustomers"
  };
}
customer_service.proto

Esse valor é mapeado para o customers.listAccessibleCustomers Método REST.

Exemplo: CreateCustomerClient

Outro exemplo de customer_service.proto é o método CreateCustomerClient. A anotação google.api.http dele descreve um HTTP POST 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";
}
customer_service.proto

Ele é mapeado para customers.createCustomerClient Método REST.