Work IQ OneDrive-Referenz (Vorschau)

Übersicht

Verfügbare Tools

getOnedrive

Ruft Informationen über die OneDrive des Benutzers ab, einschließlich Laufwerkmetadaten, Kontingent und Besitzerinformationen.

Es müssen keine Parameter angegeben werden.

getFolderChildrenInMyOnedrive

Listet die 20 wichtigsten Dateien und Ordner (DriveItems) auf, die in einem angegebenen übergeordneten Ordner im OneDrive des Benutzers enthalten sind.

Optionale Parameter:

• parentFolderId: ID des übergeordneten Ordners, dessen Dateien und Ordner Sie auflisten möchten (Standard: 'root')

findenDateiOderOrdnerInMeinemOnedrive

Sucht eine Datei oder einen Ordner (DriveItem) im OneDrive des Benutzers nach Suchabfrage. Diese Methode ist effizienter als das Durchsuchen aller barrierefreien Dateien, wenn Sie wissen, dass sich das Element im OneDrive des Benutzers befindet.

Erforderliche Parameter:

• searchQuery: Suchabfrage; kann der gesamte oder teilweise Dateiname sein.

getFileOrFolderMetadataInMyOnedrive

Ruft Metadaten einer Datei oder eines Ordners (DriveItem) aus der OneDrive des Benutzers ab.

Erforderliche Parameter:

• fileOrFolderId: ID der Datei oder des Ordners im OneDrive des Benutzers

getFileOrFolderMetadataByUrl

Ruft Metadaten einer Datei oder eines Ordners (DriveItem) aus einer Freigabe-URL ab. Nur Benutzer mit vorhandenen expliziten Berechtigungen für den Zugriff auf die Datei können die Metadaten abrufen.

Erforderliche Parameter:

• fileOrFolderUrl: DIE URL der Datei oder des Ordners. Die URL dient nicht dazu, sie mit dem Benutzer zu teilen; der Benutzer muss bereits ausdrücklich Zugriff haben.

Kleine Textdatei aus meinem OneDrive lesen

Liest (lädt herunter) eine Textdatei aus dem OneDrive-Konto des Benutzers.

Erforderliche Parameter:

• fileId: ID der Datei (DriveItem) zum Lesen oder Herunterladen

KleineTextdateiInMeinemOnedriveErstellen

Erstellt oder lädt eine Textdatei, die kleiner als 5 MB ist, in die OneDrive des Benutzers hoch.

Erforderliche Parameter:

• Dateiname: Name der zu erstellenden Datei
• contentText: Textinhalt der Datei

Optionale Parameter:

• parentFolderId: ID des übergeordneten Ordners (Standard: 'root')

Ordner in meinem OneDrive erstellen

Erstellt einen neuen Ordner (DriveItem) im OneDrive des Benutzers als untergeordnetes Element des angegebenen übergeordneten Ordners. Wenn bereits ein Ordner mit demselben Namen vorhanden ist, fügt die Methode ein numerisches Suffix hinzu (z. B. NewFolder (1)).

Erforderliche Parameter:

• Foldername: Name des zu erstellenden Ordners

Optionale Parameter:

• parentFolderId: ID des übergeordneten Ordners (Standard: 'root')

BenennenSieDateiOderOrdnerInMeinemOneDriveUm

Benennt eine Datei oder einen Ordner (DriveItem) im OneDrive des Benutzers um. Der neue Name muss den Benennungskonventionen entsprechen.

Erforderliche Parameter:

• fileOrFolderId: ID der umzubenennende Datei oder des Ordners
• newFileOrFolderName: Der neue Name für die Datei oder den Ordner

Optionale Parameter:

• Etag: ETag-Wert zur Steuerung von Parallelität. Der Vorgang ist nur erfolgreich, wenn das aktuelle ETag des DriveItem-Objekts übereinstimmt.

DateiOderOrdnerInMeinemOneDriveLöschen

Löscht eine Datei oder einen Ordner (DriveItem) aus dem OneDrive des Benutzers.

Erforderliche Parameter:

• fileOrFolderId: ID der zu löschenden Datei oder des Zu löschenden Ordners

Optionale Parameter:

• ETag: ETag-Wert für Gleichzeitigkeitsteuerung

DateiOderOrdnerInMeinemOnedriveTeilen

Sendet eine Freigabeaufladung, um Lese- oder Schreibberechtigungen für eine Datei oder einen Ordner (DriveItem) im OneDrive des Benutzers zu erteilen.

Erforderliche Parameter:

• fileOrFolderId: ID der zu teilenden Datei oder des Ordners
• recipientEmails: Array von E-Mail-Adressen von Empfängern, die eingeladen werden sollen
• Rollen: Array von Rollen, die zugewiesen werden sollen. Akzeptierte Werte: 'lesen', 'schreiben' (schreiben gewährt sowohl Lese- als auch Schreibzugriff)

Optionale Parameter:

• Nachricht: Benutzerdefinierte Nachricht, die in die Einladungs-E-Mail eingeschlossen werden soll. Standard: "Hier ist die Datei, an der wir zusammenarbeiten.".
• sendInvitation: Gibt an, ob eine Freigabeanfrage gesendet werden soll. Voreinstellung: wahr.

EmpfindlichkeitsbezeichnungAufDateiInMeinemOneDriveFestlegen

Legt die Vertraulichkeitsbezeichnung einer Datei im OneDrive des Benutzers fest.

Erforderliche Parameter:

• fileId: ID der Datei (DriveItem)
• sensitivityLabelId: ID der zuzuweisenden Vertraulichkeitsbezeichnung oder leere Zeichenfolge zum Entfernen

Optionale Parameter:

• assignmentMethod: Zuordnungsmethode: 'standard', 'privileged', 'auto' oder 'unknownFutureValue' (Standard: 'privileged')
• justificationText: Begründungstext für Auditzwecke; erforderlich beim Herabstufen oder Entfernen einer Bezeichnung (Standard: 'Geändert von MCPServer')

erstelleKleineBinärdateiInMeinemOnedrive

Erstellt eine Binärdatei mit einer Größe von weniger als 5 MB durch Base64-Codierung des Inhalts für die OneDrive des Benutzers.

Erforderliche Parameter:

• Dateiname: Name der zu erstellenden Datei, einschließlich der Dateierweiterung
• Base64content: Der binäre Dateiinhalt, der als base64-Zeichenfolge codiert ist

Optionale Parameter:

• parentFolderId: ID des übergeordneten Ordners (Standard: 'root')

leseKleineBinärdateiVonMeinemOneDrive

Liest eine Binärdatei, die kleiner als 5 MB ist, aus der OneDrive des Benutzers. Gibt den Dateiinhalt als base64-codierte Zeichenfolge zurück.

Erforderliche Parameter:

• fileId: ID der Datei (DriveItem) zum Lesen oder Herunterladen

DateiOderOrdnerInMeinemOneDriveKopieren

Kopiert eine Datei oder einen Ordner (DriveItem) in einen Zielordner innerhalb der OneDrive des Benutzers. Dieser Vorgang ist asynchron. Verwenden Sie checkOperationStatusInMyOnedrive, um den Fortschritt zu überwachen.

Erforderliche Parameter:

• sourcefileid: ID der zu kopierenden Quelldatei oder des Quellordners (DriveItem)
• destfolderid:-ID des Zielordners (muss im OneDrive des Benutzers vorhanden sein)

Optionale Parameter:

• newfilename: Neuer Name für das kopierte Element (Standardeinstellung für den ursprünglichen Namen)

DateiOderOrdnerInMeinemOnedriveVerschieben

Verschiebt eine Datei oder einen Ordner (DriveItem) in einen Zielordner innerhalb der OneDrive des Benutzers. Dieser Vorgang ist asynchron. Verwenden Sie checkOperationStatusInMyOnedrive, um den Fortschritt zu überwachen.

Erforderliche Parameter:

• sourcefileid: ID der Zu verschiebenden Quelldatei oder des Quellordners (DriveItem)
• destfolderid:-ID des Zielordners (muss im OneDrive des Benutzers vorhanden sein)

Optionale Parameter:

• newfilename: Neuer Name für das verschobene Element (Standardeinstellung für den ursprünglichen Namen)

ÜberprüfeBetriebsstatusInMeinemOnedrive

Überprüft den Status eines asynchronen Vorgangs, z. B. Kopieren oder Verschieben, mithilfe des vom ursprünglichen Vorgang zurückgegebenen Vorgangstokens. Gibt Statusinformationen zurück, wenn sie noch ausgeführt werden, Fehlerdetails, falls fehlgeschlagen, oder die endgültigen Datei- oder Ordnermetadaten, wenn sie erfolgreich abgeschlossen wurden.

Erforderliche Parameter:

• operationToken: Das von einem asynchronen Vorgang zurückgegebene Vorgangstoken wie copyFileOrFolderInMyOnedrive oder moveFileOrFolderInMyOnedrive

Wichtigste Funktionen

verwaltung von OneDrive

• Ruft OneDrive Informationen ab, z. B. Kontingent und Besitzer
• Zugreifen auf das persönliche OneDrive des Benutzers
• Alle Vorgänge zielen auf das OneDrive eines authentifizierten Benutzers ab.

Dateisuche und -auffindung

• Durchsuchen von Dateien und Ordnern anhand des Namens im OneDrive des Benutzers
• Abrufen von Datei- oder Ordnermetadaten nach ID oder Freigabe-URL
• Durchsuchen von Ordnerinhalten (bis zu 20 Elemente)

Dateivorgänge

• Erstellen von Text- und Binärdateien (≤5 MB)
• Lesen von Text- und Binärdateien (≤5 MB)
• Löschen von Dateien mit Nebenläufigkeitskontrolle
• Umbenennen von Dateien mit eTag-Schutz
• Asynchrones Kopieren und Verschieben von Dateien und Ordnern

Ordnerverwaltung

• Ordner erstellen, einschließlich optionaler übergeordneter Pfade
• Automatisches numerisches Suffix für doppelte Ordnernamen
• Listenordnerinhalte (bis zu 20 Elemente)
• Abrufen von Ordnermetadaten
• Ordner mit Nebenläufigkeitskontrolle löschen
• Umbenennen von Ordnern mit eTag-Schutz

Freigabe und Berechtigungen

• Freigeben von Dateien und Ordnern für Benutzer
• Rollenbasierte Zugriffssteuerung (Lesen, Schreiben)
• E-Mail-Benachrichtigungen für das Teilen
• Benutzerdefinierte Nachrichten in Einladungen

Sicherheit und Konformität

• Anwenden und Entfernen von Vertraulichkeitsbezeichnungen.
• Verwenden Sie mehrere Zuweisungsmethoden, darunter Standard-, privilegierte und automatische Methoden.
• Unterstützen Sie die Begründung der Überwachung.
• Verwenden Sie die Parallelitätssteuerung mit eTags.

Hinweise

• Alle Vorgänge zielen auf die persönliche OneDrive des authentifizierten Benutzers ab.
• Dateivorgänge sind auf Dateien beschränkt, die 5 MB oder weniger zum Hochladen und Herunterladen sind.
• Lösch- und Umbenennungsvorgänge unterstützen eTags für parallele Steuerung.
• Um etwas freigeben zu können, sind gültige E-Mail-Adressen und entsprechende Berechtigungen erforderlich.
• Vertraulichkeitsbezeichnungen erfordern eine korrekte Lizenzierung und Konfiguration.
• Die Ordnerauflistung gibt standardmäßig maximal 20 Elemente zurück.