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 APIs estão documentados na documentação de referência REST.

Mapeamentos de RPC de buffer de protocolo para REST

Todos os endpoints de serviço (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 é mapeado para HTTP. Ele usa um HTTP GET com o verbo personalizado listAccessibleCustomers:

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

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

Exemplo: CreateCustomerClient

Outro exemplo de customer_service.proto é o método CreateCustomerClient. A anotação google.api.http descreve um HTTP POST usando o verbo personalizado createCustomerClient:

rpc CreateCustomerClient(CreateCustomerClientRequest)
    returns (CreateCustomerClientResponse) {
  option (google.api.http) = {
    post: "/v20/customers/{customer_id=*}:createCustomerClient"
    body: "*"
  };
  option (google.api.method_signature) = "customer_id,customer_client";
}

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