Andere Methoden

Mutate, Search und SearchStream sind zwar die häufigsten Methoden, in der Google Ads API gibt es noch viele weitere für bestimmte Zwecke. Alle Dienste und ihre APIs in der REST-Referenzdokumentation

Zuordnungen zwischen Protokollzwischenspeicher-RPC und REST

Alle Dienstendpunkte (ob mit REST und gRPC) werden letztlich definiert. in der .proto-Dateien des Services-Pakets mithilfe der proto3 Interface Definition Language.

Beispiel: ListAccessibleCustomers

Beispiel: Die Datei customer_service.proto definiert zusätzlich zum standardmäßigen Mutate eine ListAccessibleCustomers-Methode . Die Anmerkung google.api.http beschreibt wie die Methode HTTP zugeordnet wird. Sie verwendet ein HTTP-GET mit dem benutzerdefinierten Verb listAccessibleCustomers:

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

Dies entspricht der customers.listAccessibleCustomers REST-Methode.

Beispiel: CreateCustomerClient

Ein weiteres Beispiel von customer_service.proto ist mit der Methode CreateCustomerClient. Die Anmerkung google.api.http beschreibt ein HTTP POST mit dem benutzerdefinierten Verb 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

Dies entspricht der Methode customers.createCustomerClient REST-Methode.