Caution: You are viewing documentation for the API's REST interface. Most of our official client libraries use gRPC. See the REST Introduction for details.

Otros métodos

Si bien Mutate, Search y SearchStream son los métodos más comunes en la API de Google Ads, existen muchos más para fines específicos. Todos los servicios y sus API están documentados en la documentación de referencia de REST.

Asignaciones de RPC del búfer de protocolo a REST

Todos los extremos del servicio (ya sea que usen REST y gRPC) se definen, en última instancia, en los archivos.proto del paquete de servicios mediante el lenguaje de definición de la interfaz proto3.

Ejemplo: ListAccessibleCustomers

Por ejemplo, el archivo customer_service.proto define un método ListAccessibleCustomers, además del Mutate estándar. Su anotación google.api.http describe cómo se asigna el método a HTTP. Usa un GET HTTP con el verbo personalizado listAccessibleCustomers:

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

Esto se mapea al método de REST customers.listAccessibleCustomers.

Ejemplo: CreateCustomerClient

Otro ejemplo de customer_service.proto es el método CreateCustomerClient. Su anotación google.api.http describe un POST de HTTP mediante el verbo personalizado createCustomerClient:

rpc CreateCustomerClient(CreateCustomerClientRequest) returns (CreateCustomerClientResponse) {
  option (google.api.http) = {
    post: "/v11/customers/{customer_id=*}:createCustomerClient"
    body: "*"
  };
  option (google.api.method_signature) = "customer_id,customer_client";
}

Esto se mapea al método de REST customers.createCustomerClient.