group リソースの種類

[アーティクル]
03/15/2023

名前空間: microsoft.graph

Microsoft Entra グループ、Microsoft 365 グループ、またはセキュリティグループを表します。このリソースは、他のプロパティを渡すことができるオープン型です。

directoryObject から継承します。

パフォーマンス上の理由から、作成、取得、一覧表示の操作は、既定ではより一般的に使用されるプロパティのみを返します。これらの既定のプロパティは、「プロパティ」セクションに記載されています。既定で返されないプロパティを取得するには、OData クエリオプションでプロパティを $select 指定します。

このリソースは以下をサポートしています。

拡張機能としてカスタムプロパティにデータを追加する。
変更通知を受信します。
デルタ関数を提供することにより、デルタクエリを使用して、増分の追加、削除、更新を追跡します。

メソッド

メソッド	戻り値の型	説明
グループの管理
グループを作成する	group	新しいグループを作成します。 Microsoft 365 グループ、動的なグループ、またはセキュリティグループのいずれかにできます。
グループを取得する	group	グループオブジェクトのプロパティを読み取ります。
グループを一覧表示する	group コレクション	グループオブジェクトとそのプロパティを一覧表示します。
グループを更新する	なし	グループオブジェクトのプロパティを更新します。
グループを削除する	なし	グループオブジェクトを削除します。
delta	group コレクション	グループに対する増分の変更を取得します。
メンバーの追加	なし	メンバーナビゲーションプロパティ (セキュリティグループと Microsoft 365 グループでのみサポート) に投稿して、このグループにメンバーを追加します。
所有者の追加	なし	owners ナビゲーションプロパティ (セキュリティグループおよび Microsoft 365 グループのみをサポート) に投稿することによってグループの新規所有者を追加します。
List groupLifecyclePolicies	groupLifecyclePolicy コレクション	グループのライフサイクルポリシーを一覧表示します。
メンバーを一覧表示する	directoryObject コレクション	メンバーのナビゲーションプロパティから、このグループの直接のメンバーであるユーザーを取得します。
所有者を一覧表示する	directoryObject コレクション	owners ナビゲーションプロパティからグループの所有者を取得します。
推移的なメンバーを一覧表示する	directoryObject コレクション	このグループの入れ子のメンバーを含む、メンバーになっているユーザー、グループ、デバイスを取得します。
推移的な memberOf を一覧表示する	directoryObject コレクション	このグループがメンバーとして含まれているグループの一覧。この操作は推移的で、このグループが入れ子のメンバーになっているグループが含まれます。
メンバーを削除する	なし	メンバーのナビゲーションプロパティを使用して、Microsoft 365 グループまたはセキュリティグループからメンバーを削除します。
所有者を削除する	なし	所有者のナビゲーションプロパティを使用して、Microsoft 365 グループまたはセキュリティグループから所有者を削除します。
assignLicense	group	グループのサブスクリプションを追加または削除します。サブスクリプションに関連付けられている特定のプランを有効または無効にすることもできます。
renew	ブール値	グループの有効期限を更新します。グループが更新されると、グループの有効期限はポリシーで定義された日数、延長されます。
validateProperties	JSON	Microsoft 365 グループの表示名またはメールのニックネームが名前付けポリシーに準拠していることを検証します。
アプリの役割の割り当て
appRoleAssignments を一覧表示する	appRoleAssignment コレクション	このグループに割り当てられているアプリとアプリの役割を取得します。
appRoleAssignment を追加する	appRoleAssignment	このグループにアプリの役割を割り当てます。
appRoleAssignment を削除する	なし。	このグループからアプリの役割の割り当てを削除します。
Calendar
イベントを作成する	event	event コレクションへの投稿によって、新しいイベントを作成します。
イベントを取得する	event	event オブジェクトのプロパティを読み取ります。
イベントを一覧表示する	event コレクション	event オブジェクトのコレクションを取得します。
イベントを更新する	なし	event オブジェクトのプロパティを更新します。
イベントを削除する	なし	event オブジェクトを削除します。
calendarView を一覧表示する	event コレクション	指定された時間枠のイベントのコレクションを取得します。
会話
会話を作成する	conversation	conversation コレクションに投稿して、新しい会話を作成します。
会話を取得する	conversation	conversation オブジェクトのプロパティを読み取ります。
会話を一覧表示する	conversation コレクション	conversation オブジェクトのコレクションを取得します。
会話を削除する	なし	conversation オブジェクトを削除します。
Create thread	conversationThread	新しい会話スレッドを作成します。
スレッドを取得する	conversationThread	thread オブジェクトのプロパティを読み取ります。
スレッドを一覧表示する	conversationThread コレクション	グループのすべてのスレッドを取得します。
スレッドを更新する	なし	thread オブジェクトのプロパティを更新します。
スレッドを削除する	なし	thread オブジェクトを削除します。
acceptedSenders を一覧表示する	directoryObject collection	このグループの許可された送信者リストに含まれるユーザーまたはグループの一覧を取得します。
acceptedSender を追加する	directoryObject	acceptSenders コレクションにユーザーまたはグループを追加します。
acceptedSender を削除する	directoryObject	acceptedSenders コレクションからユーザーまたはグループを削除します。
rejectedSenders を一覧表示する	directoryObject collection	このグループの拒否された送信者リストに含まれるユーザーまたはグループの一覧を取得します。
rejectedSender を追加する	directoryObject	rejectedSender コレクションに新しいユーザーまたはグループを追加します。
rejectedSender を削除する	directoryObject	rejectedSender コレクションから新しいユーザーまたはグループを削除します。
設定を作成する	groupSetting	groupSettingTemplate に基づいて設定オブジェクトを作成します。 POST 要求では、テンプレートで定義されているすべての設定に対して settingValues を指定する必要があります。この操作には、グループ固有のテンプレートのみを使用できます。
ディレクトリオブジェクト
削除されたグループを一覧表示する	directoryObject collection	過去 30 日間にテナントで削除されたグループを取得します。
ユーザーによって所有されている削除済みグループを一覧表示する	directoryObject collection	過去 30 日間にテナントで削除され、ユーザーによって所有されているグループを取得します。
削除されたグループを取得する	directoryObject collection	ID で削除されたグループを取得します。
削除されたグループを復元する	directoryObject collection	過去 30 日間にテナントで削除されたグループを復元します。
グループを完全に削除する	directoryObject collection	テナントから削除されたグループを完全に削除します。
checkMemberGroups	String collection	グループの一覧内のメンバーシップを確認します。この関数は推移的です。
getMemberGroups	String collection	このグループがメンバーであるすべてのグループを返します。この関数は推移的です。
checkMemberObjects	String collection	グループ、ディレクトリロール、または管理ユニットオブジェクト一覧内のメンバーシップを確認します。この関数は推移的です。
getMemberObjects	String collection	グループがメンバーであるすべてのグループと管理単位を返します。この関数は推移的です。
グループ設定
設定を取得する	groupSetting	特定の設定オブジェクトのプロパティを参照します。
設定を一覧表示する	groupSetting コレクション	すべての設定オブジェクトのプロパティを一覧表示します。
設定を更新する	なし	設定オブジェクトを更新します。
設定を削除する	なし	設定オブジェクトを削除します。
設定テンプレートを取得する	なし	設定テンプレートのプロパティを読み取ります。
設定テンプレートを一覧表示する	なし	すべての設定テンプレートを一覧表示します。
オープン拡張機能
オープン拡張機能を作成する	openTypeExtension	オープン拡張機能を作成し、新規または既存のリソースにカスタムプロパティを追加します。
オープン拡張機能を取得する	openTypeExtension コレクション	拡張機能の名前で識別されるオープン拡張機能を取得します。
スキーマ拡張機能
スキーマ拡張機能の値を追加する	なし	スキーマ拡張機能の定義を作成し、それを使用してカスタムの型指定されたデータをリソースに追加します。
その他のグループリソース
写真を一覧表示する	profilePhoto コレクション	グループのプロファイル写真のコレクションを取得します。
plannerPlans を一覧表示する	plannerPlan コレクション	グループが所有しているプランナーの計画を取得します。
permissionGrants を一覧表示する	resourceSpecificPermissionGrant コレクション	アクセスがグループにアクセスするために付与されたアクセス許可を表示します。
ユーザーの設定
addFavorite	なし	サインインしているユーザーのお気に入りのグループ一覧にグループを追加します。 Microsoft 365 グループでのみサポートされます。
removeFavorite	なし	サインインしているユーザーのお気に入りのグループ一覧からグループを削除します。 Microsoft 365 グループでのみサポートされます。
memberOf を一覧表示する	directoryObject コレクション	このユーザーが直接のメンバーであるグループおよび管理単位を、memberOf ナビゲーションプロパティから取得します。
参加チームのリストを作成する	group コレクション	ユーザーがダイレクトメンバーになっている Microsoft Teams を取得します。
関連付けられているチームを一覧表示する	associatedTeamInfo コレクション	ユーザーが関連付けられている Microsoft Teams の associatedTeamInfo オブジェクトの一覧を取得します。
subscribeByMail	なし	isSubscribedByMail プロパティを `true` に設定します。サインインしているユーザーが電子メールの会話を受信できるようにします。 Microsoft 365 グループでのみサポートされます。
unsubscribeByMail	なし	isSubscribedByMail プロパティを `false` に設定します。サインインしているユーザーが電子メールの会話を受信できないようにします。 Microsoft 365 グループでのみサポートされます。
resetUnseenCount	なし	サインインしているユーザーが最後の訪問以降見ていない、すべての投稿の unseenCount を 0 にリセットします。 Microsoft 365 グループでのみサポートされます。

プロパティ

重要

$filter および $search クエリパラメーターの具体的な使用方法は、ConsistencyLevel ヘッダーの設定を eventual と $count に使用する場合にのみサポートされます。詳細については、「ディレクトリオブジェクトの高度なクエリ機能」を参照してください。

プロパティ	種類	説明
allowExternalSenders	Boolean	組織外部のユーザーがグループにメッセージを送信できるかどうかを示します。既定値は `false` です。 `$select` でのみ返されます。グループ API を取得 (`GET /groups/{ID}`) でのみサポートされます。
assignedLabels	assignedLabel コレクション	Microsoft 365 グループに関連付けられている秘密度ラベルペア (ラベル ID、ラベル名) のリスト。 `$select` でのみ返されます。
assignedLicenses	assignedLicense コレクション	グループに割り当てられているライセンス。 `$select` でのみ返されます。 `$filter` (`eq`) をサポートします。読み取り専用。
autoSubscribeNewMembers	Boolean	グループに追加された新しいメンバーが、電子メールの通知を受信するように自動的にサブスクライブされるかどうかを示します。グループの PATCH 要求でこのプロパティを設定できます。グループを作成する最初の POST 要求では設定しないでください。既定値は、`false` です。 `$select` でのみ返されます。グループ API を取得 (`GET /groups/{ID}`) でのみサポートされます。
classification	String	グループの分類 (低、中、高のビジネスへの影響など) について説明します。このプロパティの有効な値は、テンプレート定義に基づいて ClassificationList 設定値を作成することによって定義されます。既定で返されます。 `$filter` (`eq`、`ne`、`not`、`ge`、`le`、`startsWith`) をサポートしています。
createdDateTime	DateTimeOffset	グループ作成時のタイムスタンプです。値は変更できず、グループが作成されると自動的に設定されます。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、`2014-01-01T00:00:00Z` です。既定で返されます。読み取り専用です。
deletedDateTime	DateTimeOffset	一部のMicrosoft Entra オブジェクト (ユーザー、グループ、アプリケーション) では、オブジェクトが削除された場合、最初に論理的に削除され、オブジェクトが削除された日時でこのプロパティが更新されます。それ以外の場合、このプロパティは `null` です。オブジェクトを復元すると、このプロパティは `null` に更新されます。
説明	String	グループに関するオプションの説明。既定で返されます。 `$filter` (`eq`、`ne`、`not`、`ge`、`le`、`startsWith`) および `$search` をサポートしています。
displayName	文字列	グループの表示名。このプロパティは、グループの作成時の必須プロパティであり、更新時にクリアすることはできません。最大文字数は 256 文字です。既定で返されます。 `$filter` (`eq`、`ne`、`not`、`ge`、`le`、`in`、`startsWith`、および `eq` の `null`値)、`$search`、および `$orderby` をサポートします。
expirationDateTime	DateTimeOffset	グループに設定されている有効期限のタイムスタンプです。これは `null` セキュリティグループ用ですが、Microsoft 365 グループの場合は、 groupLifecyclePolicy で定義されているようにグループの有効期限が切れるタイミングを表します。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC で表されます。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、`2014-01-01T00:00:00Z` です。既定で返されます。 `$filter` (`eq`、`ne`、`not`、`ge`、`le`、`in`) をサポートしています。読み取り専用です。
groupTypes	String collection	グループの種類とそのメンバーシップを指定します。コレクションにが含まれている `Unified`場合、グループは Microsoft 365 グループです。それ以外の場合は、セキュリティグループまたは配布グループのいずれかです。詳しくは、「グループの概要」をご覧ください。 `DynamicMembership`が含まれている場合、グループは動的メンバーシップがあります。それ以外の場合、メンバーシップは静的です。既定で返されます。 `$filter` (`eq`、`not`) をサポートしています。
hasMembersWithLicenseErrors	Boolean	このグループの中に、そのグループに基づくライセンス割り当てのライセンスエラーが発生しているメンバーがいるかどうかを示します。このプロパティは GET 操作では返されません。これを $ filter 引数として使用して、ライセンスエラーが発生しているメンバーがいるグループを取得できます (つまり、このプロパティが true であるフィルターです)。例を参照してください。 `$filter` (`eq`)をサポートしています。
hideFromAddressLists	Boolean	アドレス帳、メッセージ受信者を選択するためのアドレス一覧、およびグループを検索するための [グループの参照] ダイアログで Outlook UI の特定の部分にグループが表示されない場合は true でそうでない場合は false です。既定値は、`false` です。 `$select` でのみ返されます。グループ API を取得 (`GET /groups/{ID}`) でのみサポートされます。
hideFromOutlookClients	Boolean	Outlook for Windows や Outlook on the web などの Outlook クライアントにグループが表示されない場合は true で、そうでない場合は false です。既定値は `false` です。 `$select` でのみ返されます。グループ API を取得 (`GET /groups/{ID}`) でのみサポートされます。
id	String	グループの一意の識別子。既定で返されます。 directoryObject から継承されます。キー。 null 許容ではありません。読み取り専用です。 `$filter` (`eq`、`ne`、`not`、`in`) をサポートします。
isArchived	Boolean	グループがチームに関連付けられている場合、このプロパティは、チームが読み取り専用モードであるかどうかを判断します。このプロパティを読み取るには、`/group/{groupId}/team` エンドポイントまたは Get team API を使用します。このプロパティを更新するには、archiveTeam API と unarchiveTeam API を使用します。
isAssignableToRole	ブール値	このグループをMicrosoft Entraロールに割り当てることができるかどうかを示します。オプション。このプロパティは、グループの作成時にのみ設定でき、変更できません。に `true`設定する場合、 securityEnabled プロパティもに設定する `true`必要があります。可視性は `Hidden`である必要があります。また、グループを動的グループにすることはできません (つまり、 groupTypes にを含 `DynamicMembership`めることはできません)。このプロパティを設定できるのは、グローバル管理者ロールと特権ロール管理者ロールの呼び出し元のみです。このプロパティを設定したり、そのようなグループのメンバーシップを更新したりするには、呼び出し元に RoleManagement.ReadWrite.Directory 権限も割り当てる必要があります。詳細については、「グループを使用してMicrosoft Entraロールの割り当てを管理する」を参照してください。この機能を使用するには、Microsoft Entra ID P1 ライセンスが必要です。既定で返されます。 `$filter` (`eq`、`ne`、`not`) をサポートします。
isSubscribedByMail	Boolean	サインインしているユーザーが電子メールの会話を受信するように登録されているかどうかを示します。既定値は `true` です。 `$select` でのみ返されます。グループ API を取得 (`GET /groups/{ID}`) でのみサポートされます。
licenseProcessingState	String	すべてのグループメンバーに対するグループライセンスの割り当ての状態を示します。既定値は `false` です。読み取り専用です。使用可能な値: `QueuedForProcessing`、`ProcessingInProgress`、`ProcessingComplete`。 `$select` でのみ返されます。読み取り専用です。
mail	String	グループの SMTP アドレス ("" などserviceadmins@contoso.onmicrosoft.com)。既定で返されます。読み取り専用です。 `$filter` (`eq`、`ne`、`not`、`ge`、`le`、`in`、`startsWith` と `eq` の `null`値) をサポートします。
mailEnabled	ブール値	メールが有効なグループであるかどうかを指定します。必須です。既定で返されます。 `$filter` (`eq`、`ne`、`not`) をサポートします。
mailNickname	String	組織内の Microsoft 365 グループに対して一意の、グループのメールエイリアス。最大文字数は 64 文字です。このプロパティには、 ASCII 文字セット 0 ~ 127 の文字のみを含めることができます。ただし、以下の `@ () \ [] " ; : <> , SPACE`を除いたものです。必須です。既定で返されます。 `$filter` (`eq`、 `ne`、 `not`、 `ge`、 `le`、 `in`、 `startsWith` と `eq` の `null`値) をサポートします。
membershipRule	String	グループが動的なグループの場合 (groupTypes に `DynamicMembership` が含まれる) に、このグループのメンバーを決定する規則です。メンバーシップの規則の構文の詳細については、「メンバーシップの規則の構文」を参照してください。既定で返されます。 `$filter` (`eq`、`ne`、`not`、`ge`、`le`、`startsWith`) をサポートしています。
membershipRuleProcessingState	String	動的メンバーシップの処理が進行中か、または一時停止しているかどうかを示します。使用可能な値は `On` または `Paused` です。既定で返されます。 `$filter` (`eq`、`ne`、`not`、`in`) をサポートします。
onPremisesLastSyncDateTime	DateTimeOffset	グループがオンプレミスのディレクトリと最後に同期した日時を示します。Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、必ず UTC 時間です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、`2014-01-01T00:00:00Z` です。既定で返されます。読み取り専用です。 `$filter` (`eq`、`ne`、`not`、`ge`、`le`、`in`) をサポートします。
onPremisesProvisioningErrors	onPremisesProvisioningError コレクション	Microsoft 同期製品のプロビジョニング中に発生するエラーです。既定で返されます。 `$filter` (`eq`、`not`) をサポートしています。
onPremisesSamAccountName	文字列	オンプレミスディレクトリから同期されたオンプレミスの SAM アカウント名が含まれています。このプロパティは、オンプレミスディレクトリを Microsoft Entra Connect 経由で Microsoft Entra ID に同期しているお客様にのみ設定されます。既定で返されます。 `$filter` (`eq`、`ne`、`not`、`ge`、`le`、`in`、`startsWith`) をサポートします。読み取り専用です。
onPremisesSecurityIdentifier	String	オンプレミスからクラウドに同期されるグループのオンプレミスセキュリティ識別子 (SID) が含まれます。既定で返されます。 `$filter` をサポートします (`null` 値を含む `eq`)。読み取り専用です。
onPremisesSyncEnabled	Boolean	このグループがオンプレミスのディレクトリから同期される場合は `true`、このグループが最初にオンプレミスのディレクトリから同期されていて、今後は同期しない場合は `false`、このオブジェクトがオンプレミスのディレクトリから一度も同期されたことがない場合は null。既定で返されます。読み取り専用です。 `$filter` (`eq`、`ne`、`not`、`in`、および `eq` の `null` 値) をサポートします。
preferredDataLocation	String	Microsoft 365 グループのデータの優先される場所。既定では、グループはグループ作成者が優先するデータの場所を継承します。このプロパティを設定するには、呼び出し元のアプリに Directory.ReadWrite.All アクセス許可を付与し、ユーザーに次のMicrosoft Entraロールのいずれかを割り当てる必要があります。グローバル管理者ユーザーアカウント管理者ディレクトリライター Exchange 管理者 SharePoint 管理者このプロパティの詳細については、「OneDrive Online Multi-Geo」を参照してください。 Null 許容型。既定で返されます。
preferredLanguage	文字列	Microsoft 365 グループで優先する言語。 ISO 639-1 コードに従う必要があります (例: `en-US`)。既定で返されます。 `$filter` (`eq`、`ne`、`not`、`ge`、`le`、`in`、`startsWith` と `eq` の `null`値) をサポートします。
proxyAddresses	String コレクション	同じグループメールボックスに送信されるグループのメールアドレスです。例: `["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"]`。複数値プロパティのフィルター式には any 演算子が必要です。既定で返されます。読み取り専用です。 null 許容ではありません。 `$filter` (`eq`、`not`、`ge`、`le`、`startsWith`、`endsWith`、`/$count eq 0`、`/$count ne 0`) をサポートします。
renewedDateTime	DateTimeOffset	グループの最後の更新時のタイムスタンプです。これは直接変更することはできず、更新サービスアクション経由でのみ更新されます。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC で表されます。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、`2014-01-01T00:00:00Z` です。既定で返されます。 `$filter` (`eq`、`ne`、`not`、`ge`、`le`、`in`) をサポートしています。読み取り専用。
resourceBehaviorOptions	String コレクション	作成中に Microsoft 365 グループに設定できるグループ動作を指定します。これは、作成 (POST) の一部としてのみ設定できます。使用可能な値は、`AllowOnlyMembersToPost`、`HideGroupInOutlook`、`SubscribeNewGroupMembers`、`WelcomeEmailDisabled` です。詳細については、「Microsoft 365 グループの動作とプロビジョニングオプションを設定する」を参照してください。
resourceProvisioningOptions	String コレクション	Microsoft 365 グループ作成の一部としてプロビジョニングされるグループリソースを指定します。これは、通常、既定のグループ作成の一部ではありません。指定できる値はです `Team`。詳細については、「Microsoft 365 グループの動作とプロビジョニングオプションを設定する」を参照してください。
securityEnabled	ブール値	グループがセキュリティグループであるかどうかを指定します。必須です。既定で返されます。 `$filter` (`eq`、`ne`、`not`、`in`) をサポートします。
securityIdentifier	文字列	Windows シナリオで使用されるグループのセキュリティ識別子。既定で返されます。
theme	文字列	Microsoft 365 グループの色のテーマを指定します。可能な値: `Teal`、`Purple`、`Green`、`Blue`、`Pink`、`Orange`、`Red`。既定で返されます。
unseenCount	Int32	サインにしているユーザーのグループへの最後のアクセス以降に新しい投稿を受け取った会話の数です。 `$select` でのみ返されます。グループ API を取得 (`GET /groups/{ID}`) でのみサポートされます。
visibility	String	グループのグループ参加ポリシーとグループコンテンツの可視性を指定します。使用可能な値は、`Private`、`Public`、`HiddenMembership` です。 `HiddenMembership` は、グループの作成時に Microsoft 365 グループにのみ設定できます。後で更新することはできません。可視性の他の値は、グループの作成後に更新できます。 Microsoft Graph でのグループの作成時に可視性の値が指定されていない場合、セキュリティグループは既定でとして `Private` 作成され、Microsoft 365 グループはになります `Public`。役割に割り当て可能なグループは常に `Private` です。詳細については、「グループの表示オプション」を参照してください。既定で返されます。 Null 許容型。

グループの表示オプション

値	説明
パブリック	所有者のアクセス許可の必要がなく、だれでもグループに参加することができます。だれでもグループの属性を表示できます。だれでもグループのメンバーを確認できます。
プライベート	グループに参加するには、所有者のアクセス許可が必要です。だれでもグループの属性を表示できます。だれでもグループのメンバーを確認できます。
Hiddenmembership	グループに参加するには、所有者のアクセス許可が必要です。ゲストユーザーは、グループの属性を表示できません。メンバー以外はグループのメンバーを確認することができません。管理者 (グローバル、会社、ユーザー、ヘルプデスク) が、グループのメンバーシップを参照できます。グループは、グローバルアドレス帳 (GAL) に表示されます。

リレーションシップ

リレーションシップ	型	説明
acceptedSenders	directoryObject コレクション	このグループに投稿または予定表イベントを作成できるユーザーまたはグループの一覧。このリストが空でない場合は、ここに一覧表示されているユーザーまたはグループのみが投稿できます。
appRoleAssignments	appRoleAssignment コレクション	グループがアプリに対して付与されているアプリの役割を表します。 `$expand` をサポートします。
予定表	calendar	グループの予定表。読み取り専用です。
calendarView	event コレクション	予定表のカレンダービュー。読み取り専用です。
conversations	conversation コレクション	グループの会話。
createdOnBehalfOf	directoryObject	グループを作成したユーザー (またはアプリケーション)。注: ユーザーが管理者である場合、これは設定されません。読み取り専用です。
drive	drive	グループの既定のドライブ。読み取り専用です。
drives	drive コレクション	グループのドライブ。読み取り専用です。
events	event コレクション	グループの予定表イベント。
extensions	extension コレクション	グループに対して定義されている開いている拡張機能のコレクション。読み取り専用です。 Null 許容型。
groupLifecyclePolicies	groupLifecyclePolicy コレクション	このグループのライフサイクルポリシーのコレクション。読み取り専用です。 Null 許容型。
memberOf	directoryObject コレクション	このグループがメンバーとして含まれているグループ。 HTTP メソッド: GET (すべてのグループでサポートされます)。読み取り専用です。 Null 許容型。 `$expand` をサポートします。
members	directoryObject コレクション	このグループのメンバー。ユーザー、デバイス、他のグループ、またはサービスプリンシパルになります。メンバーのリスト、メンバーの追加、およびメンバーの削除の操作をサポートします。 Null 許容型。入れ子になった `$select` を含む `$expand` をサポートします。たとえば、「 `/groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=members($select=id,userPrincipalName,displayName)` 」のように入力します。
membersWithLicenseErrors	User コレクション	このグループに基づくライセンスの割り当てからのライセンスエラーが発生しているグループメンバーの一覧です。読み取り専用です。
onenote	OneNote	読み取り専用です。
owners	directoryObject コレクション	グループの所有者。 100 人の所有者に制限されます。 Null 許容型。 Microsoft 365 グループの作成時にこのプロパティを指定しない場合は、呼び出し元ユーザーがグループ所有者として自動的に割り当てられます。 `$filter` (`/$count eq 0`、`/$count ne 0`、`/$count eq 1`、`/$count ne 1`) をサポートします。入れ子になった `$select` を含む `$expand` をサポートします。たとえば、「 `/groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=owners($select=id,userPrincipalName,displayName)` 」のように入力します。
photo	profilePhoto	グループのプロファイル写真
photos	profilePhoto コレクション	グループが所有するプロフィール写真。読み取り専用です。 Null 許容型。
planner	plannerGroup	統合グループに存在する可能性がある Planner リソースのエントリポイント。
rejectedSenders	directoryObject コレクション	このグループに投稿または予定表イベントを作成できないユーザーまたはグループの一覧。 Nullable
設定	groupSetting コレクション	メンバーがゲストユーザーをグループに招待できるかどうかなどのグループの動作を管理する設定。 Null 許容型。
sites	site コレクション	このグループ内の SharePoint サイトの一覧。 /sites/root を使用して既定のサイトにアクセスします。
team	channel コレクション	このグループに関連付けられているチーム。
threads	conversationThread コレクション	グループの会話スレッド。 Null 許容型。
transitiveMemberOf	directoryObject コレクション	直接または入れ子になったメンバーシップを使用して、グループがメンバーになっているグループ。 Null 許容型。
transitiveMembers	directoryObject コレクション	グループの直接および推移的なメンバー。 Null 許容型。

JSON 表記

リソースの JSON 表記を次に示します。

{
  "allowExternalSenders": false,
  "acceptedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "assignedLicenses": [{ "@odata.type": "microsoft.graph.assignedLicense" }],
  "autoSubscribeNewMembers": true,
  "calendar": { "@odata.type": "microsoft.graph.calendar" },
  "calendarView": [{ "@odata.type": "microsoft.graph.event" }],
  "classification": "String",
  "conversations": [{ "@odata.type": "microsoft.graph.conversation" }],
  "createdDateTime": "String (timestamp)",
  "createdOnBehalfOf": { "@odata.type": "microsoft.graph.directoryObject" },
  "description": "String",
  "displayName": "String",
  "drive": { "@odata.type": "microsoft.graph.drive" },
  "events": [{ "@odata.type": "microsoft.graph.event" }],
  "groupTypes": ["String"],
  "hasMembersWithLicenseErrors": "Boolean",
  "hideFromAddressLists": false,
  "hideFromOutlookClients": false,
  "id": "String (identifier)",
  "isAssignableRole": false,
  "isSubscribedByMail": true,
  "licenseProcessingState": "String",
  "mail": "String",
  "mailEnabled": true,
  "mailNickname": "String",
  "memberOf": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "members": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "membersWithLicenseErrors": [{ "@odata.type": "microsoft.graph.user" }],
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesProvisioningErrors": [
    { "@odata.type": "microsoft.graph.onPremisesProvisioningError" }
  ],
  "onPremisesSecurityIdentifier": "String",
  "onPremisesSyncEnabled": true,
  "owners": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "preferredDataLocation": "String",
  "proxyAddresses": ["String"],
  "photo": { "@odata.type": "microsoft.graph.profilePhoto" },
  "photos": [{ "@odata.type": "microsoft.graph.profilePhoto" }],
  "rejectedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
  "renewedDateTime": "String (timestamp)",
  "resourceBehaviorOptions": ["String"],
  "resourceProvisioningOptions": ["String"],
  "securityEnabled": true,
  "securityIdentifier": "String",
  "sites": [{ "@odata.type": "microsoft.graph.site" }],
  "threads": [{ "@odata.type": "microsoft.graph.conversationThread" }],
  "unseenCount": 1024,
  "visibility": "String"
}