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 グループの表示名またはメールのニックネームが名前付けポリシーに準拠していることを検証します。 |
| アプリの役割の割り当て | ||
| List | appRoleAssignment コレクション | このグループに割り当てられているアプリとアプリロールを取得します。 |
| 追加する | appRoleAssignment | このグループにアプリの役割を割り当てます。 |
| Remove | なし。 | このグループからアプリの役割の割り当てを削除します。 |
| 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 日間にテナントで削除されたグループを取得します。 |
| 削除済みアイテムの取得 | directoryObject コレクション | ID で削除されたグループを取得します。 |
| 削除済みアイテムの復元 | directoryObject コレクション | 過去 30 日間にテナントで削除されたグループを復元します。 |
| アイテムを完全に削除する | directoryObject コレクション | テナントから削除されたグループを完全に削除します。 |
| ユーザーによって所有されている削除済みアイテムを一覧表示する | directoryObject コレクション | 過去 30 日間にテナントで削除されたユーザーのグループを取得します。 |
| メンバー グループをチェックする | String collection | グループの一覧内のメンバーシップを確認します。 この関数は推移的です。 |
| メンバー グループを取得する | String collection | このグループがメンバーであるすべてのグループを返します。 この関数は推移的です。 |
| メンバー オブジェクトを確認する | String collection | グループ、ディレクトリ ロール、または管理ユニット オブジェクト一覧内のメンバーシップを確認します。 この関数は推移的です。 |
| メンバー オブジェクトを取得する | String collection | グループがメンバーであるすべてのグループと管理単位を返します。 この関数は推移的です。 |
| Drive | ||
| Get drive | drive | Drive リソースのプロパティと関係を取得します。 |
| List children | DriveItems | DriveItem の子リレーションシップで DriveItems のコレクションを返します。 |
| グループ設定 | ||
| List | groupSetting コレクション | すべての設定オブジェクトのプロパティを一覧表示します。 |
| Create | groupSetting | groupSettingTemplate に基づいて設定オブジェクトを作成します。 POST 要求では、テンプレートで定義されているすべての設定に対して settingValues を指定する必要があります。 この操作には、グループ固有のテンプレートのみを使用できます。 |
| Get | groupSetting | 特定の設定オブジェクトのプロパティを参照します。 |
| Update | なし | 設定オブジェクトを更新します。 |
| Delete | なし | 設定オブジェクトを削除します。 |
| 設定テンプレートを一覧表示する | なし | すべての設定テンプレートを一覧表示します。 |
| 設定テンプレートを取得する | なし | 設定テンプレートのプロパティを読み取ります。 |
| Notes | ||
| List notebooks | notebook コレクション | ノートブック オブジェクトの一覧を取得します。 |
| Create notebook | notebook | 新しい OneNote のノートブックを作成します。 |
| プロフィールの写真 | ||
| Get | profilePhoto | 指定した profilePhoto またはそのメタデータ (profilePhoto プロパティ) を取得します。 |
| Update | なし | サインイン ユーザー、または指定されたグループあるいは連絡先を含むテナント内の任意のユーザーの写真を更新します。 |
| Delete | なし | サインイン ユーザー、または指定されたグループを含むテナント内の任意のユーザーの写真を削除します。 |
| Planner | ||
| 計画を一覧表示する | plannerPlan コレクション | グループに割り当てられたプランを取得します。 |
| Posts | ||
| List | post collection | 会話スレッドの投稿を取得します。 |
| Get | 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 でのみ返されます。 このプロパティは、呼び出し元が Microsoft Graph のアクセス許可と サポートされている管理者ロールの両方を必要とする委任されたシナリオでのみ更新できます。 |
| 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 に更新されます。
directoryObject から継承されます。 |
| 説明 | 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 | ブール型 | グループが Outlook UI の特定の部分 (アドレス帳、メッセージ受信者を選択するためのアドレス一覧、グループを検索するための [グループ参照] ダイアログなど) に表示されない場合は True、それ以外の場合は false。 既定値は false です。 $select でのみ返されます。 グループ API を取得 (GET /groups/{ID}) でのみサポートされます。 |
| hideFromOutlookClients | ブール型 | 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 でのみ返されます。 読み取り専用です。 |
| 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) をサポートします。 |
| onPremisesDomainName | String | オンプレミス ディレクトリから同期されたオンプレミスのドメイン FQDN (dnsDomainName とも呼ばれます) が含まれています。 このプロパティは、オンプレミス ディレクトリを Microsoft Entra Connect 経由で Microsoft Entra ID と同期する顧客の場合にのみ読み込まれます。 既定で返されます。 読み取り専用。 |
| onPremisesLastSyncDateTime | DateTimeOffset | グループがオンプレミス ディレクトリと同期された最後の時刻を示します。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日の午前 0 時 (UTC) は 2014-01-01T00:00:00Z。 既定で返されます。 読み取り専用です。 $filter (eq、ne、not、ge、le、in) をサポートします。 |
| onPremisesNetBiosName | String | オンプレミス ディレクトリから同期されたオンプレミスの netBios name が含まれています。 このプロパティは、オンプレミス ディレクトリを Microsoft Entra Connect 経由で Microsoft Entra ID と同期する顧客の場合にのみ読み込まれます。 既定で返されます。 読み取り専用です。 |
| 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 つを割り当てる必要があります。
このプロパティの詳細については、「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) をサポートしています。 読み取り専用です。 |
| 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 | グループに割り当て、代替キーとして使用できる一意の識別子。 不変です。 読み取り専用です。 |
| 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 許容型。 $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" },
"deletedDateTime": "String (timestamp)",
"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" }],
"onPremisesDomainName": "String",
"onPremisesLastSyncDateTime": "String (timestamp)",
"onPremisesNetBiosName": "String",
"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)",
"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"
}