その他の方法

注: Google Ads API を初めて使用する場合は、まずスタート ガイドをお読みになることをおすすめします。スタートガイドでは、アカウントの設定方法と最初の API 呼び出しを行う方法について説明しています。必ず [curl] タブに沿って操作してください。

Mutate、Search、SearchStream は Google Ads API で最も一般的なメソッド ですが、特定の目的で使用するメソッドも多数用意されています。すべてのサービスと その API については、 リファレンス ドキュメントで説明されています。

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

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

例: ListAccessibleCustomers

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

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

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