その他の方法

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

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

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

例: ListAccessibleCustomers

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

rpc ListAccessibleCustomers(ListAccessibleCustomersRequest)
    returns (ListAccessibleCustomersResponse) {
  option (google.api.http) = {
    get: "/v19/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: "/v19/customers/{customer_id=*}:createCustomerClient"
    body: "*"
  };
  option (google.api.method_signature) = "customer_id,customer_client";
}
customer_service.proto

これは、customers.createCustomerClient REST メソッドに対応しています。