REST Resource: properties.audienceExports

리소스: AudienceExport

잠재고객 내보내기는 목록 생성 시점의 잠재고객에 있는 사용자 목록입니다. 한 잠재고객에 대해 서로 다른 날짜에 생성된 잠재고객 내보내기가 여러 개 있을 수 있습니다.

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

출력 전용입니다. 식별자. 생성 중에 할당된 잠재고객 내보내기 리소스 이름입니다. 이 리소스 이름은 이 AudienceExport을 식별합니다.

형식: properties/{property}/audienceExports/{audienceExport}
audience

string

필수 항목입니다. 잠재고객 리소스 이름입니다. 이 리소스 이름은 나열되는 잠재고객을 식별하며 애널리틱스 데이터 및 관리 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 상태를 시작한 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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는 요청에서 비동기적으로 활성 상태로 업데이트됩니다. 이는 초기 생성 호출 후 일정 시간 (예: 15분)이 지난 후에 발생합니다.
FAILED AudienceExport를 만들 수 없습니다. 이 잠재고객 내보내기를 다시 요청하면 성공할 수도 있습니다.

메서드

create

 나중에 검색할 수 있도록 잠재고객 내보내기를 만듭니다.

get

 특정 잠재고객 내보내기에 관한 구성 메타데이터를 가져옵니다.

list

 속성의 모든 잠재고객 내보내기를 나열합니다.

query

 사용자의 잠재고객 내보내기를 가져옵니다.