Andere Methoden

Mutate, Search und SearchStream sind die gängigsten Methoden in der Google Ads API. Es gibt aber noch viele weitere für bestimmte Zwecke. Alle Dienste und ihre APIs sind in der REST-Referenzdokumentation dokumentiert.

Zuordnungen von Protocol Buffer-RPC zu REST

Alle Dienstendpunkte (REST und gRPC) werden letztendlich in den .proto-Dateien des Dienstepakets mit der Interface Definition Language proto3 definiert.

Beispiel: ListAccessibleCustomers

In der Datei customer_service.proto ist beispielsweise neben der Standardmethode Mutate auch eine ListAccessibleCustomers-Methode definiert. Die Annotation google.api.http beschreibt, wie die Methode HTTP zugeordnet wird. Es verwendet ein HTTP-GET mit dem benutzerdefinierten Verb listAccessibleCustomers:

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

Dies entspricht der REST-Methode customers.listAccessibleCustomers.

Beispiel: CreateCustomerClient

Ein weiteres Beispiel aus customer_service.proto ist die Methode CreateCustomerClient. Die google.api.http-Anmerkung beschreibt einen HTTP-POST mit dem benutzerdefinierten Verb 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";
}

Dies entspricht der REST-Methode customers.createCustomerClient.