Outros métodos

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: "/v16/customers:listAccessibleCustomers"
  };
}
customer_service.proto

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: "/v16/customers/{customer_id=*}:createCustomerClient"
    body: "*"
  };
  option (google.api.method_signature) = "customer_id,customer_client";
}
customer_service.proto

Isso é mapeado para o método REST customers.createCustomerClient.