REST Resource: properties.audienceExports

リソース: AudienceExport

オーディエンス エクスポートは、リストの作成時点でオーディエンスに含まれていたユーザーのリストです。1 つのオーディエンスに対して、異なる日に作成された複数のオーディエンス エクスポートが存在する場合があります。

JSON 表現 
{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "creationQuotaTokensCharged": integer,
  "state": enum (State),
  "beginCreatingTime": string,
  "rowCount": integer,
  "errorMessage": string,
  "percentageCompleted": number
}
フィールド
name

string

出力専用。ID。作成時に割り当てられたオーディエンス エクスポート リソース名。このリソース名は、この AudienceExport を識別します。

形式: properties/{property}/audienceExports/{audienceExport}
audience

string

必須。オーディエンス リソース名。このリソース名は、リストに表示されるオーディエンスを識別するもので、Analytics Data API と Admin API 間で共有されます。

形式: properties/{property}/audiences/{audience}
audienceDisplayName

string

出力専用。このオーディエンスのわかりやすい表示名。（例: 「購入者」）。
dimensions[]

object (AudienceDimension)

必須。リクエストされ、クエリ レスポンスに表示されるディメンション。
creationQuotaTokensCharged

integer

出力専用。AudienceExport の作成時に課金された割り当てトークンの合計数。このトークン数は CREATING 状態のアクティビティに基づいているため、AudienceExport が ACTIVE 状態または FAILED 状態になると、課金されるトークン数が修正されます。
state

enum (State)

出力専用。この AudienceExport の現在の状態。
beginCreatingTime

string (Timestamp format)

出力専用。audienceExports.create が呼び出され、AudienceExport が CREATING 状態になった時刻。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。
rowCount

integer

出力専用。AudienceExport の結果の行の合計数。
errorMessage

string

出力専用。作成中にオーディエンスのエクスポートに失敗すると、エラー メッセージが表示されます。このような失敗の一般的な原因は、割り当ての枯渇です。
percentageCompleted

number

出力専用。このオーディエンス エクスポートの完了率（0 ～ 100）。

AudienceDimension

オーディエンス ディメンションはユーザー属性です。特定のユーザー属性がリクエストされ、後で QueryAudienceExportResponse で返されます。

JSON 表現 
{
  "dimensionName": string
}
フィールド
dimensionName

string

省略可。ディメンションの API 名。ディメンション名の一覧については、API ディメンションをご覧ください。

州

AudienceExport は現在、この状態です。

列挙型
STATE_UNSPECIFIED 未指定の状態は使用されません。
CREATING AudienceExport は現在作成中であり、今後利用可能になる予定です。作成は、audienceExports.create 呼び出しの直後に行われます。
ACTIVE AudienceExport が完全に作成され、クエリを実行できる状態になりました。AudienceExport は、リクエストから非同期でアクティブに更新されます。これは、最初の作成呼び出しからしばらくした後（15 分など）に発生します。
FAILED AudienceExport を作成できませんでした。このオーディエンス エクスポートを再リクエストすると、成功する可能性があります。

メソッド

create

 後で取得できるようにオーディエンス エクスポートを作成します。

get

 特定のオーディエンス エクスポートに関する構成メタデータを取得します。

list

 プロパティのすべてのオーディエンス エクスポートを一覧表示します。

query

 ユーザーのオーディエンス エクスポートを取得します。