Si bien Mutate, Search y SearchStream son los métodos más comunes
en la API de Google Ads, existen muchos otros para fines específicos. Todos los servicios y
sus APIs se documentan en la
documentación de referencia.
Asignaciones de RPC de búfer de protocolo a REST
Todos los extremos de 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 customer_service.proto archivo
define un método ListAccessibleCustomers, además del Mutate
estándar. Su google.api.http anotación describe
cómo se asigna el método a HTTP. Usa un GET de HTTP con el verbo personalizado listAccessibleCustomers:
rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) returns (ListAccessibleCustomersResponse) { option (google.api.http) = { get: "/v25/customers:listAccessibleCustomers" }; }
Esto se asigna al 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: "/v25/customers/{customer_id=*}:createCustomerClient" body: "*" }; option (google.api.method_signature) = "customer_id,customer_client"; }
Esto se asigna al método REST customers.createCustomerClient.