後で取得できるようにオーディエンス リストを作成します。このメソッドは、オーディエンス リストのリソース名をすばやく返し、長時間実行される非同期リクエストを開始して、オーディエンス リストを作成します。オーディエンス リストのユーザーを一覧表示するには、まずこのメソッドでオーディエンス リストを作成してから、オーディエンス リソース名を audienceLists.query メソッドに送信します。
オーディエンス リストの概要と例については、オーディエンス リストを作成するをご覧ください。
オーディエンス リストとは、オーディエンス リストの作成時に、そのオーディエンスに現在含まれているユーザーのスナップショットです。1 つのオーディエンスに対して日ごとにオーディエンス リストを作成すると、そのオーディエンスへの参加と離脱によって結果が異なります。
Google アナリティクス 4 のオーディエンスを使用すると、ビジネスの目的に合わせてユーザーをセグメント化できます。詳しくは、https://support.google.com/analytics/answer/9267572 をご覧ください。オーディエンス リストには、各オーディエンスのユーザーが含まれます。
このメソッドは、audienceExports.create でベータ版の安定版として利用できます。この API に関するフィードバックは、Google アナリティクス Audience Export API フィードバック フォームにご記入ください。
HTTP リクエスト
POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
| パラメータ | |
|---|---|
parent |
必須。このオーディエンス リストが作成される親リソース。形式: |
リクエスト本文
リクエストの本文には AudienceList のインスタンスが含まれています。
レスポンスの本文
成功した場合、レスポンスの本文には、新しく作成された Operation のインスタンスが含まれます。
承認スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/analytics.readonlyhttps://www.googleapis.com/auth/analytics