Autres méthodes

Mutate, Search et SearchStream sont les méthodes les plus courantes. dans l'API Google Ads, il en existe de nombreux autres dédiés à des fins spécifiques. Tous les services leurs API sont décrites dans le Documentation de référence REST

Mappages RPC vers REST du tampon de protocole

Au final, tous les points de terminaison du service (qu'ils utilisent REST et gRPC) sont définis dans 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 du Mutate standard pour en savoir plus. Son annotation google.api.http décrit comment la méthode est mappée à HTTP. Elle utilise un GET HTTP avec le verbe personnalisé listAccessibleCustomers:

rpc ListAccessibleCustomers(ListAccessibleCustomersRequest)
    returns (ListAccessibleCustomersResponse) {
  option (google.api.http) = {
    get: "/v17/customers:listAccessibleCustomers"
  };
}
customer_service.proto

Cette valeur correspond au customers.listAccessibleCustomers Méthode REST.

Exemple: CreateCustomerClient

Autre exemple tiré de customer_service.proto : la méthode CreateCustomerClient. Son annotation google.api.http décrit une 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";
}
customer_service.proto

Cette valeur correspond à l'objet customers.createCustomerClient Méthode REST.