Mutate
、Search
和 SearchStream
是最常见的方法,
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 方法。