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: "/v16/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: "/v16/customers/{customer_id=*}:createCustomerClient"
body: "*"
};
option (google.api.method_signature) = "customer_id,customer_client";
}
Cette valeur correspond à la méthode REST customers.createCustomerClient.