Updates from: 06/26/2021 03:15:55
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Driveitem List Permissions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/driveitem-list-permissions.md
Effective sharing permissions of a DriveItem can come from two sources:
Callers can differentiate if the permission is inherited or not by checking the **inheritedFrom** property. This property is an [**itemReference**](../resources/itemreference.md) resource referencing the ancestor that the permission is inherited from.
-SharePoint permission levels set on an item are returned with an 'SP' prefix. For example, SP.View Only, SP.Limited Access, SP.View Web Analytics Data. See [Full list of SharePoint roles](/SharePoint/sites/user-permissions-and-permission-levels#section1).
- ## Example This example retrieves the collection of permissions on an item in the signed in user's drive.
v1.0 Group List Transitivemembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-list-transitivemembers.md
One of the following permissions is required to call this API. To learn more, in
| Delegated (personal Microsoft account) | Not supported. | | Application | GroupMember.Read.All, Group.Read.All, GroupMember.ReadWrite.All, Group.ReadWrite.All, Directory.Read.All |
-> **Note:** To list the members of a hidden membership group, the Member.Read.Hidden permission is required.
+> **Note:** To list the members of a hidden membership group, the *Member.Read.Hidden* permission is required.
[!INCLUDE [limited-info](../../includes/limited-info.md)]
GET /groups/{id}/transitiveMembers
## Optional query parameters
-This method supports the [OData query parameters](/graph/query_parameters) to help customize the response, including `$search`, `$count`, and `$filter`. You can use `$search` on the **displayName** property. When items are added or updated for this resource, they are specially indexed for use with the `$count` and `$search` query parameters. There can be a slight delay between when an item is added or updated and when it is available in the index.
+This method supports the [OData query parameters](/graph/query-parameters) to help customize the response, including `$search`, `$count`, and `$filter`. You can use `$search` on the **displayName** and **description** properties. When items are added or updated for this resource, they are specially indexed for use with the `$count` and `$search` query parameters. There can be a slight delay between when an item is added or updated and when it is available in the index.
+
+To filter the results on the OData type, such as `microsoft.graph.user` or `microsoft.graph.group`, you must use the [advanced query parameters](/graph/aad-advanced-queries). That is, the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string.
## Request headers
Content-type: application/json
The following is an example of the request. <!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_group_transitivemembers_count" }-->
ConsistencyLevel: eventual
#### Response The following is an example of the response.
->**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.directoryObject",
- "isCollection": true
} --> ```http HTTP/1.1 200 OK Content-type: text/plain+
+```
+
+`893`
++
+### Example 3: Use the microsoft.graph.group OData cast to get only members that are groups
+
+#### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_group_transitivemembers_odataCast"
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/groups/{id}/transitivemembers/microsoft.graph.group?$count=true
+ConsistencyLevel: eventual
```
-893
+#### Response
+
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.group",
+ "isCollection": true
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#groups",
+ "@odata.count": 2,
+ "value": [
+ {
+ "@odata.id": "https://graph.microsoft.com/v2/927c6607-8060-4f4a-a5f8-34964ac78d70/directoryObjects/4d0ef681-e88f-42a3-a2db-e6bf1e249e10/Microsoft.DirectoryServices.Group",
+ "id": "4d0ef681-e88f-42a3-a2db-e6bf1e249e10",
+ "organizationId": "927c6607-8060-4f4a-a5f8-34964ac78d70",
+ "description": null,
+ "displayName": "Executives",
+ "groupTypes": [],
+ "mail": "Executives@contoso.com",
+ "mailEnabled": true,
+ "mailNickname": "Executives",
+ },
+ {
+ "@odata.id": "https://graph.microsoft.com/v2/927c6607-8060-4f4a-a5f8-34964ac78d70/directoryObjects/d9fb0c47-c783-40a1-bce1-53b52ada51fc/Microsoft.DirectoryServices.Group",
+ "id": "d9fb0c47-c783-40a1-bce1-53b52ada51fc",
+ "organizationId": "927c6607-8060-4f4a-a5f8-34964ac78d70",
+ "displayName": "Project Falcon",
+ "groupTypes": [],
+ "mail": "Falcon@contoso.com",
+ "mailEnabled": true,
+ "mailNickname": "Falcon",
+ }
+ ]
+}
+```
-### Example 3: Use OData cast and $search to get membership in groups with display names that contain the letters 'tier' including a count of returned objects
+### Example 4: Use OData cast and $search to get membership in groups with display names that contain the letters 'tier' including a count of returned objects
#### Request The following is an example of the request. <!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_tier_count" }--> ```msgraph-interactive
Content-type: application/json
} ```
-### Example 4: Use OData cast and $filter to get user membership in groups with a display name that starts with 'A' including a count of returned objects
+### Example 5: Use OData cast and $filter to get user membership in groups with a display name that starts with 'A' including a count of returned objects
#### Request The following is an example of the request. <!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_a_count" }-->
v1.0 Orgcontact Get Transitivereports https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/orgcontact-get-transitivereports.md
+
+ Title: "Get transitiveReports for orgContact"
+description: "Get the count of transitive reports for an organizational contact."
+
+localization_priority: Normal
++
+# Get transitiveReports for orgContact
+
+Namespace: microsoft.graph
++
+Retrieve a count of transitive reports for an organizational contact.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
++
+| Permission type | Permissions (from least to most privileged) |
+|:--|:|
+| Delegated (work or school account) | OrgContact.Read, OrgContact.Read.All, Directory.Read.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | OrgContact.Read, OrgContact.Read.All, Directory.Read.All |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+```http
+GET /contacts/{id}/transitiveReports/$count
+```
+
+## Optional query parameters
+
+This method does not support the use of query parameters, but does require the `$count` query segment.
+
+## Request headers
+
+| Header | Value |
+|:|:--|
+| Authorization | Bearer {token}. Required. |
+| ConsistencyLevel | eventual. Required. |
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a count of transitive reports for an organizational contact in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_transitivereports"
+}-->
+```http
+GET https://graph.microsoft.com/beta/contacts/45b7d2e7-b882-4a80-ba97-10b7a63b8fa4/transitiveReports/$count
+```
+
+### Response
+
+The following is an example of the response.
+<!-- {
+ "blockType": "response"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: text/plain
+```
+
+5
+
+<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
+2015-10-25 14:57:30 UTC -->
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Get transitiveReports",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": [
+ ]
+}
+-->
v1.0 Permission Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/permission-get.md
description: "Return the effective sharing permission for a particular permission resource." Last updated 09/10/2017 Title: Get permissions
+ Title: Get permission
localization_priority: Normal doc_type: apiPageType ms.prod: ""
Effective permissions of an item can come from two sources: permissions set dire
Callers can differentiate if the permission is inherited or not by checking the `inheritedFrom` property. This property is an [ItemReference](../resources/itemreference.md) resource referencing the ancestor that the permission is inherited from.
-SharePoint permission levels set on an item are returned with an 'SP' prefix. For example, SP.View Only, SP.Limited Access, SP.View Web Analytics Data. See [Full list of SharePoint roles](/SharePoint/sites/user-permissions-and-permission-levels#section1).
- ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Serviceannouncement List Healthoverviews https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceannouncement-list-healthoverviews.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:| |Delegated (work or school account)|ServiceHealth.Read.All|
-|Delegated (personal Microsoft account)|ServiceHealth.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
|Application|ServiceHealth.Read.All| ## HTTP request
v1.0 Serviceannouncement List Issues https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceannouncement-list-issues.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:| |Delegated (work or school account)|ServiceHealth.Read.All|
-|Delegated (personal Microsoft account)|ServiceHealth.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
|Application|ServiceHealth.Read.All| ## HTTP request
v1.0 Serviceannouncement List Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceannouncement-list-messages.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:| |Delegated (work or school account)|ServiceMessage.Read.All|
-|Delegated (personal Microsoft account)|ServiceMessage.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
|Application|ServiceMessage.Read.All| ## HTTP request
v1.0 Servicehealth Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/servicehealth-get.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:| |Delegated (work or school account)|ServiceHealth.Read.All|
-|Delegated (personal Microsoft account)|ServiceHealth.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
|Application|ServiceHealth.Read.All| ## HTTP request
v1.0 Servicehealthissue Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/servicehealthissue-get.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:| |Delegated (work or school account)|ServiceHealth.Read.All|
-|Delegated (personal Microsoft account)|ServiceHealth.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
|Application|ServiceHealth.Read.All| ## HTTP request
v1.0 Servicehealthissue Incidentreport https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/servicehealthissue-incidentreport.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:| |Delegated (work or school account)|ServiceHealth.Read.All|
-|Delegated (personal Microsoft account)|ServiceHealth.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
|Application|ServiceHealth.Read.All| ## HTTP request
v1.0 Serviceupdatemessage Archive https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceupdatemessage-archive.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:| |Delegated (work or school account)|ServiceMessageViewpoint.Write|
-|Delegated (personal Microsoft account)|ServiceMessageViewpoint.Write|
+|Delegated (personal Microsoft account)|Not supported.|
|Application|Not supported| ## HTTP request
v1.0 Serviceupdatemessage Favorite https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceupdatemessage-favorite.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:| |Delegated (work or school account)|ServiceMessageViewpoint.Write|
-|Delegated (personal Microsoft account)|ServiceMessageViewpoint.Write|
-|Application|Not supported|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
## HTTP request
v1.0 Serviceupdatemessage Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceupdatemessage-get.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:| |Delegated (work or school account)|ServiceMessage.Read.All|
-|Delegated (personal Microsoft account)|ServiceMessage.Read.All|
+|Delegated (personal Microsoft account)|Not supported.|
|Application|ServiceMessage.Read.All| ## HTTP request
v1.0 Serviceupdatemessage Markread https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceupdatemessage-markread.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:| |Delegated (work or school account)|ServiceMessageViewpoint.Write|
-|Delegated (personal Microsoft account)|ServiceMessageViewpoint.Write|
+|Delegated (personal Microsoft account)|Not supported.|
|Application|Not supported| ## HTTP request
v1.0 Serviceupdatemessage Markunread https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceupdatemessage-markunread.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:| |Delegated (work or school account)|ServiceMessageViewpoint.Write|
-|Delegated (personal Microsoft account)|ServiceMessageViewpoint.Write|
+|Delegated (personal Microsoft account)|Not supported.|
|Application|Not supported| ## HTTP request
v1.0 Serviceupdatemessage Unarchive https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceupdatemessage-unarchive.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:| |Delegated (work or school account)|ServiceMessageViewpoint.Write|
-|Delegated (personal Microsoft account)|ServiceMessageViewpoint.Write|
+|Delegated (personal Microsoft account)|Not supported.|
|Application|Not supported| ## HTTP request
v1.0 Serviceupdatemessage Unfavorite https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceupdatemessage-unfavorite.md
One of the following permissions is required to call this API. To learn more, in
|Permission type|Permissions (from least to most privileged)| |:|:| |Delegated (work or school account)|ServiceMessageViewpoint.Write|
-|Delegated (personal Microsoft account)|ServiceMessageViewpoint.Write|
+|Delegated (personal Microsoft account)|Not supported.|
|Application|Not supported| ## HTTP request
v1.0 User Get Transitivereports https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-get-transitivereports.md
+
+ Title: "Get transitiveReports for a user"
+description: "Get the count of transitive reports for a user."
+
+localization_priority: Normal
++
+# Get transitiveReports for a user
+
+Namespace: microsoft.graph
++
+Retrieve a count of transitive reports for a user.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
++
+| Permission type | Permissions (from least to most privileged) |
+|:--|:|
+| Delegated (work or school account) | User.Read, User.Read.All, Directory.Read.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | User.Read, User.Read.All, Directory.Read.All |
+
+## HTTP request
+<!-- { "blockType": "ignored" } -->
+```http
+GET /users/{id}/transitiveReports/$count
+```
+## Optional query parameters
+
+This method supports the `$filter` query parameter for only the **accountEnabled** property. For more information about using query parameters, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+
+| Header | Value |
+|:|:--|
+| Authorization | Bearer {token}. Required. |
+| ConsistencyLevel | eventual. Required. |
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a count of transitive reports for the user in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of the request. The `$count` query segment is required.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_transitivereports_user"
+}-->
+```http
+GET https://graph.microsoft.com/beta/users/45b7d2e7-b882-4a80-ba97-10b7a63b8fa4/transitiveReports/$count
+```
+
+### Response
+
+The following is an example of the response.
+<!-- {
+ "blockType": "response"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: text/plain
+```
+
+5
+
+<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
+2015-10-25 14:57:30 UTC -->
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Get transitiveReports for a user",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": "",
+ "suppressions": [
+ ]
+}
+-->
v1.0 Windowsupdates Deploymentaudience List Exclusions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-deploymentaudience-list-exclusions.md
Content-Type: application/json
{ "value": [
- {
- "@odata.type": "#microsoft.graph.windowsUpdates.updatableAssetGroup",
- "id": "f5ba7065-7065-f5ba-6570-baf56570baf5"
- },
{ "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice", "id": "fb95f07d-9e73-411d-99ab-7eca3a5122b1",
v1.0 Windowsupdates Deploymentaudience List Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-deploymentaudience-list-members.md
Content-Type: application/json
{ "value": [
- {
- "@odata.type": "#microsoft.graph.windowsUpdates.updatableAssetGroup",
- "id": "f5ba7065-7065-f5ba-6570-baf56570baf5"
- },
{ "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice", "id": "fb95f07d-9e73-411d-99ab-7eca3a5122b1",
v1.0 Windowsupdates Updates List Updatableassets https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/windowsupdates-updates-list-updatableassets.md
Content-Type: application/json
{ "value": [
- {
- "@odata.type": "#microsoft.graph.windowsUpdates.updatableAssetGroup",
- "id": "5c55730b-730b-5c55-0b73-555c0b73555c"
- },
{ "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice", "id": "983f03cd-03cd-983f-cd03-3f98cd033f98",
v1.0 Orgcontact https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/orgcontact.md
This resource supports using [delta query](/graph/delta-query-overview) to track
| [List organizational contacts](../api/orgcontact-list.md) | [orgContact](orgcontact.md) collection | List properties of organizational contacts. | | [Get organizational contact](../api/orgcontact-get.md) | [orgContact](orgcontact.md) | Read properties and relationships of orgContact object. | | [Get manager](../api/orgcontact-get-manager.md) | [directoryObject](directoryobject.md) | Get the contact's manager. |
+| [Get transitiveReports](../api/orgcontact-get-transitivereports.md) | Integer | Get the count of transitive reports for an organization contact from the transitiveReports navigation property. |
| [List directReports](../api/orgcontact-list-directreports.md) | [directoryObject](directoryobject.md) collection | List the contact's direct reports. | | [List memberOf](../api/orgcontact-list-memberof.md) | [directoryObject](directoryobject.md) collection | Get a memberOf object collection. | | [checkMemberGroups](../api/orgcontact-checkmembergroups.md) | String collection | Check for group membership. |
This resource supports using [delta query](/graph/delta-query-overview) to track
| directReports | [directoryObject](directoryobject.md) collection | The contact's direct reports. (The users and contacts that have their manager property set to this contact.) Read-only. Nullable. | | manager | [directoryObject](directoryobject.md) | The user or contact that is this contact's manager. Read-only. | | memberOf | [directoryObject](directoryobject.md) collection | Groups that this contact is a member of. Read-only. Nullable. |
+| transitiveReports | [directoryObject](directoryobject.md) collection | The transitive reports for a contact. Read-only. |
## JSON representation
v1.0 User https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/user.md
This resource supports:
| [getByIds](../api/directoryobject-getbyids.md) | String collection | Returns the directory objects specified in a list of ids. | | [getMemberGroups](../api/user-getmembergroups.md) | String collection | Return all the groups that the user is a member of. The check is transitive. | | [getMemberObjects](../api/user-getmemberobjects.md) | String collection | Return all the groups, directory roles, and administrative units that the user is a member of. The check is transitive. |
+| [Get transitiveReports](../api/user-get-transitivereports.md) | Integer | Get the count of transitive reports for a user from the transitiveReports navigation property. |
| [List createdObjects](../api/user-list-createdobjects.md) | [directoryObject](directoryobject.md) collection | Get the directory objects created by the user from the createdObjects navigation property. | | [List licenseDetails](../api/user-list-licensedetails.md) | [licenseDetails](licensedetails.md) collection | Get a licenseDetails object collection. | | [List ownedDevices](../api/user-list-owneddevices.md) | [directoryObject](directoryobject.md) collection | Get the devices that are owned by the user from the ownedDevices navigation property. |
Hence the type of the corresponding 3 properties remain as string type in the Pr
|settings|[userSettings](usersettings.md) | Read-only. Nullable.| |teamwork|[userTeamwork](userteamwork.md)| A container for Microsoft Teams features available for the user. Read-only. Nullable.| |todo|[todo](todo.md)|Represents the To Do services available to a user. |
+|transitiveReports|[directoryObject](directoryobject.md) collection | The transitive reports for a user. Read-only.|
|usageRight|[usageRight](usageright.md) collection|Represents the usage rights a user has been granted. | ### User preferences for languages and regional formats
v1.0 Driveitem List Permissions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/driveitem-list-permissions.md
Effective sharing permissions of a DriveItem can come from two sources:
Callers can differentiate if the permission is inherited or not by checking the **inheritedFrom** property. This property is an [**itemReference**](../resources/itemreference.md) resource referencing the ancestor that the permission is inherited from.
-SharePoint permission levels set on an item are returned with an 'SP' prefix. For example, SP.View Only, SP.Limited Access, SP.View Web Analytics Data. See [Full list of SharePoint roles](/SharePoint/sites/user-permissions-and-permission-levels#section1).
- ## Example This example retrieves the collection of permissions on an item in the signed in user's drive.
v1.0 Group List Transitivemembers https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-list-transitivemembers.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | GroupMember.Read.All, Group.Read.All, GroupMember.ReadWrite.All, Group.ReadWrite.All, Directory.Read.All |
->**Note:** To list the members of a hidden membership group, the Member.Read.Hidden permission is required.
+>**Note:** To list the members of a hidden membership group, the *Member.Read.Hidden* permission is required.
[!INCLUDE [limited-info](../../includes/limited-info.md)]
GET /groups/{id}/transitiveMembers
This method supports the [OData query parameters](/graph/query-parameters) to help customize the response, including `$search`, `$count`, and `$filter`. You can use `$search` on the **displayName** and **description** properties. When items are added or updated for this resource, they are specially indexed for use with the `$count` and `$search` query parameters. There can be a slight delay between when an item is added or updated and when it is available in the index.
+To filter the results on the OData type, such as `microsoft.graph.user` or `microsoft.graph.group`, you must use the [advanced query parameters](/graph/aad-advanced-queries). That is, the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string.
+ ## Request headers | Name | Description |
Content-type: application/json
The following is an example of the request. <!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_group_transitivemembers_count" }-->
The following is an example of the response.
```http HTTP/1.1 200 OK Content-type: text/plain+ ``` `893`
-### Example 3: Use OData cast and $search to get membership in groups with display names that contain the letters 'tier' including a count of returned objects
+### Example 3: Use the microsoft.graph.group OData cast to get only members that are groups
#### Request The following is an example of the request. <!-- {
- "blockType": "ignored",
+ "blockType": "request",
+ "name": "get_group_transitivemembers_odataCast"
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/v1.0/groups/{id}/transitivemembers/microsoft.graph.group?$count=true
+ConsistencyLevel: eventual
+```
+
+#### Response
+
+The following is an example of the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.group",
+ "isCollection": true
+} -->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groups",
+ "@odata.count": 2,
+ "value": [
+ {
+ "@odata.id": "https://graph.microsoft.com/v2/927c6607-8060-4f4a-a5f8-34964ac78d70/directoryObjects/4d0ef681-e88f-42a3-a2db-e6bf1e249e10/Microsoft.DirectoryServices.Group",
+ "id": "4d0ef681-e88f-42a3-a2db-e6bf1e249e10",
+ "organizationId": "927c6607-8060-4f4a-a5f8-34964ac78d70",
+ "description": null,
+ "displayName": "Executives",
+ "groupTypes": [],
+ "mail": "Executives@contoso.com",
+ "mailEnabled": true,
+ "mailNickname": "Executives",
+ },
+ {
+ "@odata.id": "https://graph.microsoft.com/v2/927c6607-8060-4f4a-a5f8-34964ac78d70/directoryObjects/d9fb0c47-c783-40a1-bce1-53b52ada51fc/Microsoft.DirectoryServices.Group",
+ "id": "d9fb0c47-c783-40a1-bce1-53b52ada51fc",
+ "organizationId": "927c6607-8060-4f4a-a5f8-34964ac78d70",
+ "displayName": "Project Falcon",
+ "groupTypes": [],
+ "mail": "Falcon@contoso.com",
+ "mailEnabled": true,
+ "mailNickname": "Falcon",
+ }
+ ]
+}
+```
+
+### Example 4: Use OData cast and $search to get membership in groups with display names that contain the letters 'tier' including a count of returned objects
+
+#### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
"name": "get_tier_count" }--> ```msgraph-interactive
Content-type: application/json
} ```
-### Example 4: Use OData cast and $filter to get user membership in groups with a display name that starts with 'A' including a count of returned objects
+
+### Example 5: Use OData cast and $filter to get user membership in groups with a display name that starts with 'A' including a count of returned objects
#### Request The following is an example of the request. <!-- {
- "blockType": "ignored",
+ "blockType": "request",
"name": "get_a_count" }-->
Content-type: application/json
] } ```+++ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!-- {
v1.0 Permission Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/permission-get.md
Last updated 09/10/2017 Title: Get permissions
+ Title: Get permission
localization_priority: Normal description: "Return the effective sharing permission for a particular permission resource." ms.prod: ""
Effective permissions of an item can come from two sources: permissions set dire
Callers can differentiate if the permission is inherited or not by checking the `inheritedFrom` property. This property is an [ItemReference](../resources/itemreference.md) resource referencing the ancestor that the permission is inherited from.
-SharePoint permission levels set on an item are returned with an 'SP' prefix. For example, SP.View Only, SP.Limited Access, SP.View Web Analytics Data. See [Full list of SharePoint roles](/SharePoint/sites/user-permissions-and-permission-levels#section1).
- ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).