Mutate
, Search
und SearchStream
sind die am häufigsten verwendeten Methoden in der Google Ads API. Für bestimmte Zwecke gibt es jedoch noch viele weitere. Alle Dienste und zugehörigen APIs sind in der REST-Referenzdokumentation dokumentiert.
Zuordnungen von Protokollzwischenspeicher-RPC zu REST
Alle Dienstendpunkte (unabhängig davon, ob Sie REST und gRPC verwenden) werden letztendlich in den .proto-Dateien des Dienstpakets mithilfe der Proto3 Interface Definition Language definiert.
Beispiel: ListAccessibleCustomers
Beispielsweise definiert die Datei customer_service.proto
zusätzlich zum Standard-Mutate
eine ListAccessibleCustomers
-Methode. In der Annotation google.api.http
wird beschrieben, wie die Methode HTTP zugeordnet wird. Sie verwendet einen HTTP-GET
mit dem benutzerdefinierten Verb listAccessibleCustomers
:
rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) returns (ListAccessibleCustomersResponse) { option (google.api.http) = { get: "/v17/customers:listAccessibleCustomers" }; }
Dies entspricht der REST-Methode customers.listAccessibleCustomers.
Beispiel: CreateCustomerClient
Ein weiteres Beispiel aus customer_service.proto
ist die Methode CreateCustomerClient
. Die Annotation google.api.http
beschreibt einen 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"; }
Dies entspricht der REST-Methode customers.createCustomerClient.