OneDrive-viite (esikatselu)

Yleiskatsaus

Käytettävissä olevat työkalut

getOnedrive

Hakee tietoja käyttäjän OneDrive, mukaan lukien aseman metatiedot, kiintiön ja omistajan tiedot.

Parametreja ei tarvita.

getFolderChildrenInMyOnedrive

Luetteloi 20 parasta tiedostoa ja kansiota (DriveItems), jotka sisältyvät käyttäjän OneDrive määritettyyn pääkansioon.

Valinnaiset parametrit:

• parentFolderId: Sen pääkansion tunnus, jonka tiedostot ja kansiot haluat luetella (oletusarvo: pääkansio)

findFileOrFolderInMyOnedrive

Etsii käyttäjän OneDrive tiedoston tai kansion (DriveItem) hakukyselyllä. Tämä menetelmä on tehokkaampi kuin kaikkien helppokäyttöisten tiedostojen hakeminen, jos tiedät kohteen olevan käyttäjän OneDrive.

Pakolliset parametrit:

• searchQuery: Hakukysely; voi olla koko tiedoston nimi tai osittainen

getFileOrFolderMetadataInMyOnedrive

Hakee tiedoston tai kansion (DriveItem) metatiedot käyttäjän OneDrive.

Pakolliset parametrit:

• fileOrFolderId: tunnus tiedostosta tai käyttäjän OneDrive

getFileOrFolderMetadataByUrl

Hakee tiedoston tai kansion (DriveItem) metatiedot jako-URL-osoitteesta. Vain käyttäjät, joilla on olemassa olevat eksplisiittiset oikeudet käyttää tiedostoa, voivat saada metatiedot.

Pakolliset parametrit:

• fileOrFolderUrl: Tiedoston tai kansion URL-osoite. URL-osoitetta ei lunastetaan, jotta se voidaan jakaa käyttäjälle. Niillä on jo oltava nimenomainen käyttöoikeus.

readSmallTextFileFromMyOnedrive

Lukee (lataa) tekstitiedoston käyttäjän OneDrive.

Pakolliset parametrit:

• fileId: Lue tai lataa tiedoston tunnus (DriveItem).

createSmallTextFileInMyOnedrive

Luo tai lataa käyttäjälle alle 5 Mt:n kokoisen tekstitiedoston käyttäjän OneDrive.

Pakolliset parametrit:

• Tiedostonimi: Luotavan tiedoston nimi
• contentText: Tiedoston tekstisisältö.

Valinnaiset parametrit:

• parentFolderId: Vanhemman kansion tunnus (oletus: 'root').

createFolderInMyOnedrive

Luo uuden kansion (DriveItem) käyttäjän OneDrive määritetyn pääkansion alikohteena. Jos samanniminen kansio on jo olemassa, menetelmä lisää numeerisen liitetiedoston (esimerkiksi NewFolder (1)).

Pakolliset parametrit:

• folderName: Luotavan kansion nimi

Valinnaiset parametrit:

• parentFolderId: Vanhemman kansion tunnus (oletus: 'root').

renameFileOrFolderInMyOnedrive

Nimeää uudelleen käyttäjän OneDrive tiedoston tai kansion (DriveItem). Uuden nimen on oltava nimeämiskäytäntöjen mukainen.

Pakolliset parametrit:

• fileOrFolderId: Uudelleennimettävän tiedoston tai kansion tunnus
• newFileOrFolderName: Tiedoston tai kansion uusi nimi

Valinnaiset parametrit:

• Etag: Samanaikaisuuden hallinnan ETag-arvo. Toiminto onnistuu vain, jos DriveItemin nykyinen ETag-sähköpostiosoite vastaa

deleteFileOrFolderInMyOnedrive

Poistaa tiedoston tai kansion (DriveItem) käyttäjän OneDrive.

Pakolliset parametrit:

• fileOrFolderId: Poistettavan tiedoston tai kansion tunnus

Valinnaiset parametrit:

• Etag: Samanaikaisuuden hallinnan ETag-arvo

jaa tiedosto tai kansio omassa OneDrivessäni

Lähettää jakamiskutsun myöntääkseen luku- tai kirjoitusoikeudet tiedostoon tai kansioon (DriveItem) käyttäjän OneDrive.

Pakolliset parametrit:

• fileOrFolderId: Jaettavan tiedoston tai kansion tunnus
• recipientEmails: Kutsuttavien vastaanottajien sähköpostiosoitteiden matriisi
• Roolit: Määritettävät roolit. Hyväksytyt arvot: 'read', 'write' ('write' sallii sekä lukemisen että kirjoittamisen)

Valinnaiset parametrit:

• Viesti: Mukautettu viesti, joka sisällytetään kutsusähköpostiin. Oletusarvo: 'Tässä on tiedosto, jota olemme muokkaamassa yhdessä.'
• sendInvitation: Haluatko lähettää jakamiskutsun? Oletusarvo: true.

Määritä tunnistetietoluokitus tiedostolle omassa OneDrivessäni

Määrittää käyttäjän OneDrive tiedoston luottamuksellisuustunnisteen.

Pakolliset parametrit:

• fileId: Tiedoston tunnus (DriveItem)
• sensitivityLabelId: Määritettävän luottamuksellisuustunnisteen tunnus tai poistettava tyhjä merkkijono

Valinnaiset parametrit:

• assignmentMethod: Määritysmenetelmä: 'standard', 'privileged', 'auto' tai 'unknownFutureValue' (oletus: 'privileged')
• justificationText: oikeutusteksti valvontaa varten; pakollinen, kun selitettä alennetaan tai poistetaan (oletus: MCPServer muutti sen)

luoPieniBinaaritiedostoOmaanOneDriveen

Luo alle 5 Mt:n kokoisen binaaritiedoston koodaamalla sen sisällön käyttäjän OneDrive.

Pakolliset parametrit:

• Tiedostonimi: Luotavan tiedoston nimi, mukaan lukien tiedostotunniste
• base64Content: Binaaritiedoston sisältö, joka on koodattu base64-merkkijonoksi

Valinnaiset parametrit:

• parentFolderId: Vanhemman kansion tunnus (oletus: 'root').

readSmallBinaryFileFromMyOnedrive

Lukee alle 5 Mt:n kokoisen binaaritiedoston käyttäjän OneDrive. Palauttaa tiedoston sisällön base64-koodattuna merkkijonona.

Pakolliset parametrit:

• fileId: Lue tai lataa tiedoston tunnus (DriveItem).

Kopioi tiedosto tai kansio omassa OneDrivessä

Kopioi tiedoston tai kansion (DriveItem) käyttäjän OneDrive olevaan kohdekansioon. Tämä toiminto on asynkroninen. Käytä - checkOperationStatusInMyOnedrive mittaria edistymisen seurantaan.

Pakolliset parametrit:

• sourcefileid: Kopioitettavan lähdetiedoston tai -kansion (DriveItem) tunnus
• kohdekansion destfolderid: tunnus (sen on oltava olemassa käyttäjän OneDrive)

Valinnaiset parametrit:

• uusi tiedostonimi: Kopioidun kohteen uusi nimi (oletusarvona alkuperäinen nimi)

moveFileOrFolderInMyOnedrive

Siirtää tiedoston tai kansion (DriveItem) käyttäjän OneDrive olevaan kohdekansioon. Tämä toiminto on asynkroninen. Käytä - checkOperationStatusInMyOnedrive mittaria edistymisen seurantaan.

Pakolliset parametrit:

• sourcefileid: Siirrettävän lähdetiedoston tai -kansion (DriveItem) tunnus
• kohdekansion destfolderid: tunnus (sen on oltava olemassa käyttäjän OneDrive)

Valinnaiset parametrit:

• uusi tiedostonimi: Siirrettyjen kohteiden uusi nimi (oletusarvo on alkuperäinen nimi)

tarkistaToiminnonTilaOmassaOneDrivessa

Tarkistaa asynkronisen toiminnon, kuten kopioinnin tai siirtämisen, tilan alkuperäisestä toiminnosta palautetun toimintotunnuksen avulla. Palauttaa edistymistiedot, jos ne ovat vielä kesken, virhetiedot, jos ne epäonnistuivat, tai lopullisen tiedoston tai kansion metatiedot, jos ne on suoritettu onnistuneesti.

Pakolliset parametrit:

• operationToken: Toimintotunnus, joka on palautettu asynkronisesta toiminnosta, kuten copyFileOrFolderInMyOnedrive tai moveFileOrFolderInMyOnedrive

Tärkeimmät ominaisuudet

OneDrive hallinta

• Hakee OneDrive tietoja, kuten kiintiön ja omistajan
• Käytä käyttäjän henkilökohtaista OneDrivea
• Kaikki toiminnot kohdistavat todennetun käyttäjän OneDrive

Tiedoston haku ja etsintä

• Hae tiedostoja ja kansioita nimen mukaan käyttäjän OneDrive
• Hae tiedoston tai kansion metatiedot tunnuksen tai jaon URL-osoitteen mukaan
• Selaa kansion sisältöä (enintään 20 kohdetta).

Tiedostotoiminnot

• Teksti- ja binaaritiedostojen luominen (≤5 Mt)
• Teksti- ja binaaritiedostojen lukeminen (≤5 Mt)
• Samanaikaisuuden hallinnan tiedostojen poistaminen
• Nimeä tiedostot uudelleen eTag-suojauksella
• Tiedostojen ja kansioiden kopioiminen ja siirtäminen asynkronisesti

Kansioiden hallinta

• Luo kansioita valinnaisilla pääpoluilla
• Automaattinen numeerinen pääte kaksoiskansioiden nimille.
• Luetteloi kansion sisältö (enintään 20 kohdetta)
• Kansion metatietojen hakeminen
• Poista kansiot, joissa on samanaikaisuuden hallinta
• Nimeä kansiot uudelleen eTag-suojauksella

Jakaminen ja käyttöoikeudet

• Tiedostojen ja kansioiden jakaminen käyttäjien kanssa
• Roolipohjaisen käytön hallinta (luku, kirjoitus)
• Sähköposti-ilmoitukset jakamista varten.
• Mukautetut viestit kutsuissa.

Tietoturva ja yhteensopivuus

• Ota luottamuksellisuustunnisteet käyttöön ja poista ne.
• Käytä useita määritysmenetelmiä, kuten vakiomuotoista, etuoikeutettua ja automaattista.
• Tue auditointiperusteita.
• Käytä samanaikaisuuden hallintaa eTags-palvelun kanssa.

Huomautuksia

• Kaikki toiminnot kohdistuvat todennetun käyttäjän henkilökohtaisiin OneDrive.
• Tiedostotoiminnot on rajoitettu tiedostoihin, joiden lataaminen ja lataaminen on enintään 5 Mt.
• Toimintojen poistaminen ja uudelleennimeäminen tukevat samanaikaisuuden hallinnan eTags-tavoitteita.
• Jakaminen edellyttää kelvollisia sähköpostiosoitteita ja asianmukaisia käyttöoikeuksia.
• Luottamuksellisuustunnisteet edellyttävät asianmukaisia käyttöoikeuksia ja määrityksiä.
• Kansioluettelo palauttaa oletusarvoisesti enintään 20 kohdetta.