Bien que Mutate
, Search
et SearchStream
soient les méthodes les plus courantes dans l'API Google Ads, il en existe de nombreuses autres à des fins spécifiques. Tous les services et leurs API sont documentés dans la documentation de référence REST.
Mappages RPC Protocol Buffer vers REST
Tous les points de terminaison de service (qu'ils utilisent REST ou gRPC) sont finalement définis dans les fichiers.proto du package de services à l'aide du langage de définition d'interface proto3.
Exemple: ListAccessibleCustomers
Par exemple, le fichier customer_service.proto
définit une méthode ListAccessibleCustomers
, en plus de la Mutate
standard. Son annotation google.api.http
décrit comment la méthode est mappée sur HTTP. Il utilise un GET
HTTP avec le verbe personnalisé listAccessibleCustomers
:
rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) returns (ListAccessibleCustomersResponse) { option (google.api.http) = { get: "/v19/customers:listAccessibleCustomers" }; }
Cette valeur correspond à la méthode REST customers.listAccessibleCustomers.
Exemple: CreateCustomerClient
Un autre exemple de customer_service.proto
est la méthode CreateCustomerClient
. Son annotation google.api.http
décrit un POST
HTTP à l'aide du verbe personnalisé createCustomerClient
:
rpc CreateCustomerClient(CreateCustomerClientRequest) returns (CreateCustomerClientResponse) { option (google.api.http) = { post: "/v19/customers/{customer_id=*}:createCustomerClient" body: "*" }; option (google.api.method_signature) = "customer_id,customer_client"; }
Cette valeur correspond à la méthode REST customers.createCustomerClient.