Autres méthodes

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 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 méthode Mutate standard. Son annotation google.api.http décrit comment la méthode est mappée sur HTTP. Il utilise un HTTP GET avec le verbe personnalisé listAccessibleCustomers :

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

Cela 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: "/v20/customers/{customer_id=*}:createCustomerClient"
    body: "*"
  };
  option (google.api.method_signature) = "customer_id,customer_client";
}

Cela correspond à la méthode REST customers.createCustomerClient.