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.

Mappages RPC de tampon de protocole vers REST

Tous les points de terminaison de 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 customer_service.proto fichier définit une ListAccessibleCustomers méthode, en plus de la Mutate standard. Son google.api.http annotation décrit comment la méthode est mappée sur HTTP. Elle utilise un GET HTTP avec le verbe personnalisé listAccessibleCustomers :

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

Cela correspond à la customers.listAccessibleCustomers.

Exemple : CreateCustomerClient

Un autre exemple tiré 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: "/v25/customers/{customer_id=*}:createCustomerClient"
    body: "*"
  };
  option (google.api.method_signature) = "customer_id,customer_client";
}

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