group リソースの種類

  • [アーティクル]

名前空間: microsoft.graph

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

directoryObject から継承します。

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

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

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

メソッド

メソッド 戻り値の型 説明
グループの管理
グループを作成する group 新しいグループを作成します。 Microsoft 365 グループ、動的なグループ、またはセキュリティ グループのいずれかにできます。
グループを取得する group グループ オブジェクトのプロパティを読み取ります。
グループを一覧表示する group コレクション グループ オブジェクトとそのプロパティを一覧表示します。
グループを更新する なし グループ オブジェクトのプロパティを更新します。
Upsert グループ 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 グループの表示名またはメールのニックネームが名前付けポリシーに準拠していることを検証します。
アプリの役割の割り当て
List 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 コレクション このグループの許可された送信者リストに含まれるユーザーまたはグループの一覧を取得します。
acceptedSender を追加する directoryObject acceptSenders コレクションにユーザーまたはグループを追加します。
acceptedSender を削除する directoryObject acceptedSenders コレクションからユーザーまたはグループを削除します。
rejectedSenders を一覧表示する directoryObject collection このグループの拒否された送信者リストに含まれるユーザーまたはグループの一覧を取得します。
rejectedSender を追加する directoryObject rejectedSender コレクションに新しいユーザーまたはグループを追加します。
rejectedSender を削除する directoryObject rejectedSender コレクションから新しいユーザーまたはグループを削除します。
設定を作成する groupSetting groupSettingTemplate に基づいて設定オブジェクトを作成します。 POST 要求では、テンプレートで定義されているすべての設定に対して settingValues を指定する必要があります。 この操作には、グループ固有のテンプレートのみを使用できます。
ディレクトリ オブジェクト
削除されたグループを一覧表示する directoryObject コレクション 過去 30 日間にテナントで削除されたグループを取得します。
ユーザーによって所有されている削除済みグループを一覧表示する directoryObject コレクション 過去 30 日間にテナントで削除され、ユーザーによって所有されているグループを取得します。
削除されたグループを取得する directoryObject コレクション ID で削除されたグループを取得します。
Restore deleted group directoryObject コレクション 過去 30 日間にテナントで削除されたグループを復元します。
Permanently delete group directoryObject コレクション テナントから削除されたグループを完全に削除します。
checkMemberGroups String collection グループの一覧内のメンバーシップを確認します。 この関数は推移的です。
getMemberGroups String collection このグループがメンバーであるすべてのグループを返します。 この関数は推移的です。
checkMemberObjects String collection グループ、ディレクトリ ロール、または管理ユニット オブジェクト一覧内のメンバーシップを確認します。 この関数は推移的です。
getMemberObjects String collection グループがメンバーであるすべてのグループと管理単位を返します。 この関数は推移的です。
グループ設定
設定を取得する groupSetting 特定の設定オブジェクトのプロパティを参照します。
設定を一覧表示する groupSetting コレクション すべての設定オブジェクトのプロパティを一覧表示します。
設定を更新する なし 設定オブジェクトを更新します。
設定を削除する なし 設定オブジェクトを削除します。
設定テンプレートを取得する なし 設定テンプレートのプロパティを読み取ります。
設定テンプレートを一覧表示する なし すべての設定テンプレートを一覧表示します。
オープン拡張機能
Create open extension openTypeExtension オープン拡張機能を作成し、新規または既存のリソースにカスタム プロパティを追加します。
Get open extension openTypeExtension コレクション 拡張機能の名前で識別されるオープン拡張機能を取得します。
スキーマ拡張機能
Add schema extension values なし スキーマ拡張機能の定義を作成し、それを使用してカスタムの型指定されたデータをリソースに追加します。
その他のグループ リソース
写真を一覧表示する 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.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) の一部としてのみ設定できます。 使用可能な値の一覧については、「 Microsoft 365 グループの動作とプロビジョニング オプション」を参照してください。
resourceProvisioningOptions String コレクション Microsoft 365 グループに関連付けられているグループ リソースを指定します。 指定できる値は です Team。 詳細については、「 Microsoft 365 グループの動作とプロビジョニング オプション」を参照してください。

既定で返されます。 $filter (eq, not, startsWith. をサポートしています。
securityEnabled ブール値 グループがセキュリティ グループであるかどうかを指定します。 必須です。

既定で返されます。 $filter (eq、ne、not、in) をサポートします。
securityIdentifier 文字列 Windows シナリオで使用されるグループのセキュリティ識別子。

既定で返されます。
serviceProvisioningErrors serviceProvisioningError コレクション グループ オブジェクトからのプロパティまたはリンクに関する一時的でないサービス固有のエラーを記述するフェデレーション サービスによって発行されたエラー。

$filter (isResolved および serviceInstance の eq、not) をサポートします。
theme 文字列 Microsoft 365 グループの色のテーマを指定します。 可能な値: Teal、Purple、Green、Blue、Pink、Orange、Red。

既定で返されます。
uniqueName String グループに割り当て、代替キーとして使用できる一意の識別子。 不変です。 読み取り専用です。
unseenConversationsCount Int32 サインインしたユーザーがグループに最後にアクセスしてから、1 つ以上の新しい投稿が配信された会話の数。 このプロパティは、unseenCount と同じです。

$select でのみ返されます。
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",
  "serviceProvisioningErrors": [
    { "@odata.type": "microsoft.graph.serviceProvisioningXmlError" }
  ],
  "sites": [{ "@odata.type": "microsoft.graph.site" }],
  "threads": [{ "@odata.type": "microsoft.graph.conversationThread" }],
  "uniqueName": "String",
  "unseenCount": 1024,
  "visibility": "String"
}

関連コンテンツ