Otros métodos

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

Asignaciones de RPC de 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 con el lenguaje de definición de 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: "/v16/customers:listAccessibleCustomers"
  };
}
customer_service.proto

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 con el verbo personalizado createCustomerClient:

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

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