Method: properties.audienceLists.create

後で取得できるようにオーディエンス リストを作成します。このメソッドは、オーディエンス リストのリソース名をすばやく返し、長時間実行される非同期リクエストを開始して、オーディエンス リストを作成します。オーディエンス リストのユーザーを一覧表示するには、まずこのメソッドでオーディエンス リストを作成してから、オーディエンス リソース名を 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

string

必須。このオーディエンス リストが作成される親リソース。形式: properties/{property}

リクエスト本文

リクエストの本文には AudienceList のインスタンスが含まれています。

レスポンスの本文

成功した場合、レスポンスの本文には、新しく作成された Operation のインスタンスが含まれます。

承認スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics