# 구글 시트 연동 방식

구글 시트 연동 업로드는 구글 스프레드시트의 데이터를 직접 LEVER Xpert 데이터센터로 가져오는 기능입니다. 구글 로그인을 통해 접근 권한이 있는 시트의 데이터를 업로드할 수 있습니다.

## 1단계: 기본 정보 입력 <a href="#id-1" id="id-1"></a>

<figure><img src="https://3711033526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpqoSMIt3zkckXcCoNG4M%2Fuploads%2FpdjE9kvxMX3vr4BDNXxB%2F%EC%8B%9C%ED%8A%B8_1%EB%8B%A8%EA%B3%84.png?alt=media&#x26;token=46334fc8-e63f-46c4-9a54-57c86f10c3c2" alt="" width="563"><figcaption></figcaption></figure>

### 1. 데이터 이름 입력 <a href="#undefined" id="undefined"></a>

업로드할 데이터를 식별할 수 있는 고유한 이름을 입력합니다.

데이터 목록 탭의 데이터 이름 컬럼에 나타나는 항목입니다.

### 2. 데이터 유형 선택 <a href="#undefined" id="undefined"></a>

업로드할 데이터의 성격에 따라 데이터센터에서 지원하는 아래 4가지 유형 중 하나를 선택합니다.

<table data-header-hidden><thead><tr><th width="179.4000244140625"></th><th></th><th></th></tr></thead><tbody><tr><td>유형</td><td>설명</td><td>데이터센터 처리 방식</td></tr><tr><td><strong>매체</strong></td><td>매핑의 기준이 되는 데이터</td><td>매체로 취급</td></tr><tr><td><strong>트래커</strong></td><td>매핑의 재료가 되는 데이터</td><td>트래커로 취급</td></tr><tr><td><strong>인덱스</strong></td><td>매핑의 재료가 되는 데이터</td><td>인덱스로 취급</td></tr><tr><td><strong>호스팅</strong></td><td>매핑의 재료가 되는 데이터</td><td>트래커 및 인덱스로 취급</td></tr></tbody></table>

## 2단계: 구글 시트 연동 <a href="#id-2" id="id-2"></a>

<figure><img src="https://3711033526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpqoSMIt3zkckXcCoNG4M%2Fuploads%2FTpqn41bk1rmoAADswKe7%2F%EC%8B%9C%ED%8A%B8_2%EB%8B%A8%EA%B3%84.png?alt=media&#x26;token=44267aa1-dcf9-484c-b062-6c2784f9dcf3" alt="" width="563"><figcaption></figcaption></figure>

### 3. 구글 로그인 <a href="#undefined" id="undefined"></a>

구글 시트 연동 방식을 선택한 후 스프레드시트 선택 버튼을 클릭하면 구글 로그인 옵션이 활성화됩니다.

구글 계정으로 로그인 진행한 후 로그인한 계정의 권한으로 시트에 접근할 수 있습니다.

### 4. 구글 시트 선택 <a href="#undefined" id="undefined"></a>

1. **스프레드시트 선택**
   * 로그인한 계정에서 접근 가능한 구글 스프레드시트 리스트가 표시됩니다.
   * 리스트에서 원하는 스프레드시트를 선택합니다.
2. **워크시트 선택**
   * 선택한 스프레드시트 내의 워크시트 목록을 드롭다운으로 제공합니다.
   * 업로드하고자 하는 특정 워크시트를 선택합니다.

## 3단계: 업로드 검증 <a href="#id-3" id="id-3"></a>

<figure><img src="https://3711033526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpqoSMIt3zkckXcCoNG4M%2Fuploads%2FGfPtwaE2IVKktCCSxie9%2F%EC%8B%9C%ED%8A%B8_3%EB%8B%A8%EA%B3%84.png?alt=media&#x26;token=db088125-7f3f-4ec8-b131-e10261427820" alt="" width="563"><figcaption></figcaption></figure>

### 5. 업로드 데이터 확인 버튼 활성화 <a href="#undefined" id="undefined"></a>

워크시트 선택을 완료하면 최하단의 **업로드 데이터 확인** 버튼이 활성화됩니다.

**상태 표시**

* **파란 체크 표시 있음**: 업로드 준비가 완료된 상태를 의미합니다.
* **파란 체크 표시 없음**: 데이터에 문제가 발견된 경우로, 확인이 필요합니다.

**완료 버튼 제한**

파란 체크 표시가 없는 상태에서 데이터 업로드 완료를 시도할 경우 "완료할 수 없습니다"라는 메시지가 표시됩니다.

이 때에는 반드시 **업로드 데이터 확인** 버튼을 클릭해 문제를 해결해야 업로드를 완료할 수 있습니다.

## 4단계: 데이터 형식 검증 및 설정 <a href="#id-4" id="id-4"></a>

<figure><img src="https://3711033526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpqoSMIt3zkckXcCoNG4M%2Fuploads%2FD2NAd0v0oD2LgW9hueum%2F%EC%8B%9C%ED%8A%B8_4%EB%8B%A8%EA%B3%84.png?alt=media&#x26;token=711e9e7c-d9d6-4f80-a53f-c2e24223a785" alt=""><figcaption></figcaption></figure>

### 6. 업로드 데이터 확인 팝업 <a href="#undefined" id="undefined"></a>

업로드하려는 데이터의 컬럼과 데이터 타입을 확인할 수 있으며, 데이터 타입을 지정할 수 있습니다.

**컬럼 분석**

* **컬럼 헤더**: 구글 시트의 실제 컬럼명이 표시됩니다.
* **데이터 타입**: Xpert에서 각 컬럼에 대해 자동으로 인식한 데이터 유형이 표시됩니다.

**지원 데이터 타입**

<table data-header-hidden><thead><tr><th width="213"></th><th></th><th></th></tr></thead><tbody><tr><td>데이터 타입</td><td>설명</td><td>변환 옵션</td></tr><tr><td><strong>일자</strong></td><td>날짜 형식 데이터<br>(YYYY-MM-DD 형식 필수)</td><td>기준 일자로 지정 가능</td></tr><tr><td><strong>일시</strong></td><td>날짜와 시간이 포함된 데이터</td><td>변환 불가</td></tr><tr><td><strong>문자</strong></td><td>텍스트 형식 데이터</td><td>변환 불가</td></tr><tr><td><strong>숫자</strong></td><td>숫자 형식 데이터</td><td>문자로 변환 가능</td></tr><tr><td><strong>비어있음</strong></td><td>빈 값이 포함된 컬럼</td><td>문자로 변환 가능</td></tr></tbody></table>

**데이터 타입 변환**

* **숫자 → 문자**: 숫자 데이터를 텍스트로 처리하고 싶을 때 사용
* **비어있음 → 문자**: 빈 값이 있는 컬럼을 문자열로 처리

**기준 일자 설정**

기준 일자는 Xpert 데이터센터에서 **모든 데이터 처리의 기준**이 되는 핵심 날짜입니다. 필터링, 내보내기 및 데이터센터 내 날짜 기반 검색과 분석의 핵심 요소로 작용합니다.

{% hint style="warning" %}
**매체, 트래커, 호스팅** 데이터 업로드 시 기준 일자를 지정하는 것을 **강력 권장**드립니다.

기준 일자를 지정하지 않을 경우 데이터센터에서 날짜 필터링이 제대로 작동하지 않습니다.
{% endhint %}

* **필수 형식**: `YYYY-MM-DD` (예: 2025-08-09)
* 다른 형식의 날짜는 업로드가 불가합니다.
* 형식이 불일치할 경우 데이터를 수정한 후 재업로드가 필요합니다.

## 5단계: 데이터 수정 및 재검증 <a href="#id-5" id="id-5"></a>

### 7. 데이터 수정 및 재검증 <a href="#undefined" id="undefined"></a>

업로드한 데이터에 형식 오류가 있는 경우 `업로드 데이터 확인` 창에 오류가 표시되며, 데이터 수정 및 재검증으로 통해 업로드를 완료할 수 있습니다.

**일반적인 형식 오류**

* 일자 컬럼의 날짜 형식이 잘못된 경우
* 숫자로 인식되어야 할 데이터가 텍스트로 저장된 경우
* 필수 데이터가 누락된 경우
* 예상과 다른 데이터 타입으로 인식된 경우

**형식 오류 해결 프로세스**

1. **직접 수정**: 구글 스프레드시트에서 오류가 발생한 데이터를 직접 수정합니다.
2. **새로고침**: 업로드 데이터 확인 팝업의 **새로고침** 아이콘을 클릭합니다.
3. **재검증**: 수정된 데이터로 다시 형식 검증을 진행합니다.
4. **반복**: 모든 문제가 해결될 때까지 위 과정을 반복합니다.

### 8. 업로드 완료 <a href="#undefined" id="undefined"></a>

모든 검증이 완료되면 팝업 창의 `확인` 버튼을 누른 후, `업로드 데이터 확인` 버튼에 파란 체크 표시가 나타나면 **완료** 버튼을 클릭할 수 있습니다.

데이터가 Xpert 데이터센터로 안전하게 업로드되며, 이후 데이터 업로드 관리 화면에서 상태 확인이 가능합니다.