その他の方法

Mutate、Search、SearchStream は Google Ads API の最も一般的なメソッドですが、特定の目的のためのメソッドは他に多数あります。すべてのサービスとその API は、REST リファレンス ドキュメントに記載されています。

プロトコル バッファの RPC から REST へのマッピング

すべてのサービス エンドポイント（REST と gRPC のどちらを使用する場合でも）は、最終的に proto3 インターフェース定義言語を使用して、サービス パッケージの .proto ファイルで定義されます。

例: ListAccessibleCustomers

たとえば、customer_service.proto ファイルでは、標準の Mutate に加えて ListAccessibleCustomers メソッドが定義されています。google.api.http アノテーションは、このメソッドが HTTP にどのようにマッピングされるかを示しています。HTTP GET とカスタム動詞 listAccessibleCustomers を使用します。

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

これは customers.listAccessibleCustomers REST メソッドにマッピングされます。

例: CreateCustomerClient

customer_service.proto のもう一つの例は、CreateCustomerClient メソッドです。その google.api.http アノテーションは、カスタム動詞 createCustomerClient を使用して HTTP POST を記述します。

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

これは customers.createCustomerClient REST メソッドにマッピングされます。

前へ
Mutate
次へ
例