group リソースの種類
名前空間: microsoft.graph
Microsoft 365 グループまたはセキュリティ グループのいずれかの Azure Active Directory (Azure AD) グループを表します。 このリソースは、他のプロパティを渡すことができるオープン型です。
directoryObject から継承します。
パフォーマンス上の理由から、作成、取得、一覧表示の操作は、既定ではより一般的に使用されるプロパティのみを返します。 これらの 既定 のプロパティは、「プロパティ」セクションに記載されています。 既定では返されないプロパティを取得するには、そのプロパティを $select OData クエリ オプションで指定します。
このリソースは以下をサポートしています。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| グループの管理 | ||
| グループを作成する | group | 新しいグループを作成します。Microsoft 365 グループ、動的なグループ、またはセキュリティ グループのいずれにすることができます。 |
| グループを取得する | group | グループ オブジェクトのプロパティを読み取ります。 |
| グループを一覧表示する | group コレクション | グループ オブジェクトとそのプロパティを一覧表示します。 |
| グループを更新する | なし | グループ オブジェクトのプロパティを更新します。 |
| グループを削除する | なし | グループ オブジェクトを削除します。 |
| delta | group コレクション | グループに対する増分の変更を取得します。 |
| メンバーの追加 | なし | members ナビゲーション プロパティ (セキュリティ グループおよび Microsoft 365 グループのみをサポート) に投稿することによってこのグループにユーザーまたはグループを追加します。 |
| 所有者の追加 | なし | owners ナビゲーション プロパティ (セキュリティ グループおよび Microsoft 365 グループのみをサポート) に投稿することによってグループの新規所有者を追加します。 |
| 設定を作成する | groupSetting | groupSettingTemplate に基づいて、設定オブジェクトを作成します。POST 要求は、テンプレートに定義されているすべての設定の settingValues を提供する必要があります。グループ固有のテンプレートにのみ、この操作を使用します。 |
| 設定を削除する | なし | 設定オブジェクトを削除します。 |
| 設定を取得する | groupSetting | 特定の設定オブジェクトのプロパティを参照します。 |
| List groupLifecyclePolicies | groupLifecyclePolicy コレクション | グループのライフサイクル ポリシーを一覧表示します。 |
| メンバーを一覧表示する | directoryObject コレクション | メンバー のナビゲーション プロパティから、このグループの直接のメンバーであるユーザーを取得します。 |
| 所有者を一覧表示する | directoryObject コレクション | owners ナビゲーション プロパティからグループの所有者を取得します。 |
| 設定を一覧表示する | groupSetting コレクション | すべての設定オブジェクトのプロパティを一覧表示します。 |
| 推移的なメンバーを一覧表示する | directoryObject コレクション | このグループの入れ子のメンバーを含む、メンバーになっているユーザー、グループ、デバイスを取得します。 |
| 推移的な memberOf を一覧表示する | directoryObject コレクション | このグループがメンバーとして含まれているグループの一覧。 この操作は推移的で、このグループが入れ子のメンバーになっているグループが含まれます。 |
| メンバーを削除する | なし | メンバー のナビゲーション プロパティを使用して、Microsoft 365 グループまたはセキュリティ グループからメンバーを削除します。 |
| 所有者を削除する | なし | 所有者 のナビゲーション プロパティを使用して、Microsoft 365 グループまたはセキュリティ グループから所有者を削除します。 |
| 設定を更新する | groupSetting | 設定オブジェクトを更新します。 |
| 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 コレクション | このグループの許可された送信者リストに含まれるユーザーまたはグループの一覧を取得します。 |
| acceptedSender を追加する | directoryObject | acceptSenders コレクションにユーザーまたはグループを追加します。 |
| acceptedSender を削除する | directoryObject | acceptedSenders コレクションからユーザーまたはグループを削除します。 |
| rejectedSenders を一覧表示する | directoryObject collection | このグループの拒否された送信者リストに含まれるユーザーまたはグループの一覧を取得します。 |
| rejectedSender を追加する | directoryObject | rejectedSender コレクションに新しいユーザーまたはグループを追加します。 |
| rejectedSender を削除する | directoryObject | rejectedSender コレクションから新しいユーザーまたはグループを削除します。 |
| 設定を作成する | groupSetting | groupSettingTemplate に基づいて、設定オブジェクトを作成します。POST 要求は、テンプレートに定義されているすべての設定の settingValues を提供する必要があります。グループ固有のテンプレートにのみ、この操作を使用します。 |
| ディレクトリ オブジェクト | ||
| 削除されたグループを一覧表示する | directoryObject collection | 過去 30 日間にテナントで削除されたグループを取得します。 |
| ユーザーによって所有されている削除済みグループを一覧表示する | directoryObject コレクション | 過去 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 コレクション | グループが所有しているプランナーの計画を取得します。 |
| ユーザーの設定 | ||
| addFavorite | なし | サインインしたユーザーのお気に入りのグループ一覧にグループを追加します。Microsoft 365 のグループのみをサポートします。 |
| removeFavorite | なし | サインインしたユーザーのお気に入りのグループ一覧からグループを削除します。Microsoft 365 のグループのみをサポートします。 |
| memberOf を一覧表示する | directoryObject コレクション | このユーザーが直接のメンバーであるグループおよび管理単位を、memberOf ナビゲーション プロパティから取得します。 |
| subscribeByMail | なし | isSubscribedByMail プロパティを true に設定します。サインインしたユーザーが電子メールの会話を受信できるようにします。Microsoft 365 のグループのみをサポートします。 |
| unsubscribeByMail | なし | isSubscribedByMail プロパティを false に設定します。サインインしたユーザーに対して電子メールでの会話の受信を無効にします。Microsoft 365 のグループのみをサポートします。 |
| resetUnseenCount | なし | サインインしたユーザーが最後の訪問以降見ていない、すべての投稿の unseenCount を 0 にリセットします。Microsoft 365 のグループのみをサポートします。 |
プロパティ
重要
$filter および $search クエリ パラメーターの具体的な使用方法は、ConsistencyLevel ヘッダーの設定を eventual と $count に使用する場合にのみサポートされます。 詳細については、「Azure AD ディレクトリ オブジェクトの詳細クエリ機能」を参照してください。
| プロパティ | 型 | 説明 |
|---|---|---|
| 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 です。 既定で返されます。 $filter (eq、ne、not、ge、le、in) 読み取り専用。 |
| deletedDateTime | DateTimeOffset | 一部の Azure Active Directory オブジェクト (ユーザー、グループ、アプリケーション) の場合、オブジェクトが削除されると、最初に論理的に削除され、このプロパティはオブジェクトが削除された日時で更新されます。それ以外の場合、このプロパティは 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 | グループに設定されている有効期限のタイムスタンプです。 値は変更できず、グループが作成されると自動的に設定されます。 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 | ブール値 | このグループを Azure Active Directory の役割に割り当てることができるかどうかを示します。オプション。 このプロパティは、グループの作成時にのみ設定でき、変更できません。 true に設定する場合、securityEnabled プロパティも true に設定する必要があり、グループを動的グループにすることはできません (つまり、groupTypes に DynamicMembership を含めることはできません)。 グローバル管理者と特権ロール管理者の役割の呼び出し元のみが、このプロパティを設定できます。 このプロパティを設定したり、そのようなグループのメンバーシップを更新したりするには、呼び出し元に RoleManagement.ReadWrite.Directory アクセス許可を割り当てる必要があります。 詳細については、「グループを使用して Azure AD ロールの割り当てを管理する」を参照してください既定で返されます。 $filter (eq、ne、not) をサポートします。 |
| isSubscribedByMail | Boolean | サインインしているユーザーが電子メールの会話を受信するように登録されているかどうかを示します。既定値は true です。 $select でのみ返されます。グループ API を取得 (GET /groups/{ID}) でのみサポートされます。 |
| licenseProcessingState | String | グループのメンバー全員へのグループ ライセンスの割り当ての状態を示します。既定値は false です。読み取り専用。使用可能な値: QueuedForProcessing、ProcessingInProgress、ProcessingComplete。$select でのみ返されます。読み取り専用です。 |
| 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 | String | オンプレミス ディレクトリから同期されたオンプレミス SAM アカウント名 が含まれています。このプロパティは、オンプレミス ディレクトリを Azure AD Connect 経由で Azure Active Directory と同期する顧客の場合にのみ読み込まれます。 既定で返されます。 $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 グループのデータの優先される場所。 既定では、グループはグループ作成者が優先するデータの場所を継承します。 このプロパティを設定するには、呼び出し元のユーザーに次のいずれかの Azure AD ロールが割り当てられている必要があります。
このプロパティの詳細については、「OneDrive Online Multi-Geo」 を参照してください。 Null 許容型。既定で返されます。 |
| preferredLanguage | String | 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、および空のコレクションをカウント) をサポートします。 |
| 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 | Boolean | グループがセキュリティ グループであるかどうかを指定します。必須。 既定で返されます。 $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 | calendar | グループの予定表。読み取り専用です。 |
| calendarView | event コレクション | 予定表のカレンダー ビュー。読み取り専用です。 |
| conversations | conversation コレクション | グループの会話。 |
| createdOnBehalfOf | directoryObject | グループを作成したユーザー (またはアプリケーション)。注: ユーザーが管理者である場合、これは設定されません。読み取り専用です。 |
| ドライブ | drive | グループの既定のドライブ。読み取り専用です。 |
| drives | drive コレクション | グループのドライブ。読み取り専用です。 |
| events | event コレクション | グループの予定表イベント。 |
| extensions | extension コレクション | グループに対して定義されているオープン拡張機能のコレクション。読み取り専用です。Null 許容型。 |
| groupLifecyclePolicies | groupLifecyclePolicy コレクション | このグループのライフ サイクル ポリシーのコレクション。読み取り専用。Null 許容型です。 |
| memberOf | directoryObject collection | このグループがメンバーとして含まれているグループ。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 グループの作成時にこのプロパティが指定されていない場合、呼び出し元のユーザーが自動的にグループ所有者として割り当てられます。 入れ子になった $select を含む $expand をサポートします。 たとえば、「 /groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=owners($select=id,userPrincipalName,displayName) 」のように入力します。 |
| permissionGrants | resourceSpecificPermissionGrant | 特定のアプリケーションに対してグループに付与されたアクセス許可。$expand をサポートします。 |
| photo | profilePhoto | グループのプロファイル写真 |
| photos | profilePhoto コレクション | グループが所有しているプロファイル写真。読み取り専用です。Null 許容型。 |
| planner | plannerGroup | 統合グループに存在する可能性がある Planner リソースのエントリ ポイント。 |
| rejectedSenders | directoryObject コレクション | このグループで投稿またはカレンダーのイベントを作成することが許可されていないグループの一覧。Null 許容型 |
| 設定 | groupSetting コレクション | メンバーがゲスト ユーザーをグループに招待できるかどうかなどのグループの動作を管理する設定。Null 許容型。 |
| sites | site コレクション | このグループ内の SharePoint サイトの一覧。/sites/root を使用して既定のサイトにアクセスします。 |
| team | channel コレクション | このグループに関連付けられているチーム。 |
| threads | conversationThread コレクション | グループの会話スレッド。Null 許容型。 |
| transitiveMemberOf | directoryObject コレクション | グループがメンバーであるグループ。直接、入れ子になったメンバーシップを使用します。 Null 許容型。 |
| transitiveMembers | directoryObject コレクション | グループの直接および推移的なメンバー。 Null 許容型。 |
JSON 表記
リソースの JSON 表記を次に示します。
{
"allowExternalSenders": false,
"assignedLicenses": [{ "@odata.type": "microsoft.graph.assignedLicense" }],
"autoSubscribeNewMembers": true,
"classification": "String",
"createdDateTime": "String (timestamp)",
"description": "String",
"displayName": "String",
"groupTypes": ["String"],
"hasMembersWithLicenseErrors": "Boolean",
"hideFromAddressLists": false,
"hideFromOutlookClients": false,
"id": "String (identifier)",
"isSubscribedByMail": true,
"isAssignableRole": false,
"licenseProcessingState": "String",
"mail": "String",
"mailEnabled": true,
"mailNickname": "String",
"onPremisesLastSyncDateTime": "String (timestamp)",
"onPremisesProvisioningErrors": [
{ "@odata.type": "microsoft.graph.onPremisesProvisioningError" }
],
"onPremisesSecurityIdentifier": "String",
"onPremisesSyncEnabled": true,
"preferredDataLocation": "String",
"proxyAddresses": ["String"],
"renewedDateTime": "String (timestamp)",
"resourceBehaviorOptions": ["String"],
"resourceProvisioningOptions": ["String"],
"securityEnabled": true,
"securityIdentifier": "String",
"unseenCount": 1024,
"visibility": "String",
"acceptedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
"calendar": { "@odata.type": "microsoft.graph.calendar" },
"calendarView": [{ "@odata.type": "microsoft.graph.event" }],
"conversations": [{ "@odata.type": "microsoft.graph.conversation" }],
"createdOnBehalfOf": { "@odata.type": "microsoft.graph.directoryObject" },
"drive": { "@odata.type": "microsoft.graph.drive" },
"events": [{ "@odata.type": "microsoft.graph.event" }],
"memberOf": [{ "@odata.type": "microsoft.graph.directoryObject" }],
"members": [{ "@odata.type": "microsoft.graph.directoryObject" }],
"membersWithLicenseErrors": [{ "@odata.type": "microsoft.graph.user" }],
"owners": [{ "@odata.type": "microsoft.graph.directoryObject" }],
"photo": { "@odata.type": "microsoft.graph.profilePhoto" },
"rejectedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
"sites": [{ "@odata.type": "microsoft.graph.site" }],
"threads": [{ "@odata.type": "microsoft.graph.conversationThread" }]
}
関連項目
フィードバック
フィードバックの送信と表示