group リソースの種類group resource type

重要: Microsoft Graph のベータ版 (/beta) の API はプレビュー中であるため、変更されることがあります。Important: APIs under the /beta version in Microsoft Graph are in preview and are subject to change. 実稼働アプリケーションでの、これらの API の使用はサポートされていません。Use of these APIs in production applications is not supported.

Office 365 のグループ、マイクロソフトのチームで、チーム、動的グループ、またはセキュリティ グループは、Azure Active Directory (AD の Azure) のグループを表します。Represents an Azure Active Directory (Azure AD) group, which can be an Office 365 group, a team in Microsoft Teams, a dynamic group, or a security group. directoryObject から継承します。Inherits from directoryObject.

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

マイクロソフトのチームと Office 365 のグループはグループの共同作業をサポートします。Microsoft Teams and Office 365 groups support group collaboration. マイクロソフトのチームでは、ほとんどの Office 365 グループ API を使用できます。You can use most of the Office 365 groups API with Microsoft Teams. 作成するチーム、最初のグループを作成してそれをチームに追加します。To create a team, first create group and then add a team to it. 詳細については、マイクロソフトのチームの概要を参照してください。For details, see the Microsoft Teams overview.

メソッドMethods

メソッドMethod 戻り値の型Return Type 説明Description
グループの管理Group management
グループを作成するCreate group groupgroup 指定された新しいグループを作成します。Create a new group as specified. Office 365 のグループ、動的グループ、セキュリティ グループ、またはチームであることができます。It can be an Office 365 group, dynamic group, security group, or team.
グループを取得するGet group groupgroup グループ オブジェクトのプロパティと関係を参照してください。Read properties and relationships of group object.
グループを更新するUpdate group なしNone グループ オブジェクトのプロパティを更新します。Update the properties of a group object.
グループを削除するDelete group なしNone グループ オブジェクトを削除します。Delete group object.
deltadelta group コレクションgroup collection グループに対する増分の変更を取得します。Get incremental changes for groups.
List groupLifecyclePoliciesList groupLifecyclePolicies groupLifecyclePolicy コレクションgroupLifecyclePolicy collection グループのライフサイクル ポリシーを一覧表示します。List group lifecycle policies.
所有者を一覧表示するList owners directoryObject コレクションdirectoryObject collection owners ナビゲーション プロパティからグループの所有者を取得します。Get the owners of the group from the owners navigation property.
Add ownerAdd owner directoryObjectdirectoryObject owners ナビゲーション プロパティ (セキュリティ グループおよびメールが有効なセキュリティ グループのみをサポート) に投稿することによってグループの新規所有者を追加します。Add a new owner for the group by posting to the owners navigation property (supported for security groups and mail-enabled security groups only).
所有者を削除するRemove owner なしNone owners ナビゲーション プロパティを使用して Office 365 のグループ、セキュリティ グループ、またはメールが有効なセキュリティ グループから所有者を削除します。Remove an owner from an Office 365 group, a security group or a mail-enabled security group through the owners navigation property.
メンバーを一覧表示するList members directoryObject コレクションdirectoryObject collection members ナビゲーション プロパティからこのグループの直接のメンバーであるユーザーおよびグループを取得します。Get the users and groups that are direct members of this group from the members navigation property.
推移的なメンバーの一覧List transitive members directoryObject コレクションdirectoryObject collection ユーザー、グループ、デバイス、およびサービス プリンシパルは、このグループの入れ子にされたメンバーを含むメンバーを取得します。Get the users, groups, devices, and service principals that are members, including nested members of this group.
メンバーを追加するAdd member directoryObjectdirectoryObject members ナビゲーション プロパティ (セキュリティ グループおよびメールが有効なセキュリティ グループでのみサポートされます) に投稿することによってこのグループにユーザーまたはグループを追加します。Add a user or group to this group by posting to the members navigation property (supported for security groups and mail-enabled security groups only).
メンバーを削除するRemove member なしNone members ナビゲーション プロパティを使用して Office 365 のグループ、セキュリティ グループ、またはメールが有効なセキュリティ グループからメンバーを削除できます。ユーザーや他のグループを削除できます。Remove a member from an Office 365 group, a security group or a mail-enabled security group through the members navigation property. You can remove users or other groups.
memberOf を一覧表示するList memberOf directoryObject コレクションdirectoryObject collection グループとは、このグループへの後方リンクのナビゲーション プロパティから直接メンバーの管理の単位を取得します。Get the groups and administrative units that this group is a direct member of from the memberOf navigation property.
[推移的な所属するグループ] ボックスの一覧](../api/group-list-transitivememberof.md)List transitive memberOf directoryObject コレクションdirectoryObject collection グループとメンバーであるユーザーの管理の単位を一覧表示します。List the groups and administrative units that this user is a member of. この操作では、推移的では、このグループの入れ子にされたメンバーであるグループが含まれています。This operation is transitive and includes the groups that this group is a nested member of.
checkMemberGroupscheckMemberGroups String コレクションString collection グループの一覧のメンバーシップを確認します。Check for membership in a list of groups. 関数は、推移的です。The function is transitive.
getMemberGroupsgetMemberGroups String コレクションString collection このグループがメンバーであるすべてのグループを返します。この関数は、推移的です。Return all the groups that the group is a member of. The function is transitive.
getMemberObjectsgetMemberObjects String コレクションString collection すべてのグループとグループのメンバーである管理の単位を返します。Return all of the groups and administrative units that the group is a member of. 関数は、推移的です。The function is transitive.
設定を作成するCreate setting directorySettingdirectorySetting DirectorySettingTemplate に基づいて、設定オブジェクトを作成します。Create a setting object based on a directorySettingTemplate. POST 要求は、テンプレートで定義されているすべての設定 settingValues を提供する必要があります。The POST request must provide settingValues for all the settings defined in the template. この操作には、グループ固有のテンプレートのみを使用できます。Only groups specific templates may be used for this operation.
設定を取得するGet setting directorySettingdirectorySetting 特定の設定オブジェクトのプロパティを参照します。Read properties of a specific setting object.
設定を一覧表示するList settings directorySettingコレクションdirectorySetting collection すべての設定オブジェクトのプロパティを一覧表示します。List properties of all setting objects.
設定を更新するUpdate setting directorySettingdirectorySetting 設定オブジェクトを更新します。Update a setting object.
設定を削除するDelete setting なしNone 設定オブジェクトを削除します。Delete a setting object.
エンドポイントのリストList endpoints エンドポイントのコレクションendpoint collection エンドポイント オブジェクトのコレクションを取得します。Get an endpoint object collection.
エンドポイントを取得します。Get endpoint エンドポイントendpoint エンドポイント オブジェクトのプロパティと関係を参照してください。Read properties and relationships of an endpoint object.
deltadelta group コレクションgroup collection グループに対する増分の変更を取得します。Get incremental changes for groups.
validatePropertiesvalidateProperties JSONJSON メールのニックネームは、命名ポリシーに準拠しているまたは、Office 365 のグループの表示名を検証します。Validate an Office 365 group's display name or mail nickname complies with naming policies.
予定表Calendar
イベントを作成するCreate event eventevent event コレクションへの投稿によって、新しいイベントを作成します。Create a new event by posting to the events collection.
イベントを取得するGet event eventevent event オブジェクトのプロパティを読み取ります。Read properties of an event object.
イベントを一覧表示するList events event コレクションevent collection event オブジェクトのコレクションを取得します。Get an event object collection.
イベントを更新するUpdate event なしNone event オブジェクトのプロパティを更新します。Update the properties of an event object.
イベントを削除するDelete event なしNone event オブジェクトを削除します。Delete event object.
calendarView を一覧表示するList calendarView event コレクションevent collection 指定された時間枠のイベントのコレクションを取得します。Get a collection of events in a specified time window.
会話Conversations
会話を作成するCreate conversation conversationconversation conversation コレクションに投稿して、新しい会話を作成します。Create a new conversation by posting to the conversations collection.
会話を取得するGet conversation conversationconversation conversation オブジェクトのプロパティを読み取ります。Read properties of a conversation object.
会話を一覧表示するList conversations conversation コレクションconversation collection conversation オブジェクトのコレクションを取得します。Get a conversation object collection.
会話を削除するDelete conversation なしNone conversation オブジェクトを削除します。Delete conversation object.
スレッドを取得するGet thread conversationThreadconversationThread thread オブジェクトのプロパティを読み取ります。Read properties of a thread object.
スレッドを一覧表示するList threads conversationThread コレクションconversationThread collection グループのすべてのスレッドを取得します。Get all the threads of a group.
スレッドを更新するUpdate thread なしNone thread オブジェクトのプロパティを更新します。Update properties of a thread object.
スレッドを削除するDelete thread なしNone スレッド オブジェクトを削除します。Delete thread object
acceptedSenders を一覧表示するList acceptedSenders directoryObject コレクションdirectoryObject collection このグループの acceptedSenders リストに含まれるユーザーまたはグループの一覧を取得します。Get a list of users or groups that are in the acceptedSenders list for this group.
acceptedSender を追加するAdd acceptedSender directoryObjectdirectoryObject acceptSenders コレクションにユーザーまたはグループを追加します。Add a User or Group to the acceptSenders collection.
acceptedSender を削除するRemove acceptedSender directoryObjectdirectoryObject acceptedSenders コレクションからユーザーまたはグループを削除します。Remove a User or Group from the acceptedSenders collection.
rejectedSenders を一覧表示するList rejectedSenders directoryObject コレクションdirectoryObject collection このグループの rejectedSenders リストに含まれるユーザーまたはグループの一覧を取得します。Get a list of users or groups that are in the rejectedSenders list for this group.
rejectedSender を追加するAdd rejectedSender directoryObjectdirectoryObject rejectedSender コレクションに新しいユーザーまたはグループを追加します。Add a new User or Group to the rejectedSenders collection.
rejectedSender を削除するRemove rejectedSender directoryObjectdirectoryObject rejectedSender コレクションから新しいユーザーまたはグループを削除します。Remove new new User or Group from the rejectedSenders collection.
オープン拡張機能Open extensions
オープン拡張機能を作成するCreate open extension openTypeExtensionopenTypeExtension オープン拡張機能を作成し、新規または既存のリソースにカスタム プロパティを追加します。Create an open extension and add custom properties to a new or existing resource.
オープン拡張機能を取得するGet open extension openTypeExtension コレクションopenTypeExtension collection 拡張機能の名前で識別されるオープン拡張機能を取得します。Get an open extension identified by the extension name.
スキーマ拡張機能Schema extensions
スキーマ拡張機能の値を追加するAdd schema extension values スキーマ拡張機能の定義を作成し、それを使用してカスタムの型指定されたデータをリソースに追加します。Create a schema extension definition and then use it to add custom typed data to a resource.
その他のグループ リソースOther group resources
写真を一覧表示するList photos profilePhoto コレクションprofilePhoto collection グループのプロファイル写真のコレクションを取得します。Get a collection of profile photos for the group.
plannerPlans を一覧表示するList plannerPlans plannerPlan コレクションplannerPlan collection グループが所有しているプランナーの計画を取得します。Get Planner plans owned by the group.
ユーザーの設定User settings
addFavoriteaddFavorite なしNone 現在のユーザーのお気に入りのグループ一覧にグループを追加します。Office 365 のグループのみをサポートします。Add the group to the list of the current user's favorite groups. Supported for only Office 365 groups.
removeFavoriteremoveFavorite なしNone 現在のユーザーのお気に入りのグループ一覧からグループを削除します。Office 365 のグループのみをサポートします。Remove the group from the list of the current user's favorite groups. Supported for Office 365 Groups only.
memberOf を一覧表示するList memberOf directoryObject コレクションdirectoryObject collection このユーザーが直接のメンバーであるグループおよび管理単位を、memberOf ナビゲーション プロパティから取得します。Get the groups and administative units that this user is a direct member of, from the memberOf navigation property.
参加チームのリストを作成するList joinedTeams group コレクションgroup collection ユーザーの直接のメンバーでは、マイクロソフトのチームを取得します。Get the Microsoft Teams that the user is a direct member of.
subscribeByMailsubscribeByMail なしNone IsSubscribedByMail プロパティをtrueに設定します。Set the isSubscribedByMail property to true. 電子メールを受信する現在のユーザーを有効にします。Enabling the current user to receive email conversations. Office 365 のグループのみをサポートします。Supported for Office 365 Groups only.
unsubscribeByMailunsubscribeByMail なしNone IsSubscribedByMail プロパティをfalseに設定します。Set the isSubscribedByMail property to false. 受信電子メールのやり取りなどから現在のユーザーを無効にします。Disabling the current user from receive email conversations. Office 365 のグループのみをサポートします。Supported for Office 365 Groups only.
resetUnseenCountresetUnseenCount なしNone UnseenCount が、前回のアクセス以降に現在のユーザーが認識されていないすべての投稿の 0 にリセットします。Reset the unseenCount to 0 of all the posts that the current user has not seen since their last visit. Office 365 のグループのみをサポートします。Supported for Office 365 Groups only.

プロパティProperties

プロパティProperty 種類Type 説明Description
allowExternalSendersallowExternalSenders ブール値Boolean 既定値は false です。組織外部のユーザーがグループにメッセージを送信できるかどうかを示します。Default is false. Indicates if people external to the organization can send messages to the group.
assignedLicensesassignedLicenses assignedLicense collectionassignedLicense collection グループに割り当てられているライセンスです。The licenses that are assigned to the group. 読み取り専用です。Read-only.
autoSubscribeNewMembersautoSubscribeNewMembers BooleanBoolean 既定値は false です。グループに追加された新しいメンバーが、電子メールの通知を受信するように自動的にサブスクライブされるかどうかを示します。グループの PATCH 要求でこのプロパティを設定できます。グループを作成する最初の POST 要求では設定しないでください。Default is false. Indicates if new members added to the group will be auto-subscribed to receive email notifications. You can set this property in a PATCH request for the group; do not set it in the initial POST request that creates the group.
分類classification StringString グループの分類 (低、中、高程度の企業への影響など) を説明します。このプロパティの有効な値は、テンプレート定義に基づいて ClassificationList 設定値を作成することによって定義されます。Describes a classification for the group (such as low, medium or high business impact). Valid values for this property are defined by creating a ClassificationList setting value, based on the template definition.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset グループ作成時のタイムスタンプです。Timestamp of when the group was created. 値は変更できず、グループが作成されると自動的に設定されます。The value cannot be modified and is automatically populated when the group is created. Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. 読み取り専用です。Read-only.
説明description StringString グループに関するオプションの説明。An optional description for the group.
displayNamedisplayName StringString グループの表示名。このプロパティは、グループの作成時の必須プロパティであり、更新時にクリアすることはできません。$filter および $orderby をサポートします。The display name for the group. This property is required when a group is created and it cannot be cleared during updates. Supports $filter and $orderby.
groupTypesgroupTypes String コレクションString collection 作成するグループの種類を指定します。Specifies the type of group to create. 使用可能な値は、 Unified 、Office 365 のグループを作成するまたはDynamicMembership動的グループにします。Possible values are Unified to create an Office 365 group, or DynamicMembership for dynamic groups. 他のすべてのグループのセキュリティが有効なグループなど、メールが有効なセキュリティ グループの種類には、このプロパティが設定されません。For all other group types, like security-enabled groups and email-enabled security groups, do not set this property.
idid StringString グループの一意の識別子。directoryObject から継承されます。キー。null 許容ではありません。読み取り専用です。The unique identifier for the group. Inherited from directoryObject. Key. Not nullable. Read-only.
isSubscribedByMailisSubscribedByMail BooleanBoolean 既定値は true です。現在のユーザーが電子メールの会話を受信するように登録されているかどうかを示します。Default value is true. Indicates whether the current user is subscribed to receive email conversations.
licenseProcessingStatelicenseProcessingState StringString グループのすべてのメンバー グループのライセンスの割り当ての状態を示します。Indicates status of the group license assignment to all members of the group. 読み取り専用です。Read-only. 使用可能な値: QueuedForProcessingProcessingInProgressProcessingCompletePossible values: QueuedForProcessing, ProcessingInProgress, and ProcessingComplete.
mailmail StringString グループの SMTP アドレス (たとえば、"Serviceadmins@contoso.onmicrosoft.com")。読み取り専用です。$filter をサポートします。The SMTP address for the group, for example, "serviceadmins@contoso.onmicrosoft.com". Read-only. Supports $filter.
mailEnabledmailEnabled BooleanBoolean メールが有効なグループであるかどうかを指定します。securityEnabled プロパティも true の場合、グループはメールが有効なセキュリティ グループになります。それ以外の場合は、Microsoft Exchange 配布グループになります。Specifies whether the group is mail-enabled. If the securityEnabled property is also true, the group is a mail-enabled security group; otherwise, the group is a Microsoft Exchange distribution group.
mailNicknamemailNickname StringString 組織内で一意のグループのメール エイリアス。このプロパティは、グループの作成時に指定する必要があります。$filter をサポートします。The mail alias for the group, unique in the organization. This property must be specified when a group is created. Supports $filter.
membershipRulemembershipRule StringString グループが動的グループの場合、このグループのメンバーを決定するルール (groupTypes が含まれていますDynamicMembership)。The rule that determines members for this group if the group is a dynamic group (groupTypes contains DynamicMembership). メンバーシップの規則の構文の詳細については、メンバーシップの規則の構文を参照してください。For more information about the syntax of the membership rule, see Membership Rules syntax
membershipRuleProcessingStatemembershipRuleProcessingState StringString 動的メンバーシップ処理が上または一時停止するかどうかを示します。Indicates whether the dynamic membership processing is on or paused. 値には"On"または「一時停止」Possible values are "On" or "Paused"
onPremisesLastSyncDateTimeonPremisesLastSyncDateTime DateTimeOffsetDateTimeOffset 最後にオブジェクトが設置ディレクトリと同期された時刻を示します。Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、UTC 時間に常に。Indicates the last time at which the object was synced with the on-premises directory.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. 読み取り専用です。Read-only. $filter をサポートします。Supports $filter.
onPremisesProvisioningErrorsonPremisesProvisioningErrors onPremisesProvisioningErrorコレクションonPremisesProvisioningError collection 提供処理中に同期の Microsoft 製品を使用するときのエラーです。Errors when using Microsoft synchronization product during provisioning.
onPremisesSecurityIdentifieronPremisesSecurityIdentifier StringString オンプレミスからクラウドに同期されたグループのオンプレミスのセキュリティ識別子 (SID) が含まれます。読み取り専用です。Contains the on-premises security identifier (SID) for the group that was synchronized from on-premises to the cloud. Read-only.
onPremisesSyncEnabledonPremisesSyncEnabled BooleanBoolean このオブジェクトがオンプレミスのディレクトリから同期される場合は true。このオブジェクトが最初にオンプレミスのディレクトリから同期されていて、今後は同期されない場合は false。このオブジェクトがオンプレミスのディレクトリから一度も同期されたことがない場合は null (既定値)。true if this object is synced from an on-premises directory; false if this object was originally synced from an on-premises directory but is no longer synced; null if this object has never been synced from an on-premises directory (default). 読み取り専用です。Read-only. $filter をサポートします。Supports $filter.
preferredDataLocationpreferredDataLocation StringString グループの希望するデータの場所です。The preferred data location for the group. 詳細については、オンラインの複数の地域 OneDriveを参照してください。For more information, see OneDrive Online Multi-Geo.
preferredLanguagepreferredLanguage StringString Office 365 のグループの言語です。The preferred language for an Office 365 group. ISO 639-1 コードに従う必要があります。たとえば"EN-US"です。Should follow ISO 639-1 Code; for example "en-US".
proxyAddressesproxyAddresses String コレクションString collection 例: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"] any演算子は、複数値を持つプロパティのフィルター式に必要です。For example: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"] The any operator is required for filter expressions on multi-valued properties. 読み取り専用です。Read-only. null 許容ではありません。Not nullable. $filter をサポートします。Supports $filter.
renewedDateTimerenewedDateTime DateTimeOffsetDateTimeOffset グループの最後の更新時のタイムスタンプです。Timestamp of when the group was last renewed. これは直接変更することはできず、更新サービス アクション経由でのみ更新されます。This cannot be modified directly and is only updated via the renew service action. Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. 読み取り専用です。Read-only.
securityEnabledsecurityEnabled BooleanBoolean グループがセキュリティ グループであるかどうかを指定します。mailEnabled プロパティも true の場合、グループはメールが有効なセキュリティ グループになります。それ以外の場合は、セキュリティ グループになります。Office 365 グループの場合、false にする必要があります。$filter をサポートします。Specifies whether the group is a security group. If the mailEnabled property is also true, the group is a mail-enabled security group; otherwise it is a security group. Must be false for Office 365 groups. Supports $filter.
themetheme StringString Office 365 のグループの色のテーマを指定します。Specifies an Office 365 group's color theme. 使用可能な値は、 TealPurpleGreenBluePinkOrangeまたはRedPossible values are Teal, Purple, Green, Blue, Pink, Orange or Red.
unseenConversationsCountunseenConversationsCount Int32Int32 1 つまたは複数の新規投稿、グループにサインインしているユーザーの前回のアクセス以降配信された会話の数。Count of conversations that have been delivered one or more new posts since the signed-in user's last visit to the group. このプロパティは、 unseenCountと同じです。This property is the same as unseenCount.
unseenCountunseenCount Int32Int32 1 つまたは複数の新規投稿、グループにサインインしているユーザーの前回のアクセス以降配信された会話の数。Count of conversations that have been delivered one or more new posts since the signed-in user's last visit to the group. このプロパティは、 unseenConversationsCountと同じです。This property is the same as unseenConversationsCount.
unseenMessagesCountunseenMessagesCount Int32Int32 グループにサインインしているユーザーの前回のアクセス以降、グループの会話に配信された新規の投稿の数です。Count of new posts that have been delivered to the group's conversations since the signed-in user's last visit to the group.
visibilityvisibility StringString Office 365 のグループの表示/非表示を指定します。Specifies the visibility of an Office 365 group. 使用可能な値: privatepublic、またはhiddenmembership。空白の値は、public として扱われます。Possible values are: private, public, or hiddenmembership; blank values are treated as public. 詳細については、グループの表示/非表示のオプションを参照してください。See Group visibility options to learn more.
グループが作成されたときにのみ、表示/非表示を設定できます。編集はできません。Visibility can be set only when a group is created; it is not editable.
可視性が統一されたグループでのみサポートされています。セキュリティ グループのことはサポートされていません。Visibility is supported only for unified groups; it is not supported for security groups.

グループの表示/非表示のオプションGroup visibility options

表示プロパティの値の意味を以下に示します。Here's what each visibility property value means:

Value 説明Description
public グループは、所有者のアクセス許可がなくても誰でも参加できます。Anyone can join the group without needing owner permission.
すべてのユーザーは、グループの内容を表示できます。Anyone can view the contents of the group.
private グループに参加するには、所有者の権限が必要です。Owner permission is needed to join the group.
メンバー以外には、グループの内容を表示できません。Non-members cannot view the contents of the group.
hiddenmembership グループに参加するには、所有者の権限が必要です。Owner permission is needed to join the group.
メンバー以外には、グループの内容を表示できません。Non-members cannot view the contents of the group.
メンバー以外には、グループのメンバーを表示できません。Non-members cannot see the members of the group.
(グローバル、会社、ユーザー、およびヘルプデスク) の管理者は、グループのメンバーシップを表示できます。Administrators (global, company, user, and helpdesk) can view the membership of the group.
グループは、グローバル アドレス一覧 (GAL) に表示されます。The group appears in the global address book (GAL).

リレーションシップRelationships

リレーションシップRelationship Type 説明Description
acceptedSendersacceptedSenders directoryObject コレクションdirectoryObject collection このグループで投稿または予定表のイベントを作成することが許可されているユーザーまたはグループの一覧。この一覧が空でない場合、ここに記載されているユーザーまたはグループだけが投稿を許可されます。The list of users or groups that are allowed to create post's or calendar events in this group. If this list is non-empty then only users or groups listed here are allowed to post.
予定表calendar calendarcalendar グループの予定表。読み取り専用です。The group's calendar. Read-only.
calendarViewcalendarView event コレクションevent collection 予定表のカレンダー ビュー。読み取り専用です。The calendar view for the calendar. Read-only.
conversationsconversations conversation コレクションconversation collection グループの会話。The group's conversations.
createdOnBehalfOfcreatedOnBehalfOf directoryObjectdirectoryObject グループを作成したユーザー (またはアプリケーション)。注: ユーザーが管理者である場合、これは設定されません。読み取り専用です。The user (or application) that created the group. NOTE: This is not set if the user is an administrator. Read-only.
ドライブdrive drivedrive グループの既定のドライブです。The group's default drive. 読み取り専用です。Read-only.
drivesdrives drive コレクションdrive collection グループのドライブです。The group's drives. 読み取り専用です。Read-only.
エンドポイントendpoints エンドポイントのコレクションEndpoint collection グループに対応するエンドポイントです。Endpoints for the group. 読み取り専用です。Read-only. Null 許容型。Nullable.
eventsevents event コレクションevent collection グループのイベントです。The group's events.
extensionsextensions extension コレクションextension collection グループに対して定義されているオープン拡張機能のコレクション。読み取り専用です。Null 許容型。The collection of open extensions defined for the group. Read-only. Nullable.
groupLifecyclePoliciesgroupLifecyclePolicies groupLifecyclePolicy コレクションgroupLifecyclePolicy collection このグループのライフ サイクル ポリシーのコレクションです。The collection of lifecycle policies for this group. 読み取り専用です。Read-only. Null 許容型。Nullable.
memberOfmemberOf directoryObject コレクションdirectoryObject collection 出荷単位一覧および管理者はこのグループのメンバーであります。Groups and administrative units that this group is a member of. : の HTTP メソッドを取得 (サポートされているすべてのグループ)。HTTP Methods: GET (supported for all groups). 読み取り専用です。Read-only. Null 許容型。Nullable.
membersmembers directoryObject コレクションdirectoryObject collection ユーザー、連絡先およびグループがこのグループのメンバーであります。Users, contacts, and groups that are members of this group. HTTP メソッド: 取得 (サポートされているすべてのグループ)、(セキュリティ グループ、およびメールが有効なセキュリティ グループのサポート) の投稿、削除の (セキュリティ グループに対してのみサポートされています) 読み取り専用です。HTTP Methods: GET (supported for all groups), POST (supported for security groups and mail-enabled security groups), DELETE (supported only for security groups) Read-only. Null 許容型。Nullable.
membersWithLicenseErrorsmembersWithLicenseErrors ユーザーのコレクションUser collection このグループ ・ ベースのライセンスの割り当てからのライセンス エラーのあるグループのメンバーの一覧です。A list of group members with license errors from this group-based license assignment. 読み取り専用です。Read-only.
onenoteonenote OneNoteOneNote 読み取り専用です。Read-only.
ownersowners directoryObject コレクションdirectoryObject collection グループの所有者です。The owners of the group. 所有者は、このオブジェクトを変更するのには許可されている管理者以外のユーザーのセットです。The owners are a set of non-admin users who are allowed to modify this object. HTTP メソッド: 取得 (サポートされているすべてのグループ)、(セキュリティ グループ、およびメールが有効なセキュリティ グループのサポート) の投稿、削除の (セキュリティ グループに対してのみサポートされています) 読み取り専用です。HTTP Methods: GET (supported for all groups), POST (supported for security groups and mail-enabled security groups), DELETE (supported only for security groups) Read-only. Null 許容型。Nullable.
photophoto profilePhotoprofilePhoto グループのプロフィールの写真です。The group's profile photo.
photosphotos profilePhoto コレクションprofilePhoto collection グループが所有しているプロファイル写真。読み取り専用です。Null 許容型。The profile photos owned by the group. Read-only. Nullable.
プランナーplanner plannerGroupplannerGroup 選択的プランナー サービス グループで使用します。Selective Planner services available to the group. 読み取り専用です。Read-only. Null 許容型。Nullable.
rejectedSendersrejectedSenders directoryObject コレクションdirectoryObject collection このグループで投稿またはカレンダーのイベントを作成することが許可されていないグループの一覧。Null 許容型The list of users or groups that are not allowed to create posts or calendar events in this group. Nullable
設定settings directorySettingコレクションdirectorySetting collection メンバーがグループに guest ユーザーを招待するかどうかのように、このグループの動作を制御する設定です。Settings that can govern this group's behavior, like whether members can invite guest users to the group. Null 許容型。Nullable.
sitessites site コレクションsite collection このグループ内の SharePoint サイトの一覧。/sites/root を使用して既定のサイトにアクセスします。The list of SharePoint sites in this group. Access the default site with /sites/root.
threadsthreads conversationThread コレクションconversationThread collection グループの会話スレッド。Null 許容型。The group's conversation threads. Nullable.

JSON 表記JSON representation

次は、JSON 形式のリソースThe following is a JSON representation of the resource

{
  "accessType": "string",
  "assignedLicenses": [{"@odata.type": "microsoft.graph.assignedLicense"}],
  "allowExternalSenders": false,
  "autoSubscribeNewMembers": true,
  "createdDateTime": "String (timestamp)",
  "deletedDateTime": "String (timestamp)",
  "description": "string",
  "displayName": "string",
  "groupTypes": ["string"],
  "id": "string (identifier)",
  "isFavorite": true,  
  "isSubscribedByMail": true,
  "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)",
  "securityEnabled": true,
  "unseenConversationsCount": 1024,
  "unseenCount": 1024,
  "unseenMessagesCount": 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" }]
}

関連項目See also