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

# Google 커넥터

> 기업 계정으로 생성한 Google OAuth 동의화면을 기반으로 커넥터를 연결합니다.

<Card>
  직접 생성한 OAuth 동의화면을 Ale에 연결하여 다양한 Google 도구를 안전하게 사용할 수 있습니다.
</Card>

## Google OAuth 앱 생성

### Google Cloud 프로젝트 생성

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/oauth01.webp" />
</Frame>

> Google Cloud에 접속한 후 새 프로젝트를 만들 수 있습니다.

### 사용할 API 추가하기

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/oauth02.webp" />
</Frame>

> 생성한 프로젝트에 진입한 후 사이드바의 `API 및 서비스 > 라이브러리`에서 사용할 API를 검색하고 `사용` 버튼을 클릭하세요.

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/oauth03.webp" />
</Frame>

<Tip>
  Gmail 이외에도 Ale AI에서 연동을 지원하는 다양한 API를 추가하여 사용할 수 있습니다.
</Tip>

### OAuth 동의 화면 생성

<Steps>
  <Step title="OAuth 동의 화면 생성 시작하기">
    <Frame>
      <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/oauth04.webp" />
    </Frame>

    사이드바의 `API 및 서비스 > OAuth 동의 화면`을 선택하고 `시작하기`를 클릭하면 동의 화면 생성 과정이 시작됩니다.
  </Step>

  <Step title="기본 정보 입력하기">
    <Frame>
      <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/oauth05.webp" />
    </Frame>

    앱 이름과 이메일 등 기본 정보를 입력합니다. 이 과정에서 2번 항목인 대상 설정은 Google Workspace를 사용하는 경우 `내부`를, 무료 Gmail을 사용하는 경우 `외부`를 선택해 주세요.

    <Tip>
      Google Workspace를 사용하지만, 조직 이외의 사용자도 사용할 필요가 있는 특수한 경우에는 `외부`로 선택해 주세요.
    </Tip>
  </Step>

  <Step title="데이터 액세스 범위 설정">
    <Frame>
      <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/oauth06.webp" />
    </Frame>

    `데이터 액세스` 페이지에서 `범위 추가 또는 삭제`를 클릭하면 이전 과정에서 사용 설정한 Gmail, Google Drive 등의 API를 OAuth 방식으로 활용할 수 있도록 설정할 수 있습니다. 우측 창에서 API를 검색한 후 최상단의 권한을 선택하고 업데이트 및 저장해주세요.

    <Note>
      API 검색 후 최상단에 표시되는 권한은 모든 권한입니다. 일부 기능만 사용하려는 경우, 필요한 권한만 활성화하고 업데이트하면 됩니다.
    </Note>
  </Step>

  <Step title="OAuth 사용자 대상 설정">
    <Frame>
      <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/oauth07.webp" />
    </Frame>

    `대상` 페이지에서 `앱 게시` 버튼을 클릭하여 OAuth 동의 화면의 게시 상태를 프로덕션으로 변경하세요.

    <Info>
      디폴트 상태는 테스트 모드입니다. 이 모드에서는 인증 토큰이 1주일마다 만료되어 재인증(로그인) 절차가 필요합니다. 프로덕션 모드로 사용하면 이러한 제한 없이 사용할 수 있습니다.
    </Info>

    <Tip>
      테스트 모드로 사용하려는 경우, 페이지 하단부에서 본인을 포함한 테스트 사용자 이메일을 추가해야 합니다.
    </Tip>

    <Note>
      모드 변경 후 상단에 "앱을 인증해야 합니다. 정보를 구성한 후 검토를 위해 앱을 제출하세요."라는 알람이 표시됩니다. 인증 대상은 OAuth 앱이며, 인증을 거치지 않아도 100명의 팀원까지는 사용할 수 있습니다.
    </Note>
  </Step>

  <Step title="클라이언트 만들기">
    <Frame>
      <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/oauth08.webp" />
    </Frame>

    `클라이언트` 페이지 상단의 `+ 클라이언트 만들기`를 클릭한 후, 아래 표를 참고하여 각 항목을 설정하고 `만들기` 버튼을 클릭하세요.

    | 항목               | 설정 내용                              |
    | :--------------- | :--------------------------------- |
    | **애플리케이션 유형**    | 드롭다운에서 `웹 애플리케이션` 선택               |
    | **이름**           | 자유롭게 입력                            |
    | **승인된 리디렉션 URI** | Ale AI의 Google 커넥터 화면에서 복사한 콜백 URL |
  </Step>
</Steps>

### OAuth 클라이언트 인증 정보 조회

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/oauth09.webp" />
</Frame>

> 클라이언트 생성 즉시 발급되는 `클라이언트 ID`와 `클라이언트 보안 비밀번호`를 복사하거나, 클라이언트 ID 상세 페이지에서 조회하여 사용할 수 있습니다.

## Ale AI와 연동

### Google 커넥터 설치

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/oauth10.webp" />
</Frame>

> `스페이스 설정 > 커넥터`에서 Google을 선택한 후 커넥터를 설치하세요.

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/oauth11.webp" />
</Frame>

### OAuth 클라이언트 인증 정보 입력

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/oauth12.webp" />
</Frame>

> 커넥터 설치 후 표시되는 `Client ID`와 `Client Secret` 필드에 [OAuth 클라이언트 생성 후 조회한 클라이언트 ID, 클라이언트 보안 비밀번호](/ko/google#oauth-클라이언트-인증-정보-조회)를 입력하고 저장하세요.

<Warning>
  Client ID에는 `https://`가 포함되지 않습니다.
</Warning>

## Google 도구 연동

> OAuth 동의화면 설정 과정에서 API를 추가한 서비스만 Ale AI에서 도구로 활용할 수 있습니다. 인증되지 않은 OAuth 앱이라는 경고창이 뜨는 경우, 하단부의 고급(Advanced)을 클릭하고 **Ale AI로 이동**을 선택한 후 연동을 마무리할 수 있습니다.

<Note>
  경고창은 Google에서 자동으로 표시하는 공지 문구로, 직접 만든 OAuth 앱은 인증 없이 사용할 수 있습니다.
</Note>

<Tip>
  Google Workspace를 사용하며, OAuth 사용 대상을 `내부`로 설정한 경우, 경고창이 표시되지 않으며 Google Workspace 조직 구성원만 사용할 수 있습니다. 이 경우 인원 수의 제한이 없습니다.

  <Frame>
    <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/oauth15.webp" />
  </Frame>
</Tip>