사용자의 잠재고객 목록을 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 |
필수 항목입니다. 사용자를 가져올 잠재고객 목록의 이름입니다. 형식: |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "offset": string, "limit": string } |
필드 | |
---|---|
offset |
선택사항입니다. 시작 행의 행 수입니다. 첫 번째 행은 0행으로 계산됩니다. 페이징할 때 첫 번째 요청은 오프셋을 지정하지 않습니다. 또는 이와 동등하게 오프셋을 0으로 설정합니다. 첫 번째 요청은 행의 처음 페이지로 나누기 매개변수에 관한 자세한 내용은 페이지로 나누기를 참고하세요. |
limit |
선택사항입니다. 반환할 행의 개수입니다. 지정하지 않으면 10,000행이 반환됩니다. API는 요청 수에 관계없이 요청당 최대 250,000개의 행을 반환합니다. 측정기준 값이 페이지로 나누기 매개변수에 관한 자세한 내용은 페이지로 나누기를 참고하세요. |
응답 본문
잠재고객 목록의 사용자 목록으로 생성된 Google 시트입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"spreadsheetUri": string,
"spreadsheetId": string,
"rowCount": integer,
"audienceList": {
object ( |
필드 | |
---|---|
spreadsheetUri |
Google 시트를 보기 위해 브라우저에서 방문할 수 있는 URI입니다. |
spreadsheetId |
생성된 Google 시트 리소스를 식별하는 ID입니다. |
rowCount |
AudienceList 결과의 총 행 수입니다. 페이지로 나누기 매개변수에 관한 자세한 내용은 페이지로 나누기를 참고하세요. |
audienceList |
내보내는 AudienceList에 대한 구성 데이터입니다. 이 응답의 Google 시트에서 AudienceList를 해석하기 위해 반환됩니다. 예를 들어 AudienceList에 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