次の方法で共有

Gmail

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

このコネクタは、次の製品とリージョンで使用できます。

サービス クラス リージョン
コピロット スタジオ Standard 次を除くすべての Power Automate リージョン :
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
ロジック アプリ Standard 次を除くすべての Logic Apps リージョン :
     - Azure China リージョン
     - 米国国防総省 (DoD)
Power Apps Standard 次を除くすべての Power Apps リージョン :
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
Power Automate Standard 次を除くすべての Power Automate リージョン :
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
お問い合わせ
名前 Microsoft
URL Microsoft LogicApps のサポート
Microsoft Power Automate のサポート
Microsoft Power Apps のサポート
コネクタ メタデータ
Publisher Microsoft
Web サイト https://mail.google.com/mail/
プライバシー ポリシー https://policies.google.com/privacy

認証と Bring Your Own アプリケーション

Gmail コネクタでは、複数の認証の種類がサポートされるようになりました。

  • 既定の共有アプリケーションを使用する
  • 独自のアプリケーションを持ち込む

既定の共有アプリケーションでは、Microsoft によって管理されている Google クライアント アプリケーションが使用されます。 この場合、Gmail アカウントにサインインすると、 Microsoft Power Platform アプリケーションに同意するように求められます。

[Bring your own application]\(独自のアプリケーションを持ち込む\) オプションを使用すると、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 クライアント アプリケーションとその資格情報の作成のプロセスを案内する セットアップ ツール が用意されています。 ツールを使用する際に役立つ情報を次に示します。

  • 必要に応じて、利用規約を読んで同意します。
  • 既存のプロジェクトを選択するか、ツールによって "My Project" という名前の新しいプロジェクトが作成されます。
  • このツールを使用すると、プロジェクトで Gmail API が有効になります。
  • このツールは、必要な資格情報の種類を確認しようとします。 OAuth クライアント アプリケーションを取得する必要があります。
    • 使用する API の Gmail API を選択します (まだ選択されていない場合)。
    • API の呼び出し元となる Web サーバー を選択します。
    • アクセスする データの [ユーザー データ ] を選択します。
  • このツールでは、OAuth 同意の設定画面が表示されます。
    • ユーザーの種類 (内部 または 外部) を選択します。 Gmail コンシューマー アカウントを使用している場合は、[ 内部] を選択できません。
    • アプリケーションの名前と、必要に応じてロゴを指定します。
    • [ スコープの追加 ] をクリックし、Gmail のスコープ (https://mail.google.com) を追加します。

      注

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

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

      注

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

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

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

Google OAuth クライアント

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

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

  • [ Bring your own application]\(独自のアプリケーションを持ち込む\) を選択
  • アプリケーションのクライアント ID とクライアント シークレットの値を指定します。

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

既知の問題と制限事項

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

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

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

考えられる回避策として、次の方法を試してください。

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

  • 別のコンシューマー Gmail アカウントを使用し、Google ワークスペース アカウントからこの新しいコンシューマー 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 値が空になるまで確認します。 空でない場合は、 pageToken パラメーター値を応答から nextPageToken に設定して同じ API を呼び出す必要があります。 たとえば 、"Until" ループ を使用してこれを行うことができます。

    • 以前の実行で既に処理されているメッセージ ID を除外します (たとえば、 Azure Table Storage コネクタを使用して、既に処理されている 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 カレンダー、Google 連絡先、Google ドライブ、Google スプレッドシート、Google タスク
  • 組み込みのアクションとトリガー: コントロール、AI ビルダー、データ操作、日時、数値関数、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を参照してください。

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

名前 タイプ Description 必須
クライアントID 文字列 Google アプリケーションのクライアント (またはアプリケーション) ID 正しい
クライアント シークレット securestring Google アプリケーションのクライアント シークレット 正しい

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

認証 ID: shared-application

適用対象: すべてのリージョン

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

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

既定 [非推奨]

適用対象: すべてのリージョン

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

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

調整制限

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

アクション

メールに返信する (V2)

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

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

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

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

この操作は、特定の受信者に電子メールを送信するために使用されます。
メールをごみ箱に移動する

この操作は、特定のメールをごみ箱に移動するために使用されます。
電子メールの詳細を取得する

この操作は、特定の電子メールの詳細を取得します。
電子メールの送信 (V2)

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

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

メールに返信する (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
 Body html

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

True を指定すると、すべての受信者に返信できます。 (既定値: False)
重要度
 Importance string

重要度を選択します。 (既定値: 標準)
名前
 Name True string

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

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

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

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

操作 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
 Body string

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

True を指定すると、すべての受信者に返信できます。 (既定値: False)
HTML です
 IsHtml boolean

True の 場合は、HTML として応答を送信します。 (既定値: True)
重要度
 Importance string

重要度を選択します。 (既定値: 標準)
名前
 Name True string

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

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

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

メールの送信 [非推奨]

操作 ID:
SendEmail

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

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

パラメーター

名前 キー 必須 型 説明
移行先
 To True email

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

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

セミコロンまたはコンマで区切られた有効な電子メール アドレスの一覧。
サブジェクト
 Subject string

送信メールの件名。
Body
 Body string

送信メールの本文。
HTML です
 IsHtml boolean

True を指定すると、電子メールが HTML として送信されます。 (既定値: True)
重要度
 Importance string

電子メール メッセージに関連付けられている重要度。
名前
 Name True string

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

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

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

メールをごみ箱に移動する

操作 ID:
TrashEmail

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

パラメーター

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

ごみ箱に移動するメールの ID。

電子メールの詳細を取得する

操作 ID:
GetEmail

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

パラメーター

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

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

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

戻り値

特定の電子メール メッセージに関連付けられている詳細。

Body
DetailedReceiveMessage

電子メールの送信 (V2)

操作 ID:
SendEmailV2

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

パラメーター

名前 キー 必須 型 説明
移行先
 To True email

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

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

セミコロンまたはコンマで区切られた有効な電子メール アドレスの一覧。
サブジェクト
 Subject string

送信メールの件名。
Body
 Body html

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

電子メール メッセージに関連付けられている重要度。
名前
 Name True string

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

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

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

電子メールを削除する

操作 ID:
DeleteEmail

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

パラメーター

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

削除する電子メールの ID。

トリガー

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

この操作は、指定した条件に一致する新しい電子メールが届いたときにトリガーされます。

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

操作 ID:
OnNewEmail

この操作は、指定した条件に一致する新しい電子メールが届いたときにトリガーされます。

パラメーター

名前 キー 必須 型 説明
ラベル
 label string

ラベルを選択します (既定: 受信トレイ)。
移行先
 to email

セミコロンまたはコンマで区切られた有効な電子メール アドレスの一覧。
より
 from email

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

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

True の 場合は、電子メールが重要です。 (既定値: すべて)。
主演
 starred string

True の 場合は、電子メールを星付けする必要があります。 (既定値: すべて)。
添付ファイルあり
 fetchOnlyWithAttachments boolean

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

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

戻り値

特定の電子メール メッセージに関連付けられている詳細。

Body
DetailedReceiveMessage

定義

DetailedReceiveMessage

特定の電子メール メッセージに関連付けられている詳細。

名前 パス 型 説明
より
 From email

メッセージが送信されたメール アドレス。
送信者の名前
 SenderName string

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

メッセージが送信された電子メール アドレス。
CC
 Cc email

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

[BCC] フィールドに含まれる電子メール アドレス。
サブジェクト
 Subject string

電子メール メッセージに関連付けられている件名またはトピック。
Body
 Body string

電子メール メッセージの内容。
抜粋
 Snippet string

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

電子メール メッセージに関連付けられているラベルの一覧。
受信した Date-Time
 DateTimeReceived date-time

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

メッセージの推定サイズ (バイト単位)。
読み取りですか?
 IsRead boolean

メッセージが読み取られた場合は True。それ以外の場合は false。
HTML です
 IsHtml boolean

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

True の 場合、メッセージに添付ファイルがあります。
Attachments
 Attachments array of Attachment

電子メール メッセージの添付ファイルの一覧。
メッセージ ID
 Id string

メッセージの変更できない ID。
スレッド ID
 ThreadId string

メッセージが属しているスレッドの ID。

Attachment

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

名前 パス 型 説明
名前
 Name string

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

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

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