其他方法

雖然 MutateSearchSearchStream 是最常見的方法 Google Ads API 中還有許多其他特定用途所有服務與 相關資訊都已記錄在 REST 參考說明文件

通訊協定緩衝區 RPC 到 REST 對應

最終會定義所有服務端點 (無論是使用 REST 和 gRPC) 的 服務套件的.proto 檔案 方法是使用 proto3 介面定義語言

範例:ListAccessibleCustomers

例如 customer_service.proto 檔案 除了標準 Mutate 之外,還會定義 ListAccessibleCustomers 方法 ,直接在 Google Cloud 控制台實際操作。其 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 方法。