Google Workspace コネクタ

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

アプリでコネクタを使用するには、Builder プラン 以上が必要です。

できること

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

メールを自動化

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

カレンダーと連絡先を同期

予約を同期し、空き状況を表示し、連絡先を最新の状態に保ちます。

ファイルとデータを扱う

レポートを Drive に保存し、Docs を生成し、Sheets のデータをインポートまたはエクスポートします。

受信トレイ、カレンダー、Drive のファイルを扱うアシスタントなど、アプリで複数の Google サービスを組み合わせる場合は、このコネクタを使用します。1 つか 2 つのサービスしか使わない場合は、代わりにそれらを接続してください。 プロンプト例 AI チャットで、関係する Google サービス、アクションのきっかけ、動的なフィールドを説明します。例:

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

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

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

各会議の後に、参加者へのフォローアップの下書きを作成して。

今週の会議とメールを 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 アカウントのデータを扱います。

Google サービスを接続する

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

共有コネクタ
アプリユーザーコネクタ

1 つのアカウントを 1 度接続すると、アプリを使う全員がその接続とデータを共有します。共有 Google コネクタを追加するには:

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

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

始める前に: アプリユーザーコネクタを設定するのは、ワークスペースのオーナーと管理者です。Base44 に OAuth を管理させるには、Pro プラン以上が必要です。独自の OAuth クライアントを使う場合は、構築する前にスコープと権限を確認してください。

Google Calendar で Let Base44 manage OAuth を使う場合は、アプリユーザー Google コネクタを追加するには に進んでください。独自の OAuth クライアントを準備するには:

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

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

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

Google サービス

アプリが使用するサービスを探して、できることと要求するスコープを確認します。 Google Analytics、Google Meet、Google Search Console などのその他の Google コネクタについては、コネクタカタログを参照してください。

Gmail

Gmail でメールを送信、読み取り、管理します。 プロンプト例 AI チャットで、件名、本文、書式、受信者、動的なフィールドを説明します。例:

新しい注文が入ったら、確認メールを自動で送信して。

受信メールを読み取って解析し、サポートチケットを作成して。

新しいメールが届いたら、ワークフローを自動的に実行して。

新しいリードにパーソナライズしたフォローアップメールを送信して。

タスクが割り当てられたら、チームメンバーにメールで通知して。

スコープ

メールの内容の読み取りは、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 の予定にアクセスして管理します。 プロンプト例 AI チャットで、カレンダー、予定、アクションのきっかけ、動的なフィールドを説明します。例:

すべての予約を Google Calendar に直接同期して。

Google Calendar のリアルタイムの空き状況をクライアントに表示して。

カレンダーの予定が作成または更新されたら、オートメーションを実行して。

個人のカレンダーで会議の時間を自動的にブロックして。

タスクが完了としてマークされたら、カレンダーに新しい予定を追加して。

スコープ

広範な 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 チャットで、連絡先、アクションのきっかけ、動的なフィールドを説明します。例:

Google Contacts とクライアントを双方向に同期する CRM を作って。

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

連絡先のネットワークを分析し、AI で連絡先を自動的に分類して。

Google Workspace の組織から検索可能な社内ディレクトリを作成して。

新しい顧客がサインアップしたら、自動的に連絡先として保存して。

スコープ

アプリで保存済みの連絡先を読み取るだけの場合は、contacts.readonly を選択してください。

Google Contacts のスコープ名は https://www.googleapis.com/auth/ で始まります:

contacts.readonly: 連絡先を表示する
contacts: 連絡先を表示、作成、編集、削除する
contacts.other.readonly: メールを送ったが保存していない人など、その他の連絡先を表示する
directory.readonly: 組織の Google Workspace ディレクトリを表示する

アクセス: アプリは、接続を承認した Google アカウントの連絡先を扱います。

Google Drive

Google Drive のファイルを検索、アクセス、管理します。 プロンプト例 AI チャットで、ファイルやフォルダ、アクションのきっかけ、動的なフィールドを説明します。例:

Google Drive のすべてのファイルを一覧表示して、アプリに表示して。

キーワードに一致するドキュメントを Google Drive で検索して、結果を表示して。

アプリで生成した PDF レポートを Google Drive に保存して。

Google Drive のスプレッドシートを読み取って、そのデータをアプリにインポートして。

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 のドキュメントを作成、編集します。 プロンプト例 AI チャットで、ドキュメント、作成のきっかけ、動的なフィールドを説明します。例:

議事録のドキュメントを自動で生成して。

クライアントのデータを使ってテンプレートから契約書を作成して。

プロジェクトのステータスが変わったら、共有ドキュメントを更新して。

レポートを Google Docs 形式でエクスポートして。

チームのコメントでドキュメントを共同編集して。

スコープ

documents スコープでは、アプリは作成したものだけでなく、接続したアカウントのすべての Google Docs ドキュメントを表示、編集できます。

Google Docs のスコープ名は https://www.googleapis.com/auth/ で始まります:

documents: すべての Google Docs ドキュメントを表示、作成、編集する
documents.readonly: すべての Google Docs ドキュメントを表示する

アクセス: アプリは、接続を承認した Google アカウントのドキュメントを扱います。

Google Sheets

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

アプリのデータを Google Sheets のスプレッドシートにエクスポートして。

Google Sheet からリードを CRM にインポートして。

Google Sheets の在庫数を自動的に更新して。

週次レポートを作成して、Google Sheets に保存して。

フォームの送信内容を 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 クライアントを使うを参照してください。 Google は、アプリが要求する権限を 3 つのカテゴリに分類しています。このカテゴリによって、アプリの公開前に必要な審査が決まります。そのため、アプリの機能に対応する最も限定的なスコープを選択してください。これは Gmail、Drive、Calendar で特に重要です。

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

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

制限付きスコープの審査には数週間かかる場合があります。審査が完了するまで、Google はアプリを使える人数を制限し、未確認アプリの警告を表示することがあります。Google がセキュリティ評価を求める場合は、Google が承認した独立評価機関が CASA フレームワークを使ってアプリを評価します。評価では自分のコードだけでなく、アプリが動作するプラットフォームについても質問されるため、早めにサポートに連絡してください。要件、期間、例外は Google が決定します。計画を立てる前に Google の開発者向けドキュメントを確認してください。

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

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

独自のバックエンド関数を作成する場合は、Google の API を直接呼び出せます。OAuth フローとトークンの保管は Base44 が処理します。共有接続の場合は、下の表のサービス ID を getConnection() に渡します。アプリユーザー接続の場合は、サービス ID ではなく、独自のコネクタの ID を渡します。

共有コネクタ
アプリユーザーコネクタ

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

// 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`

共有コネクタ

バックエンド関数から共有接続を設定、デプロイ、呼び出します。

アプリユーザーコネクタ

ユーザーごとのトークンを取得し、サインイン中のユーザーとして API を呼び出します。

トラブルシューティング

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

一部のユーザーが自分のアカウントを接続できない

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

リダイレクト URI のエラーで接続に失敗する

接続で使用するコールバック URL を、Google OAuth クライアントの承認済みのリダイレクト URI として登録します:

単一のコールバック URL の場合は、https://connectors.base44.com/api/oauth/callback を正確に入力します。
アプリごとのコールバック URL の場合は、コールバック URL を表示するを参照してください。

このページは AI によって翻訳されました。最も正確で最新の情報については、英語版を参照してください。

はじめに

アプリの構築

アプリのセキュリティ

アプリのプロモーション

コネクタ

変更履歴

Google Workspace コネクタ

できること

メールを自動化

カレンダーと連絡先を同期

ファイルとデータを扱う