group リソースの種類

  • [アーティクル]

名前空間: microsoft.graph

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

directoryObject から継承します。

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

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

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

メソッド

メソッド 戻り値の型 説明
List group コレクション グループ オブジェクトとそのプロパティを一覧表示します。
Create group 新しいグループを作成します。 Microsoft 365 グループ、動的なグループ、またはセキュリティ グループのいずれかにできます。
Get group グループ オブジェクトのプロパティを読み取ります。
Update なし グループ オブジェクトのプロパティを更新します。
Upsert group 新しいグループが存在しない場合は作成するか、既存のグループのプロパティを更新します。
Delete なし グループ オブジェクトを削除します。
Get delta group コレクション グループに対する増分の変更を取得します。
グループの管理
メンバーを一覧表示する directoryObject コレクション メンバーのナビゲーション プロパティから、このグループの直接のメンバーであるユーザーを取得します。
メンバーの追加 なし メンバー ナビゲーション プロパティ (セキュリティ グループと Microsoft 365 グループでのみサポート) に投稿して、このグループに メンバー を追加します。
メンバーを削除する なし メンバーのナビゲーション プロパティを使用して、Microsoft 365 グループまたはセキュリティ グループからメンバーを削除します。
所有者を一覧表示する directoryObject コレクション owners ナビゲーション プロパティからグループの所有者を取得します。
所有者の追加 なし owners ナビゲーション プロパティ (セキュリティ グループおよび Microsoft 365 グループのみをサポート) に投稿することによってグループの新規所有者を追加します。
所有者を削除する なし 所有者のナビゲーション プロパティを使用して、Microsoft 365 グループまたはセキュリティ グループから所有者を削除します。
グループのライフサイクル ポリシーを一覧表示する groupLifecyclePolicy コレクション グループのライフサイクル ポリシーを一覧表示します。
推移的なメンバーを一覧表示する directoryObject コレクション このグループの入れ子になったメンバーを含む、メンバーであるユーザー、グループ、デバイスを取得します。
推移的な所属を一覧表示する directoryObject コレクション このグループがメンバーとして含まれているグループの一覧。 この操作は推移的で、このグループが入れ子のメンバーになっているグループが含まれます。
ライセンスを割り当てる group グループのサブスクリプションを追加または削除します。 サブスクリプションに関連付けられている特定のプランを有効または無効にすることもできます。
Renew ブール型 グループの有効期限を更新します。 更新により、ポリシーで定義された日数だけグループの有効期限が延長されます。
プロパティの検証 JSON Microsoft 365 グループの表示名またはメールのニックネームが名前付けポリシーに準拠していることを検証します。
アプリの役割の割り当て
アプリの役割の割り当てを一覧表示する appRoleAssignment コレクション このグループに割り当てられているアプリとアプリロールを取得します。
アプリの役割の割り当てを追加する appRoleAssignment このグループにアプリの役割を割り当てます。
アプリの役割の割り当てを削除する なし。 このグループからアプリの役割の割り当てを削除します。
Calendar
予定表を取得する calendar グループの予定表を取得します。
予定表を更新する なし グループの予定表を更新します。
List events event コレクション event オブジェクトのコレクションを取得します。
Create event event event コレクションへの投稿によって、新しいイベントを作成します。
イベントを取得する event event オブジェクトのプロパティを読み取ります。
イベントを更新する なし event オブジェクトのプロパティを更新します。
イベントを削除する なし event オブジェクトを削除します。
予定表ビューを一覧表示する event コレクション 指定された時間枠のイベントのコレクションを取得します。
会話
会話を一覧表示する conversation コレクション conversation オブジェクトのコレクションを取得します。
会話を作成する conversation conversation コレクションに投稿して、新しい会話を作成します。
会話を取得する conversation conversation オブジェクトのプロパティを読み取ります。
会話を削除する なし conversation オブジェクトを削除します。
スレッドを一覧表示する conversationThread コレクション グループのすべてのスレッドを取得します。
スレッドを作成する conversationThread 新しい会話スレッドを作成します。
スレッドを取得する conversationThread thread オブジェクトのプロパティを読み取ります。
スレッドを更新する なし thread オブジェクトのプロパティを更新します。
スレッドを削除する なし thread オブジェクトを削除します。
承認済み送信者を一覧表示する directoryObject コレクション このグループの許可された送信者リストに含まれるユーザーまたはグループの一覧を取得します。
承認済み送信者を追加する directoryObject acceptSenders コレクションにユーザーまたはグループを追加します。
承認済み送信者を削除する directoryObject acceptedSenders コレクションからユーザーまたはグループを削除します。
拒否する送信者を一覧表示する directoryObject collection このグループの拒否された送信者リストに含まれるユーザーまたはグループの一覧を取得します。
拒否済み送信者を追加する directoryObject rejectedSender コレクションに新しいユーザーまたはグループを追加します。
拒否済み送信者を削除する directoryObject rejectedSender コレクションから新しいユーザーまたはグループを削除します。
ディレクトリ オブジェクト
削除されたグループを一覧表示する directoryObject コレクション 過去 30 日間にテナントで削除されたグループを取得します。
Get deleted group directoryObject コレクション ID で削除されたグループを取得します。
Restore deleted group directoryObject コレクション 過去 30 日間にテナントで削除されたグループを復元します。
Permanently delete group directoryObject コレクション テナントから削除されたグループを完全に削除します。
ユーザーによって所有されている削除済みグループを一覧表示する directoryObject コレクション 過去 30 日間にテナントで削除されたユーザーのグループを取得します。
メンバー グループをチェックする String collection グループの一覧内のメンバーシップを確認します。 この関数は推移的です。
メンバー グループを取得する String collection このグループがメンバーであるすべてのグループを返します。 この関数は推移的です。
メンバー オブジェクトを確認する String collection グループ、ディレクトリ ロール、または管理ユニット オブジェクト一覧内のメンバーシップを確認します。 この関数は推移的です。
メンバー オブジェクトを取得する String collection グループがメンバーであるすべてのグループと管理単位を返します。 この関数は推移的です。
Drive
Get drive drive Drive リソースのプロパティと関係を取得します。
List children DriveItems DriveItem の子リレーションシップで DriveItems のコレクションを返します。
グループ設定
設定を一覧表示する groupSetting コレクション すべての設定オブジェクトのプロパティを一覧表示します。
設定を作成する groupSetting groupSettingTemplate に基づいて設定オブジェクトを作成します。 POST 要求では、テンプレートで定義されているすべての設定に対して settingValues を指定する必要があります。 この操作には、グループ固有のテンプレートのみを使用できます。
設定を取得する groupSetting 特定の設定オブジェクトのプロパティを参照します。
設定を更新する なし 設定オブジェクトを更新します。
設定を削除する なし 設定オブジェクトを削除します。
設定テンプレートを一覧表示する なし すべての設定テンプレートを一覧表示します。
設定テンプレートを取得する なし 設定テンプレートのプロパティを読み取ります。
Notes
List notebooks notebook コレクション ノートブック オブジェクトの一覧を取得します。
Create notebook notebook 新しい OneNote のノートブックを作成します。
Photo
プロフィール写真を取得する profilePhoto 指定した profilePhoto またはそのメタデータ (profilePhoto プロパティ) を取得します。
プロフィール写真を更新する なし サインイン ユーザー、または指定されたグループあるいは連絡先を含むテナント内の任意のユーザーの写真を更新します。
プロフィール写真を削除する なし サインイン ユーザー、または指定されたグループを含むテナント内の任意のユーザーの写真を削除します。
Planner
計画を一覧表示する plannerPlan コレクション グループに割り当てられたプランを取得します。
Posts
List posts post collection 会話スレッドの投稿を取得します。
Get post post 特定の投稿を取得します。
投稿に返信する なし 投稿に返信します。
投稿を転送する なし 投稿を転送します。
その他のグループ リソース
権限付与の表示 resourceSpecificPermissionGrant コレクション グループにアクセスするためのアプリに付与されるアクセス許可を一覧表示します。
User settings
お気に入りに追加する なし サインインしているユーザーのお気に入りのグループ一覧にグループを追加します。 Microsoft 365 グループでのみサポートされます。
お気に入りを削除する なし サインインしているユーザーのお気に入りのグループ一覧からグループを削除します。 Microsoft 365 グループでのみサポートされます。
所属を一覧表示する directoryObject コレクション このユーザーが直接のメンバーであるグループおよび管理単位を、memberOf ナビゲーション プロパティから取得します。
結合されたチームを一覧表示する group コレクション ユーザーがダイレクト メンバーになっている Microsoft Teams を取得します。
関連付けられているチームを一覧表示する associatedTeamInfo コレクション ユーザーが関連付けられている Microsoft Teams の associatedTeamInfo オブジェクトの一覧を取得します。
メールで購読する なし isSubscribedByMail プロパティを true に設定します。 サインインしているユーザーが電子メールの会話を受信できるようにします。 Microsoft 365 グループでのみサポートされます。
メールでの購読を中止する なし isSubscribedByMail プロパティを false に設定します。 サインインしているユーザーが電子メールの会話を受信できないようにします。 Microsoft 365 グループでのみサポートされます。
見えないカウントをリセットする なし サインインしているユーザーが前回の訪問以降に表示していないすべての投稿の 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 ブール型 True の場合、グループが Outlook UI の特定の部分に表示されない場合: アドレス帳、メッセージ受信者を選択するためのアドレス一覧、およびグループを検索するための [グループの参照 ] ダイアログ。それ以外の場合は false。 既定値は、false です。

$select でのみ返されます。 グループ API を取得 (GET /groups/{ID}) でのみサポートされます。
hideFromOutlookClients ブール型 True を指定すると、Outlook for Windows や Outlook on the web などの Outlook クライアントにグループが表示されません。それ以外の場合は 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 ロールの少なくとも 1 つを割り当てる必要があります。
    ユーザー アカウント管理者
  • ディレクトリ ライター
  • 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)",
  "isAssignableToRole": 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"
}

関連コンテンツ