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: "/v16/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: "/v16/customers/{customer_id=*}:createCustomerClient"
body: "*"
};
option (google.api.method_signature) = "customer_id,customer_client";
}
Dies entspricht der REST-Methode customers.createCustomerClient.