group リソース タイプ

Office 365 グループ、動的なグループ、またはセキュリティ グループのいずれかの Azure Active Directory グループを表します。directoryObject から継承します。

メソッド

メソッド 戻り値の型 説明
グループを作成する group 新しいグループを作成します。Office 365 グループ、動的なグループ、またはセキュリティ グループのいずれにすることができます。
グループを取得する group グループ オブジェクトのプロパティを読み取ります。
グループを一覧表示する group コレクション グループ オブジェクトとそのプロパティを一覧表示します。
グループを更新する group グループ オブジェクトのプロパティを更新します。
グループを削除する なし グループ オブジェクトを削除します。
メンバーを追加する なし members ナビゲーション プロパティ (セキュリティ グループおよびメールが有効なセキュリティ グループでのみサポートされます) に投稿することによってこのグループにユーザーまたはグループを追加します。
メンバーを一覧表示する directoryObject コレクション members ナビゲーション プロパティからこのグループの直接のメンバーであるユーザーおよびグループを取得します。
メンバーを削除する なし members ナビゲーション プロパティを使用して Office 365 のグループ、セキュリティ グループ、またはメールが有効なセキュリティ グループからメンバーを削除できます。ユーザーや他のグループを削除できます。
memberOf を一覧表示する directoryObject コレクション memberOf ナビゲーション プロパティからこのグループが直接のメンバーであるグループを取得します。
所有者を追加する なし members ナビゲーション プロパティ (セキュリティ グループおよびメールが有効なセキュリティ グループのみをサポート) に投稿することによってグループの新規所有者を追加します。
所有者を一覧表示する directoryObject コレクション owners ナビゲーション プロパティからグループの所有者を取得します。
所有者を削除する なし owners ナビゲーション プロパティを使用して Office 365 のグループ、セキュリティ グループ、またはメールが有効なセキュリティ グループから所有者を削除します。
checkMemberGroups String collection グループの一覧内のメンバーシップについてこのグループを確認します。この関数は、推移的です。
getMemberGroups String collection このグループがメンバーであるすべてのグループを返します。この関数は、推移的です。
getMemberObjects String collection このグループがメンバーであるすべてのグループを返します。この関数は、推移的です。
イベントを作成する Event Event コレクションへの投稿によって、新しいイベントを作成します。
イベントを一覧表示する Event コレクション Event オブジェクトのコレクションを取得します。
calendarView を一覧表示する Event コレクション 指定された時間枠のイベントのコレクションを取得します。
会話を作成する Conversation Conversation コレクションに投稿することによって、新しい会話を作成します。
会話を一覧表示する Conversation コレクション Conversation オブジェクトのコレクションを取得します。
スレッドを一覧表示する conversationThread コレクション グループのすべてのスレッドを取得します。
acceptedSenders を一覧表示する directoryObject コレクション このグループの acceptedSenders リストに含まれるユーザーまたはグループの一覧を取得します。
acceptedSender を追加する directoryObject acceptSenders コレ��ションにユーザーまたはグループを追加します。
acceptedSender を削除する directoryObject acceptedSenders コレクションからユーザーまたはグループを削除します。
rejectedSender を追加する directoryObject rejectedSender コレクションに新しいユーザーまたはグループを追加します。
rejectedSenders を一覧表示する directoryObject コレクション このグループの rejectedSenders リストに含まれるユーザーまたはグループの一覧を取得します。
rejectedSender を削除する directoryObject rejectedSender コレクションから新しいユーザーまたはグループを削除します。
addFavorite なし 現在のユーザーのお気に入りのグループ一覧にグループを追加します。Office 365 のグループのみをサポートします。
removeFavorite なし 現在のユーザーのお気に入りのグループ一覧からグループを削除します。Office 365 のグループのみをサポートします。
subscribeByMail なし isSubscribedByMail プロパティを true に設定します。現在のユーザーが電子メールの会話を受信できるようにします。Office 365 のグループのみをサポートします。
unsubscribeByMail なし isSubscribedByMail プロパティを false に設定します。現在のユーザーに対して電子メールでの会話の受信を無効にします。Office 365 のグループのみをサポートします。
resetUnseenCount なし 現在のユーザーが最後の訪問以降見ていない、すべての投稿の unseenCount を 0 にリセットします。Office 365 のグループのみをサポートします。

プロパティ

プロパティ 説明
allowExternalSenders Boolean 既定値は false です。組織外部のユーザーがグループにメッセージを送信できるかどうかを示します。
autoSubscribeNewMembers Boolean 既定値は false です。グループに追加された新しいメンバーが、電子メールの通知を受信するように自動的にサブスクライブされるかどうかを示します。グループの PATCH 要求でこのプロパティを設定できます。グループを作成する最初の POST 要求では設定しないでください。
description String グループに関するオプションの説明。
displayName String グループの表示名。このプロパティは、グループの作成時の必須プロパティであり、更新時にクリアすることはできません。$filter および $orderby をサポートします。
groupTypes String collection 作成するグループの種類を指定します。使用可能な値は Unified (Office 365 のグループを作成する場合) または DynamicMembership (動的なグループを作成する場合) です。その他のグループの種類 (セキュリティが有効なグループやメールが有効なセキュリティ グループなど) の場合、このプロパティは設定しないでください。$filter をサポートします。
id String グループの一意の識別子。directoryObject から継承されます。キー。null 許容ではありません。読み取り専用です。
isSubscribedByMail Boolean 既定値は true です。現在のユーザーが電子メールの会話を受信するように登録されているかどうかを示します。
メール String グループの SMTP アドレス (たとえば、"Serviceadmins@contoso.onmicrosoft.com")。読み取り専用です。$filter をサポートします。
mailEnabled Boolean メールが有効なグループであるかどうかを指定します。securityEnabled プロパティも true の場合、グループはメールが有効なセキュリティ グループになります。それ以外の場合は、Microsoft Exchange 配布グループになります。
mailNickname String グループの電子メール エイリアス。このプロパティは、グループの作成時に指定する必要があります。$filter をサポートします。
onPremisesLastSyncDateTime DateTimeOffset グループがオンプレミスのディレクトリと最後に同期した日時を示します。Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、必ず UTC 時間です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'読み取り専用です。$filter をサポートします。
onPremisesSecurityIdentifier String オンプレミスからクラウドに同期されたグループのオンプレミスのセキュリティ識別子 (SID) が含まれます。読み取り専用です。
onPremisesSyncEnabled Boolean このグループがオンプレミスのディレクトリから同期される場合は true、このグループが最初にオンプレミスのディレクトリから同期されていて、今後は同期しない場合は false、このオブジェクトがオンプレミスのディレクトリから一度も同期されたことがない場合は null。読み取り専用です。$filter をサポートします。
proxyAddresses String collection 複数値プロパティのフィルター式には any 演算子が必要です。読み取り専用です。null 許容ではありません。$filter をサポートします。
securityEnabled Boolean グループがセキュリティ グループであるかどうかを指定します。mailEnabled プロパティも true の場合、グループはメールが有効なセキュリティ グループになります。それ以外の場合は、セキュリティ グループになります。Office 365 グループの場合、false にする必要があります。$filter をサポートします。
unseenCount Int32 現在のユーザーの最後のアクセス以降の投稿の非表示カウントです。
visibility String Office 365 グループの表示を指定します。使用可能な値は次のとおりです。PrivatePublic、または空 (Public として解釈されます)。

リレーションシップ

リレーションシップ 説明
acceptedSenders directoryObject コレクション このグループで投稿または予定表のイベントを作成することが許可されているユーザーまたはグループの一覧。この一覧が空でない場合、ここに記載されているユーザーまたはグループだけが投稿を許可されます。
予定表 calendar グループの予定表。読み取り専用です。
calendarView event コレクション 予定表のカレンダー ビュー。読み取り専用です。
conversations conversation コレクション グループの会話。
createdOnBehalfOf directoryObject グループを作成したユーザー (またはアプリケーション)。注: ユーザーが管理者である場合、これは設定されません。読み取り専用です。
ドライブ drive グループのドライブ。読み取り専用です。
events event コレクション グループの予定表イベント。
memberOf directoryObject コレクション このグループがメンバーとして含まれているグループ。HTTP メソッド:GET (すべてのグループでサポートされます)。読み取り専用です。Null 許容型。
members directoryObject コレクション このグループのメンバーであるユーザーとグループ。HTTP メソッド:GET (すべてのグループでサポートされます)、POST (Office 365 グループ、セキュリティ グループ、およびメールが有効なセキュリティ グループでサポートされます)、DELETE (Office 365 グループとセキュリティ グループでサポートされます)。Null 許容型。
owners directoryObject コレクション グループの所有者。所有者は、このオブジェクトの変更を許可されている管理者以外のユーザーです。10 人の所有者に制限されます。HTTP メソッド:GET (すべてのグループでサポートされます)、POST (Office 365 グループ、セキュリティ グループ、およびメールが有効なセキュリティ グループでサポートされます)、DELETE (Office 365 グループとセキュリティ グループでサポートされます)。Null 許容型。
写真 profilePhoto グループのプロフィール写真
rejectedSenders directoryObject コレクション このグループで投稿またはカレンダーのイベントを作成することが許可されていないグループの一覧。Null 許容型
スレッド conversationThread コレクション グループの会話スレッド。Null 許容型。

JSON 表記

以下は、リソースの JSON 表記です

{
  "allowExternalSenders": false,
  "autoSubscribeNewMembers": true,
  "description": "string",
  "displayName": "string",
  "groupTypes": ["string"],
  "id": "string (identifier)",
  "isSubscribedByMail": true,
  "mail": "string",
  "mailEnabled": true,
  "mailNickname": "string",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesSecurityIdentifier": "string",
  "onPremisesSyncEnabled": true,
  "proxyAddresses": ["string"],
  "securityEnabled": true,
  "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" } ],
  "owners": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "photo": { "@odata.type": "microsoft.graph.profilePhoto" },
  "rejectedSenders": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "threads": [ { "@odata.type": "microsoft.graph.conversationThread" }]
}