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

# Google Workspace コネクタ

> Gmail、Google Calendar、Contacts、Drive、Docs、Sheets を個別のコネクタで接続するか、Google Workspace コネクタでまとめて扱います。

コネクタを選び、1 つの共有アカウントまたは各ユーザー自身のアカウントで接続します。スコープは、アプリが Google に要求する権限です。必要なスコープだけを要求してください。

> [!NOTE]
>
> アプリでコネクタを使用するには、[**Builder プラン**](https://base44.com/pricing) 以上が必要です。

***

## できること

アプリをメール、カレンダー、連絡先、ファイルに接続します。

> **メールを自動化**
>
> 確認メールやフォローアップを送信し、受信メールをタスクやチケットに変換します。

> **カレンダーと連絡先を同期**
>
> 予約を同期し、空き状況を表示し、連絡先を最新の状態に保ちます。

> **ファイルとデータを扱う**
>
> レポートを Drive に保存し、Docs を生成し、Sheets のデータをインポートまたはエクスポートします。

***

## Google Workspace コネクタ

受信トレイ、カレンダー、Drive のファイルを扱うアシスタントなど、アプリで複数の Google サービスを組み合わせる場合は、このコネクタを使用します。1 つか 2 つのサービスしか使わない場合は、代わりにそれらを接続してください。

**プロンプト例**

AI チャットで、関係する Google サービス、アクションのきっかけ、動的なフィールドを説明します。例:

```text wrap theme={null}
私のことを知って。メール、会議、Drive のファイルにざっと目を通して、私が何に取り組んでいるか教えて。
```

```text wrap theme={null}
私の個人アシスタントになって。受信トレイとカレンダーを見て、今日対応が必要なことを教えて。
```

```text wrap theme={null}
関連するメールのスレッド、ファイル、参加者の詳細から、次の会議の準備をして。
```

```text wrap theme={null}
各会議の後に、参加者へのフォローアップの下書きを作成して。
```

```text wrap theme={null}
今週の会議とメールを Doc と Sheet にまとめて。
```

**スコープ**

> このコネクタは 6 つのサービスにわたって以下のスコープを要求するため、個別のコネクタよりも多くのアクセス権が必要です。
>
> * **Gmail:** `gmail.readonly`、`gmail.modify`、`gmail.compose`、`gmail.send`
> * **Calendar:** `calendar.readonly`、`calendar.settings.readonly`、`calendar.events`
> * **Contacts:** `contacts.readonly`
> * **Drive:** `drive.readonly`、`drive`
> * **Docs:** `documents.readonly`、`documents`
> * **Sheets:** `spreadsheets.readonly`、`spreadsheets`
>
> 各スコープの説明は、[Google サービス](#google-services) の各サービスの下にあります。
>
> **アクセス:** アプリは、接続を承認した Google アカウントのデータを扱います。

***

## Google サービスを接続する

Google サービスを 1 つの共有アカウントで接続するか、各ユーザーが自分のアカウントを接続できるようにします。

**共有コネクタ**

1 つのアカウントを 1 度接続すると、アプリを使う全員がその接続とデータを共有します。

**共有 Google コネクタを追加するには:**

1. ワークスペースのサイドバーで **Connectors** をクリックします。
2. **Add connector** をクリックします。
3. **Google Calendar** や **Google Workspace** など、目的のサービスを検索してクリックします。
4. **Shared connector** を選択し、**Next** をクリックします。
5. **Connection name** を入力します。
6. **Who can access** で、接続を使える場所を選択します。デフォルトは **Apps and Super agent** です。
7. **Permissions** が表示された場合は、データを表示するには **Read-only** を、アプリでデータの送信、作成、変更が必要な場合は **Read & write** を選択します。デフォルトは **Read-only** です。
8. **Add connector** をクリックし、共有したい Google アカウントでサインインします。
9. アプリエディタでアプリを開きます。
10. 構築したい機能で共有 Google 接続を使うよう AI チャットに依頼します。

**アプリユーザーコネクタ**

各ユーザーが自分の Google アカウントを接続するため、アプリはそのユーザーのデータを扱います。Google Calendar では **Let Base44 manage OAuth** も利用できます。

> [!TIP]
>
> **始める前に:** アプリユーザーコネクタを設定するのは、ワークスペースのオーナーと管理者です。Base44 に OAuth を管理させるには、[Pro プラン](https://base44.com/pricing) 以上が必要です。独自の OAuth クライアントを使う場合は、構築する前に [スコープと権限](#scopes-and-permissions) を確認してください。

Google Calendar で **Let Base44 manage OAuth** を使う場合は、**アプリユーザー Google コネクタを追加するには** に進んでください。

**独自の OAuth クライアントを準備するには:**

1. Google Cloud コンソールでプロジェクトを作成または選択します。
2. アプリが使用する各 Google サービスの API を有効にします。
3. 要求する予定のスコープで OAuth 同意画面を設定します。
4. OAuth アプリがテストモードの間は、テストに使う Google アカウントをテストユーザーとして追加します。
5. ウェブアプリケーション用の OAuth クライアントを作成します。
6. 承認済みのリダイレクト URI として `https://connectors.base44.com/api/oauth/callback` を追加します。
7. クライアント ID とクライアントシークレットをコピーします。

**アプリユーザー Google コネクタを追加するには:**

1. ワークスペースのサイドバーで **Connectors** をクリックします。
2. **Add connector** をクリックします。
3. **Google Calendar** や **Google Drive** など、目的のサービスを検索してクリックします。
4. **App user connector** を選択し、**Next** をクリックします。
5. **Choose how to manage authentication** が表示された場合は、**Let Base44 manage OAuth** または **Use your own OAuth client** を選択します。
6. **Connector name** を入力します。
7. 独自の OAuth クライアントを使う場合は、その **Client ID** と **Client Secret** を入力します。
8. **Scopes** で、アプリに不要なスコープの選択を解除します。独自の OAuth クライアントでは、**Additional scopes** でその他のスコープを追加します。各スコープの内容は [Google サービス](#google-services) を参照してください。
9. **Add Connector** をクリックします。
10. アプリエディタでアプリを開きます。
11. 各ユーザーが自分の Google アカウントを接続できる仕組みを追加するよう AI チャットに依頼します。

***

## Google サービス

アプリが使用するサービスを探して、できることと要求するスコープを確認します。

Google Analytics、Google Meet、Google Search Console などのその他の Google コネクタについては、[コネクタカタログ](https://docs.base44.com/ja/Integrations/connectors-catalog.md) を参照してください。

### Gmail

[Gmail](https://base44.com/integrations/connectors/gmail) でメールを送信、読み取り、管理します。

**プロンプト例**

AI チャットで、件名、本文、書式、受信者、動的なフィールドを説明します。例:

```text wrap theme={null}
新しい注文が入ったら、確認メールを自動で送信して。
```

```text wrap theme={null}
受信メールを読み取って解析し、サポートチケットを作成して。
```

```text wrap theme={null}
新しいメールが届いたら、ワークフローを自動的に実行して。
```

```text wrap theme={null}
新しいリードにパーソナライズしたフォローアップメールを送信して。
```

```text wrap theme={null}
タスクが割り当てられたら、チームメンバーにメールで通知して。
```

**スコープ**

> メールの内容の読み取りは、Google の制限付きスコープです。
>
> Gmail のスコープ名は `https://www.googleapis.com/auth/` で始まります:
>
> * `gmail.readonly`: メッセージとメタデータを読み取る
> * `gmail.modify`: メッセージの読み取り、ラベル付け、変更 (完全な削除は除く)
> * `gmail.compose`: 下書きを作成してメールを送信する
> * `gmail.send`: メッセージを送信する
> * `gmail.labels`: ラベルを管理する
> * `gmail.settings.basic`: フィルター、署名、不在時の自動返信を管理する
>
> **アクセス:** アプリは、接続を承認した Gmail アカウントのメールを扱います。

### Google Calendar

[Google Calendar](https://base44.com/integrations/connectors/google-calendar) の予定にアクセスして管理します。

**プロンプト例**

AI チャットで、カレンダー、予定、アクションのきっかけ、動的なフィールドを説明します。例:

```text wrap theme={null}
すべての予約を Google Calendar に直接同期して。
```

```text wrap theme={null}
Google Calendar のリアルタイムの空き状況をクライアントに表示して。
```

```text wrap theme={null}
カレンダーの予定が作成または更新されたら、オートメーションを実行して。
```

```text wrap theme={null}
個人のカレンダーで会議の時間を自動的にブロックして。
```

```text wrap theme={null}
タスクが完了としてマークされたら、カレンダーに新しい予定を追加して。
```

**スコープ**

> 広範な `calendar` スコープはすべてのカレンダーを管理します。アプリで予定や空き状況を読み取るだけの場合は、より限定的なスコープを選択してください。**Let Base44 manage OAuth** では、選択肢に限定的なスコープのみが表示されます。
>
> Google Calendar のスコープ名は `https://www.googleapis.com/auth/` で始まります:
>
> * `calendar`: すべてのカレンダーと予定を管理する
> * `calendar.readonly`: すべてのカレンダー、予定、その設定を表示する
> * `calendar.events`: カレンダーの予定を管理する
> * `calendar.events.readonly`: カレンダーの予定を表示する
> * `calendar.events.freebusy`: 予定の詳細を見ずに、カレンダーの空き時間情報を表示する
> * `calendar.freebusy`: カレンダーの空き時間情報を表示する
> * `calendar.app.created`: アプリが作成したカレンダーを管理する
> * `calendar.calendarlist.readonly`: カレンダーの一覧を表示する
> * `calendar.events.public.readonly`: カレンダーの公開予定を表示する
> * `calendar.settings.readonly`: Google Calendar の設定を表示する
>
> **アクセス:** アプリは、接続を承認した Google アカウントのカレンダーを扱います。

### Google Contacts

Google Contacts で連絡先を読み取り、作成、管理します。

**プロンプト例**

AI チャットで、連絡先、アクションのきっかけ、動的なフィールドを説明します。例:

```text wrap theme={null}
Google Contacts とクライアントを双方向に同期する CRM を作って。
```

```text wrap theme={null}
メールを送ったことはあるけれど連絡先に保存していない人をリードとしてインポートして。
```

```text wrap theme={null}
連絡先のネットワークを分析し、AI で連絡先を自動的に分類して。
```

```text wrap theme={null}
Google Workspace の組織から検索可能な社内ディレクトリを作成して。
```

```text wrap theme={null}
新しい顧客がサインアップしたら、自動的に連絡先として保存して。
```

**スコープ**

> アプリで保存済みの連絡先を読み取るだけの場合は、`contacts.readonly` を選択してください。
>
> Google Contacts のスコープ名は `https://www.googleapis.com/auth/` で始まります:
>
> * `contacts.readonly`: 連絡先を表示する
> * `contacts`: 連絡先を表示、作成、編集、削除する
> * `contacts.other.readonly`: メールを送ったが保存していない人など、その他の連絡先を表示する
> * `directory.readonly`: 組織の Google Workspace ディレクトリを表示する
>
> **アクセス:** アプリは、接続を承認した Google アカウントの連絡先を扱います。

### Google Drive

[Google Drive](https://base44.com/integrations/connectors/google-drive) のファイルを検索、アクセス、管理します。

**プロンプト例**

AI チャットで、ファイルやフォルダ、アクションのきっかけ、動的なフィールドを説明します。例:

```text wrap theme={null}
Google Drive のすべてのファイルを一覧表示して、アプリに表示して。
```

```text wrap theme={null}
キーワードに一致するドキュメントを Google Drive で検索して、結果を表示して。
```

```text wrap theme={null}
アプリで生成した PDF レポートを Google Drive に保存して。
```

```text wrap theme={null}
Google Drive のスプレッドシートを読み取って、そのデータをアプリにインポートして。
```

```text wrap theme={null}
Drive でファイルが追加または更新されたら、ワークフローを実行して。
```

**スコープ**

> `drive` スコープでは、アプリは Google Drive のすべてのファイルとフォルダにアクセスできます。一方、`drive.file` はアプリが作成または開いたファイルのみが対象です。
>
> Google Drive のスコープ名は `https://www.googleapis.com/auth/` で始まります:
>
> * `drive`: Google Drive のすべてのファイルとフォルダを表示、作成、編集、削除する
> * `drive.readonly`: Google Drive のすべてのファイルとフォルダを表示する
> * `drive.file`: アプリが作成したファイル、または許可を得て開いたファイルのみにアクセスする
>
> **アクセス:** アプリは、接続を承認した Google アカウントの Google Drive にあるファイルを扱います。

### Google Docs

[Google Docs](https://base44.com/integrations/connectors/google-docs) のドキュメントを作成、編集します。

**プロンプト例**

AI チャットで、ドキュメント、作成のきっかけ、動的なフィールドを説明します。例:

```text wrap theme={null}
議事録のドキュメントを自動で生成して。
```

```text wrap theme={null}
クライアントのデータを使ってテンプレートから契約書を作成して。
```

```text wrap theme={null}
プロジェクトのステータスが変わったら、共有ドキュメントを更新して。
```

```text wrap theme={null}
レポートを Google Docs 形式でエクスポートして。
```

```text wrap theme={null}
チームのコメントでドキュメントを共同編集して。
```

**スコープ**

> `documents` スコープでは、アプリは作成したものだけでなく、接続したアカウントのすべての Google Docs ドキュメントを表示、編集できます。
>
> Google Docs のスコープ名は `https://www.googleapis.com/auth/` で始まります:
>
> * `documents`: すべての Google Docs ドキュメントを表示、作成、編集する
> * `documents.readonly`: すべての Google Docs ドキュメントを表示する
>
> **アクセス:** アプリは、接続を承認した Google アカウントのドキュメントを扱います。

### Google Sheets

[Google Sheets](https://base44.com/integrations/connectors/google-sheets) のスプレッドシートでデータを読み書きします。

**プロンプト例**

AI チャットで、スプレッドシート、アクションのきっかけ、動的なフィールドを説明します。例:

```text wrap theme={null}
アプリのデータを Google Sheets のスプレッドシートにエクスポートして。
```

```text wrap theme={null}
Google Sheet からリードを CRM にインポートして。
```

```text wrap theme={null}
Google Sheets の在庫数を自動的に更新して。
```

```text wrap theme={null}
週次レポートを作成して、Google Sheets に保存して。
```

```text wrap theme={null}
フォームの送信内容を Google Sheets のデータベースに同期して。
```

**スコープ**

> `spreadsheets` スコープでは、アプリは作成したものだけでなく、アカウントのすべてのスプレッドシートを変更できます。
>
> Google Sheets のスコープ名は `https://www.googleapis.com/auth/` で始まります:
>
> * `spreadsheets`: すべての Google Sheets スプレッドシートを表示、編集、作成、削除する
> * `spreadsheets.readonly`: すべての Google Sheets スプレッドシートを表示する
>
> **アクセス:** アプリは、接続を承認した Google アカウントのスプレッドシートを扱います。

***

## スコープと権限

独自の OAuth クライアントを使う場合は、OAuth アプリを所有し、その審査を Google に申請します。共有 Google コネクタと **Let Base44 manage OAuth** は Base44 の OAuth アプリで動作するため、Google への申請は不要です。[独自の OAuth クライアントを使う](https://docs.base44.com/ja/Integrations/Connectors.md#using-your-own-oauth-client) を参照してください。

Google は、アプリが要求する権限を 3 つのカテゴリに分類しています。このカテゴリによって、アプリの公開前に必要な審査が決まります。そのため、アプリの機能に対応する最も限定的なスコープを選択してください。これは Gmail、Drive、Calendar で特に重要です。

* **基本:** 名前、メールアドレス、プロフィールが対象です。Google は追加の要件を求めません。
* **機密:** カレンダーの予定の作成など、Google サービスへのより広いアクセスが対象です。Google は、データの使用方法の審査を含むアプリの審査を求めます。
* **制限付き:** Gmail の読み取りなど、ユーザーのメッセージやファイルの内容の読み取りが対象です。Google はアプリの審査を求め、年 1 回の独立したセキュリティ評価を求める場合もあります。

> [!TIP]
>
> 制限付きスコープの審査なしでメールを送信するには、`gmail.send` のみを要求してください。

制限付きスコープの審査には数週間かかる場合があります。審査が完了するまで、Google はアプリを使える人数を制限し、未確認アプリの警告を表示することがあります。Google がセキュリティ評価を求める場合は、Google が承認した独立評価機関が CASA フレームワークを使ってアプリを評価します。評価では自分のコードだけでなく、アプリが動作するプラットフォームについても質問されるため、早めに [サポートに連絡](https://docs.base44.com/ja/Community-and-support/Contacting-support.md) してください。要件、期間、例外は Google が決定します。計画を立てる前に [Google の開発者向けドキュメント](https://developers.google.com/identity/protocols/oauth2/production-readiness/restricted-scope-verification) を確認してください。

> [!NOTE]
>
> Base44 は、Google アカウントを識別するために常に `email` スコープを追加します。常に含まれるため、**Scopes** にロックされたスコープとして表示されます。

***

## バックエンド関数で Google サービスを使う

独自のバックエンド関数を作成する場合は、Google の API を直接呼び出せます。OAuth フローとトークンの保管は Base44 が処理します。

共有接続の場合は、下の表のサービス ID を `getConnection()` に渡します。アプリユーザー接続の場合は、サービス ID ではなく、独自のコネクタの ID を渡します。

**共有コネクタ**

```javascript theme={null}
// One account the whole app uses
const { accessToken } =
  await base44.asServiceRole.connectors.getConnection("googlecalendar");
// Use the access token to call the Google Calendar API.
```

**アプリユーザーコネクタ**

```javascript theme={null}
// The signed-in person's own account
const { accessToken } =
  await base44.asServiceRole.connectors.getCurrentAppUserConnection(
    "YOUR_CONNECTOR_ID",
  );
// Use the access token to call the Google API for that person.
```

| サービス | サービス ID (共有接続) |
| - | - |
| Gmail | `gmail` |
| Google Calendar | `googlecalendar` |
| Google Contacts | `google_contacts` |
| Google Drive | `googledrive` |
| Google Docs | `googledocs` |
| Google Sheets | `googlesheets` |
| Google Workspace | `googleworkspace` |

> **[共有コネクタ](https://docs.base44.com/ja/developers/backend/resources/connectors/shared-connectors.md)**
>
> バックエンド関数から共有接続を設定、デプロイ、呼び出します。

> **[アプリユーザーコネクタ](https://docs.base44.com/ja/developers/backend/resources/connectors/app-user-connectors.md)**
>
> ユーザーごとのトークンを取得し、サインイン中のユーザーとして API を呼び出します。

***

## トラブルシューティング

独自の OAuth クライアントを使っている場合、ユーザーが Google アカウントを接続できないときは次を確認してください。

> **一部のユーザーが自分のアカウントを接続できない**
>
> 独自の OAuth クライアントはテストモードで開始され、承認済みのテストユーザーだけが接続できます。より広くアクセスを開放する前に、OAuth アプリを本番環境に移行し、Google が求める審査を完了してください。

> **リダイレクト URI のエラーで接続に失敗する**
>
> 接続で使用するコールバック URL を、Google OAuth クライアントの承認済みのリダイレクト URI として登録します:
>
> * 単一のコールバック URL の場合は、`https://connectors.base44.com/api/oauth/callback` を正確に入力します。
> * アプリごとのコールバック URL の場合は、[コールバック URL を表示する](https://docs.base44.com/ja/Integrations/Connectors.md#viewing-your-callback-urls) を参照してください。

> [!NOTE]
>
> このページは AI によって翻訳されました。最も正確で最新の情報については、[英語版](https://docs.base44.com/index.md) を参照してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.