user: getMemberGroups

ユーザーがメンバーであるすべてのグループを返します。チェックは推移的であり、ユーザーが直接メンバーであるグループのみを返す memberOf ナビゲーション プロパティの読み取りとは異なります。

この関数は、Office 365 と Azure AD でプロビジョニングされた他の種類のグループをサポートしています。各要求を返すことができるグループの最大数は 2046 です。Office 365 グループにグループを含めることはできません。そのため、Office 365 グループのメンバーシップは常にダイレクト メンバーシップです。

前提条件

この API を実行するには、以下のいずれかのスコープが必要です。User.Read または User.ReadBasic.All および Group.Read.All; Directory.Read.All; Directory.ReadWrite.All; Directory.AccessAsUser.All

HTTP 要求

POST /users/{id | userPrincipalName}/getMemberGroups

要求ヘッダー

ヘッダー
Authorization Bearer . Required.
Content-Type application/json

要求本文

要求本文で、次のパラメーターを含む JSON オブジェクトを指定します。

パラメーター 説明
securityEnabledOnly Boolean ユーザーがメンバーであるセキュリティ グループのみを返すように指定するには true、ユーザーがメンバーであるすべてのグループとディレクトリ ロールを返すように指定するには false を設定します。注:このパラメーターの true 設定は、ユーザーに対してこのメソッドを呼び出したときにのみサポートされています。

応答

成功した場合、このメソッドはユーザーがメンバーであるグループの ID を含んだ応答本文で 200, OK 応答コードと文字列コレクションを返します。

以下は、この API を呼び出す方法の例です。

要求

以下は、要求の例です。

POST https://graph.microsoft.com/v1.0/me/getMemberGroups
Content-type: application/json
Content-length: 33

{
  "securityEnabledOnly": true
}
応答

以下は、応答の例です。注:簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。すべてのプロパティは実際の呼び出しから返されます。

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 39

{
  "value": [
    "string-value"
  ]
}