> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.nora.my/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Workspace

> Drive, Gmail, Calendar 를 데이터 소스와 액션 타겟으로 사용.

Google Workspace 커넥터가 가장 많이 쓰이는 통합. 연결하면 에이전트가 Drive 에서 읽기, Gmail 로 이메일 전송, Calendar 이벤트 읽기·쓰기 가능 — 모두 여러분이 승인한 스코프 안에서.

## 빌드 가능한 것

<CardGroup cols={2}>
  <Card title="DataSource 로서의 Drive" icon="folder">
    Agent 를 Drive 폴더로 가리킴. Docs, Sheets, Slides 검색 가능.
  </Card>

  <Card title="Gmail 전송 / 읽기" icon="envelope">
    연결된 편지함으로 이메일 초안·전송; 컨텍스트용 스레드 읽기.
  </Card>

  <Card title="Calendar" icon="calendar">
    캘린더 이벤트 목록, 새로 만들기, 여유 시간 확인.
  </Card>

  <Card title="Sheets 읽기 / 쓰기" icon="table">
    스프레드시트 로우 읽기 또는 Action 으로 새 로우 추가.
  </Card>
</CardGroup>

## Google 연결

1. **Settings → Connections → New → Google Workspace** 열기.
2. 쓰길 원하는 Google 계정으로 로그인.
3. 계획한 서비스의 스코프 부여 (Drive 읽기, Gmail 전송, Calendar 이벤트, Sheets 읽기/쓰기).
4. 연결이 워크스페이스에 나타남, Flow 에 붙일 준비.

<Note>
  Nora 는 실제 필요한 스코프만 요청. 셋업 중 Gmail 건너뛰면 그 스코프로 재연결할 때까지 Gmail 관련 블록 안 나타남.
</Note>

## DataSource 로서 Drive 사용

1. Flow 캔버스에서 **DataSource → Google Drive** 추가.
2. 픽커에서 폴더 선택 (연결된 계정으로).
3. 초기 인덱스 대기 (블록에 진행 pill 있음).
4. DataSource 를 Agent 에 연결.

새·업데이트된 파일 자동 동기화. 삭제된 파일이 몇 분 안에 인덱스에서 사라짐.

문서 컬렉션으로 자동 벌크 인제스트는 Google Drive Source 블록 있는 Foundry 파이프라인 사용 — [Source 블록](/ko/build/foundry/ingest) 참고.

## Gmail 로 이메일 전송

1. Flow 에 **Action → Gmail: Send** 추가.
2. 블록 설정에서 이메일이 뭘 담아야 하는지 설명 — Agent 가 대화 기반으로 세부 채움.
3. 전송 전 사람 리뷰 원하면 **Requires approval** 토글 ([승인·배포](/ko/reliable/optimization/approve) 참고).

Gmail 액션이 기본으로 연결된 편지함으로 전송. Reply-to 와 CC 는 Action 별 설정 가능.

## Calendar 읽기

1. Agent 에 **Tool → Google Calendar** 추가.
2. 캘린더와 작업 선택 (`list events`, `create event`, `find free time`).
3. Tool 을 Agent 에 연결.

대화가 캘린더 컨텍스트 필요할 때 Agent 가 호출 — "다음 여유 슬롯이 언제?", "3시 미팅 취소" 등.

## Sheets 읽기 / 쓰기

* **Tool → Google Sheets: Read** — Agent 가 범위 선택하고 로우 얻음. 조회 테이블에 유용.
* **Action → Google Sheets: Append** — Agent 결정 후 로우 씀. 로깅에 유용.

## 여러 Google 계정

워크스페이스당 여러 Google 계정 연결 가능. Drive DataSource 나 Gmail Action 추가할 때 어느 연결된 계정 쓸지 선택.

흔한 패턴: 공유 워크스페이스 데이터 (문서, 캘린더) 용 한 계정, 아웃바운드 전송 (no-reply 주소) 용 한 계정.

## 특정 폴더로 스코프

Drive 는 셋업 시 커넥터를 특정 폴더 트리로 좁힘:

* Agent 가 우발 읽을 수 있는 표면 감소.
* 초기 인덱싱 속도 향상.

나중에 재인증 없이 폴더 더 추가 가능.

## 연결 해제

**Settings → Connections → Google Workspace → Disconnect**. 연결 사용한 모든 블록이 재연결 또는 제거할 때까지 "reconnect needed" 상태 표시.

같은 Google 계정으로 재연결이 재인덱싱 없이 연결 복원.

## 스코프 변경

초기 셋업 후 추가 스코프 필요하면 (예: 기존 Drive 전용 연결에 Gmail 스코프 추가):

1. Settings → Connections → Google Workspace → **Update scopes**.
2. 재인증; Google 이 새 동의 화면 표시.
3. 추가된 스코프의 새 블록 사용 가능.

## 관련

* [커넥터](/ko/settings/connections/connectors) — 일반 커넥터 개념.
* [Source 블록](/ko/build/foundry/ingest) — Foundry 파이프라인의 Drive 사용.
* [Tool 블록](/ko/build/workflow/tool-block) — Agent 가 Google API 호출 방법.