Gmail
Gmailは、消費者と企業の両方で広く使用されている人気のメールサービスです。 ユーザーは、ウェブ上でGmailにアクセスできるほか、POPまたはIMAPプロトコルを通じてメールコンテンツを同期するサードパーティプログラムを使用してアクセスできます。
Gmailコネクターを使用すると、Gmailを中心とした強力な自動化を構築し、他のアプリケーションと接続できます。
機能の提供状況
CNデータセンターのワークスペースでは、Gmailコネクターを利用できません。 これは現地の規制要件を反映したものであり、当社のマルチテナントおよびVirtual Private Workato(VPW)サービスに適用されます。
APIバージョン
Gmailコネクターは、Gmail REST API v1を使用します。
WorkatoでGmailに接続する方法
Workatoは、Gmailへの2種類のコネクションをサポートしています:
サービスアカウント認証
サービスアカウントを使用すると、個人ユーザーアカウントなしで認証できます。 一貫した使用のため、Workatoではサービスアカウント認証をお勧めします。
最小スコープとデフォルトスコープ
コネクションを確立するには、最低限、メインのGoogleアカウントのメールアドレスの表示スコープが必要です。
特定のスコープをリクエストしない場合、Workatoはデフォルトで次のスコープをリクエストします:
- メインのGoogleアカウントのメールアドレスを表示する
- メールラベルを表示および編集する
- 代理でメールを送信する
- メールメッセージと設定を表示する
- Gmailアカウントからメールの読み取り、作成、送信を行う
サービスアカウントを使用してGmailに接続する予定がある場合は、Googleワークスペース管理者がサービスアカウントにドメイン全体の権限委任を付与していることを確認してください。 これにより、必要なスコープと権限を使用して、コネクション設定時に入力したユーザーのメールアドレスを偽装できます。
OAuth 2.0認証
OAuth 2.0コネクションを設定するには、次の手順を実行します:
Workatoアカウントにサインインし、Gmailコネクションを追加する予定のプロジェクトに移動します。
作成>コネクションをクリックするか、Cを2回押してから、コネクションとしてGmailを選択します。
Gmailコネクションインスタンスを一意に識別するコネクション名を指定します。
認証タイプメニューをクリックし、OAuth 2.0を選択します。
任意です。 詳細設定をクリックし、追加のOAuth 2.0スコープを選択します。 空白のままにすると、次のスコープがリクエストされます:
- メインのGoogleアカウントのメールアドレスを表示する
- メールラベルを表示および編集する
- 代理でメールを送信する
- メールメッセージと設定を表示する
- Gmailアカウントからメールの読み取り、作成、送信を行う
任意です。 Custom OAuth profileドロップダウンメニューを使用して、コネクション用のCustom OAuth profileを選択します。
Googleでサインインをクリックし、Googleアカウントにサインインして設定を完了します。
サービスアカウント認証
Googleサービスアカウントは、Google Cloudプロジェクト(GCP)に関連付けられた専用のGoogleアカウントであり、ユーザーに代わってAPIリクエストを実行できます。
サービスアカウントには次の利点があります:
- 継続的な運用: サービスアカウントにより、個々のユーザー権限が変更された場合でも運用を継続できます。
- 専用の権限: サービスアカウントは、共有先として指定したプロジェクトにのみアクセスできます。
- 専用のAPIクォータ: GCPを通じてサービスアカウントのAPIクォータを管理し、Googleに直接クォータの引き上げをリクエストできます。
サービスアカウントの詳細については、Googleサービスアカウントのドキュメントを参照してください。
GCPプロジェクトのサービスアカウントメールを取得
Googleサービスアカウントを設定する
Googleサービスアカウントを設定するには、次の手順を実行します:
GCPプロジェクトでサービスアカウントを作成します。
IAMと管理>サービスアカウントに移動します。 ダッシュボードのスコープが、サービスアカウントを含むプロジェクトに設定されていることを確認します。
ダッシュボードのスコープを確認します。
使用するサービスアカウントのメールをクリックします。
使用するサービスアカウントのメールをクリックします。
サービスアカウントのメールをコピーし、後でコネクションを設定するために保存します。
アカウントのメールをコピーします。
キータブに移動します。
秘密鍵を生成し、JSON形式でダウンロードします。 キーは1回しかダウンロードできません。
JSONファイルを開き、秘密鍵全体を-----BEGIN PRIVATE KEY-----から-----END PRIVATE KEY-----\nまで(両端を含む)コピーして、後でコネクションを設定するために保存します。
Workatoでサービスアカウントに接続する
サービスアカウントコネクションを設定するには、次の手順を実行します:
Workatoアカウントにサインインし、Gmailコネクションを追加する予定のプロジェクトに移動します。
作成>コネクションをクリックするか、Cを2回押してから、コネクションとしてGmailを選択します。
認証タイプドロップダウンメニューを選択します。
Googleでサインインをクリックし、Googleアカウントにサインインして設定を完了します。
Last updated: