Gmail

  • リファレンス

Gmail は、Google のウェブ ベースのメール サービスです。 Gmail コネクタを使用すると、メール メッセージの送受信などのアクションを実行したり、新しいメールでフローをトリガーしたりできます。

このコネクタは、次の製品および地域で利用可能です。

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate 標準 以下を除くすべての Power Automate 地域 :
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   国防総省 (DoD)
Power Apps 標準 以下を除くすべての Power Apps 地域 :
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   国防総省 (DoD)
連絡先
件名 Microsoft
URL Microsoft LogicApps サポート
Microsoft Power Automate サポート
Microsoft Power Apps サポート
コネクタ メタデータ
公開元 Microsoft
Web サイト https://mail.google.com/mail/
プライバシー ポリシー https://policies.google.com/privacy

認証および独自のアプリケーションの導入

Gmail コネクタは、さまざまな種類の認証をサポートするようになりました。

  • 共有済みの既定アプリケーションを使用する
  • 独自のアプリケーションを導入する

共有済みの既定アプリケーションは、Microsoft が管理する Google クライアント アプリケーションを使用します。 この場合、Gmail アカウントにサインインすると、Microsoft Power Platform アプリケーションへの同意を求められます。

「独自のアプリケーションを導入する」オプションを使用すると、Microsoft が管理するアプリケーションの代わりに独自の Google OAuth クライアント アプリケーションを使用できます。 これにより、アクセス許可を制御し、コネクタの使用に関する特定の制限を有効にすることができます。

Gmail コネクタで独自の Google OAuth クライアント アプリケーションを使用するには、次の手順を実行する必要があります。

  1. Google の API コンソールを使用して OAuth クライアント アプリケーションを作成します
  2. Gmail コネクタでアプリケーションを使用する

Google で OAuth クライアント アプリケーションを作成する

独自の Google OAuth クライアント アプリケーションを作成するには、まず https://developer.google.com にサインインする必要があります。 Google API コンソール — Google API へのアクセスを管理できる — に移動し、OAuth アプリケーションを作成します。 このプロセスについては、Google の Gmail API 開発者ガイド で説明されています。 Google はプロジェクトを作成し、プロジェクトで Gmail API を有効にし、OAuth クライアント アプリケーションとその認証情報を作成するプロセスをガイドするセットアップ ツールを提供しています。 ツールを使用するときに役立つ情報を次に示します。

  • 必要に応じてサービス使用条件を読み、同意してください。
  • 既存のプロジェクトを選択しないと、ツールは「マイ プロジェクト」と呼ばれる新しいプロジェクトを作成します。
  • このツールは、プロジェクトで Gmail API を有効にします。
  • ツールは、必要な資格情報の種類を見つけようとします。 OAuth クライアント アプリケーションを入手する必要があります。
    • 使用する API として、Gmail API を選択します (まだ選択されていない場合)。
    • API を呼び出す場所として Web サーバーを選択します。
    • アクセスするデータのユーザー データを選択します。
  • このツールは、OAuth 同意画面の設定について説明します。
    • ユーザー タイプを選択します (内部または外部)。 Gmail のコンシューマー アカウントを使用している場合は、内部を選択することはできません。
    • アプリケーションの名前と、オプションでロゴを指定します。
    • スコープを追加をクリックして Gmail スコープ (https://mail.google.com) を追加します。

      注意

      使用上のニーズに基づいて、ここでアクセス許可スコープの適切なサブセットを選択できます。

    • 認可されたドメインの 1 つとして、azure-apim.net を追加します。

      注意

      これは、ここで定義されているように、Gmail コネクタがホストされているドメインです。

    • 必要に応じて、その他の情報を提供します。
  • このツールを使用すると、OAuth 2.0 クライアントの資格情報を定義して追加できます。
    • OAuth クライアント アプリケーションの名前を入力します。
    • リダイレクト URI に「https://global.consent.azure-apim.net/redirect」を追加します。

完了したら、認証情報ページから作成した OAuth クライアントに移動します。 アプリのクライアント ID とクライアント シークレットが見つかります。 これらの値を Gmail 接続で使用できるようになりました。

Google OAuth クライアント

Gmail コネクタで独自のアプリケーションを使用する

Google OAuth クライアント アプリケーションを作成すると、Gmail 接続の作成中に使用できます。

  • 独自のアプリケーションを導入するを選択する。
  • アプリケーションからクライアント ID とクライアント シークレットの値を指定する。

サインインをクリックして Gmail アカウントにサインインします。 これにより、Gmail アカウントにサインインし、上記で作成した Google アプリへのアクセスを承認するよう求められます。

既知の問題と制限事項

多数の受信メールのトリガー制限

新しいメールが届くと、インターバル 30 秒あたり 300 通の以上のメールを受信している場合、トリガーは、メールをスキップすることがあります。 メールの数を減らすために、追加のフィルター パラメーターを使用してフローを構成することを検討してください。

新規メールが届いたとき トリガーは、Google Workspace (以前の G Suite) アカウントを使用している場合、トリガーによって添付ファイル付きのメールが断続的にスキップされることがあります。 これは、場合によっては Gmail API ではメールの処理には長い時間がかかるため (おそらく添付ファイルのセキュリティ スキャン) が原因で発生します、ですからメールは一定の遅延で受信されます。

可能な回避策は、次のことを試してください。

  • 小さなメール (添付ファイルなし) を使用し、それほど頻繁に送信しないようにしてください

  • 別のコンシューマー Gmail アカウントを使用して、Google Workspace アカウントからこの新しいコンシューマー Gmail アカウントへの自動転送を構成します。 この新しいアカウントに対してトリガーを構成します。 これは消費者アカウントであるため、遅延は最小限に抑えられ、トリガーはそのようなメールをスキップしないと考えています。

  • カスタム コネクタ を qパラメータ を使って ListMessage API に使用します。

    • 過去 5 分間のメッセージを一覧表示するアクションを作成します。 q パラメータを使用してそれをおこなえます。 qパラメータ値 - after:1649457986 の例。 アクション入力として current time - 5min のエポックタイムを提供する必要があります。

      • 1649457986 は、"Friday, April 8, 2022 3:46:26 PM GMT-07:00" を表すエポックタイムです。

    • 空になるまで応答からの nextPageToken の値を確認します。 空でない場合は、同じ API を pageToken に設定されたパラメータ値を応答から nextPageToken に設定して、呼び出す必要があります。 例えば、"まで" ループ を使ってそれをおこなえます。

    • 以前の実行 (たとえば、処理済みの ID を保存するための Azure テーブル ストレージ コネクタ) ですでに処理されたメッセージ ID を除外します

    • メールの詳細を取得する アクションを使用して、ID でメールコンテンツを取得する

コンシューマー Gmail アカウントでの Gmail コネクタの使用

Google のセキュリティおよびプライバシーポリシーに準拠して、コンシューマー向け Gmail アカウント (@gmail.com および @googlemail.com で終わるアカウント) を使用している場合は、Power Automate および Logic Apps 内の限られたサービス セットにのみ接続できます。 Google Workspace (以前の G Suite) アカウントを使用しているお客様は、この変更による影響を受けません。 以下のリストに指定されていないサービスで Gmail コネクタを使用する必要がある場合は、独自のアプリケーション ID を Google に登録する 必要があります。 以下は現在承認されているサービスのリストです。このリストは、Google のポリシーに従って将来変更される可能性があることに注意してください。

  • Google サービス: Gmail、Google Calendar、Google Contacts、Google Drive、Google Sheets、Google Tasks
  • 組み込みアクションとトリガー: コントロール、AI Builder、データ操作、日時、数値関数、Power Virtual Agents、Power Apps、要求、スケジュール、テキスト関数、変数、フロー ボタン、場所
  • Microsoft サービスの限定セット : OneDrive、Sharepoint、Excel、Dynamics、Microsoft Teams、Office 365、SQL、SFTP および FTP

Power Automate で、非準拠のサービスを使用してフローを作成すると、フローは無効な状態で保存されます。

作業単位を計算する

コネクタには、1 日に消費できるワーク ユニットの数に制限があります (ここを参照)。

これらの作業単位が各操作でどのように計算されるかについてのロジックを以下に示します。

  • [新しいメールが届いたとき] トリガー : 10 + (5 * attachmentsCount);
    • トリガーが新しいメールを返す場合 : メッセージを一覧表示するための 5 ユニット + メッセージを取得するための 5 ユニット + 5 ユニット * 添付ファイルがカウントされます。
    • トリガーが新しいメールを返さない場合 : メッセージを一覧表示するための 5 ユニット。
  • メールを送信 (V2) アクション : 100 ユニット。
  • メールに返信 (V2) アクション : 105 + (5 * attachmentsCount);
    • 元のメッセージを取得するための 5 ユニット + 返信メッセージを送信するための 100 ユニット + 5 ユニット * インライン添付ファイルは元のメッセージにカウントされます。
  • 他のすべてのアクションの場合 : 10 ユニット。

コネクタの詳細

コネクタの詳細については、詳細セクション を参照してください。

一般的な制限

名称 価値
最大メール サイズ (MB 単位) 35
最大添付ファイル サイズ (MB 単位) 30

接続の作成

コネクタは、次の認証タイプをサポートしています:
独自のアプリケーションを導入する 独自の Google アプリを使用してサインインします。 詳細は https://docs.microsoft.com/connectors/gmail/#authentication-and-bring-your-own-application を参照してください。 すべての地域 共有不可
共有済みの既定アプリケーションを使用する 標準 Google アプリを使用してサインインします。 すべての地域 共有不可
既定 [非推奨] このオプションは、明示的な認証の種類を持たない古い接続専用に対してのみ使用され、下位互換性を保つためにのみ提供されます。 すべての地域 共有不可

独自のアプリケーションを導入する

認証 ID: byoa

適用できるもの: すべての領域

独自の Google アプリを使用してサインインします。 詳細は https://docs.microsoft.com/connectors/gmail/#authentication-and-bring-your-own-application を参照してください。

これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

件名 タイプ 内容 必要
クライアント ID 文字列 Google アプリケーションのクライアント (またはアプリケーション) ID 真
クライアント シークレット securestring Google アプリケーションのクライアント シークレット 真

共有済みの既定アプリケーションを使用する

認証 ID: 共有済みアプリケーション

適用できるもの: すべての領域

標準 Google アプリを使用してサインインします。

これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

既定 [非推奨]

適用できるもの: すべての領域

このオプションは、明示的な認証の種類を持たない古い接続専用に対してのみ使用され、下位互換性を保つためにのみ提供されます。

これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 60 60 秒
1 日あたりの作業単位 90000 86400 秒

アクション

メールに返信する [非推奨]

このアクションは非推奨になりました。 代わりに、メールに返信する (V2) を使用してください。

この操作は、特定のメールに返信するために使用されます。
メールの削除

この操作は、特定のメールを完全に削除するために使用されます。
メールの詳細を取得する

この操作は、特定のメールの詳細を取得します。
メールをゴミ箱に移動する

この操作は、特定のメールをゴミ箱に移動するために使用されます。
メールを送信する (V2)

この操作は、特定の受信者にメールを送信するために使用されます。
メールを送信する [非推奨]

このアクションは非推奨になりました。 メールを送信する (V2) を代わりに使用してください。

この操作は、特定の受信者にメールを送信するために使用されます。
電子メールに返信 (V2)

この操作は、特定のメールに返信するために使用されます。

メールに返信する [非推奨]

操作 ID:
ReplyTo

このアクションは非推奨になりました。 代わりに、メールに返信する (V2) を使用してください。

この操作は、特定のメールに返信するために使用されます。

パラメーター

名前 キー 必須 型 説明
メッセージ ID
 id True string

返信するメールの ID。
受信先
 To email

例: recipient1@domain.com; recipient2@domain.com
CC
 Cc email

例: recipient1@domain.com; recipient2@domain.com
BCC
 Bcc email

例: recipient1@domain.com; recipient2@domain.com
サブジェクト
 Subject string

メールの件名 (空の場合は、元の件名が使用されます)。
本文​​
 Body string

メールの内容。
全員へ返信
 ReplyAll boolean

すべての受信者に返信する場合は True。 (既定: False)
HTML かどうか
 IsHtml boolean

返信を HTML として送信する場合は True。 (既定 : True)
重要度
 Importance string

重要性を選択してください。 (既定 : 標準)
件名
 Name True string

添付ファイルのタイトル。
内容
 ContentBytes True byte

添付ファイルの本文。
コンテンツ タイプ
 ContentType string

添付ファイルのコンテンツの種類。

メールの削除

操作 ID:
DeleteEmail

この操作は、特定のメールを完全に削除するために使用されます。

パラメーター

名前 キー 必須 型 説明
メッセージ ID
 id True string

削除するメールの ID。

メールの詳細を取得する

操作 ID:
GetEmail

この操作は、特定のメールの詳細を取得します。

パラメーター

名前 キー 必須 型 説明
メッセージ ID
 id True string

メール メッセージの一意の ID。
添付ファイルを含む
 includeAttachments boolean

true に設定すると、メールと共に添付ファイルも取得されます。

戻り値

特定のメール メッセージに関連付けられた詳細。

本文​​
DetailedReceiveMessage

メールをゴミ箱に移動する

操作 ID:
TrashEmail

この操作は、特定のメールをゴミ箱に移動するために使用されます。

パラメーター

名前 キー 必須 型 説明
メッセージ ID
 id True string

ゴミ箱に移動するメールの ID。

メールを送信する (V2)

操作 ID:
SendEmailV2

この操作は、特定の受信者にメールを送信するために使用されます。

パラメーター

名前 キー 必須 型 説明
発信先
 To True email

セミコロンまたはコンマで区切られた、有効なメール アドレスのリスト。
CC
 Cc email

セミコロンまたはコンマで区切られた、有効なメール アドレスのリスト。
BCC
 Bcc email

セミコロンまたはコンマで区切られた、有効なメール アドレスのリスト。
情報カテゴリ
 Subject string

送信メールの件名。
本文​​
 Body html

送信メールの本文。
重要度
 Importance string

メール メッセージに関連する重要性。
件名
 Name True string

添付ファイルのタイトル。
内容
 ContentBytes True byte

添付ファイルの本文。
コンテンツ タイプ
 ContentType string

添付ファイルのコンテンツの種類。

メールを送信する [非推奨]

操作 ID:
SendEmail

このアクションは非推奨になりました。 メールを送信する (V2) を代わりに使用してください。

この操作は、特定の受信者にメールを送信するために使用されます。

パラメーター

名前 キー 必須 型 説明
発信先
 To True email

セミコロンまたはコンマで区切られた、有効なメール アドレスのリスト。
CC
 Cc email

セミコロンまたはコンマで区切られた、有効なメール アドレスのリスト。
BCC
 Bcc email

セミコロンまたはコンマで区切られた、有効なメール アドレスのリスト。
情報カテゴリ
 Subject string

送信メールの件名。
本文​​
 Body string

送信メールの本文。
HTML かどうか
 IsHtml boolean

メールを HTML として送信する場合は True。 (既定 : True)
重要度
 Importance string

メール メッセージに関連する重要性。
件名
 Name True string

添付ファイルのタイトル。
内容
 ContentBytes True byte

添付ファイルの本文。
コンテンツ タイプ
 ContentType string

添付ファイルのコンテンツの種類。

電子メールに返信 (V2)

操作 ID:
ReplyToV2

この操作は、特定のメールに返信するために使用されます。

パラメーター

名前 キー 必須 型 説明
メッセージ ID
 id True string

返信するメールの ID。
受信先
 To email

例: recipient1@domain.com; recipient2@domain.com
CC
 Cc email

例: recipient1@domain.com; recipient2@domain.com
BCC
 Bcc email

例: recipient1@domain.com; recipient2@domain.com
サブジェクト
 Subject string

メールの件名 (空の場合は、元の件名が使用されます)。
本文​​
 Body html

メールの内容。
全員へ返信
 ReplyAll boolean

すべての受信者に返信する場合は True。 (既定 : False)
重要度
 Importance string

重要性を選択してください。 (既定 : 標準)
件名
 Name True string

添付ファイルのタイトル。
内容
 ContentBytes True byte

添付ファイルの本文。
コンテンツ タイプ
 ContentType string

添付ファイルのコンテンツの種類。

トリガー

新しいメールが届いたとき

この操作は、指定された基準に一致する新しいメールが到着したときにトリガーされます。

新しいメールが届いたとき

操作 ID:
OnNewEmail

この操作は、指定された基準に一致する新しいメールが到着したときにトリガーされます。

パラメーター

名前 キー 必須 型 説明
Label
 label string

ラベルを選択します (既定 : 受信箱)。
発信先
 to email

セミコロンまたはコンマで区切られた、有効なメール アドレスのリスト。
送信者
 from email

例: Sender1 | sender2@domain.com。
サブジェクト
 subject string

件名内で検索する文字列です。
重要度
 importance string

メールが重要な場合は True。 (既定 : すべて)。
スター付き
 starred string

メールにスターを付ける必要がある場合は True。 (既定 : すべて)。
添付ファイルあり
 fetchOnlyWithAttachments boolean

添付ファイル付きのメールのみを取得する場合は True。
添付ファイルを含む
 includeAttachments boolean

メールと一緒に添付ファイルを取得する場合は True。

戻り値

特定のメール メッセージに関連付けられた詳細。

本文​​
DetailedReceiveMessage

定義

DetailedReceiveMessage

特定のメール メッセージに関連付けられた詳細。

名前 パス 型 説明
From
 From email

メッセージの送信元のメール アドレス。
送信者の名前
 SenderName string

メール送信者の名前
発信先
 To email

メッセージの送信先のメール アドレス。
CC
 Cc email

CC フィールドに含まれるメール アドレス。
BCC
 Bcc email

BCC フィールドに含まれるメール アドレス。
情報カテゴリ
 Subject string

メール メッセージに関連付けられた件名またはトピック。
本文​​
 Body string

メール メッセージの内容。
スニペット
 Snippet string

メッセージ テキストの短い部分。
ラベル ID
 LabelIds array of string

メール メッセージに関連付けられているラベルのリスト。
受信日時
 DateTimeReceived date-time

例 : 2017-05-03T20:08:57+00:00
推定サイズ
 EstimatedSize integer

メッセージの推定サイズ (バイト単位)。
既読かどうか ?
 IsRead boolean

メッセージが既読の場合は True。それ以外の場合は false。
HTML かどうか
 IsHtml boolean

メッセージが HTML 形式の場合は True。
添付ファイルあり
 HasAttachments boolean

メッセージに添付ファイルがある場合は True。
Attachments
 Attachments array of Attachment

メール メッセージの添付ファイルのリスト。
メッセージ ID
 Id string

メッセージの不変の ID。
スレッド ID
 ThreadId string

メッセージが属するスレッドの ID。

添付

メールの添付ファイルのプロパティ。

名前 パス 型 説明
件名
 Name string

添付ファイルのタイトル。
内容
 ContentBytes byte

添付ファイルの本文。
コンテンツ タイプ
 ContentType string

添付ファイルのコンテンツの種類。