Attenzione: stai visualizzando la documentazione per l'interfaccia REST dell'API. La maggior parte delle nostre librerie client ufficiali utilizza gRPC. Per informazioni dettagliate, consulta la
Introduzione a REST.
Altri metodi
Sebbene Mutate, Search e SearchStream siano i metodi più comuni nell'API Google Ads, ne esistono molti altri per scopi specifici. Tutti i servizi e le relative API sono documentati nella documentazione di riferimento REST.
Mappature da RPC Protocol Buffer a REST
Tutti gli endpoint di servizio (che utilizzano REST e gRPC) sono definiti
in
file.proto del pacchetto di servizi
utilizzando il linguaggio
Interface Definition Language proto3.
Esempio: ElencaClientiAccessibili
Ad esempio, il file customer_service.proto
definisce un metodo ListAccessibleCustomers, oltre a Mutate
standard. L'annotazione google.api.http descrive come il metodo viene mappato a HTTP. Utilizza un GET HTTP con il verbo personalizzato
listAccessibleCustomers:
rpc ListAccessibleCustomers(ListAccessibleCustomersRequest)
returns (ListAccessibleCustomersResponse) {
option (google.api.http) = {
get: "/v19/customers:listAccessibleCustomers"
};
}
Questo corrisponde al metodo REST
customers.listAccessibleCustomers.
Esempio: CreateCustomerClient
Un altro esempio di customer_service.proto è il metodo CreateCustomerClient. La relativa annotazione google.api.http descrive un POST HTTP che utilizza il verbo personalizzato 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";
}
Questo corrisponde al metodo REST customers.createCustomerClient.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-03-08 UTC.
[null,null,["Ultimo aggiornamento 2025-03-08 UTC."],[[["While `Mutate`, `Search`, and `SearchStream` are commonly used, the Google Ads API offers a wide range of methods for specific tasks, all documented in the REST reference documentation."],["All Google Ads API service endpoints, including REST and gRPC, are defined in .proto files using the proto3 Interface Definition Language."],["The `google.api.http` annotation within these .proto files details how each method maps to HTTP for RESTful interactions, including examples like `ListAccessibleCustomers` and `CreateCustomerClient`."]]],["The Google Ads API includes various methods beyond `Mutate`, `Search`, and `SearchStream`, all detailed in REST documentation. Service endpoints are defined in `.proto` files using proto3. `ListAccessibleCustomers` is a GET method, mapped using the `google.api.http` annotation in the `customer_service.proto` file, and uses custom verb `listAccessibleCustomers`. Similarly, `CreateCustomerClient`, a POST method, uses custom verb `createCustomerClient`, also defined in the same file.\n"]]
