Ressourcentyp „driveItem“driveItem resource type

Die driveItem-Ressource stellt eine Datei, einen Ordner oder ein anderes auf einem Laufwerk gespeichertes Element dar. Alle Dateisystemobjekte in OneDrive und SharePoint werden als driveItem-Ressourcen zurückgegeben.The driveItem resource represents a file, folder, or other item stored in a drive. All file system objects in OneDrive and SharePoint are returned as driveItem resources.

Es gibt zwei Hauptmethoden zum Adressieren einer driveItem-Ressource:There are two primary ways of addressing a driveItem resource:

  • Durch den eindeutigen driveItem-Bezeichner unter Verwendung von drive/items/{item-id}By the driveItem unique identifier using drive/items/{item-id}
  • Durch den Dateisystempfad unter Verwendung von /drive/root:/path/to/fileBy file system path using /drive/root:/path/to/file

driveItem-Ressourcen verfügen über als Eigenschaften modellierte Facets, die Daten zu den driveItem-Identitäten und -Funktionen bereitstellen.DriveItem resources have facets modeled as properties that provide data about the driveItem's identities and capabilities. Zum Beispiel:For example:

  • Ordner haben ein [„folder“-Facet][-Ordner]Folders have a folder facet
  • Dateien haben eine [„file“-Facet][-Datei].Files have a file facet.
  • Bilder haben zusätzlich zu ihrem „file“-Facet ein [„image“Facet][-Bild].Images have an image facet in addition to their file facet.
  • Mit einer Kamera aufgenommene Bilder (Fotos) haben ein [„photo“-Facet][-Foto], das die Elemente als Foto identifiziert und als Eigenschaften das Aufnahmedatum sowie das zur Aufnahme verwendete Gerät aufführt.Images taken with a camera (photos) have a photo facet that identifies the item as a photo and provides the properties of when the photo was taken and with what device.

Elemente mit dem folder-Facet fungieren als Elementcontainer und besitzen daher einen children-Verweis auf eine Sammlung von driveItems im jeweiligen Ordner.Items with the folder facet act as containers of items and therefore have a children reference pointing to a collection of driveItems under the folder.

Hinweis: In OneDrive for Business- oder SharePoint-Dokumentbibliotheken wird die Eigenschaft cTag nicht zurückgegeben, wenn die driveItem-Ressource ein [Ordner][]-Facet hat.In OneDrive for Business or SharePoint document libraries, the cTag property is not returned, if the driveItem has a folder facet.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
audioaudio audioaudio Audiometadaten, wenn das Element eine Audiodatei ist. Schreibgeschützt.Audio metadata, if the item is an audio file. Read-only.
contentcontent StreamStream Der Inhaltsdatenstrom, wenn das Element eine Datei istThe content stream, if the item represents a file.
createdBycreatedBy identitySetidentitySet Die Identität des Benutzers, des Geräts und der Anwendung, von denen das Element erstellt wurde. Schreibgeschützt.Identity of the user, device, and application which created the item. Read-only.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Datum und Uhrzeit der Elementerstellung. Schreibgeschützt.Date and time of item creation. Read-only.
cTagcTag StringString Ein ETag für den Inhalt des Elements. Dieses ETag wird nicht geändert, wenn nur die Metadaten geändert werden. Hinweis: Diese Eigenschaft wird nicht zurückgegeben, wenn das Element ein Ordner ist. Schreibgeschützt.An eTag for the content of the item. This eTag is not changed if only the metadata is changed. Note This property is not returned if the item is a folder. Read-only.
gelöschtdeleted deleteddeleted Informationen zum „gelöscht“-Zustand des Elements. Schreibgeschützt.Information about the deleted state of the item. Read-only.
descriptiondescription ZeichenfolgeString Stellt eine für den Benutzer sichtbare Beschreibung des Elements bereit. Lese-/Schreibzugriff. Nur auf OneDrive PersonalProvides a user-visible description of the item. Read-write. Only on OneDrive Personal
eTageTag StringString ETag des gesamten Elements (Metadaten + Inhalt). Schreibgeschützt.eTag for the entire item (metadata + content). Read-only.
filefile filefile Dateimetadaten, wenn das Element eine Datei ist. Schreibgeschützt.File metadata, if the item is a file. Read-only.
fileSystemInfofileSystemInfo fileSystemInfofileSystemInfo Informationen zum Dateisystem des Clients. Lese-/Schreibzugriff.File system information on client. Read-write.
folderfolder [Ordner][]folder Ordnermetadaten, wenn das Element ein Ordner ist. Schreibgeschützt.Folder metadata, if the item is a folder. Read-only.
idid StringString Der eindeutige Bezeichner des Elements im Laufwerk. Schreibgeschützt.The unique identifier of the item within the Drive. Read-only.
Abbildungimage imageimage Bildmetadaten, wenn das Element ein Bild ist. Schreibgeschützt.Image metadata, if the item is an image. Read-only.
lastModifiedBylastModifiedBy identitySetidentitySet Die Identität des Benutzers, des Geräts und der Anwendung, von denen das Element zuletzt geändert wurde. Schreibgeschützt.Identity of the user, device, and application which last modified the item. Read-only.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Datum und Uhrzeit der letzten Änderung des Elements. Schreibgeschützt.Date and time the item was last modified. Read-only.
locationlocation geoCoordinatesgeoCoordinates Standortmetadaten, sofern das Element Standortdaten aufweist. Schreibgeschützt.Location metadata, if the item has location data. Read-only.
namename StringString Der Name des Elements (Dateiname und Erweiterung). Lese-/Schreibzugriff.The name of the item (filename and extension). Read-write.
packagepackage packagepackage Zeigt wenn vorhanden an, dass das Element ein Paket ist statt eines Ordners oder einer Datei. Pakete werden in einigen Kontexten wie Dateien, in anderen Kontexten wie Ordner behandelt. Schreibgeschützt.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.
parentReferenceparentReference itemReferenceitemReference Informationen zum übergeordneten Element, wenn das Element ein übergeordnetes Element hat. Lese-/Schreibzugriff.Parent information, if the item has a parent. Read-write.
Fotophoto photophoto Fotometadaten, wenn das Element ein Foto ist. Schreibgeschützt.Photo metadata, if the item is a photo. Read-only.
Veröffentlichungpublication publicationFacetpublicationFacet Stellt Informationen über den veröffentlichten oder ausgecheckten Status eines Elements an Stellen bereit, die solche Aktionen unterstützen.Provides information about the published or checked-out state of an item, in locations that support such actions. Diese Eigenschaft wird standardmäßig nicht zurückgegeben.This property is not returned by default. Schreibgeschützt.Read-only.
remoteItemremoteItem remoteItemremoteItem Daten zum Remoteelement, wenn das Element von einem anderen Laufwerk freigegeben ist als dem, auf das zugegriffen wird. Schreibgeschützt.Remote item data, if the item is shared from a drive other than the one being accessed. Read-only.
rootroot rootroot Wenn diese Eigenschaft nicht Null ist, bedeutet dies, dass es sich bei der driveItem-Ressource um die oberste driveItem-Ressource auf dem Laufwerk handelt.If this property is non-null, it indicates that the driveItem is the top-most driveItem in the drive.
searchResultsearchResult searchResultsearchResult Suchmetadaten, wenn das Element aus einem Suchergebnis stammt. Schreibgeschützt.Search metadata, if the item is from a search result. Read-only.
freigegebenshared sharedshared Gibt an, dass das Element für andere freigegeben wurde, und enthält den „freigegeben“-Status des Elements. Schreibgeschützt.Indicates that the item has been shared with others and provides information about the shared state of the item. Read-only.
sharepointIdssharepointIds sharepointIdssharepointIds Gibt Bezeichner zurück, die für SharePoint REST-Kompatibilität nützlich sind. Schreibgeschützt.Returns identifiers useful for SharePoint REST compatibility. Read-only.
sizesize Int64Int64 Größe des Elements in Byte. Schreibgeschützt.Size of the item in bytes. Read-only.
specialFolderspecialFolder specialFolderspecialFolder Facet, das zurückgegeben wird, wenn das aktuelle Element auch als spezieller Ordner verfügbar ist. Schreibgeschützt.If the current item is also available as a special folder, this facet is returned. Read-only.
videovideo videovideo Videometadaten, wenn das Element ein Video ist. Schreibgeschützt.Video metadata, if the item is a video. Read-only.
webDavUrlwebDavUrl StringString WebDAV-kompatible URL für das Element.WebDAV compatible URL for the item.
webUrlwebUrl StringString URL, über die die Ressource im Browser angezeigt werden kann. Schreibgeschützt.URL that displays the resource in the browser. Read-only.

Hinweis: Die Eigenschaften „eTag“ und „cTag“ arbeiten bei Containern (Ordnern) anders. Der Wert „cTag“ wird geändert, wenn Inhalte oder Metadaten eines Nachfolgers des Ordners geändert werden. Der Wert „eTag“ wird nur geändert, wenn die Eigenschaften des Ordners geändert werden. Ausnahme: Eigenschaften, die von Nachfolgern abgeleitet werden (wie childCount oder lastModifiedDateTime).Note: The eTag and cTag properties work differently on containers (folders). The cTag value is modified when content or metadata of any descendant of the folder is changed. The eTag value is only modified when the folder's properties are changed, except for properties that are derived from descendants (like childCount or lastModifiedDateTime).

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
Aktivitätenactivities ItemActivity-SammlungitemActivity collection Die Liste der letzten Aktivitäten, die für dieses Element durchgeführt wurden.The list of recent activities that took place on this item.
Analysenanalytics itemAnalytics-RessourceitemAnalytics resource Analysen zu den Anzeigeaktivitäten, die auf diesem Element stattgefunden haben.Analytics about the view activities that took place in this site.
Untergeordnetes Elementchildren driveitem-SammlungdriveItem collection Sammlung von Elementobjekten der direkten untergeordneten Elemente eines Elements. Nur Elemente, die Ordner repräsentieren, haben untergeordnete Elemente. Schreibgeschützt. Nullwerte zulassend.Collection containing Item objects for the immediate children of Item. Only items representing folders have children. Read-only. Nullable.
createdByUsercreatedByUser useruser Der Name des Benutzers, der das Element erstellt hat.Identity of the user who created the item. Schreibgeschützt.Read-only.
lastModifiedByUserlastModifiedByUser useruser Der Name des Benutzers, der das Element zuletzt geändert hat.Identity of the user who last modified the item. Schreibgeschützt.Read-only.
listItemlistItem listItemlistItem Für Laufwerke in SharePoint das zugehörige Dokumentbibliothek-Listenelement.For drives in SharePoint, the associated document library list item. Schreibgeschützt.Read-only. Lässt Nullwerte zu.Nullable.
Berechtigungenpermissions permission collectionpermission collection Der Satz von Berechtigungen für das Element. Schreibgeschützt. Lässt Nullwerte zu.The set of permissions for the item. Read-only. Nullable.
Abonnementssubscriptions Abonnement-Sammlungsubscription collection Die Gruppe von Abonnements für das Element.The set of subscriptions on the item. Wird nur im Stammordner eines Laufwerks unterstützt.Only supported on the root of a drive.
thumbnailsthumbnails thumbnailSet collectionthumbnailSet collection Sammlung der dem Element zugeordneten ThumbnailSet-Objekte. Weitere Informationen finden Sie im Artikel zum Abrufen von Miniaturansichten. Schreibgeschützt. Nullwerte zulassend.Collection containing ThumbnailSet objects associated with the item. For more info, see getting thumbnails. Read-only. Nullable.
versionsversions driveItemVersion-SammlungdriveItemVersion collection Die Liste der früheren Versionen des Elements.The list of previous versions of the item. Weitere Informationen finden Sie unter Abrufen früherer Versionen.For more info, see getting previous versions. Schreibgeschützt.Read-only. Nullwerte zulassend.Nullable.
workbookworkbook workbookworkbook Greift für Dateien, die Excel-Tabellen sind, auf die Workbook-API zu, um mit dem Inhalt der Tabelle zu arbeiten.For files that are Excel spreadsheets, accesses the workbook API to work with the spreadsheet's contents. Nullwerte zulassend.Nullable.

InstanzenattributeInstance Attributes

Instanzenattribute sind Eigenschaften mit speziellem Verhalten. Diese Eigenschaften sind temporär. Sie definieren entweder, wie sich der Dienst verhalten soll, oder geben kurzfristige Eigenschaftswerte an, beispielsweise URLs zum Elementdownload, die ablaufen.Instance attributes are properties with special behaviors. These properties are temporary and either a) define behavior the service should perform or b) provide short-term property values, like a download URL for an item that expires.

EigenschaftennameProperty name TypType BeschreibungDescription
@microsoft.graph.conflictBehavior@microsoft.graph.conflictBehavior stringstring Das Konfliktlösungsverhalten von Aktionen, die ein neues Element erstellen. Verwenden Sie die Werte fail, replace oder rename. Das Standardformat für PUT ist replace. Ein Element wird nie mit dieser Anmerkung zurückgegeben. Schreibzugriff.The conflict resolution behavior for actions that create a new item. You can use the values fail, replace, or rename. The default for PUT is replace. An item will never be returned with this annotation. Write-only.
@microsoft.graph.downloadUrl@microsoft.graph.downloadUrl stringstring Eine URL, über die die Inhalte der Datei heruntergeladen werden können. Eine Authentifizierung ist mit dieser URL nicht erforderlich. Schreibgeschützt.A URL that can be used to download this file's content. Authentication is not required with this URL. Read-only.
@microsoft.graph.sourceUrl@microsoft.graph.sourceUrl stringstring Bei Ausgabe einer PUT-Anforderung kann der Dienst mithilfe dieser Instanzanmerkung angewiesen werden, den Inhalt der URL herunterzuladen und als diese Datei zu speichern. Schreibzugriff.When issuing a PUT request, this instance annotation can be used to instruct the service to download the contents of the URL, and store it as the file. Write-only.

Hinweis: Der Wert „@microsoft.graph.downloadUrl“ ist eine kurzlebige URL und kann nicht zwischengespeichert werden.Note: The @microsoft.graph.downloadUrl value is a short-lived URL and can't be cached. Die URL ist nur für kurze Zeit (1 Stunde) verfügbar, bevor sie ungültig wird.The URL will only be available for a short period of time (1 hour) before it is invalidated. Beim Entfernen von Dateiberechtigungen für einen Benutzer wird die URL möglicherweise nicht sofort ungültig.Removing file permissions for a user may not immediately invalidate the URL.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung einer driveItem-Ressource.Here is a JSON representation of a driveItem resource.

Die driveItem-Ressource wird von baseItem abgeleitet und erbt Eigenschaften von dieser Ressource.The driveItem resource is derived from baseItem and inherits properties from that resource.

{
  "audio": { "@odata.type": "microsoft.graph.audio" },
  "content": { "@odata.type": "Edm.Stream" },
  "cTag": "string (etag)",
  "deleted": { "@odata.type": "microsoft.graph.deleted"},
  "description": "string",
  "file": { "@odata.type": "microsoft.graph.file" },
  "fileSystemInfo": { "@odata.type": "microsoft.graph.fileSystemInfo" },
  "folder": { "@odata.type": "microsoft.graph.folder" },
  "image": { "@odata.type": "microsoft.graph.image" },
  "location": { "@odata.type": "microsoft.graph.geoCoordinates" },
  "package": { "@odata.type": "microsoft.graph.package" },
  "photo": { "@odata.type": "microsoft.graph.photo" },
  "publication": {"@odata.type": "microsoft.graph.publicationFacet"},
  "remoteItem": { "@odata.type": "microsoft.graph.remoteItem" },
  "root": { "@odata.type": "microsoft.graph.root" },
  "searchResult": { "@odata.type": "microsoft.graph.searchResult" },
  "shared": { "@odata.type": "microsoft.graph.shared" },
  "sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
  "size": 1024,
  "specialFolder": { "@odata.type": "microsoft.graph.specialFolder" },
  "video": { "@odata.type": "microsoft.graph.video" },
  "webDavUrl": "string",

  /* relationships */
  "activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
  "analytics": {"@odata.type": "microsoft.graph.itemAnalytics"},
  "children": [{ "@odata.type": "microsoft.graph.driveItem" }],
  "createdByUser": { "@odata.type": "microsoft.graph.user" },
  "lastModifiedByUser": { "@odata.type": "microsoft.graph.user" },
  "permissions": [ {"@odata.type": "microsoft.graph.permission"} ],
  "subscriptions": [ {"@odata.type": "microsoft.graph.subscription"} ],
  "thumbnails": [ {"@odata.type": "microsoft.graph.thumbnailSet"}],
  "versions": [ {"@odata.type": "microsoft.graph.driveItemVersion"}],

  /* inherited from baseItem */
  "id": "string (identifier)",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "eTag": "string",
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "name": "string",
  "parentReference": {"@odata.type": "microsoft.graph.itemReference"},
  "webUrl": "string",

  /* instance annotations */
  "@microsoft.graph.conflictBehavior": "string",
  "@microsoft.graph.downloadUrl": "url",
  "@microsoft.graph.sourceUrl": "url"
}

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
Get itemGet item driveItemdriveItem Mit dieser API können Sie die Metadaten einer Ressource des Typs DriveItem in einer Ressource des Typs Drive abrufen.Retrieve the metadata for a DriveItem in a Drive by file system path or ID.
Analysen abrufenGet analytics itemAnalyticsitemAnalytics Abrufen von Analysen für diese Ressource.Get analytics for this resource.
Aktivitäten nach Intervall abrufenGet activities by interval itemActivityStatitemActivityStat Eine Sammlung von itemActivityStats innerhalb des angegebenen Zeitintervalls abrufen.Get a collection of itemActivityStats within the specified time interval.
Untergeordnetes Element auflistenList children Sammlung von driveItemcollection of driveItem Eine Auflistung von DriveItems im untergeordneten Verhältnis eines DriveItem zurückgeben.Return a collection of DriveItems in the children relationship of a DriveItem.
Versionen auflistenList versions Sammlung von DriveItemVersioncollection of DriveItemVersion Die Versionen einer Datei werden auf dem Laufwerk des aktuellen Benutzers abgerufen.This example retrieves the versions of a file in the current user's drive.
Element erstellenCreate item driveItemdriveItem Erstellt ein driveItem auf dem angegebenen Laufwerk.Creates a driveItem in the specified drive.
Update itemUpdate item driveItemdriveItem Aktualisiert ein driveItem in das Laufwerk.Updates a driveItem in the drive.
Upload contentUpload content driveItemdriveItem Lädt Inhalte im driveItem hoch.Uploads content to the driveItem.
Inhalte herunterladenDownload content URL herunterladendownload Url Lädt Inhalte eines driveItem heruntergeladen.Downloads content of a driveItem.
Bestimmtes Dateiformat herunterladenDownload specific file format URL herunterladendownload Url Lädt Inhalte eines driveItem mit einem bestimmten Format herunter.Downloads content of a driveItem with a specific format.
Element löschenDelete item Kein Inhalt204 No Content Ein driveItem-Element löschen.Deletes a driveItem.
Move itemMove item driveItemdriveItem Ein driveItem in einem übergeordneten Element verschieben.Move a DriveItem to a new folder
Element kopierenCopy item detaillierte Informationen zum Überwachen des Status der KopieReturns details about how to monitor the progress of the copy, upon accepting the request. Diese Methode erstellt eine Kopie einer Ressource des Typs „driveItem“ (einschließlich aller untergeordneten Elemente).Creates a copy of an driveItem (including any children), under a new parent item.
Elemente suchenSearch items Sammlung von driveItemcollection of driveItem Durchsuchen Sie die Hierarchie der Elemente nach Elementen, die mit einer Abfrage übereinstimmen.Search the hierarchy of items for items matching a query.
Änderungen auf einem Laufwerk auflistenList changes in a drive Delta-Linkdelta link Alle Änderungen im Laufwerk auflisten.List any changes in the drive.
List thumbnailsList thumbnails Sammlung von driveItemcolletion of driveItem DriveItems mit ihren Miniaturansichten auflisten.List driveItems with their thumbnails.
Create sharing linkCreate sharing link FreigabelinkCreate sharing link Erstellen Sie einen Link zum Freigeben der driveItem.Create a link to share the driveItem.
Add permissionsAdd permissions Sammlung von [Berechtigungen][]collection of permission Sendet eine Einladung zur Freigabe an einen Benutzer.Sends a sharing ivite to a user.
Berechtigungen auflistenList permissions Sammlung von [Berechtigungen][]collection of permission Ruft die Sammlung von Berechtigungen für ein driveItem ab.Retrieves the collection of permissions on an driveItem.
Berechtigung löschenDelete permission Kein Inhalt204 No Content Entfernt die Berechtigungs des driveItem.Removes the permission level from the user.
WebSocket-Kanal erhaltenGet WebSocket channel subscriptionsubscription Empfängt nahezu in Echtzeit Änderungsbenachrichtigungen für ein Laufwerk mit socket.io.Receives near-real-time change notifications for a drive using socket.io.
Element in Vorschau anzeigenPreview item JSON-Objektjson object Erhalten Sie kurzzeitig einbindbare URLs für ein Element, um eine temporäre Vorschau zu erstellen.Obtain short-lived embeddable URLs for an item in order to render a temporary preview.