其他方法

MutateSearchSearchStream 是最常见的方法, Google Ads API 中还有许多其他可用于特定用途的 API。所有服务和 其 API 均记录在 REST 参考文档

协议缓冲区 RPC 到 REST 的映射

所有服务端点(无论是使用 REST 和 gRPC)最终都由 在 服务软件包的.proto 文件 使用 proto3 接口定义语言

示例:ListAccessibleCustomers

例如,customer_service.proto 文件 除了标准 Mutate 之外,还定义了 ListAccessibleCustomers 方法 ,了解所有最新动态。其 google.api.http 注解描述了 该方法映射到 HTTP 的方式它使用带有自定义动词的 HTTP GET listAccessibleCustomers

rpc ListAccessibleCustomers(ListAccessibleCustomersRequest)
    returns (ListAccessibleCustomersResponse) {
  option (google.api.http) = {
    get: "/v17/customers:listAccessibleCustomers"
  };
}

这将映射到 customers.listAccessibleCustomers REST 方法。

示例:CreateCustomerClient

customer_service.proto 中的另一个示例是 CreateCustomerClient 方法。其 google.api.http 注解描述的是 使用自定义动词 createCustomerClient 的 HTTP POST

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";
}

这将映射到 customers.createCustomerClient REST 方法。