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

必須。オーディエンスのリソース名。このリソース名はリストされているオーディエンスを識別し、アナリティクス データと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 が更新されて、リクエストとは非同期に有効になります。最初の create 呼び出しからしばらく（たとえば 15 分）後に発生します。
FAILED AudienceExport を作成できませんでした。このオーディエンスのエクスポートを再度リクエストすると成功する可能性があります。

メソッド

create

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

get

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

list

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

query

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