Updates from: 07/02/2021 03:08:00
Service Microsoft Docs article Related commit history on GitHub Change details
beta Drive Get Specialfolder https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/drive-get-specialfolder.md
description: "Use the special collection to access a special folder by name." Previously updated : 09/10/2017 Title: Get Special Folders localization_priority: Normal doc_type: apiPageType # Get a special folder by name
GET /me/drive/special/{name}
### Special folder names-
-The follow special folder names are available in OneDrive and OneDrive for Business.
-
-| Name | Folder id | Description |
-|:|:-|:-|
-| Documents | `documents` | The Documents folder. |
-| Photos | `photos` | The Photos folder. |
-| Camera Roll | `cameraroll` | The Camera Roll Backup folder. |
-| App Root | `approot` | The application's personal folder. Usually in `/Apps/{Application Name}` |
-| Music | `music` | The Music folder. |
### Optional query parameters
beta Driveitem Createuploadsession https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/driveitem-createuploadsession.md
description: "Create an upload session to allow your app to upload files up to the maximum file size." Previously updated : 09/10/2017 Title: Resumable file upload
+ Title: driveItem: createUploadSession
localization_priority: Normal doc_type: apiPageType
-# Upload large files with an upload session
+# driveItem: createUploadSession
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Create an upload session to allow your app to upload files up to the maximum file size.+ An upload session allows your app to upload ranges of the file in sequential API requests, which allows the transfer to be resumed if a connection is dropped while the upload is in progress.
-To upload a file using an upload session, there are two steps:
+To upload a file using an upload session:
1. [Create an upload session](#create-an-upload-session) 2. [Upload bytes to the upload session](#upload-bytes-to-the-upload-session)
For example, the `item` property allows setting the following parameters:
{ "@microsoft.graph.conflictBehavior": "fail (default) | replace | rename", "description": "description",
+ "driveItemSource": { "@odata.type": "microsoft.graph.driveItemSource" },
"fileSize": 1234,
- "name": "filename.txt"
+ "name": "filename.txt",
+ "mediaSource": { "@odata.type": "microsoft.graph.mediaSource" }
} ```
Content-Type: application/json
See the [Error Responses][error-response] topic for details about how errors are returned.
+[driveItemSource]: ../resources/driveItemSource.md
[error-response]: /graph/errors [item-resource]: ../resources/driveitem.md
+[mediaSource]: ../resources/mediaSource.md
<!-- {
beta Driveitem https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/driveitem.md
description: "The driveItem resource represents a file, folder, or other item stored in a drive." Previously updated : 09/10/2017 Title: DriveItem
+ Title: driveItem
localization_priority: Normal doc_type: resourcePageType
The **driveItem** resource is derived from [**baseItem**][baseItem] and inherits
"optionalProperties": ["cTag", "children", "folder", "file", "image", "audio", "video", "location", "deleted", "specialFolder", "photo", "thumbnails", "searchResult", "remoteItem", "shared", "content", "@microsoft.graph.conflictBehavior", "@microsoft.graph.downloadUrl", "@content.sourceUrl",
- "sharepointIds"],
+ "sharepointIds", "source", "media"],
"keyProperty": "id", "openType": true } --> ```json
The **driveItem** resource is derived from [**baseItem**][baseItem] and inherits
"folder": { "@odata.type": "microsoft.graph.folder" }, "image": { "@odata.type": "microsoft.graph.image" }, "location": { "@odata.type": "microsoft.graph.geoCoordinates" },
+ "media": { "@odata.type": "microsoft.graph.media" },
"package": { "@odata.type": "microsoft.graph.package" }, "pendingOperations": { "@odata.type": "microsoft.graph.pendingOperations" }, "photo": { "@odata.type": "microsoft.graph.photo" },
The **driveItem** resource is derived from [**baseItem**][baseItem] and inherits
"shared": { "@odata.type": "microsoft.graph.shared" }, "sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" }, "size": 1024,
+ "source": { "@odata.type": "microsoft.graph.driveItemSource" },
"specialFolder": { "@odata.type": "microsoft.graph.specialFolder" }, "video": { "@odata.type": "microsoft.graph.video" }, "webDavUrl": "string",
The **driveItem** resource is derived from [**baseItem**][baseItem] and inherits
| lastModifiedBy | [identitySet][] | Identity of the user, device, and application which last modified the item. Read-only. | lastModifiedDateTime | DateTimeOffset | Date and time the item was last modified. Read-only. | location | [geoCoordinates][] | Location metadata, if the item has location data. Read-only.
+| media | [media][] | Information about the media (audio or video) item. Read-write. Only on OneDrive for Business and SharePoint.
| name | String | The name of the item (filename and extension). Read-write. | package | [package][] | If present, indicates that this item is a package instead of a folder or file. Packages are treated like files in some contexts and folders in others. Read-only. | parentReference | [itemReference][] | Parent information, if the item has a parent. Read-write.
The **driveItem** resource is derived from [**baseItem**][baseItem] and inherits
| sharepointIds | [sharepointIds][] | Returns identifiers useful for SharePoint REST compatibility. Read-only. | size | Int64 | Size of the item in bytes. Read-only. | specialFolder | [specialFolder][] | If the current item is also available as a special folder, this facet is returned. Read-only.
+| source | [driveItemSource][]| Information about the drive item source. Read-only. Only on OneDrive for Business and SharePoint.
| video | [video][] | Video metadata, if the item is a video. Read-only. | webDavUrl | String | WebDAV compatible URL for the item. | webUrl | String | URL that displays the resource in the browser. Read-only.
In OneDrive for Business or SharePoint document libraries, the **cTag** property
[baseItem]: baseitem.md [deleted]: deleted.md [download-format]: ../api/driveitem-get-content-format.md
+[driveItemSource]: driveItemSource.md
[driveItemVersion]: driveitemversion.md [file]: file.md [fileSystemInfo]: filesysteminfo.md
In OneDrive for Business or SharePoint document libraries, the **cTag** property
[geoCoordinates]: geocoordinates.md [List activities]: ../api/activities-list.md [listItem]: listitem.md
+[media]: media.md
[package]: package.md [permission]: permission.md [pendingOperations]: pendingoperations.md
beta Driveitemsource https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/driveitemsource.md
++
+description: "The driveItemSource contains metadata about the source application that the drive item was created in."
+ Title: driveItemSource resource type
+localization_priority: Normal
+
+# driveItemSource resource type
+
+Contains metadata about the source of the drive item.
+
+It is available on the source property of [driveItem][item-resource] resources.
+
+## Properties
+
+| Property | Type | Description |
+| :-- | : | :-- |
+| **application** | driveItemSourceApplication | Enumeration value that indicates the source application where the file was created. |
+| **externalId** | string | The external identifier for the drive item from the source. |
+
+### driveItemSourceApplication values
+
+| Value | Description |
+|:--|:--|
+| teams | The application is Teams. |
+| yammer | The application is Yammer. |
+| sharePoint | The application is SharePoint. |
+| oneDrive | The application is OneDrive. |
+| stream | The application is Stream. |
+| powerPoint | The application is PowerPoint |
+| office | The application is Office |
+| unknownFutureValue | Marker value for future compatibility. |
+
+## JSON representation
+
+<!-- {
+ "blockType": "resource",
+ "optionalProperties": [
+ "application",
+ "externalId",
+ ],
+ "@odata.type": "microsoft.graph.driveItemSource"
+}-->
+
+```json
+{
+ "application": "string",
+ "externalId" : "string"
+}
+```
+
+## See also
+
+For more information about the facets on a driveItem, see [driveItem](driveitem.md).
+
+[item-resource]: ../resources/driveitem.md
+
+<!-- {
+ "type": "#page.annotation",
+ "description": "The driveItemSource facet provides information about drive item source.",
+ "keywords": "driveItemSoruce,client,media info,onedrive",
+ "section": "documentation",
+ "tocPath": "Facets/driveItemSource"
+} -->
beta Driveitemuploadableproperties https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/driveitemuploadableproperties.md
Title: "driveItemUploadableProperties resource type"
description: "The driveItemUploadableProperties resource represents an item being uploaded when creating an upload session." localization_priority: Normal doc_type: "resourcePageType"
The **driveItemUploadableProperties** resource represents an item being uploaded
| Property | Type | Description | |:-|:-|:-| |description |String | Provides a user-visible description of the item. Read-write. Only on OneDrive Personal. |
+|driveItemSource| [driveItemSource](driveItemSource.md) | Information about the drive item source. Read-write. Only on OneDrive for Business and SharePoint. |
|fileSize |Int64 | Provides an expected file size to perform a quota check prior to upload. Only on OneDrive Personal. | |fileSystemInfo|[fileSystemInfo](filesysteminfo.md)| File system information on client. Read-write. |
+|mediaSource | [mediaSource](mediaSource.md) | Media source information. Read-write. Only on OneDrive for Business and SharePoint. |
|name |String | The name of the item (filename and extension). Read-write. | ## JSON representation
beta Media https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/media.md
++
+description: "The media resource contains metadata about the media (audio or video) drive item."
+ Title: media resource type
+localization_priority: Normal
+
+# media resouce type
+
+Contains metadata about the media (audio or video) drive item.
+
+It is available on the media property of [driveItem][item-resource] resources.
++
+## Properties
+
+| Property | Type | Description |
+| :-- | :-- | :
+| **isTranscriptionShown** | Boolean | If a file has a transcript, this setting controls if the closed captions / transcription for the media file should be shown to people during viewing. Read-Write. |
+| **mediaSource** | [mediaSource](mediaSource.md) | Information about the source of media. Read-only. |
++
+## JSON representation
+
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.media"
+}-->
+
+```json
+{
+ "isTranscriptionShown" : true,
+ "mediaSource": { "@odata.type": "microsoft.graph.mediaSource" }
+}
+```
+
+## See also
+
+For more information about the facets on a driveItem, see [driveItem](driveitem.md).
+
+[item-resource]: ../resources/driveitem.md
+[mediaSource]: mediaSource.md
+
+<!-- {
+ "type": "#page.annotation",
+ "description": "The media resource type provides information about the media item.",
+ "keywords": "mediaItem,client,media info,onedrive",
+ "section": "documentation",
+ "tocPath": "Facets/Media"
+} -->
beta Mediasource https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/mediasource.md
++
+description: "The mediaSource resource contains metadata about source of the media (audio or video) drive item."
+ Title: mediaSource resource type
+localization_priority: Normal
+
+# mediaSource resouce type
+
+The **mediaSource** resource contains metadata about the source of media (audio or video) drive item.
+
+It is available on the media property of [driveItem][item-resource] resources.
+
+## Properties
+
+| Property | Type | Description |
+| :-- | : | :-- |
+| **contentCategory** | mediaSourceContentCategory | Enumeration value that indicates the media content category. |
+
+### mediaSourceContentCategory values
+
+| Value | Description |
+|:- |:-|
+| meeting | The media is a meeting. |
+| liveStream | The media is a live stream. |
+| presentation | The media is a presentation. |
+| screenRecording | The media is a screen recording. |
+| unknownFutureValue | Marker value for future compatibility. |
+
+## JSON representation
+
+<!-- {
+ "blockType": "resource",
+ "optionalProperties": [
+ "contentCategory"
+ ],
+ "@odata.type": "microsoft.graph.mediaSource"
+}-->
+
+```json
+{
+ "contentCategory" : "string"
+}
+```
+
+## See also
+
+For more information about the facets on a driveItem, see [driveItem](driveitem.md).
+
+[item-resource]: ../resources/driveitem.md
+
+<!-- {
+ "type": "#page.annotation",
+ "description": "The mediaSource facet provides information about drive item source.",
+ "keywords": "mediaSource,client,media info,onedrive",
+ "section": "documentation",
+ "tocPath": "Facets/MediaSource"
+} -->
beta Specialfolder https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/specialfolder.md
-description: "The SpecialFolder resource groups special folder-related data items into a single structure."
Previously updated : 09/10/2017 Title: SpecialFolder
+description: "Groups special folder-related data items into a single structure."
+ Title: specialFolder resource type
localization_priority: Normal doc_type: resourcePageType
-# SpecialFolder resource type
+# specialFolder resource type
Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-The **SpecialFolder** resource groups special folder-related data items into a single structure.
+Groups special folder-related data items into a single structure.
-If a **DriveItem** has a non-null **specialFolder** facet, the item represents a special (named) folder.
+If a **driveItem** has a non-null **specialFolder** facet, the item represents a special (named) folder.
Special folders can be accessed directly via the [special folders collection](../api/drive-get-specialfolder.md). Special folders provide simple aliases to access well-known folders without the need to look up the folder by path (which would require localization), or reference the folder with an ID.
If a special folder is renamed or moved to another location within the drive, th
Special folders are automatically created the first time an application attempts to write to one, if it doesn't already exist. If a user deletes one, it is recreated when written to again.
-**Note:** If your app has only requested **Files.Read** scope and requests a special folder that doesn't exist, the response will be a `403 Forbidden` error.
+
+>**Note:** If your app has only requested **Files.Read** scope and requests a special folder that doesn't exist, the response will be a `403 Forbidden` error.
+
+## Properties
+
+| Property | Type | Description |
+|:-|:-|:--|
+| name | string | The unique identifier for this item in the `/drive/special` collection |
+ ## JSON representation
If a user deletes one, it is recreated when written to again.
} ```
-## Properties
-
-| Property | Type | Description |
-|:-|:-|:--|
-| name | string | The unique identifier for this item in the `/drive/special` collection |
-
-## Special folders
-
-Here are the special folders available in OneDrive Personal and OneDrive for Business.
-
-| Name | Folder id | Description |
-|:|:-|:-|
-| App Root | `approot` | The application's personal folder. Usually in `/Apps/{Application Name}` |
-| Camera Roll | `cameraroll` | The Camera Roll Backup folder. Not available in OneDrive for Business. |
-| Documents | `documents` | The Documents folder. |
-| Music | `music` | The Music folder. Not available in OneDrive for Business. |
-| Photos | `photos` | The Photos folder. |
-
-## Remarks
+## See also
-For more information about the facets on a DriveItem, see [DriveItem](driveitem.md).
+For more information about the facets on a driveItem, see [driveItem](driveitem.md).
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79