Andere Methoden

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

Zuordnungen von Protokollpuffer-RPC zu REST

Alle Dienstendpunkte (unabhängig davon, ob REST oder gRPC verwendet wird) werden letztendlich definiert in den .proto-Dateien des Dienstpakets mit der proto3-Schnittstellendefinitionssprache.

Beispiel: ListAccessibleCustomers

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

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

Dies wird der customers.listAccessibleCustomers zugeordnet.

Beispiel: CreateCustomerClient

Ein weiteres Beispiel aus customer_service.proto ist die CreateCustomerClient Methode. Die Annotation google.api.http beschreibt ein HTTP-POST mit dem benutzerdefinierten Verb createCustomerClient:

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

Dies wird der customers.createCustomerClient REST-Methode zugeordnet.