# Google Sheets 애드온: 스프레드시트로 데이터 추출

> Google Workspace Marketplace에서 ImageToTable.ai 애드온을 설치하고, Google 로그인 또는 API Key로 기존 계정에 연결한 후, 열려 있는 스프레드시트에 추출된 행을 업로드, 처리, 삽입할 수 있습니다 — 웹 앱과 동일한 크레딧을 사용합니다.

**Google Sheets용 ImageToTable.ai 애드온**은 스프레드시트 옆 사이드바에 추출 도구를 배치합니다. 문서를 업로드하고 처리한 후 추출된 행을 작업 중인 시트에 삽입할 수 있습니다 — 웹사이트와 동일한 계정, [템플릿](/docs/reference/glossary#template), [크레딧](/docs/reference/glossary#credits)을 사용합니다.

## 애드온 설치

Google Workspace Marketplace에서 설치합니다:

[ImageToTable.ai — 이미지에서 데이터 추출](https://workspace.google.com/marketplace/app/imagetotableai_%E2%80%94_extract_data_from_image/758062068256?flow_type=2)

설치가 완료되면 Google Sheets를 열고 **확장 프로그램 → ImageToTable.ai → 열기**로 이동합니다. 사이드바가 스프레드시트 오른쪽에 나타납니다. 필요할 때마다 같은 방법으로 다시 열 수 있습니다.

## 계정 연결

애드온은 기존 ImageToTable.ai 계정을 사용합니다 — 별도로 계정을 만들거나 추가로 구독할 필요가 없습니다. 사이드바 상단의 **Account** 섹션에서 두 가지 방법으로 연결할 수 있습니다:

- **Google로 로그인.** **Google로 로그인**을 클릭하고 요청을 승인합니다. 해당 Google 계정이 이미 ImageToTable.ai 계정에 연결되어 있으면 사이드바가 해당 계정을 엽니다. 연결되어 있지 않으면 새 계정이 생성됩니다.
- **API Key 붙여넣기.** **API Key 붙여넣기** 입력란에 키를 입력하거나 붙여넣고 **저장**을 클릭합니다. 입력란에서 키를 찾을 수 있는 위치를 안내합니다: 웹사이트 프로필 페이지의 **API Key** 섹션입니다.

API Key는 사이드바를 계정에 연결하는 역할을 하므로 비밀번호처럼 취급해야 합니다 — 키를 가진 사람은 누구나 계정으로 활동할 수 있습니다. 키를 발급받거나 더 이상 사용하지 않을 키를 교체하려면 [API Key 관리](/docs/guides/api-key-management)를 참조하세요.

연결되면 Account 섹션에 사용자 이름, 요금제, 크레딧 **Balance**가 표시됩니다. **Switch Account**는 API Key로 다른 계정을 연결하고, **Sign out**은 스프레드시트에 영향을 주지 않고 사이드바 연결을 해제합니다.

동일한 계정을 사용하므로 사이드바는 웹 앱과 모든 것을 공유합니다:

- **Files** 목록에는 웹사이트에서 업로드하거나 처리한 배치를 포함한 계정의 모든 배치가 표시됩니다.
- **Data Columns** 섹션은 웹사이트에서 이미 저장한 템플릿과 함께 작동합니다.
- 처리 시 프로필에 표시된 것과 동일한 크레딧 잔액이 사용됩니다.

## 사이드바에서 할 수 있는 작업

### 문서 업로드

**Your Uploads** 섹션의 **Files** 탭에 있는 **Upload** 버튼을 사용하여 컴퓨터에서 파일을 추가할 수 있습니다. 이미지, PDF, Word 문서(`.docx`), 일반 텍스트 파일(`.txt`)이 지원되며, 여러 개를 한 번에 선택할 수 있습니다. PDF를 추가하면 먼저 **Select PDF Pages** 대화상자가 열려 전체 문서를 가져오는 대신 보낼 페이지를 선택할 수 있습니다. 각 파일 유형이 도착했을 때 어떻게 처리되는지는 [Uploading Documents](/docs/guides/uploading-documents)를 참조하세요.

### 추출할 항목 선택

**Data Columns** 섹션은 대시보드의 섹션과 동일하게 작동합니다. 입력란에 열 이름을 입력하고 **Add**를 클릭합니다. **New**, **Switch**, **Settings**는 템플릿을 만들고, 선택하고, 구성합니다. 웹사이트에 저장된 모든 템플릿을 여기에서 사용할 수 있으므로 열을 한 번 설정하고 어느 곳에서든 사용할 수 있습니다 — [Templates & Columns](/docs/concepts/templates-and-columns)를 참조하세요. 열이 정의되지 않은 배치를 처리하기 시작하고 파일이 두 개 이상인 경우, 사이드바는 실행 전에 **AI-Suggested Columns** 목록을 제안할 수 있습니다.

### 배치 처리

Files 목록의 각 배치에는 처리를 시작하는 재생 컨트롤이 있습니다. 사이드바는 먼저 사용 가능한 크레딧을 확인합니다. 모든 파일에 충분하지 않은 경우 **Insufficient Credits** 대화상자가 표시되어 **Get More Credits**을 제공하거나 잔액으로 처리 가능한 파일만 처리합니다. 이미 처리된 배치는 다시 실행할 수 있으며, 사이드바는 실패했거나 처리되지 않은 파일만 다시 제출할지 아니면 모든 것을 다시 처리할지 묻습니다.

### 결과를 시트에 쓰기

**Insert**는 추출된 행을 현재 열려 있는 시트에 씁니다. 단일 파일의 결과, 전체 배치 또는 여러 배치를 한 번에 삽입할 수 있습니다 — 동일한 열을 공유하는 결과는 배치와 관계없이 하나의 헤더 아래에 기록됩니다. 삽입된 모든 행은 소스 **File Name** 및 **Batch**를 포함하므로 시트에 들어간 후에도 행을 추적할 수 있습니다.

삽입의 열이 해당 시트에 대한 마지막 삽입과 일치하면 행이 기존 헤더 아래에 추가됩니다. 열 집합이 다른 경우 새 헤더 행이 새 행 위에 추가되어 기존 테이블에 섞이지 않습니다.

삽입 전에 추출된 테이블을 원본 문서와 함께 보여주는 미리보기를 열고 배치의 파일을 넘겨볼 수 있습니다. 사이드바는 To Table 모드로 파일을 처리하므로 기록하는 결과는 추출된 테이블입니다. 테이블 결과가 없는 배치는 삽입할 내용이 없습니다. 테이블 대신 편집 가능한 Word 출력으로 문서를 되돌려 받으려면 웹 앱의 To Word 모드와 [Export](/docs/guides/export)를 사용하세요.

## 크레딧 작동 방식

이 애드온에는 자체 할당량이 없습니다. 사이드바에서 처리하는 작업은 웹 앱과 동일한 [크레딧](/docs/reference/glossary#credits)이 동일한 요율로 차감됩니다. 파일 하나당 한 번 차감되며, 계정의 [Model Tier](/docs/concepts/model-tier)에 따라 결정됩니다. PDF, Word, 텍스트 파일의 모든 페이지가 각각 하나의 파일로 간주되므로 여러 페이지 문서는 여러 크레딧을 사용합니다.

Account 섹션에는 항상 현재 잔액이 표시되며, **Get more**를 클릭하면 요금제 페이지로 이동합니다. 애드온을 사용해도 다른 종류의 크레딧이 적립되거나 소비되지 않습니다. 여기서 사용한 잔액은 웹사이트에서 사용하는 것과 동일한 잔액입니다. 요금제별 세부 정보는 [Plans & Credits](/docs/guides/plans-and-points)에서 확인할 수 있습니다.

## 자주 묻는 질문

### 애드온에 별도 계정이나 구독이 필요한가요?

아니요. 애드온은 이미 보유한 계정에 연결되며 별도 할당량이 없습니다. 보유한 요금제가 여기서도 적용됩니다.

### 웹사이트와 동일한 파일과 템플릿이 표시되나요?

네. Files 목록, Data Columns의 템플릿, 크레딧 잔액은 모두 계정에서 가져오므로 웹사이트에서 업로드한 배치를 여기서 처리하고 결과를 스프레드시트에 삽입할 수 있습니다.

### 결과는 어떤 시트에 삽입되나요?

삽입할 때 활성화된 시트, 즉 사이드바가 연결된 스프레드시트에서 선택된 탭에 삽입됩니다. 새 열 집합을 삽입하는 경우 데이터 위에 헤더 행이 추가됩니다.

### 크레딧이 소진되면 어떻게 되나요?

처리가 시작되지 않습니다. 사이드바에 보유 크레딧 수와 배치에 필요한 크레딧 수가 표시되며, 더 보기 또는 잔액으로 처리 가능한 파일만 처리할 수 있습니다. [Plans & Credits](/docs/guides/plans-and-points)를 참조하세요.

---

Source: https://imagetotable.ai/ko/docs/guides/google-sheets-add-on