# Google アプリ

> AI が使えるように Google Drive、Gmail、Google カレンダー、ドキュメント、スプレッドシートをつなぐ方法と、自分たちで運用するサーバーで管理者が先に行う設定です。

Google Drive、Gmail、Google カレンダー、Google ドキュメント、Google スプレッドシートは Trina AX に組み込まれています。各自がアプリごとに 1 回、自分の Google アカウントをつなぎます。AI はその人のチャットの中だけで、その人の Google の権限の範囲で使います。

コピーや貼り付けは必要ありません。Google でログインするだけです。

## Google アプリをつなぐ（全員）

> **ヒント:** **必要なもの**
>
> - 自分の Google アカウント（会社の Google Workspace アカウントまたは個人の Gmail アカウント）。ブラウザーでログインしておきます。

1. **コネクターでアプリを開く**

   左のバーの下にある自分の写真を選び、**設定 › コネクター** を開いて、**見つける** からアプリ（たとえば Gmail）を選びます。アプリのページには、AI ができることと、すべてのツールが載っています。

2. **接続を選ぶ**

   Google 自身のログインページが開きます（デスクトップアプリではブラウザーで開きます）。自分のアカウントを選びます。

3. **すべての項目にチェックを入れたままにする**

   Google が、Trina AX に許可する内容（「メールの閲覧、作成、送信」など）を一覧で表示します。**すべての** 項目にチェックを入れたまま **続行** を選びます。チェックを外した項目があるとログインは拒否されます。「一部の権限にチェックが入っていませんでした。もう一度接続し、すべての項目にチェックを入れたままにしてください。」

4. **アカウントを確かめる**

   Trina AX に戻ったら、表示されたアカウント（「このアカウントを接続しますか？」）を確かめて **このアカウントを確認** を選びます。ページに「（あなたのアドレス）で接続中」と表示されます。

読むだけなら確認はありません。AI がメールを送る、予定を追加する、ドキュメントを編集する前には、行う内容をすべて載せたカードを表示し、あなたの OK を待ちます。カードの上、またはアプリの **設定**（**⋯** メニュー）で、**先に確認する** の代わりに **常に許可** を選ぶこともできます。Google Drive は読むだけで、何かを変更、移動、送信することはありません。

### 「管理者に追加を依頼」と表示されたら

そのアプリはまだチームで設定されていません。**管理者に追加を依頼** を選ぶと、オーナーと管理者に通知が届き、接続できるようになったら知らせが来ます。

![メンバーの設定 › コネクターにある Google Drive のページ：接続の代わりに管理者に追加を依頼（Ask admin to add it）があり、AI が Drive でできることと 3 つのツールが表示されている](../../images/connect/google-member-ask.webp "管理者に追加を依頼")

## チームで共有する Google アカウント（管理者）

`sales@acme.com` のような共有のメールボックスやカレンダーは、必要な人のために 1 回だけつなげます。**管理 › 連携サービス** で Google アプリを開き、**チーム設定 › チームで共有するGoogleアカウント** で **チームに接続** を選びます。共有アカウントでログインし、使う人を選びます。Google Drive には、同じ場所に **チームと共有** があります。

## Google アプリを設定する（自分たちで運用するサーバーの管理者）

Trina がホストするチームでは、Google ログインはすぐに使えるので設定は不要です。会社が自分で運用するサーバーでは、管理者が Google Cloud で Google ログイン用のアプリを 1 回作り、**管理 › 連携サービス** に追加します。

> **ヒント:** **必要なもの**
>
> - チームのサーバーの **公開 https アドレス**（Google から戻ってくる先です）。これがないうちは、Google アプリに「先にこのサーバーの公開アドレスが必要です。」と表示されます。設定はサーバーの運用担当者が行います。[Configuration](/docs/operate/configuration.md)（英語）を見てください。
> - **Google Cloud プロジェクト**、各アプリに必要な **API** の有効化、種類が **Web application** の **ログイン用クライアント**。
> - Google Cloud から：クライアントの **JSON ファイル**（または **クライアントID** と **クライアントシークレット**）。
> - Google Cloud に入れるもの：Trina AX が表示する **戻り先アドレス**（Google Drive 用に 1 つ、ほかの 4 つのアプリ用に 1 つ）。

![公開アドレスのないサーバーで、管理 › 連携サービスの Gmail のページ：未設定（Not set up）、先にこのサーバーの公開アドレスが必要です、チーム設定の下に有効にする Google API](../../images/connect/google-admin-gmail.webp "Gmail（未設定）")

1. **Google Cloud でアプリを作る**

   会社のアプリのページの [Google Cloud で](/docs/ja/use/google-own-app.md#google-cloud-で) の手順に沿って進めます。プロジェクト、API、アプリの名前と対象（Google Workspace の会社なら **Internal**、それ以外はテストユーザー付きの **External**）、権限、**Web application** のクライアントを用意します。

2. **戻り先アドレスを追加する**

   クライアントの **Authorized redirect URIs** に、各アプリの **設定** ダイアログに表示されるアドレスを、コピーボタンでコピーして追加します。

   ```
   https://<your team address>/api/integrations/google-drive/callback
   https://<your team address>/api/integrations/google-apps/callback
   ```

3. **Trina AX にファイルをアップロードする**

   **管理 › 連携サービス** で **Google Drive** を開き、**設定** を選びます。ダウンロードした JSON ファイルをアップロードするか、**クライアントID** と **クライアントシークレット** を貼り付けて保存します。続けて Gmail、Google カレンダー、ドキュメント、スプレッドシートを順に開き、**設定** を選んで **Google Drive と同じ Google アプリを使う** をオンにします。ほかにアップロードするものはありません。

各アプリのページの **Google API** に、そのアプリで有効にする API が載っています。

| アプリ | 有効にする Google API |
|---|---|
| Google Drive | Google Drive API |
| Gmail | Gmail API |
| Google カレンダー | Google Calendar API |
| Google ドキュメント | Google Docs API、Google Drive API |
| Google スプレッドシート | Google Sheets API、Google Drive API |

Gmail、カレンダー、ドキュメント、スプレッドシートのアプリは Linux サーバーで動きます。Mac アプリでは、これらのページに「このチームのサーバーではまだ使えません」と表示されます。

## Google の画面に会社名を表示する

Google Workspace を使う会社は、すべての Google アプリのログインに会社独自の Google アプリを使えます。そうすると、Google の画面に会社名が表示され、警告も出ません。[会社独自の Google アプリを使う](/docs/ja/use/google-own-app.md) を見てください。

## 困ったとき

| 表示 | 対処 |
|---|---|
| **一部の権限にチェックが入っていませんでした。もう一度接続し、すべての項目にチェックを入れたままにしてください。** | もう一度接続し、Google の画面のすべての項目にチェックを入れたままにしてください。 |
| **Googleから再ログインを求められています。** | アプリのページで **再接続** を選んでください。パスワードを変えたあとや、会社の管理者がアクセスを取り消したときに起こります。 |
| Google のページに **`redirect_uri_mismatch`**（自分で運用するサーバー） | Google Cloud の戻り先アドレスが、Trina AX の表示と違います。**設定** ダイアログからもう一度コピーしてください。 |
| **「このアプリはブロックされています」**（This app is blocked）または **`admin_policy_enforced`** | 会社の Google 管理者が、Google アカウントを使えるアプリを制限しています。アプリを信頼済みにするよう頼んでください。[管理コンソールでアプリを信頼する](/docs/ja/use/google-own-app.md#任意管理コンソールでアプリを信頼する) を見てください。 |
| **このアプリは Google で確認されていません**（Google hasn't verified this app） | テスト中の External アプリです。管理者が作ったアプリの場合に限り **詳細** › **…（安全ではないページ）に移動**（Advanced › Go to …）を選んでください。または、会社独自のアプリに切り替えるよう管理者に頼んでください。 |

開発者と運用担当者向けの詳しい情報：[Google apps](https://github.com/trina-app/trina-ax/blob/main/docs/GOOGLE-APPS.md)（英語）、[Google Drive](https://github.com/trina-app/trina-ax/blob/main/docs/GOOGLE-DRIVE.md)（英語）。
