Method: properties.audienceLists.exportSheet

사용자의 잠재고객 목록을 Google Sheets로 내보냅니다. 잠재고객을 만든 후에는 사용자를 즉시 등록할 수 없습니다. 첫째, 사용자의 잠재고객 목록을 만들려면 audienceLists.create에 대한 요청이 필요합니다. 둘째, 이 메서드는 잠재고객 목록의 사용자를 Google Sheets로 내보내는 데 사용됩니다.

잠재고객 목록에 관한 소개와 예시는 잠재고객 목록 만들기를 참고하세요.

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 요청에 50개의 limit가 포함된 경우 응답에는 175개의 rowCount가 포함되지만 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