Skip to content

Commit 0d8cd87

Browse files
committed
Merge branch 'tl-width-height-format-api' of https://github.com/microsoftgraph/microsoft-graph-docs into tl-width-height-format-api
2 parents 877d74f + e81dda6 commit 0d8cd87

24 files changed

Lines changed: 223 additions & 75 deletions

File tree

api-reference/beta/api/activities-list.md renamed to api-reference/beta/api/itemactivity-list.md

Lines changed: 9 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,20 @@
11
---
22
author: daspek
33
title: List activities
4-
description: "List the recent activities that took place on an item or under a hierarchy."
4+
description: "List the recent activities that took place on a drive, list, item, or within an item hierarchy."
55
ms.localizationpriority: medium
66
doc_type: apiPageType
77
ms.subservice: onedrive
88
ms.date: 04/04/2024
99
---
10-
# List activities (preview)
10+
# List activities
1111

1212
Namespace: microsoft.graph
1313

1414
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
1515

16-
List the recent [activities](../resources/itemactivity.md) that took place on an item or under a hierarchy.
16+
List the recent [activities](../resources/itemactivity.md) that took place on a [drive](../resources/drive.md), [list](../resources/list.md), item, or within an item hierarchy.
1717

18-
>**Note:** Activities is in a limited preview and is not yet available to all tenants.
1918

2019
[activities]: ../resources/itemactivity.md
2120

@@ -25,8 +24,8 @@ List the recent [activities](../resources/itemactivity.md) that took place on an
2524

2625
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
2726

28-
<!-- { "blockType": "permissions", "name": "activities_list" } -->
29-
[!INCLUDE [permissions-table](../includes/permissions/activities-list-permissions.md)]
27+
<!-- { "blockType": "permissions", "name": "itemactivity_list" } -->
28+
[!INCLUDE [permissions-table](../includes/permissions/itemactivity-list-permissions.md)]
3029

3130
## HTTP request
3231

@@ -39,48 +38,21 @@ GET /sites/{site-id}/lists/{list-id}/activities
3938
GET /sites/{site-id}/lists/{list-id}/items/{item-id}/activities
4039
```
4140

41+
## Optional query parameters
42+
43+
This method doesn't support [OData query parameters](/graph/query-parameters) to customize the response.
44+
4245
## Example
4346

4447
### Request
4548

4649

47-
# [HTTP](#tab/http)
4850
<!-- { "blockType": "request", "name": "list-activities" } -->
4951

5052
```msgraph-interactive
5153
GET https://graph.microsoft.com/beta/me/drive/activities
5254
```
5355

54-
# [C#](#tab/csharp)
55-
[!INCLUDE [sample-code](../includes/snippets/csharp/list-activities-csharp-snippets.md)]
56-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
57-
58-
# [Go](#tab/go)
59-
[!INCLUDE [sample-code](../includes/snippets/go/list-activities-go-snippets.md)]
60-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
61-
62-
# [Java](#tab/java)
63-
[!INCLUDE [sample-code](../includes/snippets/java/list-activities-java-snippets.md)]
64-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
65-
66-
# [JavaScript](#tab/javascript)
67-
[!INCLUDE [sample-code](../includes/snippets/javascript/list-activities-javascript-snippets.md)]
68-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
69-
70-
# [PHP](#tab/php)
71-
[!INCLUDE [sample-code](../includes/snippets/php/list-activities-php-snippets.md)]
72-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
73-
74-
# [PowerShell](#tab/powershell)
75-
[!INCLUDE [sample-code](../includes/snippets/powershell/list-activities-powershell-snippets.md)]
76-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
77-
78-
# [Python](#tab/python)
79-
[!INCLUDE [sample-code](../includes/snippets/python/list-activities-python-snippets.md)]
80-
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
81-
82-
---
83-
8456
### Response
8557

8658
<!-- { "blockType": "response", "@type": "Collection(microsoft.graph.itemActivity)", "truncated": true } -->

api-reference/beta/includes/permissions/activities-list-permissions.md renamed to api-reference/beta/includes/permissions/itemactivity-list-permissions.md

File renamed without changes.

api-reference/beta/resources/drive.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ Users without a OneDrive license may not have a default drive available.
2525
| [List drive][drive-list] | drive collection |Retrieve the list of drive resources available for a target user, group, or site.|
2626
| [Get drive][drive-get] | drive | Get metadata about a drive.|
2727
| [Get drive root][item-get] | [driveItem][] | Get root folder of a drive.|
28-
| [List activities][drive-activities] | [itemActivity][] collection | List activities that occurred under the drive.|
28+
| [List activities][drive-activities] | [itemActivity][] collection | List the recent [activities](../resources/itemactivity.md) that took place on a [drive](../resources/drive.md), [list](../resources/list.md), item, or within an item hierarchy. |
2929
| [List followed items][drive-following] | [driveItem][] collection | List the user's followed driveItems.|
3030
| [List children][item-children] | [driveItem][] collection | List children of the root folder of a drive.|
3131
| [List changes][item-changes] | [driveItem][] collection | List changes for all driveItems in the drive.|
@@ -129,7 +129,7 @@ The **drive** resource is derived from [**baseItem**](baseitem.md) and inherits
129129
[list]: list.md
130130
[quota-facet]: quota.md
131131
[drive-resource]: drive.md
132-
[drive-activities]: ../api/activities-list.md
132+
[drive-activities]: ../api/itemactivity-list.md
133133
[drive-following]: ../api/drive-list-following.md
134134
[drive-get]: ../api/drive-get.md
135135
[drive-list]: ../api/drive-list.md

api-reference/beta/resources/driveitem.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,7 @@ Items with the **folder** facet act as containers of items and therefore have a
4545
| [Get item](../api/driveitem-get.md) | [driveItem](../resources/driveitem.md) |Retrieve the metadata for a **driveItem** in a drive.|
4646
| [Get analytics][] | [itemAnalytics][] | Get analytics for this resource.|
4747
| [Get activities by interval][] | [itemActivityStat](../resources/itemactivitystat.md) | Get a collection of **itemActivityStats** within the specified time interval.|
48+
| [Get recent activities](../api/itemactivity-list.md) | [itemActivity](../resources/itemactivity.md) collection | List the recent [activities](../resources/itemactivity.md) that took place on a [drive](../resources/drive.md), [list](../resources/list.md), item, or within an item hierarchy. |
4849
| [List children](../api/driveitem-list-children.md) | [driveItem](../resources/driveitem.md) collection | Return a collection of **driveItems** in the children relationship of a **driveItem**.|
4950
| [List versions](../api/driveitem-list-versions.md) | [driveItemVersion][] collection | Retrieve the versions of a file in the current user's drive.|
5051
| [Create folder](../api/driveitem-post-children.md) | [driveItem](../resources/driveitem.md) | Create a **driveItem** in the specified drive.|
@@ -270,7 +271,6 @@ The **driveItem** resource is derived from [**baseItem**][baseItem] and inherits
270271
[itemReference]: itemreference.md
271272
[itemRetentionLabel]: itemretentionlabel.md
272273
[geoCoordinates]: geocoordinates.md
273-
[List activities]: ../api/activities-list.md
274274
[listItem]: listitem.md
275275
[malware]: malware.md
276276
[media]: media.md

api-reference/beta/resources/educationalactivitydetail.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -18,17 +18,17 @@ Represents more detail about an undergraduate, graduate, postgraduate degree, or
1818

1919
## Properties
2020

21-
| Property | Type | Description |
22-
|:-------------|:------------|:--------------------------------------------------------------|
23-
|abbreviation |String |Shortened name of the degree or program (example: PhD, MBA) |
24-
|activities |String |Extracurricular activities undertaken alongside the program. |
25-
|awards |String |Any awards or honors associated with the program. |
26-
|description |String |Short description of the program provided by the user. |
27-
|displayName |String |Long-form name of the program that the user provided. |
28-
|fieldsOfStudy |String |Majors and minors associated with the program. (if applicable) |
29-
|grade |String |The final grade, class, GPA, or score. |
30-
|notes |String |More notes the user provided. |
31-
|webUrl |String |Link to the degree or program page. |
21+
| Property | Type | Description |
22+
|:-------------|:-----------------|:--------------------------------------------------------------|
23+
|abbreviation |String |Shortened name of the degree or program, for example, `PhD` and `MBA`. |
24+
|activities |String collection |Extracurricular activities undertaken alongside the program. |
25+
|awards |String collection |Any awards or honors associated with the program. |
26+
|description |String |Short description of the program provided by the user. |
27+
|displayName |String |Long-form name of the program that the user provided. |
28+
|fieldsOfStudy |String collection |Majors and minors associated with the program, if applicable. |
29+
|grade |String |The final grade, class, grade point average (GPA), or score. |
30+
|notes |String |More notes provided by the user. |
31+
|webUrl |String |Link to the degree or program page. |
3232

3333
## JSON representation
3434

@@ -46,11 +46,11 @@ The following JSON representation shows the resource type.
4646
```json
4747
{
4848
"abbreviation": "String",
49-
"activities": "String",
50-
"awards": "String",
49+
"activities": ["String"],
50+
"awards": ["String"],
5151
"description": "String",
5252
"displayName": "String",
53-
"fieldsOfStudy": "String",
53+
"fieldsOfStudy": ["String"],
5454
"grade": "String",
5555
"notes": "String",
5656
"webUrl": "String"

api-reference/beta/resources/itemactivity.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,12 @@ Namespace: microsoft.graph
1717
Provides information about activities that took place on an item or within a container.
1818
Currently only available on SharePoint and OneDrive for Business.
1919

20+
## Methods
21+
22+
| Method | Return type | Description |
23+
|:-------|:------------|:------------|
24+
| [List activities](../api/itemactivity-list.md) | [itemActivity](itemactivity.md) collection | List the recent [activities](../resources/itemactivity.md) that took place on a [drive](../resources/drive.md), [list](../resources/list.md), item, or within an item hierarchy. |
25+
2026
## Properties
2127

2228
| Property | Type | Description |

api-reference/beta/resources/list.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ Represents a list in a [site](site.md). This resource contains the top level pro
2424
| [Get](../api/list-get.md) | [list](../resources/list.md) | Get the metadata for a **list**. |
2525
| [Get items](../api/listitem-list.md) | [listItem](../resources/listitem.md) collection | Get the collection of [listItems]( ../resources/listitem.md) in a **list**. |
2626
| [Get lists in a site](../api/list-list.md) | [list](../resources/list.md) collection | Get the collection of **lists** in a [site](site.md). |
27-
| [Get recent activities](../api/activities-list.md) | [itemActivity](../resources/itemactivity.md) collection | List the recent [activities](../resources/itemactivity.md) that took place on an item or under a hierarchy. |
27+
| [List activities](../api/itemactivity-list.md) | [itemActivity](../resources/itemactivity.md) collection | List the recent [activities](../resources/itemactivity.md) that took place on a [drive](../resources/drive.md), [list](../resources/list.md), item, or within an item hierarchy. |
2828
| [Create item](../api/listitem-create.md) | [listItem](../resources/listitem.md) | Create a new [listItem]( ../resources/listitem.md) in a **list**. |
2929
| [Update item](../api/listitem-update.md) | [listItem](../resources/listitem.md) | Update the properties on a [listItem]( ../resources/listitem.md). |
3030
| [Delete item](../api/listitem-delete.md) | None | Delete a [listItem]( ../resources/listitem.md) from a **list**. |

api-reference/beta/resources/listitem.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,7 @@ All examples are relative to a **[list][]**; for example, `https://graph.microso
3333
| [Update][] | [fieldValueSet][] | Update the properties on a listItem. |
3434
| [Delete][] | No Content | Removes an item from a list. |
3535
| [Get analytics][] | [itemAnalytics][] | Get analytics for this resource. |
36+
| [Get recent activities](../api/itemactivity-list.md) | [itemActivity](../resources/itemactivity.md) collection | List the recent [activities](../resources/itemactivity.md) that took place on a [drive](../resources/drive.md), [list](../resources/list.md), item, or within an item hierarchy. |
3637
| [Get column values][Get] | listItem | Get column values from listItem. |
3738
| [Update column values][Update] | [fieldValueSet][] | Update column values on a listItem. |
3839
| [List document set version](../api/listitem-list-documentsetversions.md) | [documentSetVersion][] collection | Get a list of the versions of a document set item in a list. |

api-reference/beta/toc/files/toc.yml

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ items:
1515
- name: Get drive root
1616
href: ../../api/driveitem-get.md
1717
- name: List activities
18-
href: ../../api/activities-list.md
18+
href: ../../api/itemactivity-list.md
1919
- name: List followed items
2020
href: ../../api/drive-list-following.md
2121
- name: List children
@@ -40,6 +40,8 @@ items:
4040
href: ../../api/itemanalytics-get.md
4141
- name: Get activities by interval
4242
href: ../../api/itemactivity-getbyinterval.md
43+
- name: Get recent activities
44+
href: ../../api/itemactivity-list.md
4345
- name: List children
4446
href: ../../api/driveitem-list-children.md
4547
- name: List versions

api-reference/beta/toc/reports/toc.yml

Lines changed: 4 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -348,26 +348,14 @@ items:
348348
href: ../../api/healthmonitoring-alertconfiguration-get.md
349349
- name: Update
350350
href: ../../api/healthmonitoring-alertconfiguration-update.md
351-
- name: Premium license utilization
351+
- name: Premium license utilization (preview)
352352
items:
353-
- name: Microsoft Entra premium license insight
353+
- name: Entra ID P1/P2 license utilization
354354
items:
355-
- name: Microsoft Entra premium license insight
355+
- name: Entra ID P1/P2 license utilization
356356
href: ../../resources/azureadpremiumlicenseinsight.md
357357
- name: Get
358358
href: ../../api/azureadpremiumlicenseinsight-get.md
359-
- name: Complex types
360-
items:
361-
- name: Internet access feature utilizations
362-
href: ../../resources/internetaccessfeatureutilizations.md
363-
- name: Microsoft Entra premium feature utilization
364-
href: ../../resources/azureadpremiumfeatureutilization.md
365-
- name: Microsoft Entra premium p 1 feature utilizations
366-
href: ../../resources/azureadpremiump1featureutilizations.md
367-
- name: Microsoft Entra premium p 2 feature utilizations
368-
href: ../../resources/azureadpremiump2featureutilizations.md
369-
- name: Private access feature utilizations
370-
href: ../../resources/privateaccessfeatureutilizations.md
371359
- name: Service principal sign-in activity (preview)
372360
items:
373361
- name: Service principal sign-in activity (preview)
@@ -376,7 +364,7 @@ items:
376364
href: ../../api/reportroot-list-serviceprincipalsigninactivities.md
377365
- name: Get
378366
href: ../../api/serviceprincipalsigninactivity-get.md
379-
- name: Microsoft Entra logs
367+
- name: Microsoft Entra logs and reports
380368
items:
381369
- name: Overview
382370
href: ../../resources/azure-ad-auditlog-overview.md

0 commit comments

Comments
 (0)