Method: properties.audienceExports.query

사용자의 잠재고객 내보내기를 가져옵니다. 잠재고객을 만든 후에는 사용자를 즉시 내보낼 수 없습니다. 먼저 audienceExports.create에 대한 요청이 있어야 사용자의 잠재고객 내보내기를 만들 수 있으며, 그런 다음 이 메서드를 사용하여 잠재고객 내보내기에서 사용자를 가져옵니다.

예시와 함께 잠재고객 내보내기를 소개하려면 잠재고객 내보내기 만들기를 참고하세요.

Google 애널리틱스의 잠재고객을 사용하면 비즈니스에 중요한 방식으로 사용자를 분류할 수 있습니다. 자세한 내용은 https://support.google.com/analytics/answer/9267572를 참고하세요.

잠재고객 내보내기 API에는 알파 안정성의 메서드와 베타 안정성의 메서드가 있습니다. 일부 의견과 채택 후 메서드를 베타 안정성으로 발전시키는 것이 목표입니다. 이 API에 대한 의견을 제공하려면 Google 애널리틱스 잠재고객 내보내기 API 의견 양식을 작성하세요.

HTTP 요청

POST https://analyticsdata.googleapis.com/v1beta/{name=properties/*/audienceExports/*}:query

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
name

string

필수 항목입니다. 사용자를 가져올 잠재고객 내보내기의 이름입니다. 형식: properties/{property}/audienceExports/{audienceExport}

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "offset": string,
  "limit": string
}
필드
offset

string (int64 format)

선택사항입니다. 시작 행의 행 수입니다. 첫 번째 행은 행 0으로 계산됩니다.

페이지를 나눌 때 첫 번째 요청은 오프셋을 지정하지 않거나 오프셋을 0으로 설정합니다. 첫 번째 요청은 첫 번째 limit 행을 반환합니다. 두 번째 요청은 오프셋을 첫 번째 요청의 limit로 설정합니다. 두 번째 요청은 두 번째 limit 행을 반환합니다.

이 페이지 나누기 매개변수에 대한 자세한 내용은 페이지 나누기를 참고하세요.
limit

string (int64 format)

선택사항입니다. 반환할 행 수입니다. 지정하지 않으면 10,000개의 행이 반환됩니다. 요청한 수와 관계없이 API는 요청당 최대 250,000개의 행을 반환합니다. limit는 양수여야 합니다.

API는 limit만큼의 측정기준 값이 없는 경우 요청된 limit보다 적은 행을 반환할 수도 있습니다.

이 페이지 나누기 매개변수에 대한 자세한 내용은 페이지 나누기를 참고하세요.

응답 본문

잠재고객 내보내기의 사용자 목록입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "audienceRows": [
    {
      object (AudienceRow)
    }
  ],
  "audienceExport": {
    object (AudienceExport)
  },
  "rowCount": integer
}
필드
audienceRows[]

object (AudienceRow)

잠재고객 내보내기의 각 사용자에 대한 행입니다. 이 응답의 행 수는 요청의 페이지 크기보다 작거나 같습니다.
audienceExport

object (AudienceExport)

쿼리 중인 AudienceExport에 관한 구성 데이터입니다. 이 응답에서 잠재고객 행을 해석하는 데 도움이 되도록 반환됩니다. 예를 들어 이 AudienceExport의 측정기준은 AudienceRows의 열에 해당합니다.
rowCount

integer

AudienceExport 결과의 총 행 수입니다. rowCount는 응답에서 반환되는 행 수, limit 요청 매개변수, offset 요청 매개변수와는 독립적입니다. 예를 들어 쿼리가 175개의 행을 반환하고 API 요청에 50개의 limit가 포함된 경우 응답에는 rowCount가 175개이지만 행은 50개만 포함됩니다.

이 페이지 나누기 매개변수에 대한 자세한 내용은 페이지 나누기를 참고하세요.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

AudienceRow

잠재고객 사용자 행의 측정기준 값 속성입니다.

JSON 표현 
{
  "dimensionValues": [
    {
      object (AudienceDimensionValue)
    }
  ]
}
필드
dimensionValues[]

object (AudienceDimensionValue)

잠재고객 사용자의 각 측정기준 값 속성입니다. 요청된 각 측정기준 열에 측정기준 값 하나가 추가됩니다.

AudienceDimensionValue

측정기준의 값입니다.

JSON 표현 
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
필드
통합 필드 one_value. 한 종류의 측정기준 값입니다. one_value은 다음 중 하나여야 합니다.
value

string

측정기준 유형이 문자열인 경우 문자열 값입니다.