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

必須。オーディエンス リソース名。このリソース名は、一覧表示されるオーディエンスを識別し、Google アナリティクス データ API と管理 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 状態になった時刻。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
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 は、リクエストから非同期でアクティブに更新されます。これは、最初の create 呼び出しからしばらく（15 分など）経過した後に発生します。
FAILED AudienceExport を作成できませんでした。このオーディエンスのエクスポートを再度リクエストすると、成功する可能性があります。

メソッド

create

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

get

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

list

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

query

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