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: "/v17/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 con el verbo personalizado createCustomerClient
:
rpc CreateCustomerClient(CreateCustomerClientRequest) returns (CreateCustomerClientResponse) { option (google.api.http) = { post: "/v17/customers/{customer_id=*}:createCustomerClient" body: "*" }; option (google.api.method_signature) = "customer_id,customer_client"; }
Esto se asigna al método de REST customers.createCustomerClient.