Otros métodos

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 o 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: "/v21/customers:listAccessibleCustomers"
  };
}

Esto se asigna al método 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 HTTP con el verbo personalizado createCustomerClient:

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

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