プロパティのすべてのオーディエンス リストを一覧表示します。この方法を使用すると、不要な新しいオーディエンス リストを作成せずに、既存のオーディエンス リストを見つけて再利用できます。同じオーディエンスに複数のオーディエンス リストを含め、それぞれのオーディエンスに含まれる日が異なるユーザーのリストを表すことができます。
オーディエンス リストの概要と例については、オーディエンス リストを作成するをご覧ください。
この方法は、audienceExports.list でベータ版の安定版として利用できます。この API に関するフィードバックは、Google アナリティクス Audience Export API フィードバック フォームにご記入ください。
HTTP リクエスト
GET https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
parent |
必須。このプロパティのすべてのオーディエンス リストがレスポンスに含まれます。形式: |
クエリ パラメータ
パラメータ | |
---|---|
pageSize |
省略可。返されるオーディエンス リストの最大数。サービスはこの値より少ない値を返すことがあります。指定しない場合は、最大 200 個のオーディエンス リストが返されます。最大値は 1,000 です(それより大きい値は最大値に強制変換されます)。 |
pageToken |
省略可。前回の ページ分割を行う場合、 |
リクエスト本文
リクエストの本文は空にする必要があります。
レスポンスの本文
プロパティのすべてのオーディエンス リストのリスト。
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{
"audienceLists": [
{
object ( |
フィールド | |
---|---|
audienceLists[] |
プロパティの各オーディエンス リスト。 |
nextPageToken |
次のページを取得するために |
承認スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics