Referencja do OneDrive (podgląd)

Note

Funkcje opisane w tym artykule są zasilane standardową wiązką, która wykorzystuje opcje rozliczeniowe opisane w sekcji Licencjonowanie dla agentów zasilanych standardową wiązką. Dowiedz się, jak korzystać ze standardowych funkcji w Access, agentów standardowych i przepływach agentów.

Ważna

Jest to funkcja w wersji zapoznawczej.

• Microsoft udostępnia funkcje w wersji zapoznawczej przed ich oficjalnym wydaniem, aby klienci mogli uzyskać wcześniejszy dostęp i przekazać opinie.
• Funkcje w wersji zapoznawczej mają ograniczone funkcje i nie są przeznaczone do użytku produkcyjnego.
• Microsoft może zmienić nazwy i parametry narzędzia MCP w wersji zapoznawczej. Unikaj zakodowanych na sztywno zależności. Microsoft obsługuje scenariusze.
• Funkcje w wersji zapoznawczej podlegają dodatkowym warunkom użytkowania firmy Microsoft.

Overview

Identyfikator serwera	Adres URL na poziomie dzierżawcy	Wyświetlana nazwa	Opis
mcp_OneDriveRemoteServer	https://agent365.svc.cloud.microsoft/ agents/tenants/{tenantId}/servers/ mcp_OneDriveRemoteServer	OneDrive	Narzędzia do operacji OneDrive. Ten serwer służy do zarządzania plikami i folderami w osobistych OneDrive użytkownika. Wszystkie operacje na plikach ograniczone do ≤5 MB.

Dostępne narzędzia

getOnedrive

Pobiera informacje o OneDrive użytkownika, w tym metadane dysku, limit przydziału i informacje o właścicielu.

Brak wymaganych parametrów.

getFolderChildrenInMyOnedrive

Wylicza 20 pierwszych plików i folderów (DriveItems) zawartych w określonym folderze nadrzędnym w OneDrive użytkownika.

Parametry opcjonalne:

• parentFolderId: Identyfikator folderu nadrzędnego, którego pliki i foldery chcesz wyświetlić (ustawienie domyślne: "root")

findFileOrFolderInMyOnedrive

Znajduje plik lub folder (DriveItem) w OneDrive użytkownika przez zapytanie wyszukiwania. Ta metoda jest wydajniejsza niż przeszukiwanie wszystkich dostępnych plików, jeśli wiesz, że element znajduje się w OneDrive użytkownika.

Wymagane parametry:

• searchQuery: Kwerenda wyszukiwania; może być cała lub częściowa nazwa pliku

Pobierz metadane pliku lub folderu w moim OneDrive

Pobiera metadane pliku lub folderu (DriveItem) z OneDrive użytkownika.

Wymagane parametry:

• fileOrFolderId: identyfikator pliku lub folderu w OneDrive użytkownika

getFileOrFolderMetadataByUrl

Pobiera metadane pliku lub folderu (DriveItem) z adresu URL udostępniania. Metadane mogą uzyskać tylko użytkownicy z istniejącymi jawnymi uprawnieniami dostępu do pliku.

Wymagane parametry:

• fileOrFolderUrl: Adres URL pliku lub folderu. Adres URL nie służy do udostępniania zasobu użytkownikowi; użytkownik musi już mieć wyraźnie przyznany dostęp.

readSmallTextFileFromMyOnedrive

Odczytuje (pobiera) plik tekstowy z OneDrive użytkownika.

Wymagane parametry:

• fileId: Identyfikator pliku (DriveItem) do odczytu lub pobrania

utwórzMałyPlikTekstowyWMoimOneDrive

Tworzy lub przekazuje plik tekstowy mniejszy niż 5 MB do OneDrive użytkownika.

Wymagane parametry:

• nazwa pliku: Nazwa pliku do utworzenia
• contentTekst: Zawartość tekstu pliku.

Parametry opcjonalne:

• parentFolderId: ID folderu nadrzędnego (domyślnie: 'root').

createFolderInMyOnedrive

Tworzy nowy folder (DriveItem) w OneDrive użytkownika jako element podrzędny określonego folderu nadrzędnego. Jeśli folder o tej samej nazwie już istnieje, metoda dodaje sufiks liczbowy (na przykład NewFolder (1)).

Wymagane parametry:

• Nazwa_folderu: Nazwa folderu do utworzenia

Parametry opcjonalne:

• parentFolderId: ID folderu nadrzędnego (domyślnie: 'root').

ZmieńNazwęPlikuLubFolderuWMoimOneDrive

Zmienia nazwę pliku lub folderu (DriveItem) w OneDrive użytkownika. Nowa nazwa musi być zgodna z konwencjami nazewnictwa.

Wymagane parametry:

• fileOrFolderId: Identyfikator pliku lub folderu do zmiany nazwy
• newFileOrFolderName: Nowa nazwa pliku lub folderu

Parametry opcjonalne:

• Etag: Wartość elementu ETag dla kontrolki współbieżności. Operacja kończy się powodzeniem tylko wtedy, gdy bieżący element ETag dysku jest zgodny

usuńPlikLubFolderWMoimOneDrive

Usuwa plik lub folder (DriveItem) z OneDrive użytkownika.

Wymagane parametry:

• fileOrFolderId: Identyfikator pliku lub folderu do usunięcia

Parametry opcjonalne:

• Etag: Wartość elementu ETag dla kontrolki współbieżności

udostępnij plik lub folder w moim OneDrive

Wysyła zaproszenie do udostępniania, aby nadać uprawnienia do odczytu lub zapisu do pliku lub folderu (DriveItem) w usłudze OneDrive użytkownika.

Wymagane parametry:

• fileOrFolderId: Identyfikator pliku lub folderu do udostępnienia
• recipientEmails: Tablica adresów e-mail odbiorców, których chcesz zaprosić
• role: Tablica ról do przypisania. Akceptowane wartości: 'read', 'write' (write przyznaje uprawnienia zarówno do odczytu, jak i zapisu)

Parametry opcjonalne:

• Komunikat: Niestandardowa wiadomość do uwzględnienia w wiadomości e-mail z zaproszeniem. Ustawienie domyślne: "Oto plik, nad który współpracujemy".
• sendInvitation: Czy wysłać zaproszenie do udostępniania. Wartość domyślna: true.

setSensitivityLabelOnFileInMyOnedrive

Ustawia etykietę poufności pliku w OneDrive użytkownika.

Wymagane parametry:

• fileId: Identyfikator pliku (DriveItem)
• sensitivityLabelId: Identyfikator etykiety poufności do przypisania lub pusty ciąg do usunięcia

Parametry opcjonalne:

• assignmentMethod: Metoda przypisania: "standard", "privileged", "auto" lub "unknownFutureValue" (Domyślnie: "privileged")
• uzasadnienieTekst: Tekst uzasadnienia do celów audytu; wymagany przy obniżaniu poziomu lub usuwaniu etykiety (ustawienie domyślne: "Zmieniono przez MCPServer")

createSmallBinaryFileInMyOnedrive

Tworzy plik binarny o rozmiarze mniejszym niż 5 MB przez kodowanie zawartości base64 do OneDrive użytkownika.

Wymagane parametry:

• nazwa pliku: Nazwa pliku, który ma zostać utworzony, wraz z rozszerzeniem pliku
• base64Content: Zawartość pliku binarnego zakodowana jako ciąg base64

Parametry opcjonalne:

• parentFolderId: ID folderu nadrzędnego (domyślnie: 'root').

readSmallBinaryFileFromMyOnedrive

Odczytuje plik binarny mniejszy niż 5 MB z OneDrive użytkownika. Zwraca zawartość pliku jako ciąg zakodowany w formacie base64.

Wymagane parametry:

• fileId: Identyfikator pliku (DriveItem) do odczytu lub pobrania

kopiujPlikLubFolderWMoimOneDrive

Kopiuje plik lub folder (DriveItem) do folderu docelowego w OneDrive użytkownika. Ta operacja jest asynchroniczna. Użyj checkOperationStatusInMyOnedrive, aby monitorować postęp.

Wymagane parametry:

• sourcefileid: Identyfikator pliku lub folderu źródłowego (DriveItem) do skopiowania
• destfolderid: identyfikator folderu docelowego (musi istnieć w OneDrive użytkownika)

Parametry opcjonalne:

• newfilename: Nowa nazwa skopiowanego elementu (domyślnie jest to oryginalna nazwa)

przenieść plik lub folder w moim OneDrive

Przenosi plik lub folder (DriveItem) do folderu docelowego w OneDrive użytkownika. Ta operacja jest asynchroniczna. Użyj checkOperationStatusInMyOnedrive, aby monitorować postęp.

Wymagane parametry:

• sourcefileid: Identyfikator pliku lub folderu źródłowego (DriveItem) do przeniesienia
• destfolderid: identyfikator folderu docelowego (musi istnieć w OneDrive użytkownika)

Parametry opcjonalne:

• newfilename: Nowa nazwa przeniesionego elementu (domyślnie jest to oryginalna nazwa)

sprawdźStatusOperacjiWMoimOneDrive

Sprawdza stan operacji asynchronicznej, takiej jak kopiowanie lub przenoszenie, przy użyciu tokenu operacji zwróconego z oryginalnej operacji. Zwraca informacje o postępie, jeśli nadal są w toku, szczegóły błędu, jeśli nie powiodło się, lub końcowe metadane pliku lub folderu po pomyślnym zakończeniu.

Wymagane parametry:

• operationToken: Token operacji zwrócony z operacji asynchronicznej, takiej jak copyFileOrFolderInMyOnedrive lub moveFileOrFolderInMyOnedrive

Kluczowe funkcje

zarządzanie OneDrive

• Pobiera informacje o usłudze OneDrive, takie jak przydział i właściciel
• Uzyskaj dostęp do osobistego konta OneDrive użytkownika
• Wszystkie operacje dotyczą usługi OneDrive uwierzytelnionego użytkownika

Wyszukiwanie i odnajdywanie plików

• Wyszukiwanie plików i folderów według nazwy w OneDrive użytkownika
• Pobieranie metadanych pliku lub folderu według identyfikatora lub adresu URL udostępniania
• Przeglądaj zawartość folderów (do 20 pozycji).

Operacje na plikach

• Tworzenie plików tekstowych i binarnych (≤5 MB)
• Odczytywanie plików tekstowych i binarnych (≤5 MB)
• Usuwanie plików za pomocą kontrolki współbieżności
• Zmienianie nazwy plików przy użyciu ochrony eTag
• Asynchroniczne kopiowanie i przenoszenie plików i folderów

Zarządzanie folderami

• Utwórz foldery z opcjonalnymi ścieżkami nadrzędnymi
• Automatyczny przyrostek numeryczny dla zduplikowanych nazw folderów.
• Wyświetlanie zawartości folderu (maksymalnie 20 elementów)
• Pobieranie metadanych folderu
• Usuwanie folderów za pomocą kontrolki współbieżności
• Zmienianie nazw folderów za pomocą ochrony eTag

Udostępnianie i uprawnienia

• Udostępnianie plików i folderów użytkownikom
• Kontrola dostępu oparta na rolach (odczyt, zapis)
• Powiadomienia e-mail do udostępnienia.
• Niestandardowe wiadomości w zaproszeniach.

Zabezpieczenia i zgodność

• Stosuj i usuwaj etykiety poufności.
• Użyj wielu metod przypisywania, w tym standardowych, uprzywilejowanych i automatycznych.
• Obsługa uzasadnienia audytu.
• Użyj kontroli współbieżności za pomocą znaczników ETag.

Notatki

• Wszystkie operacje są przeznaczone dla OneDrive osobistych uwierzytelnionych użytkowników.
• Operacje na plikach są ograniczone do plików o rozmiarze 5 MB lub mniejszym podczas przesyłania i pobierania.
• Operacje usuwania i zmieniania nazw obsługują tagi eTag dla kontrolki współbieżności.
• Udostępnianie wymaga prawidłowych adresów e-mail i odpowiednich uprawnień.
• Etykiety poufności wymagają odpowiednich licencji i konfiguracji.
• Lista folderów zwraca domyślnie maksymalnie 20 elementów.