Office 365 Groups Mail
Office 365 Groups Mail コネクタを使用すると、ユーザーは Office 365 Group メールボックスにあるデータを操作できます。 このコネクタの機能は、単一のユーザーの個人用メールボックスとは独立して機能し、ユーザーが組織内でアクセスできる任意のグループで作業できるようにします。 コネクタは Microsoft Graph API で機能し、Graph API 内の Office 365 Groups のドキュメントで指定されている用語を使用します。 詳細については、コネクタのドキュメントをご覧ください。
このコネクタは、次の製品および地域で利用可能です。
| サービス | クラス | リージョン |
|---|---|---|
| Logic Apps | 標準 | すべての Logic Apps 地域 |
| Power Automate | Standard | すべての Power Automate 地域 |
| Power Apps | Standard | すべての Power Apps 地域 |
| Contact | |
|---|---|
| 件名 | マイクロソフト |
| URL | Microsoft LogicApps サポート Microsoft Power Automate サポート Microsoft Power Apps サポート |
| コネクタ メタデータ | |
|---|---|
| 公開元 | Microsoft |
| Web サイト | https://docs.microsoft.com/en-us/graph/api/resources/groups-overview?view=graph-rest-1.0 |
| カテゴリ | 生産性 |
前提条件
このコネクタを使用するには、組織内の Office 365 Groups にアクセスできるユーザー アカウントが必要です。
Microsoft 365 グループ用の Microsoft Graph API ドキュメント を確認して、API 内でのデータの構造を理解することをお勧めします。 「会話」、「スレッド」、「投稿」など、このコネクタを使用する前に確認する必要のある主な用語があります。
既知の問題と制限事項
「指定したオブジェクトがストア内に見つかりませんでした」エラーのトラブルシューティングを行うには、次を実行することができます。
- アカウントのアクセス許可を検証します。
- 現在の Office 365 グループメールの接続を削除して、新しい接続を作成してみてください。
メンバーシップなしで「パブリック」グループにアクセスする
認証されたユーザーは、メンバーであるグループおよび組織内の任意の「パブリック」グループからグループ データにアクセスできます。 コネクタのエクスペリエンスでは、グループを選択すると、コネクタは選択するグループの動的ドロップダウンを提供します。 よりクリーンなエクスペリエンスのために、このドロップダウンには、認証されたユーザーがメンバーになっているグループのみが自動的に入力されます。
ドロップダウンに入力されていない組織内の「パブリック」グループにアクセスするには、一番下までスクロールしてコネクタ ドロップダウンにグループ ID を入力し、カスタム値を入力を選択する必要があります。
組織内でグループ ID を確認するには、次の手順に従います。
Microsoft Graph Explorer に移動し、左上のユーザーで認証します。
サンプル クエリ セクションで、グループを選択し、その後組織内のすべてのグループを取得するを選択します。
応答プレビューで、探している組織内のグループを見つけます。 コネクタ ドロップ エクスペリエンスでカスタム値としての
idプロパティで値を指定します。グループの表示方法がパブリックに設定されていることを確認します。そうしないと、ユーザーはグループ内のデータにアクセスできなくなります。
グループが見つからない場合は、結果の次のページを確認する必要があります。このページには、
@odata.nextLinkでリンクをコピーして、ページの上部でクエリとして実行することでアクセスできます。
メール トリガー
同時に送信されるメールが多数ある場合、トリガーが一部のメールを見落とす可能性があります。 これは電子メール処理遅延を伴う基盤となるシステム制限が原因で、(コネクタが遅延した電子メールを含むバッチを処理した後に) 電子メールが遅れて「表示」されるようになります。
非推奨の情報
このコネクタのメール流出制御 サポートがないため、「投稿の転送」操作は一時的に非推奨になりました。 サポートの提供に取り組んでおり、完了したら操作を更新します。
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
| トリガー ポーリングの頻度 | 1 | 60 秒 |
アクション
| HTTP 要求を送信する |
Microsoft Graph REST API リクエストを作成し呼び出します。 詳細情報: https://docs.microsoft.com/en-us/graph/use-the-api |
| グループに新しい会話を作成する |
このグループに新しい会話を作成します。 |
| グループのスレッドを一覧表示する |
グループのスレッドをすべて取得します。 |
| グループの会話を一覧表示する |
このグループの会話をすべて取得します。 |
| グループ会話を取得する |
特定の会話のプロパティを取得します。 |
| スレッドを作成して新しいグループ会話を開始する |
最初にスレッドを作成してから新しいグループ会話を開始します。 |
| スレッド投稿を取得する |
指定したスレッドの投稿を取得します。 |
| 会話の会話スレッドを一覧表示する |
グループ会話のスレッドをすべて取得します。 |
| 会話スレッドに返信する |
グループ会話のスレッドに返信して、新しい投稿を追加します。 |
| 会話スレッドの投稿を一覧表示する |
指定した会話スレッドの投稿をすべて取得します。 |
| 会話スレッドを作成する |
指定した会話に新しいスレッドを作成します。 |
| 会話スレッドを削除する |
指定した会話スレッドを削除します。 |
| 会話スレッドを取得する |
グループに属する特定のスレッドを取得します。 |
| 投稿に返信する |
投稿に返信して、グループ会話の指定したスレッドに新しい投稿を追加します。 |
| 投稿の添付ファイルを一覧表示する |
投稿に属する添付ファイルの一覧を取得します。 |
| 投稿を転送する (プレビュー) |
受信者に投稿を転送します。 |
| 投稿を転送する [非推奨] |
このアクションは非推奨になりました。 代わりに、投稿を転送する を使用してください。
|
HTTP 要求を送信する
Microsoft Graph REST API リクエストを作成し呼び出します。 詳細情報: https://docs.microsoft.com/en-us/graph/use-the-api
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
URI
|
Uri | True | string |
完全または相対 URI。 例: https://graph.microsoft.com/{version}/{resource}。 |
|
メソッド
|
Method | True | string |
HTTP メソッド (既定は GET)。 |
|
本文
|
Body | binary |
要求本文のコンテンツ。 |
|
|
コンテンツタイプ
|
ContentType | string |
本文のコンテンツ タイプ ヘッダー (既定はアプリケーション/JSON)。 |
|
|
CustomHeader1
|
CustomHeader1 | string |
カスタム ヘッダー 1。 フォーマットに指定: ヘッダー名: ヘッダー値 |
|
|
CustomHeader2
|
CustomHeader2 | string |
カスタム ヘッダー 2。 フォーマットに指定: ヘッダー名: ヘッダー値 |
|
|
CustomHeader3
|
CustomHeader3 | string |
カスタム ヘッダー 3。 フォーマットに指定: ヘッダー名: ヘッダー値 |
|
|
CustomHeader4
|
CustomHeader4 | string |
カスタム ヘッダー 4。 フォーマットに指定: ヘッダー名: ヘッダー値 |
|
|
CustomHeader5
|
CustomHeader5 | string |
カスタム ヘッダー 5。 フォーマットに指定: ヘッダー名: ヘッダー値 |
戻り値
グループに新しい会話を作成する
このグループに新しい会話を作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
グループ ID
|
groupId | True | string |
ドロップ ダウンからグループを選択するか、グループの ID を入力します。 |
|
新しいトピック
|
topic | True | string |
新しい会話のトピック。 |
|
コンテンツ
|
content | True | html |
新しい会話のコンテンツ。 |
|
カテゴリー
|
categories | array of string |
投稿に関連付けられたカテゴリ。 |
|
|
番地
|
Address |
メール アドレス。 |
||
|
添付ファイル名
|
Name | True | string |
添付ファイルの名前。 |
|
添付ファイルのコンテンツ
|
ContentBytes | True | byte |
添付ファイルのコンテンツ。 |
戻り値
作成した会話の詳細に対する応答。
- 作成した会話オブジェクト
- CreateConversationResponse
グループのスレッドを一覧表示する
グループのスレッドをすべて取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
グループ ID
|
groupId | True | string |
ドロップ ダウンからグループを選択するか、グループの ID を入力します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
値
|
value | array of ConversationThread |
グループの会話を一覧表示する
このグループの会話をすべて取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
グループ ID
|
groupId | True | string |
ドロップ ダウンからグループを選択するか、グループの ID を入力します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
値
|
value | array of Conversation |
グループ会話を取得する
特定の会話のプロパティを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
グループ ID
|
groupId | True | string |
ドロップ ダウンからグループを選択するか、グループの ID を入力します。 |
|
会話 ID
|
conversationId | True | string |
会話 ID を入力します。 |
戻り値
会話オブジェクト。
- 本文
- Conversation
スレッドを作成して新しいグループ会話を開始する
最初にスレッドを作成してから新しいグループ会話を開始します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
グループ ID
|
groupId | True | string |
ドロップ ダウンからグループを選択するか、グループの ID を入力します。 |
|
新しいトピック
|
topic | True | string |
新しい会話のトピック。 |
|
コンテンツ
|
content | True | html |
新しい会話のコンテンツ。 |
|
カテゴリー
|
categories | array of string |
投稿に関連付けられたカテゴリ。 |
|
|
番地
|
Address |
メール アドレス。 |
||
|
添付ファイル名
|
Name | True | string |
添付ファイルの名前。 |
|
添付ファイルのコンテンツ
|
ContentBytes | True | byte |
添付ファイルのコンテンツ。 |
戻り値
スレッド投稿を取得する
指定したスレッドの投稿を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
グループ ID
|
groupId | True | string |
ドロップ ダウンからグループを選択するか、グループの ID を入力します。 |
|
スレッド ID
|
threadId | True | string |
会話スレッド ID を入力します。 |
|
投稿 ID
|
postId | True | string |
投稿 ID を入力します。 |
戻り値
会話スレッド エンティティが含むそれぞれの投稿アイテムを表します。
- 本文
- Post
会話の会話スレッドを一覧表示する
グループ会話のスレッドをすべて取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
グループ ID
|
groupId | True | string |
ドロップ ダウンからグループを選択するか、グループの ID を入力します。 |
|
会話 ID
|
conversationId | True | string |
会話 ID を入力します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
値
|
value | array of ConversationThread |
会話スレッドに返信する
グループ会話のスレッドに返信して、新しい投稿を追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
グループ ID
|
groupId | True | string |
ドロップ ダウンからグループを選択するか、グループの ID を入力します。 |
|
スレッド ID
|
threadId | True | string |
会話スレッド ID を入力します。 |
|
コンテンツ
|
content | True | html |
新しい会話のコンテンツ。 |
|
カテゴリー
|
categories | array of string |
投稿に関連付けられたカテゴリ。 |
|
|
番地
|
Address |
メール アドレス。 |
||
|
添付ファイル名
|
Name | True | string |
添付ファイルの名前。 |
|
添付ファイルのコンテンツ
|
ContentBytes | True | byte |
添付ファイルのコンテンツ。 |
会話スレッドの投稿を一覧表示する
指定した会話スレッドの投稿をすべて取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
グループ ID
|
groupId | True | string |
ドロップ ダウンからグループを選択するか、グループの ID を入力します。 |
|
スレッド ID
|
threadId | True | string |
会話スレッド ID を入力します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
値
|
value | array of Post |
指定したスレッドの投稿を含む配列。 |
会話スレッドを作成する
指定した会話に新しいスレッドを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
グループ ID
|
groupId | True | string |
ドロップ ダウンからグループを選択するか、グループの ID を入力します。 |
|
会話 ID
|
conversationId | True | string |
会話 ID を入力します。 |
|
新しいトピック
|
topic | True | string |
新しい会話のトピック。 |
|
コンテンツ
|
content | True | html |
新しい会話のコンテンツ。 |
|
カテゴリー
|
categories | array of string |
投稿に関連付けられたカテゴリ。 |
|
|
番地
|
Address |
メール アドレス。 |
||
|
添付ファイル名
|
Name | True | string |
添付ファイルの名前。 |
|
添付ファイルのコンテンツ
|
ContentBytes | True | byte |
添付ファイルのコンテンツ。 |
戻り値
会話スレッドを削除する
指定した会話スレッドを削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
グループ ID
|
groupId | True | string |
ドロップ ダウンからグループを選択するか、グループの ID を入力します。 |
|
スレッド ID
|
threadId | True | string |
会話スレッド ID を入力します。 |
会話スレッドを取得する
グループに属する特定のスレッドを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
グループ ID
|
groupId | True | string |
ドロップ ダウンからグループを選択するか、グループの ID を入力します。 |
|
スレッド ID
|
threadId | True | string |
会話スレッド ID を入力します。 |
戻り値
会話スレッド オブジェクト。
- 本文
- ConversationThread
投稿に返信する
投稿に返信して、グループ会話の指定したスレッドに新しい投稿を追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
グループ ID
|
groupId | True | string |
ドロップ ダウンからグループを選択するか、グループの ID を入力します。 |
|
スレッド ID
|
threadId | True | string |
会話スレッド ID を入力します。 |
|
投稿 ID
|
postId | True | string |
投稿 ID を入力します。 |
|
コンテンツ
|
content | True | html |
新しい会話のコンテンツ。 |
|
カテゴリー
|
categories | array of string |
投稿に関連付けられたカテゴリ。 |
|
|
番地
|
Address |
メール アドレス。 |
||
|
添付ファイル名
|
Name | True | string |
添付ファイルの名前。 |
|
添付ファイルのコンテンツ
|
ContentBytes | True | byte |
添付ファイルのコンテンツ。 |
投稿の添付ファイルを一覧表示する
投稿に属する添付ファイルの一覧を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
グループ ID
|
groupId | True | string |
ドロップ ダウンからグループを選択するか、グループの ID を入力します。 |
|
スレッド ID
|
threadId | True | string |
会話スレッド ID を入力します。 |
|
投稿 ID
|
postId | True | string |
投稿 ID を入力します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
値
|
value | array of Attachment |
投稿の添付ファイルを含む配列。 |
投稿を転送する (プレビュー)
受信者に投稿を転送します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
グループ メール
|
groupMail | True | string |
ドロップ ダウンからグループを選択するか、グループの電子メール アドレスを入力します。 |
|
会話 ID
|
conversationId | True | string |
会話 ID を入力します。 |
|
スレッド ID
|
threadId | True | string |
会話スレッド ID を入力します。 |
|
投稿 ID
|
postId | True | string |
投稿 ID を入力します。 |
|
コメント
|
Comment | html |
投稿を転送する際のコメントです。 |
|
|
Address
|
Address |
メール アドレス。 |
投稿を転送する [非推奨]
このアクションは非推奨になりました。 代わりに、投稿を転送する を使用してください。
受信者に投稿を転送します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
グループ ID
|
groupId | True | string |
ドロップ ダウンからグループを選択するか、グループの ID を入力します。 |
|
スレッド ID
|
threadId | True | string |
会話スレッド ID を入力します。 |
|
投稿 ID
|
postId | True | string |
投稿 ID を入力します。 |
|
コメント
|
comment | string |
投稿を転送する際のコメントです。 |
|
|
住所
|
Address |
メール アドレス。 |
トリガー
| グループに新しいメールが届いたとき |
グループが新しいメールを受信したとき。 |
グループに新しいメールが届いたとき
グループが新しいメールを受信したとき。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
グループ ID
|
groupId | True | string |
ドロップ ダウンからグループを選択するか、グループの ID を入力します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
値
|
value | array of ConversationTriggerResponse |
トリガーの応答。 |
定義
会話
会話オブジェクト。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
会話 ID
|
id | string |
会話の一意識別子。 |
|
会話トピック
|
topic | string |
会話のトピック。 |
|
添付ファイルはありますか?
|
hasAttachments | boolean |
この会話が含むすべての投稿に、少なくとも 1 件の添付ファイルが存在するかどうかを示します。 |
|
最新配信のタイムスタンプ
|
lastDeliveredDateTime | date-time |
このタイムスタンプの種類は、日時の情報を ISO 8601 形式で表し、常に UTC 時間です。 |
|
一意の送信者配列
|
uniqueSenders | array of string |
この会話にメッセージを送信したすべてのユーザー。 |
|
プレビュー
|
preview | string |
この会話の最新の投稿本文に関する簡単な概要。 |
ConversationThread
会話スレッド オブジェクト。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
会話スレッド ID
|
id | string |
会話スレッドの一意識別子。 |
|
会話トピック
|
topic | string |
会話のトピック。 |
|
添付ファイルはありますか?
|
hasAttachments | boolean |
この会話が含むすべての投稿に、少なくとも 1 件の添付ファイルが存在するかどうかを示します。 |
|
最新配信のタイムスタンプ
|
lastDeliveredDateTime | date-time |
このタイムスタンプの種類は、日時の情報を ISO 8601 形式で表し、常に UTC 時間です。 |
|
一意の送信者配列
|
uniqueSenders | array of string |
この会話にメッセージを送信したすべてのユーザー。 |
|
プレビュー
|
preview | string |
この会話の最新の投稿本文に関する簡単な概要。 |
|
ロックされていますか?
|
isLocked | boolean |
ロック済みスレッドかどうかを示します。 |
|
toRecipients
|
toRecipients | array of EmailAddress |
スレッドの To 受信者。 |
|
ccRecipients
|
ccRecipients | array of EmailAddress |
スレッドの CC 受信者。 |
POST
会話スレッド エンティティが含むそれぞれの投稿アイテムを表します。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
投稿 ID
|
id | string |
投稿の一意識別子。 |
|
作成した投稿のタイムスタンプ
|
createdDateTime | date-time | |
|
投稿の最終変更のタイムスタンプ
|
lastModifiedDateTime | date-time | |
|
変更キー
|
changeKey | string |
投稿のバージョンを識別します。 |
|
会話 ID
|
conversationId | string |
この投稿が属する会話を表す一意の ID。 |
|
会話スレッド ID
|
conversationThreadId | string |
この投稿が属する会話スレッドを表す一意の ID。 |
|
カテゴリ
|
categories | array of string |
投稿に関連付けられたカテゴリ。 |
|
受信のタイムスタンプ
|
receivedDateTime | date-time |
投稿受信のタイムスタンプ。 |
|
添付ファイルはありますか?
|
hasAttachments | boolean |
投稿に少なくとも 1 件の添付ファイルが存在するかどうかを表します。 |
|
新しい参加者
|
newParticipants | array of EmailAddress |
この投稿の一部としてスレッドに追加した会話の参加者。 |
|
本文
|
body | ItemBody |
メッセージ、イベント、グループ投稿など、アイテム本文のプロパティを表します。 |
|
開始
|
from | EmailAddress | |
|
sender
|
sender | EmailAddress | |
|
添付ファイル
|
attachments | array of Attachment |
添付
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
添付ファイル ID
|
id | string |
添付ファイルの ID。 |
|
添付ファイル名
|
name | string |
添付ファイルの名前。 |
|
添付ファイルのコンテンツ タイプ
|
contentType | string |
添付ファイルのコンテンツ タイプです。 |
|
添付ファイルのサイズ
|
size | integer |
添付ファイルのサイズ。 |
|
添付ファイル コンテンツのバイト数
|
contentBytes | byte |
添付ファイルのコンテンツ。 |
EmailAddress
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ユーザーの名前
|
emailAddress.name | string | |
|
ユーザーのメール アドレス
|
emailAddress.address |
ItemBody
メッセージ、イベント、グループ投稿など、アイテム本文のプロパティを表します。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
本文のコンテンツ タイプ
|
contentType | string |
本文のコンテンツ タイプ。 |
|
本文のコンテンツ
|
content | string |
本文のコンテンツ。 |
CreateConversationResponse
作成した会話の詳細に対する応答。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
会話 ID
|
id | string |
新しい会話 ID。 |
|
会話スレッド
|
threads | array of object |
会話スレッドを作成しました。 |
|
スレッド ID
|
threads.id | string |
新しいスレッド ID。 |
NewConversationThreadResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
会話スレッド ID
|
id | string |
新しい会話スレッド ID。 |
ConversationTriggerResponse
新しいメールが届いた時のトリガー応答。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
会話 ID
|
id | string |
会話の一意識別子。 |
|
最新配信のタイムスタンプ
|
lastDeliveredDateTime | date-time |
このタイムスタンプの種類は、日時の情報を ISO 8601 形式で表し、常に UTC 時間です。 |
|
スレッド
|
threads | array of ConversationThreadTriggerResponse |
ConversationThreadTriggerResponse
会話スレッド オブジェクト。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
会話スレッド ID
|
id | string |
会話スレッドの一意識別子。 |
|
投稿
|
posts | array of PostTriggerResponse |
PostTriggerResponse
会話スレッド エンティティが含むそれぞれの投稿アイテムを表します。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
投稿 ID
|
id | string |
投稿の一意識別子。 |
|
投稿の最終変更のタイムスタンプ
|
lastModifiedDateTime | date-time | |
|
変更キー
|
changeKey | string |
投稿のバージョンを識別します。 |