> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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 블록이 있는 파운더리 파이프라인을 쓰세요. [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) 파운더리 파이프라인에서 Drive 쓰기.
* [Tool 블록](/ko/build/workflow/tool-block) Agent가 Google API를 부르는 방법.