Autres méthodes

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.