Method: properties.audienceExports.query

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

잠재고객 내보내기에 대한 소개와 예시는 잠재고객 내보내기 만들기를 참고하세요.

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

잠재고객 내보내기 API에는 알파 안정성의 메서드와 베타 안정성의 메서드가 있습니다. 일부 의견과 채택 후 메서드를 베타 안정성으로 발전시키는 것이 목표입니다. 이 API에 대한 의견을 보내려면 Google 애널리틱스 Audience Export 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은 양수여야 합니다.

limit만큼 많은 측정기준 값이 없는 경우 API는 요청된 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 요청에 limit이 50으로 포함된 경우 응답에는 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 표현 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "value": string
  // End of mutually exclusive fields.
}
필드
한 종류의 측정기준 값입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
value

string

측정기준 유형이 문자열인 경우 문자열로 된 값입니다.
상호 배타적 필드의 끝입니다.