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