次の方法で共有


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 を確認するには、次の手順に従います。

  1. Microsoft Graph Explorer に移動し、左上のユーザーで認証します。

  2. サンプル クエリ セクションで、グループを選択し、その後組織内のすべてのグループを取得するを選択します。

  3. 応答プレビューで、探している組織内のグループを見つけます。 コネクタ ドロップ エクスペリエンスでカスタム値としての id プロパティで値を指定します。

  4. グループの表示方法がパブリックに設定されていることを確認します。そうしないと、ユーザーはグループ内のデータにアクセスできなくなります。

  5. グループが見つからない場合は、結果の次のページを確認する必要があります。このページには、@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 email

メール アドレス。

添付ファイル名
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 email

メール アドレス。

添付ファイル名
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 email

メール アドレス。

添付ファイル名
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 email

メール アドレス。

添付ファイル名
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 email

メール アドレス。

添付ファイル名
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 email

メール アドレス。

投稿を転送する [非推奨]

このアクションは非推奨になりました。 代わりに、投稿を転送する を使用してください。

受信者に投稿を転送します。

パラメーター

名前 キー 必須 説明
グループ ID
groupId True string

ドロップ ダウンからグループを選択するか、グループの ID を入力します。

スレッド ID
threadId True string

会話スレッド ID を入力します。

投稿 ID
postId True string

投稿 ID を入力します。

コメント
comment string

投稿を転送する際のコメントです。

住所
Address email

メール アドレス。

トリガー

グループに新しいメールが届いたとき

グループが新しいメールを受信したとき。

グループに新しいメールが届いたとき

グループが新しいメールを受信したとき。

パラメーター

名前 キー 必須 説明
グループ 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 email

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

投稿のバージョンを識別します。

ObjectWithoutType