Bien que Mutate
, Search
et SearchStream
soient les méthodes les plus courantes de l'API Google Ads, il en existe de nombreuses autres à des fins spécifiques. Tous les services et leurs API sont décrits dans la documentation de référence de REST.
Mappages RPC vers REST du tampon de protocole
Tous les points de terminaison du service (qu'ils utilisent REST et 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 méthode Mutate
standard. Son annotation google.api.http
décrit la façon dont la méthode est mappée avec HTTP. Elle utilise un GET
HTTP avec le verbe personnalisé listAccessibleCustomers
:
rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) returns (ListAccessibleCustomersResponse) { option (google.api.http) = { get: "/v17/customers:listAccessibleCustomers" }; }
Cette valeur correspond à la méthode REST customers.listAccessibleCustomers.
Exemple: CreateCustomerClient
La méthode CreateCustomerClient
est un autre exemple tiré de customer_service.proto
. Son annotation google.api.http
décrit une requête HTTP POST
à l'aide du verbe personnalisé 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"; }
Cette valeur correspond à la méthode REST customers.createCustomerClient.