Altri metodi

Sebbene Mutate, Search e SearchStream siano i metodi più comuni nell'API Google Ads, ce ne sono molte altre per scopi specifici. Tutti i servizi e le loro API sono documentate documentazione di riferimento REST.

Mapping da RPC a REST del buffer di protocollo

Tutti gli endpoint di servizio (che utilizzino REST e gRPC) sono definiti in ultima analisi nel 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 di Google. La relativa annotazione google.api.http descrive come viene mappato il metodo a HTTP. Utilizza un GET HTTP con il verbo personalizzato listAccessibleCustomers:

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

Questo corrisponde customers.listAccessibleCustomers Metodo REST.

Esempio: CreateCustomerClient

Un altro esempio di customer_service.proto è il metodo CreateCustomerClient. La sua annotazione google.api.http descrive HTTP POST con 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";
}
customer_service.proto

Questo valore è mappato a customers.createCustomerClient Metodo REST.