Skip to main content
Base44 アプリを Gmail に接続して、メールの送信、読み取り、管理を行います。Gmail を使って、アラート、承認、レポートを配信したり、受信メッセージをアプリのレコードに変換したり、新着メールをきっかけにフローをトリガーしたりできます。1 つの共有アカウントからでも、各ユーザー自身の受信トレイからでも可能です。
どちらのタイプを使うべきか? アプリが全員のために 1 つの Gmail アカウントからメールを送る場合は、アプリビルダー向けコネクタ を使います。たとえば、週次レポートをメールする運用用の受信トレイです。各ユーザーが自分の Gmail アカウントからメールを送る場合は、アプリユーザー向けコネクタ を使います。
アプリでコネクタを使用するには、Builder プラン 以上が必要です。

​
できること

メールを自動送信

アプリで何かが起きたときに、確認メール、アラート、パーソナライズされたフォローアップを送信します。

受信メールを読み取り

届いたメッセージを読み取って解析し、サポートチケットなどのレコードに変換します。

受信トレイを管理

アプリの処理に合わせてメールを整理します。たとえば、メッセージを既読にしたり、ラベルを適用したりします。
AI チャット向けのサンプルプロンプト

​
概要

タイプ識別子
gmail
認証モデル
OAuth
コネクタタイプ
アプリビルダー向け、アプリユーザー向け
接続設定
なし
権限ガイド
Gmail のスコープと権限

​
接続する

アプリ内のすべてのフローが使用する 1 つの Gmail アカウントを接続します。Gmail を接続するには:
  1. アプリエディタに移動します。
  2. AI チャットで Gmail を使ってやりたいことを説明します。例: Connect this app to Gmail and email me when a new ticket is created.
  3. We need your permission to access の下で AI チャットが求める内容を確認します。
  4. Connect to Gmail をクリックします。
  5. Google のウィンドウで、接続したいアカウントを選択し、権限を確認して Allow をクリックします。
  6. エディタに戻り、AI が Gmail を使うフローの作成を完了するのを待ちます。

​
バックエンド関数で使う

Gmail を接続すると、バックエンド関数がアクセストークンを取得して Gmail API を直接呼び出せます。OAuth フローとトークンの保管は Base44 が処理します。
  • 共有接続の場合は、getConnection() でトークンを取得します。
  • アプリユーザー接続の場合は、getCurrentAppUserConnection() を使い、各リクエストがサインイン中のユーザーのトークンを使用するようにします。

共有コネクタ

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

アプリユーザー向けコネクタ

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

​
Gmail のスコープと権限

Gmail に接続すると、コネクタは Gmail アカウントに対してアプリができることを制御する権限 (スコープ) を要求します。以下は、コネクタが要求する可能性がある現在の Gmail スコープのリストです。

Gmail のスコープ

  • email: 接続する Google アカウントを識別。
  • https://www.googleapis.com/auth/gmail.readonly: メッセージとメタデータの読み取り。
  • https://www.googleapis.com/auth/gmail.send: メッセージの送信。
  • https://www.googleapis.com/auth/gmail.labels: ラベルの管理。
  • https://www.googleapis.com/auth/gmail.modify: メッセージの変更 (たとえば既読にする、ラベルを適用する)。
  • https://www.googleapis.com/auth/gmail.compose: 下書きの作成と更新。
  • https://www.googleapis.com/auth/gmail.settings.basic: フィルター、署名、不在時の自動返信などの基本的なメール設定の管理。
スコープのリストは時間とともに変化する可能性があります。常に接続フロー中に表示される権限を確認してください。

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

https://connectors.base44.com/api/oauth/callback が、表示どおり正確に Google OAuth アプリに登録されていることを確認してください。コネクタがまだアプリ別 URL を使用している場合は、代わりに View redirect URIs for your apps の Per-app URLs (for legacy connectors) に表示される URI と一致する必要があるため、接続するアプリについて、そこに表示されるすべての URI を登録してください。
Google OAuth アプリがテストモードの場合、承認済みのテストユーザーだけが接続できます。アプリを使う誰もが自分のアカウントを接続できるように、OAuth アプリを公開するか、テストモードから移行してください。

​
よくある質問

  1. アプリのダッシュボードに移動します。
  2. Integrations をクリックします。
  3. My integrations タブをクリックします。
  4. Gmail を見つけて More Actions アイコン をクリックし、Switch account を選択します。
はい。AI チャットで、件名、メッセージ本文、フォーマット、受信者、動的フィールドを指定してください。Dashboard → Code → Functions で生成されたバックエンド関数を編集して、メールのペイロードをさらにカスタマイズすることもできます。
はい。アプリユーザー向けコネクタ を使うと、各ユーザーが自分の Gmail アカウントを接続します。コネクタの概要 を参照してください。
アプリの Integrations タブでコネクタの More actions アイコンをクリックし、アカウントの切り替え、再接続、切断などのオプションを選択します。コネクタの管理について詳しくはこちら。
このページは AI によって翻訳されました。最も正確で最新の情報については、英語版 を参照してください。