itemReference-Ressourcentyp

  • Artikel

Namespace: microsoft.graph

Die itemReference-Ressource stellt Informationen bereit, die zum Adressieren eines driveItem- oder listItem-Objekts über die API erforderlich sind.

Eigenschaften

Eigenschaft Typ Beschreibung
driveId Zeichenfolge Eindeutiger Bezeichner der Laufwerkinstanz, die das driveItem-Objekt enthält. Wird nur zurückgegeben, wenn sich das Element auf einem Laufwerk befindet. Schreibgeschützt.
driveType string Identifiziert den Laufwerkstyp. Wird nur zurückgegeben, wenn sich das Element auf einem Laufwerk befindet. Werte finden Sie unter drive-Ressource.
id Zeichenfolge Eindeutiger Bezeichner des driveItem-Objekts auf dem Laufwerk oder ein listItem-Objekt in einer Liste. Schreibgeschützt.
name Zeichenfolge Der Name des Elements, auf das verwiesen wird. Schreibgeschützt.
Pfad Zeichenfolge Prozentcodierter Pfad, der zum Navigieren zum Element verwendet werden kann. Schreibgeschützt.
shareId String Ein eindeutiger Bezeichner für eine freigegebene Ressource, auf die über die Freigabe-API zugegriffen werden kann.
sharepointIds sharepointIds Gibt Bezeichner zurück, die für SharePoint REST-Kompatibilität nützlich sind. Schreibgeschützt.
siteId Zeichenfolge Für OneDrive for Business und SharePoint stellt diese Eigenschaft die ID der Website dar, die die übergeordnete Dokumentbibliothek der driveItem-Ressource oder die übergeordnete Liste der listItem-Ressource enthält. Der Wert ist identisch mit der id-Eigenschaft dieser Standortressource . Es handelt sich um eine nicht transparente Zeichenfolge, die aus drei Bezeichnern der Website besteht.
Für OneDrive wird diese Eigenschaft nicht aufgefüllt.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "driveId": "string",
  "driveType": "personal | business | documentLibrary",
  "id": "string",
  "name": "string",
  "path": "string",
  "shareId": "string",
  "sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
  "siteId": "string"
}

Hinweise

Um ein driveItem-Element aus einer itemReference-Ressource zu adressieren, erstellen Sie eine URL im folgenden Format:

GET https://graph.microsoft.com/v1.0/drives/{driveId}/items/{id}

Der Pfadwert ist ein prozent codierter API-Pfad relativ zum Ziellaufwerk, z. B.: /drive/root:/Documents/my%20file.docx.

Um den lesbaren Pfad für ein Breadcrumb abzurufen, können Sie alles bis zum ersten : in der Pfadzeichenfolge problemlos ignorieren.