Office 365 Groups

Office 365 Groups を使用すると、Office 365 アカウントを使用して組織内のグループ メンバーシップとカレンダー イベントを管理できます。 グループ名簿の取得、メンバーの追加または削除、グループ イベントの作成など、さまざまなアクションを実行できます。

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

サービス クラス リージョン
Logic Apps 標準 すべての Logic Apps 地域
Power Automate 標準 すべての Power Automate 地域
Power Apps 標準 すべての Power Apps 地域
コネクタ メタデータ
発行元 Microsoft
Web サイト https://www.office.com/

既知の問題と制限事項

  1. グループ メンバーが追加、または削除されたとき トリガーは、バックエンドのサービスの制限により、後続のレスポンスで同じ変更を返すことがあります。 Power Automate フローや LogicApps アプリケーションは、このようなリプレイに備える必要があります。 詳細は、こちらでご覧ください。

  2. "メールが有効なセキュリティ グループや配布リストを更新できない" 旨のエラーが表示される場合は、Exchange 管理センターでこれらのグループを管理してください。

  3. 属性「isAssignableToRole」を持つ AAD グループは現在サポートされていません。

  4. HTTP リクエストを送信する/HTTP リクエスト V2 (プレビュー) を送信する アクション。 次のようなエラーが発生した場合:

  • { "error": { "code": "Forbidden", "message": "" } }
  • { "error": { "code": "Authorization_RequestDenied", "message": "Insufficient privileges to complete the operation." } } の場合は、このコネクタでスコープ セットが制限されている可能性があります。 シナリオでさらに高度な作業が必要な場合、"HTTP" コネクタを使用するか、カスタム コネクタを作成してください。

ページ区切り

ページ割り付け は結果のより大きなリストを返すクエリに必要です。

  • Power Automate と Logic Apps の ページ割り付け機能 は、Office 365 グループのコネクタでの一部の動作をサポートします。
  • Canvas Apps ギャラリー コントロールは、Office 365 グループ コネクタの自動ページ割り当てをサポートしていません。 ページングは手動で実装し、コレクションにキャッシュする必要があります。

サポートされている操作

  • ListGroupMembers
  • OnGroupMembershipChange
  • ListGroups

キャンバス アプリでページ割り当てエクスペリエンスを実装するには、@odata.nextLink フィールドを解析して、$skipToken 値を取得します。

警告

このフィールドは Power Automate や Logic Apps では使用しないでください。 キャンバスアプリの @odata.nextLink$skipToken のフィールドのみ使用してください。

キャンバス アプリでの手動ページ割り付け

最初の読み込み

データの最初のページを読み込むには、論理コントロールのアクション プロパティで次のコードを使用します (例: ページの OnVisible プロパティまたは検索を開始するボタン)。

/* Call the ListGroups operation and save response to a variable */
Set( var_response, Office365Groups.ListGroups() );

/* Parse the $skipToken value from the @odata.nextLink value in the response */
Set( var_nextLink, Last(Split( var_response.'@odata.nextLink', "=")).Result );

/* Save the response into a collection */
ClearCollect( col_groups, var_response.value );

/* Clear out the previous pages collection */
Clear( col_prevLinksData );

/* Reset page counter to 1 */
Set( var_page, 1 );

次のページを読み込みます


/* Update page counter */
Set( var_page, var_page + 1 );

/* Save the last link in a collection */
Collect( col_prevLinksData, { 
    page: var_page, 
    link: var_nextLink 
} );

/* Get next page response */
Set( var_response, Office365Groups.ListGroups({ '$skiptoken': var_nextLink }));

/* Parse the next page's skiptoken value */
Set( var_nextLink, Last(Split( var_response.'@odata.nextLink', "=" )).Result );

/* Save the page results to the collection */
ClearCollect( col_groups, var_response.value );

次に、ギャラリー コントロール (またはその他のデータ セット コントロール) の Items にある col_groups コレクションを使用して、ロードされたアイテムのリストを表示します。

接続を作成する

このコネクタは、次の認証タイプをサポートしています:

既定 接続を作成するためのパラメーター。 すべての地域 共有不可

既定

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

接続を作成するためのパラメーター。

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

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒
トリガー ポーリングの頻度 1 120 秒

アクション

HTTP リクエストを送信します 「非推奨」

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

Microsoft Graph REST API リクエストを作成し呼び出します。詳細: https://docs.microsoft.com/en-us/graph/use-the-api

HTTP 要求 V2 を送信する

Microsoft Graph REST API リクエストを作成し呼び出します。 サポートされているセグメントが 1 つあります: /groups。 詳細情報: https://docs.microsoft.com/en-us/graph/use-the-api。

イベントの削除 (V2)

この操作により、カレンダーのイベントが削除されます。

グループ イベントを作成する (V2)

この操作はグループ カレンダーに新しいイベントを作成するために使用されます。

グループ イベントを更新

この操作は、グループ カレンダーで新しいイベントを更新するために使用されます。

グループ メンバーを一覧表示する

この操作を実行すると、指定したグループ内のすべてのメンバーの一覧と、名前、タイトル、メールなどの詳細情報が返されます。上位のパラメーターを使用すると、1000 件までの項目をクエリできます。 1000 件を超える値を取得する必要がある場合は、設定 -> 改ページの機能を有効にして、しきい値の制限を指定してください。

グループの一覧

この操作を実行すると、組織のすべてのグループの一覧が返されます。

グループイベントを作成する [非推奨]

このアクションは非推奨になりました。 代わりにグループイベントの作成 (V2) を使用してください。

この操作はグループ カレンダーに新しいイベントを作成するために使用されます。

メンバーをグループから削除する

この操作は UPN を使用してメンバーを O365 グループから削除するために使用されます。

メンバーをグループに追加する

この操作は UPNを使用してメンバーを O365 グループに追加するために使用されます。

自分が所有および属しているグループを一覧表示する

この操作は、自分が所有および属しているすべてのグループの一覧を返します。

自分が所有しているグループを一覧表示する

この操作は、自分が所有しているグループの一覧を返します。

自分が所有しているグループを一覧表示する (V2)

この操作は、自分が所有しているグループの一覧を返します。

HTTP リクエストを送信します 「非推奨」

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

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。 フォーマットに指定: ヘッダー名: ヘッダー値

戻り値

HTTP 要求 V2 を送信する

Microsoft Graph REST API リクエストを作成し呼び出します。 サポートされているセグメントが 1 つあります: /groups。 詳細情報: 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。 フォーマットに指定: ヘッダー名: ヘッダー値

戻り値

イベントの削除 (V2)

この操作により、カレンダーのイベントが削除されます。

パラメーター

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

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

Id
event True string

イベントを選択する

グループ イベントを作成する (V2)

この操作はグループ カレンダーに新しいイベントを作成するために使用されます。

パラメーター

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

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

情報カテゴリ
subject True string

イベントのタイトル。

開始時間
dateTime True date-time

イベントの開始時刻 (例: '2016-11-01T14:30:00')。

終了時間
dateTime True date-time

イベントの終了時刻 (例: '2016-11-01T15:30:00')。

本文​​
content html

イベントに関連付けられているメッセージの本体。

場所
displayName string

イベントの場所。

重要度
importance string

イベントの重要度: 低、標準、高。

終日
isAllDay boolean

イベントが終日である場合は true に設定します。

アラーム設定済みである
isReminderOn boolean

イベントにアラームがある場合は true に設定します。

リマインダーの開始期間
reminderMinutesBeforeStart integer

イベントのアラームが開始されるまでの時間 (分)。

表示方法
showAs string

イベント中に表示する状態。

要求された応答
responseRequested boolean

イベントの承諾時または拒否時に送信者の応答を希望する場合は true に設定します。

戻り値

グループ イベントを更新

この操作は、グループ カレンダーで新しいイベントを更新するために使用されます。

パラメーター

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

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

Id
event True string

イベントを選択する

サブジェクト
subject True string

イベントのタイトル。

開始時刻
dateTime True date-time

イベントの開始時刻 (例: '2016-11-01T14:30:00')。

終了時間
dateTime True date-time

イベントの終了時刻 (例: '2016-11-01T15:30:00')。

本文​​
content html

イベントに関連付けられているメッセージの本体。

場所
displayName string

イベントの場所。

重要度
importance string

イベントの重要度: 低、標準、高。

終日
isAllDay boolean

イベントが終日である場合は true に設定します。

アラーム設定済みである
isReminderOn boolean

イベントにアラームがある場合は true に設定します。

リマインダーの開始期間
reminderMinutesBeforeStart integer

イベントのアラームが開始されるまでの時間 (分)。

表示方法
showAs string

イベント中に表示する状態。

要求された応答
responseRequested boolean

イベントの承諾時または拒否時に送信者の応答を希望する場合は true に設定します。

戻り値

グループ メンバーを一覧表示する

この操作を実行すると、指定したグループ内のすべてのメンバーの一覧と、名前、タイトル、メールなどの詳細情報が返されます。上位のパラメーターを使用すると、1000 件までの項目をクエリできます。 1000 件を超える値を取得する必要がある場合は、設定 -> 改ページの機能を有効にして、しきい値の制限を指定してください。

パラメーター

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

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

上詰め
$top integer

取得するグループメンバーの数 (1 から 999 まで、既定値は 100)。

戻り値

グループの一覧

この操作を実行すると、組織のすべてのグループの一覧が返されます。

パラメーター

名前 キー 必須 説明
行のフィルター
$filter string

リストが作成される行を制限する OData スタイル フィルター式を入力します。

ページ サイズ
$top integer

結果のページ サイズを設定します。

スキップ トークン
$skiptoken string

結果の次のページを参照し、応答の @odata.nextLink プロパティで返されるトークンです。

戻り値

グループイベントを作成する [非推奨]

このアクションは非推奨になりました。 代わりにグループイベントの作成 (V2) を使用してください。

この操作はグループ カレンダーに新しいイベントを作成するために使用されます。

パラメーター

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

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

情報カテゴリ
subject True string

イベントのタイトル。

開始時間
dateTime True date-time

イベントの開始時刻 (例: '2016-11-01T14:30:00')。

終了時間
dateTime True date-time

イベントの終了時刻 (例: '2016-11-01T15:30:00')。

本文​​
content string

イベントに関連付けられているメッセージの本体。

本文のコンテンツ タイプ
contentType string

コンテンツ タイプを選択します: テキストまたは HTML。

場所
displayName string

イベントの場所。

重要度
importance string

イベントの重要度: 低、標準、高。

終日
isAllDay boolean

イベントが終日である場合は true に設定します。

アラーム設定済みである
isReminderOn boolean

イベントにアラームがある場合は true に設定します。

リマインダーの開始期間
reminderMinutesBeforeStart integer

イベントのアラームが開始されるまでの時間 (分)。

表示方法
showAs string

イベント中に表示する状態。

要求された応答
responseRequested boolean

イベントの承諾時または拒否時に送信者の応答を希望する場合は true に設定します。

戻り値

メンバーをグループから削除する

この操作は UPN を使用してメンバーを O365 グループから削除するために使用されます。

パラメーター

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

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

ユーザー プリンシパル名
userUpn True string

ユーザーのユーザー プリンシパル名 (UPN)

メンバーをグループに追加する

この操作は UPNを使用してメンバーを O365 グループに追加するために使用されます。

パラメーター

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

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

ユーザー プリンシパル名
userUpn True string

ユーザーのユーザー プリンシパル名。

自分が所有および属しているグループを一覧表示する

この操作は、自分が所有および属しているすべてのグループの一覧を返します。

戻り値

自分が所有しているグループを一覧表示する

この操作は、自分が所有しているグループの一覧を返します。

戻り値

自分が所有しているグループを一覧表示する (V2)

この操作は、自分が所有しているグループの一覧を返します。

戻り値

トリガー

グループ メンバーが追加または削除されるとき

この操作は、メンバーを指定したグループから追加または削除したときにトリガーされます。

新しいイベントがある場合

この操作は新しいイベントがグループ カレンダーに追加された場合にトリガーします。

グループ メンバーが追加または削除されるとき

この操作は、メンバーを指定したグループから追加または削除したときにトリガーされます。

パラメーター

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

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

戻り値

名前 パス 説明
ユーザー ID
id string

ユーザーを表す一意の ID。

理由
@removed.reason string

ユーザーがグループから削除された理由。

新しいイベントがある場合

この操作は新しいイベントがグループ カレンダーに追加された場合にトリガーします。

パラメーター

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

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

戻り値

名前 パス 説明
ID
id string

イベントの一意の ID。

リマインダーの開始期間
reminderMinutesBeforeStart integer

イベントの開始前にアラームが起動する時間 (分)。

アラーム設定済みである
isReminderOn boolean

イベントにアラームがある場合は true に設定します。

情報カテゴリ
subject string

イベントのタイトル。

重要度
importance string

イベントの重要度: 低、標準、高。

終日
isAllDay boolean

イベントが終日である場合は true に設定します。

要求された応答
responseRequested boolean

イベントの承諾時または拒否時に送信者の応答を希望する場合は true に設定します。

表示方法
showAs string

イベント中に表示する状態。

コンテンツ タイプ
body.contentType string

イベントに関連付けられているメッセージの本体。

内容
body.content string

コンテンツ タイプを選択します: テキストまたは HTML。

日時
start.dateTime date-time

イベントの開始時刻 (例: '2016-11-01T14:30:00-07:00')。

タイム ゾーン
start.timeZone string

タイム ゾーン インデックス値として指定されたイベントのタイム ゾーン (例: '太平洋標準時')。

日時
end.dateTime date-time

イベントの終了時刻 (例: '2016-11-01T15:30:00-07:00')。

タイム ゾーン
end.timeZone string

タイム ゾーン インデックス値として指定されたイベントのタイム ゾーン (例: '太平洋標準時')。

件名
location.displayName string

イベントの場所の表示名。

定義

ListGroupMembers_Response

名前 パス 説明
OData NextLink
@odata.nextLink string

ページ付けするための $skipToken を生成するために、Power Apps キャンバスでのみ使用されます。 Power Automate と Logic Apps はページネーション設定を使用する必要があります。

価値
value array of object

価値

ユーザー Id
value.id string

ユーザーを表す一意の ID。

Display Name
value.displayName string

ユーザーの表示名。

名前
value.givenName string

ユーザーの名。

役職
value.jobTitle string

ユーザーの役職。

メール
value.mail string

ユーザーのメール アドレス。

携帯電話
value.mobilePhone string

ユーザーの携帯電話番号。

オフィスの場所
value.officeLocation string

ユーザーのオフィスの住所。

value.surname string

ユーザーの姓。

ユーザー プリンシパル名
value.userPrincipalName string

ユーザーの UPN ID。

ListOwnedGroups_Response

名前 パス 説明
value array of object

分類
value.classification string

O365 グループ分類。

作成日時
value.createdDateTime date-time

yyyy-MM-ddTHH:mm:ss.fffZ (ISO8601 形式、UTC タイムゾーン)

削除済み日時
value.deletedDateTime string

yyyy-MM-ddTHH:mm:ss.fffZ (ISO8601 形式、UTC タイムゾーン)

内容
value.description string

グループに関する詳細情報。

件名
value.displayName string

O365 グループ名。

グループ ID
value.id string

グループを表す一意の識別子です。

電子メール
value.mail string

グループのメール アドレス。

メールの有効化
value.mailEnabled boolean

メールがグループに対して有効の場合は True。

ニックネーム
value.mailNickname string

グループ ニックネーム。

オンプレミスの最終同期日時
value.onPremisesLastSyncDateTime string

yyyy-MM-ddTHH:mm:ss.fffZ (ISO8601 形式、UTC タイムゾーン)

オンプレミスのセキュリティ識別子
value.onPremisesSecurityIdentifier string

オンプレミスのセキュリティ識別子。

オンプレミスの同期が有効
value.onPremisesSyncEnabled string

オンプレミスの同期がグループに対して有効の場合は True。

更新済み日時
value.renewedDateTime date-time

yyyy-MM-ddTHH:mm:ss.fffZ (ISO8601 形式、UTC タイムゾーン)

セキュリティの有効化
value.securityEnabled boolean

所有者がセキュリティ有効化している場合は True。

可視性
value.visibility string

所有者の表示方法。

ListOwnedGroups_V2_Response

名前 パス 説明
value array of object

分類
value.classification string

O365 グループ分類。

作成日時
value.createdDateTime date-time

yyyy-MM-ddTHH:mm:ss.fffZ (ISO8601 形式、UTC タイムゾーン)

内容
value.description string

グループに関する詳細情報。

件名
value.displayName string

O365 グループ名。

グループ ID
value.id string

グループを表す一意の識別子です。

電子メール
value.mail string

グループのメール アドレス。

メールの有効化
value.mailEnabled boolean

メールがグループに対して有効の場合は True。

ニックネーム
value.mailNickname string

グループ ニックネーム。

オンプレミスの最終同期日時
value.onPremisesLastSyncDateTime string

yyyy-MM-ddTHH:mm:ss.fffZ (ISO8601 形式、UTC タイムゾーン)

オンプレミスのセキュリティ識別子
value.onPremisesSecurityIdentifier string

オンプレミスのセキュリティ識別子。

オンプレミスの同期が有効
value.onPremisesSyncEnabled string

オンプレミスの同期がグループに対して有効の場合は True。

更新済み日時
value.renewedDateTime date-time

yyyy-MM-ddTHH:mm:ss.fffZ (ISO8601 形式、UTC タイムゾーン)

セキュリティの有効化
value.securityEnabled boolean

所有者がセキュリティ有効化している場合は True。

可視性
value.visibility string

所有者の表示方法。

ListGroups_Response

名前 パス 説明
OData NextLink
@odata.nextLink string

ページ付けするための $skipToken を生成するために、Power Apps キャンバスでのみ使用されます。 Power Automate と Logic Apps はページネーション設定を使用する必要があります。

value array of object

分類
value.classification string

O365 グループ分類。

作成日時
value.createdDateTime date-time

yyyy-MM-ddTHH:mm:ss.fffZ (ISO8601 形式、UTC タイムゾーン)

内容
value.description string

グループに関する詳細情報。

件名
value.displayName string

O365 グループ名。

グループ ID
value.id string

グループを表す一意の識別子です。

電子メール
value.mail string

グループのメール アドレス。

メールの有効化
value.mailEnabled boolean

メールがグループに対して有効の場合は True。

ニックネーム
value.mailNickname string

グループ ニックネーム。

オンプレミスの最終同期日時
value.onPremisesLastSyncDateTime string

yyyy-MM-ddTHH:mm:ss.fffZ (ISO8601 形式、UTC タイムゾーン)

オンプレミスのセキュリティ識別子
value.onPremisesSecurityIdentifier string

オンプレミスのセキュリティ識別子。

オンプレミスの同期が有効
value.onPremisesSyncEnabled boolean

オンプレミスの同期がグループに対して有効の場合は True。

更新済み日時
value.renewedDateTime date-time

yyyy-MM-ddTHH:mm:ss.fffZ (ISO8601 形式、UTC タイムゾーン)

セキュリティの有効化
value.securityEnabled boolean

所有者がセキュリティ有効化している場合は True。

可視性
value.visibility string

所有者の表示方法。

CreateCalendarEvent_Response

名前 パス 説明
ID
id string

イベントの一意の ID。

リマインダーの開始期間
reminderMinutesBeforeStart integer

イベントのアラームが開始されるまでの時間 (分)。

アラーム設定済みである
isReminderOn boolean

イベントにアラームがある場合は true に設定します。

情報カテゴリ
subject string

イベントのタイトル。

重要度
importance string

イベントの重要度: 低、標準、高。

終日
isAllDay boolean

イベントが終日イベントである場合は True。

要求された応答
responseRequested boolean

イベントに対して応答が要求された場合は True。

表示方法
showAs string

イベント中に表示する状態。

コンテンツ タイプ
body.contentType string

テキストまたは HTML。

内容
body.content string

このイベントの本文のコンテンツ。

日時
start.dateTime date-time

イベントの開始時刻 (例: '2016-11-01T14:30:00-07:00')。

タイム ゾーン
start.timeZone string

タイム ゾーン インデックス値として指定されたイベントのタイム ゾーン (例: '太平洋標準時')。

日時
end.dateTime date-time

イベントの終了時刻 (例: '2016-11-01T15:30:00-07:00')。

タイム ゾーン
end.timeZone string

タイム ゾーン インデックス値として指定されたイベントのタイム ゾーン (例: '太平洋標準時')。

名称
location.displayName string

イベントの場所の表示名。

ObjectWithoutType