Method: properties.audienceLists.exportSheet

사용자의 잠재고객 목록을 Google 시트로 내보냅니다. 잠재고객을 만든 후 사용자를 즉시 나열할 수 있는 것은 아닙니다. 먼저 사용자의 잠재고객 목록을 만들려면 audienceLists.create에 대한 요청이 필요하며, 두 번째로 이 방법을 사용하여 잠재고객 목록의 사용자를 Google 시트로 내보냅니다.

잠재고객 목록에 대한 소개와 예를 보려면 잠재고객 목록 만들기를 참조하세요.

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

이 메서드는 알파 버전을 출시할 만큼 안정적일 때, 베타를 시작하기 전 구문 및 기능에 대한 의견을 수집하기 위해 도입됩니다. 이 API에 대한 의견을 보내려면 Google 애널리틱스 Audience Export API 의견 양식을 작성하세요.

HTTP 요청

POST https://analyticsdata.googleapis.com/v1alpha/{name=properties/*/audienceLists/*}:exportSheet

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

경로 매개변수

매개변수
name

string

필수 항목입니다. 사용자를 검색할 잠재고객 목록의 이름입니다. 형식: properties/{property}/audienceLists/{audienceList}

요청 본문

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

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보다 적은 수의 행을 반환할 수도 있습니다.

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

응답 본문

잠재고객 목록에 사용자 목록이 포함된 생성된 Google 시트입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "spreadsheetUri": string,
  "spreadsheetId": string,
  "rowCount": integer,
  "audienceList": {
    object (AudienceList)
  }
}
입력란
spreadsheetUri

string

Google 시트를 보기 위해 브라우저에서 방문할 수 있는 URI입니다.
spreadsheetId

string

생성된 Google 시트 리소스를 식별하는 ID입니다.
rowCount

integer

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

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

object (AudienceList)

내보내는 AudienceList에 대한 구성 데이터입니다. 이 응답의 Google 시트에 있는 AudienceList를 해석하는 데 도움을 주기 위해 반환됩니다.

예를 들어 AudienceList에 Google 시트에 있는 것보다 많은 행이 있을 수 있습니다. 이 경우 다른 offset 값을 사용하여 추가 시트 내보내기 요청을 보내 추가 Google 시트에서 다음 행 페이지를 가져올 수 있습니다.

승인 범위

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

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets