Mientras que 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 están documentadas en el
Documentación de referencia de REST
RPC de búfer de protocolo a asignaciones de REST
Todos los extremos del servicio (ya sea con REST o gRPC) se definen en última instancia en la Archivos.proto del paquete de servicios con el Lenguaje de definición de la interfaz proto3.
Ejemplo: ListaccesedCustomers
Por ejemplo, el archivo customer_service.proto
define un método ListAccessibleCustomers
, además del Mutate
estándar
de Google Cloud. 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 relaciona con customers.listAccessibleCustomers Método REST.
Ejemplo: CreateCustomerClient
Otro ejemplo de customer_service.proto
es
el método CreateCustomerClient
Su anotación google.api.http
describe un
HTTP POST
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 a customers.createCustomerClient. Método REST.