SharePoint Embedded

Microsoft SharePoint Embedded è un sistema di gestione di documenti e file basato sul cloud adatto per l'uso in qualsiasi applicazione. SharePoint Embedded è una soluzione solo API che consente agli sviluppatori di app di sfruttare la potenza della piattaforma di archiviazione di file e documenti di Microsoft 365 per qualsiasi app ed è adatta alle aziende che creano applicazioni line-of-business e ISV che creano applicazioni multi-tenant.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Servizio	Class	Regions
Copilot Studio	Normale	Tutte le aree di Power Automate , ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica	Normale	Tutte le aree di App per la logica , ad eccezione delle seguenti:      - Aree di Azure per enti pubblici      - Aree di Azure Cina      - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps	Normale	Tutte le aree di Power Apps , ad eccezione dei seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate	Normale	Tutte le aree di Power Automate , ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)

Contatto
Nome	Microsoft
URL	https://learn.microsoft.com/en-us/sharepoint/dev/embedded/overview
Email	spe-connector@service.microsoft.com

Metadati del connettore
Editore	Microsoft
Sito web	https://learn.microsoft.com/en-us/sharepoint/dev/embedded/overview
Informativa sulla privacy	https://privacy.microsoft.com/
Categorie	Contenuto e file

Come iniziare

Prima di poter usare il connettore SharePoint Embedded, è necessario creare un'applicazione SharePoint Embedded. Per altre informazioni e per iniziare, vedere la documentazione di SharePoint Embedded .

Concedere l'accesso al connettore SharePoint Embedded

Per consentire al connettore SharePoint Embedded di interagire con i contenitori di archiviazione file e il contenuto in un tenant, è necessario creare un applicationPermissionGrant per l'applicazione connettore SharePoint Embedded nel per tale containerTypeRegistration tenant. In questo modo il connettore SharePoint Embedded può accedere al tipo di contenitore specifico dell'app in un tenant.

Concedere full le autorizzazioni all'ID e8e1b0bf-140f-4b8b-8e94-fbe8937fad04 applicazione connettore SharePoint Embedded per delegated le chiamate tramite l'API Microsoft Graph.

PUT /storage/fileStorage/containerTypeRegistrations/{containerTypeId}/applicationPermissionGrants/e8e1b0bf-140f-4b8b-8e94-fbe8937fad04
Content-Type: application/json
{
  "delegatedPermissions": ["full"],
  "applicationPermissions": ["none"]
}

Per altre informazioni, vedere l'articolo di riferimento sull'API Create fileStorageContainerTypeAppPermissionGrant .

Problemi noti e limitazioni

• La dimensione massima supportata del file con l'attività Crea file è 10 MB
• La creazione di contenitori non è disponibile con il connettore
• È supportata solo l'autenticazione delegata

Azioni

Aggiornare il contenitore	Aggiornare un contenitore
Aggiornare il contenuto del file	Questa operazione aggiorna il contenuto di un file.
Aggiornare l'autorizzazione del contenitore	Aggiornare un'autorizzazione per un contenitore
Aggiornare le proprietà personalizzate del contenitore	Aggiornare le proprietà personalizzate di un contenitore
Archiviare il file	Questa operazione archivia un file estratto in un contenitore di SharePoint Embedded.
Attivare il contenitore	Attivare un contenitore
Autorizzazioni per la condivisione di elementi elenco	Questa operazione elenca le autorizzazioni di condivisione per un elemento in un contenitore di SharePoint Embedded.
Crea un file	Questa operazione crea un file e restituisce i metadati dell'oggetto driveItem.
Creare l'autorizzazione per il contenitore	Creare un'autorizzazione per un contenitore
Creare la cartella	Questa operazione crea una nuova cartella in un contenitore di SharePoint Embedded, a livello radice o all'interno di un'altra cartella.
Creare un'anteprima file	Questa operazione crea un'anteprima per un file in un contenitore di SharePoint Embedded.
Creare un collegamento di condivisione	Questa operazione crea un collegamento di condivisione per un file in un contenitore di SharePoint Embedded.
Creare una colonna contenitore	Creare una colonna che definisce lo schema del contenitore
Elementi dell'elenco nel contenitore	Questa operazione ottiene l'elenco di file e sottocartelle in un contenitore.
Elencare gli elementi riciclati	Questa operazione elenca gli elementi nel Cestino di un contenitore di SharePoint Embedded.
Elencare i campi dei file	Questa operazione ottiene i campi dell'elemento di elenco (metadati) associati a un file in un contenitore di SharePoint Embedded.
Elencare i contenitori	Elencare i contenitori
Elencare i contenitori riciclati	Elencare i contenitori riciclati
Elencare le anteprime	Questa operazione elenca le anteprime disponibili per un file in un contenitore di SharePoint Embedded.
Elencare le autorizzazioni del contenitore	Elencare le autorizzazioni per un contenitore
Elencare le colonne del contenitore	Elencare le colonne che definiscono lo schema del contenitore
Elencare le versioni dei file	Questa operazione elenca le versioni precedenti di un file in un contenitore di SharePoint Embedded.
Elimina colonna contenitore	Eliminare una colonna che definisce lo schema del contenitore
Elimina contenitore	Eliminare un contenitore
Elimina estrazione	Questa operazione elimina l'estrazione di un file in un contenitore di SharePoint Embedded.
Elimina file	Questa operazione elimina un file in un contenitore di SharePoint Embedded.
Eliminare elementi riciclati	Questa operazione elimina definitivamente uno o più elementi riciclati dal Cestino di un contenitore di SharePoint Embedded.
Eliminare l'autorizzazione contenitore	Eliminare un'autorizzazione per un contenitore
Eliminare l'autorizzazione di condivisione	Questa operazione elimina un'autorizzazione di condivisione specifica per un file in un contenitore di SharePoint Embedded.
Eliminare la versione del file	Questa operazione elimina una versione specifica di un file in un contenitore di SharePoint Embedded.
Eliminare un contenitore riciclato	Eliminare definitivamente un contenitore riciclato
Estrai file	Questa operazione estrae un file in un contenitore di SharePoint Embedded, che impedisce ad altri utenti di modificare il documento.
Impostare i campi dei file	Questa operazione aggiorna i campi dell'elemento di elenco (metadati) associati a un file in un contenitore di SharePoint Embedded. Usare valori Null per cancellare i valori dei campi.
Invia invito alla condivisione	Questa operazione invia un invito alla condivisione per un file in un contenitore di SharePoint Embedded.
Ottenere l'anteprima	Questa operazione ottiene un'anteprima specifica per un file in un contenitore di SharePoint Embedded.
Ottenere l'autorizzazione di condivisione	Questa operazione ottiene un'autorizzazione di condivisione specifica per un file in un contenitore di SharePoint Embedded.
Ottenere la colonna del contenitore	Ottenere una colonna del contenitore
Ottenere la versione del file	Questa operazione ottiene una versione specifica di un file in un contenitore SharePoint Embedded.
Ottenere le proprietà di un file	Questa operazione ottiene le proprietà di un file in un contenitore di SharePoint Embedded.
Ottenere proprietà personalizzate del contenitore	Ottenere proprietà personalizzate di un contenitore
Ottenere un contenitore	Ottenere un contenitore
Recupera contenuto di file	Questa operazione ottiene il contenuto di un file.
Rinomina file	Questa operazione rinomina un file in un contenitore di SharePoint Embedded.
Ripristinare gli elementi riciclati	Questa operazione ripristina uno o più elementi riciclati dal Cestino di un contenitore di SharePoint Embedded.
Ripristinare un contenitore riciclato	Ripristinare un contenitore riciclato

Aggiornare il contenitore

ID operazione:

UpdateContainer

Aggiornare un contenitore

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	ID contenitore
Description	description		string	Descrizione del contenitore
Nome visualizzato	displayName		string	Il nome del contenitore
OCR abilitato	isOcrEnabled		boolean	Indica se il riconoscimento ottico dei caratteri (OCR) è abilitato per il contenitore
Limite di versione secondaria dell'elemento	itemMinorVersionLimit		integer	Numero massimo di versioni secondarie da conservare per gli elementi nel contenitore
Controllo delle versioni degli elementi abilitato	isItemVersioningEnabled		boolean	Indica se il controllo delle versioni degli elementi è abilitato per il contenitore

Restituisce

Corpo

FileStorageContainer

Aggiornare il contenuto del file

ID operazione:

UpdateFileContent

Questa operazione aggiorna il contenuto di un file.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID file	file-id	True	string	Identificatore univoco del file
ID contenitore	container-id	True	string	Identificatore univoco del contenitore
Contenuto file (Base64)	body	True	byte	Contenuto di file con codifica Base64

Restituisce

Contenuto del file

Contenuto del file

binary

Aggiornare l'autorizzazione del contenitore

ID operazione:

UpdatePermission

Aggiornare un'autorizzazione per un contenitore

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	ID contenitore
ID autorizzazione	permission-id	True	string	ID autorizzazione
Ruoli di autorizzazione	roles	True	array of string	Ruoli da concedere all'utente

Restituisce

Corpo

FileStorageContainer.Permission

Aggiornare le proprietà personalizzate del contenitore

ID operazione:

UpdateContainerCustomProperties

Aggiornare le proprietà personalizzate di un contenitore

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	ID contenitore
			object

Restituisce

Corpo

FileStorageContainer.CustomProperties

Archiviare il file

ID operazione:

CheckInFile

Questa operazione archivia un file estratto in un contenitore di SharePoint Embedded.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	Identificatore univoco del contenitore
ID file	file-id	True	string	Identificatore univoco del file
Comment	comment		string	Commento di archiviazione associato alla versione
Archiviazione come	checkInAs		string	Stato del documento dopo l'archiviazione (pubblicato o secondario)

Attivare il contenitore

ID operazione:

ActivateContainer

Attivare un contenitore

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	ID contenitore

Autorizzazioni per la condivisione di elementi elenco

ID operazione:

ListSharingPermissions

Questa operazione elenca le autorizzazioni di condivisione per un elemento in un contenitore di SharePoint Embedded.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	Identificatore univoco del contenitore
ID elemento	file-id	True	string	Identificatore univoco dell'elemento

Restituisce

Rappresenta un elenco di autorizzazioni per un file o una cartella

Corpo

SharingPermissionsList

Crea un file

ID operazione:

CreateFile

Questa operazione crea un file e restituisce i metadati dell'oggetto driveItem.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID padre	parent-id	True	string	ID elemento unità della cartella padre o 'root'
ID contenitore	container-id	True	string	Identificatore univoco del contenitore
Nome file	file-name	True	string	Nome del file
Contenuto file (Base64)	body	True	byte	Contenuto di file con codifica Base64

Restituisce

Metadati degli elementi dell'unità

Corpo

DriveItem

Creare l'autorizzazione per il contenitore

ID operazione:

CreatePermission

Creare un'autorizzazione per un contenitore

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	ID contenitore
Ruoli di autorizzazione	roles	True	array of string	Ruoli da concedere all'utente
Nome principale dell'utente	userPrincipalName	True	string	Nome dell'entità utente di identità

Restituisce

Corpo

FileStorageContainer.Permission

Creare la cartella

ID operazione:

CreateFolder

Questa operazione crea una nuova cartella in un contenitore di SharePoint Embedded, a livello radice o all'interno di un'altra cartella.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	Identificatore univoco del contenitore
ID cartella padre	parent-id	True	string	ID della cartella padre in cui verrà creata la nuova cartella. Usare "root" per creare una cartella a livello radice del contenitore o specificare un ID cartella specifico per creare una cartella nidificata.
Nome cartella	name	True	string	Nome della cartella da creare
Comportamento dei conflitti	@microsoft.graph.conflictBehavior		string	Cosa fare se esiste già una cartella con lo stesso nome

Restituisce

Metadati degli elementi dell'unità

Corpo

DriveItem

Creare un'anteprima file

ID operazione:

CreateFilePreview

Questa operazione crea un'anteprima per un file in un contenitore di SharePoint Embedded.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	Identificatore univoco del contenitore
ID file	file-id	True	string	Identificatore univoco del file
Pagina	page		integer	Specifica il numero di pagina del documento da visualizzare in anteprima
Livello di zoom	zoom		float	Specifica il livello di zoom dell'anteprima del documento (ad esempio 0,5, 1.0, 1,5)

Restituisce

Nome	Percorso	Tipo	Descrizione
Ottenere l'URL	getUrl	string	URL che può essere usato per recuperare l'anteprima tramite una richiesta GET
Parametri Post	postParameters	string	Parametri che possono essere usati con la proprietà postUrl per recuperare l'anteprima tramite una richiesta POST
Post URL	postUrl	string	URL che può essere usato per recuperare l'anteprima tramite una richiesta POST

Creare un collegamento di condivisione

ID operazione:

CreateSharingLink

Questa operazione crea un collegamento di condivisione per un file in un contenitore di SharePoint Embedded.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	Identificatore univoco del contenitore
ID file	file-id	True	string	Identificatore univoco del file
Tipo di collegamento	type	True	string	Tipo di collegamento di condivisione da creare.
Ambito collegamento	scope		string	Ambito del collegamento di condivisione
Data di scadenza	expirationDateTime		date-time	Data e ora di scadenza del collegamento (aaaa-MM-ggTHH:mm:ssZ)

Restituisce

Rappresenta un collegamento di condivisione per un file o una cartella

Corpo

SharingLink

Creare una colonna contenitore

ID operazione:

CreateContainerColumn

Creare una colonna che definisce lo schema del contenitore

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	ID contenitore
			object

Restituisce

Corpo

FileStorageContainer.Column

Elementi dell'elenco nel contenitore

ID operazione:

ListContainerFiles

Questa operazione ottiene l'elenco di file e sottocartelle in un contenitore.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	Identificatore univoco del contenitore
ID cartella padre	parentId	True	string	ID della cartella padre da cui elencare gli elementi. Usare "root" per ottenere elementi dal livello radice del contenitore o specificare un ID cartella specifico per ottenere elementi da tale cartella
Filter	$filter		string	Criteri di filtro per i risultati (formato OData), ad esempio: parentReference/id eq '{{folderId}}' AND contains(listitem/fields/FileLeafRef, {{user_name_string}})
Seleziona	$select		string	Proprietà da includere nei risultati (delimitati da virgole)
Espandi	$expand		string	Risorse correlate da espandere nella risposta
In alto	$top		integer	Numero di risultati da restituire
Ordina per	$orderby		string	Campi e direzione per ordinare i risultati

Restituisce

Rappresenta una pagina di elementi di unità.

Corpo

DriveItemCollectionPage

Elencare gli elementi riciclati

ID operazione:

ListRecycledFiles

Questa operazione elenca gli elementi nel Cestino di un contenitore di SharePoint Embedded.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	Identificatore univoco del contenitore

Restituisce

Raccolta di elementi nel Cestino

Corpo

RecycleBinItemCollection

Elencare i campi dei file

ID operazione:

ListFileFields

Questa operazione ottiene i campi dell'elemento di elenco (metadati) associati a un file in un contenitore di SharePoint Embedded.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	Identificatore univoco del contenitore
ID file	file-id	True	string	Identificatore univoco del file

Restituisce

Nome	Percorso	Tipo	Descrizione
Etag	@odata.etag	string	Valore ETag per i campi

Elencare i contenitori

ID operazione:

ListContainers

Elencare i contenitori

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID del tipo di contenitore	containerType	True	string	Elencare i contenitori del tipo di contenitore specificato

Restituisce

Corpo

FileStorageContainer.List

Elencare i contenitori riciclati

ID operazione:

ListRecycledContainers

Elencare i contenitori riciclati

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID del tipo di contenitore	containerType	True	string	Elencare i contenitori riciclati del tipo di contenitore specificato

Restituisce

Corpo

FileStorageContainer.List

Elencare le anteprime

ID operazione:

ListFileThumbnails

Questa operazione elenca le anteprime disponibili per un file in un contenitore di SharePoint Embedded.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	Identificatore univoco del contenitore
ID file	file-id	True	string	Identificatore univoco del file

Restituisce

Rappresenta una raccolta di set di anteprime

Corpo

ThumbnailSets

Elencare le autorizzazioni del contenitore

ID operazione:

ListPermissions

Elencare le autorizzazioni per un contenitore

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	ID contenitore

Restituisce

Corpo

FileStorageContainer.Permissions.List

Elencare le colonne del contenitore

ID operazione:

ListContainerColumns

Elencare le colonne che definiscono lo schema del contenitore

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	ID contenitore
Filter	$filter		string	Filtro da applicare ai risultati

Restituisce

Corpo

FileStorageContainer.Columns.List

Elencare le versioni dei file

ID operazione:

ListFileVersions

Questa operazione elenca le versioni precedenti di un file in un contenitore di SharePoint Embedded.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	Identificatore univoco del contenitore
ID file	file-id	True	string	Identificatore univoco del file

Restituisce

Rappresenta una raccolta di versioni di file

Corpo

FileVersions

Elimina colonna contenitore

ID operazione:

DeleteContainerColumn

Eliminare una colonna che definisce lo schema del contenitore

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	ID contenitore
ID colonna	column-id	True	string	ID colonna

Elimina contenitore

ID operazione:

RecycleContainer

Eliminare un contenitore

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	ID contenitore

Elimina estrazione

ID operazione:

DiscardCheckOut

Questa operazione elimina l'estrazione di un file in un contenitore di SharePoint Embedded.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	Identificatore univoco del contenitore
ID file	file-id	True	string	Identificatore univoco del file

Elimina file

ID operazione:

DeleteFile

Questa operazione elimina un file in un contenitore di SharePoint Embedded.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	Identificatore univoco del contenitore
ID file	file-id	True	string	Identificatore univoco del file

Eliminare elementi riciclati

ID operazione:

PermanentDeleteRecycledFiles

Questa operazione elimina definitivamente uno o più elementi riciclati dal Cestino di un contenitore di SharePoint Embedded.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	Identificatore univoco del contenitore
ID elemento	ids	True	array of string	Matrice di ID elemento riciclati da eliminare definitivamente

Eliminare l'autorizzazione contenitore

ID operazione:

DeletePermission

Eliminare un'autorizzazione per un contenitore

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	ID contenitore
ID autorizzazione	permission-id	True	string	ID autorizzazione

Eliminare l'autorizzazione di condivisione

ID operazione:

DeleteSharingPermission

Questa operazione elimina un'autorizzazione di condivisione specifica per un file in un contenitore di SharePoint Embedded.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	Identificatore univoco del contenitore
ID file	file-id	True	string	Identificatore univoco del file
ID autorizzazione	permission-id	True	string	Identificatore univoco dell'autorizzazione da eliminare

Eliminare la versione del file

ID operazione:

DeleteFileVersion

Questa operazione elimina una versione specifica di un file in un contenitore di SharePoint Embedded.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	Identificatore univoco del contenitore
ID file	file-id	True	string	Identificatore univoco del file
ID versione	version-id	True	string	Identificatore univoco della versione da eliminare

Eliminare un contenitore riciclato

ID operazione:

DeleteContainer

Eliminare definitivamente un contenitore riciclato

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	ID contenitore

Estrai file

ID operazione:

CheckOutFile

Questa operazione estrae un file in un contenitore di SharePoint Embedded, che impedisce ad altri utenti di modificare il documento.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	Identificatore univoco del contenitore
ID file	file-id	True	string	Identificatore univoco del file

Impostare i campi dei file

ID operazione:

UpdateFileFields

Questa operazione aggiorna i campi dell'elemento di elenco (metadati) associati a un file in un contenitore di SharePoint Embedded. Usare valori Null per cancellare i valori dei campi.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	Identificatore univoco del contenitore
ID file	file-id	True	string	Identificatore univoco del file
			object

Restituisce

Nome	Percorso	Tipo	Descrizione
Etag	@odata.etag	string	Valore ETag per i campi

Invia invito alla condivisione

ID operazione:

SendSharingInvitation

Questa operazione invia un invito alla condivisione per un file in un contenitore di SharePoint Embedded.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	Identificatore univoco del contenitore
ID file	file-id	True	string	Identificatore univoco del file
Richiedi accesso	requireSignIn	True	boolean	Indica se il destinatario dell'invito è necessario per accedere per visualizzare l'elemento condiviso
Ruoli	roles	True	array of string	Autorizzazioni concesse ai destinatari dell'invito alla condivisione
Email	email		string	Indirizzo di posta elettronica del destinatario
Alias	alias		string	Alias del destinatario (nel caso di un destinatario di Microsoft 365)
ID dell'oggetto.	objectId		string	Identificatore univoco del destinatario in Azure Active Directory
Message	message	True	string	Messaggio personalizzato inviato come parte dell'invito alla condivisione
Invia invito	sendInvitation	True	boolean	Se true, viene inviato un collegamento di condivisione ai destinatari. Se false, viene creata un'autorizzazione ma non viene inviato alcun messaggio di invito.

Restituisce

Rappresenta un elenco di autorizzazioni per un file o una cartella

Corpo

SharingPermissionsList

Ottenere l'anteprima

ID operazione:

GetFileThumbnail

Questa operazione ottiene un'anteprima specifica per un file in un contenitore di SharePoint Embedded.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	Identificatore univoco del contenitore
ID file	file-id	True	string	Identificatore univoco del file
ID anteprima	thumbnail-id	True	string	Identificatore univoco del set di anteprime
Misura	size	True	string	Dimensioni dell'anteprima da recuperare

Restituisce

Rappresenta una singola anteprima

Corpo

Thumbnail

Ottenere l'autorizzazione di condivisione

ID operazione:

GetSharingPermission

Questa operazione ottiene un'autorizzazione di condivisione specifica per un file in un contenitore di SharePoint Embedded.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	Identificatore univoco del contenitore
ID file	file-id	True	string	Identificatore univoco del file
ID autorizzazione	permission-id	True	string	Identificatore univoco dell'autorizzazione

Restituisce

Rappresenta un'autorizzazione per un file o una cartella

Corpo

SharingPermissionResponse

Ottenere la colonna del contenitore

ID operazione:

GetContainerColumn

Ottenere una colonna del contenitore

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	ID contenitore
ID colonna	column-id	True	string	ID colonna

Restituisce

Corpo

FileStorageContainer.Column

Ottenere la versione del file

ID operazione:

GetFileVersion

Questa operazione ottiene una versione specifica di un file in un contenitore SharePoint Embedded.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	Identificatore univoco del contenitore
ID file	file-id	True	string	Identificatore univoco del file
ID versione	version-id	True	string	Identificatore univoco della versione

Restituisce

Rappresenta una versione di un file

Corpo

FileVersion

Ottenere le proprietà di un file

ID operazione:

GetFileProperties

Questa operazione ottiene le proprietà di un file in un contenitore di SharePoint Embedded.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	Identificatore univoco del contenitore
ID file	file-id	True	string	Identificatore univoco del file

Restituisce

Metadati degli elementi dell'unità

Corpo

DriveItem

Ottenere proprietà personalizzate del contenitore

ID operazione:

GetContainerCustomProperties

Ottenere proprietà personalizzate di un contenitore

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	ID contenitore

Restituisce

Corpo

FileStorageContainer.CustomProperties

Ottenere un contenitore

ID operazione:

GetContainer

Ottenere un contenitore

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	ID contenitore

Restituisce

Corpo

FileStorageContainer

Recupera contenuto di file

ID operazione:

GetFileContent

Questa operazione ottiene il contenuto di un file.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID file	file-id	True	string	Identificatore univoco del file
ID contenitore	container-id	True	string	Identificatore univoco del contenitore

Rinomina file

ID operazione:

RenameFile

Questa operazione rinomina un file in un contenitore di SharePoint Embedded.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	Identificatore univoco del contenitore
ID file	file-id	True	string	Identificatore univoco del file
Nome	name		string	Nuovo nome del file

Restituisce

Metadati degli elementi dell'unità

Corpo

DriveItem

Ripristinare gli elementi riciclati

ID operazione:

RestoreRecycledFiles

Questa operazione ripristina uno o più elementi riciclati dal Cestino di un contenitore di SharePoint Embedded.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	Identificatore univoco del contenitore
ID elemento	ids	True	array of string	Matrice di ID elemento riciclati da ripristinare

Restituisce

Nome	Percorso	Tipo	Descrizione
value	value	array of object
ID elemento	value.id	string	ID dell'elemento ripristinato

Ripristinare un contenitore riciclato

ID operazione:

RestoreContainer

Ripristinare un contenitore riciclato

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	ID contenitore

Restituisce

Corpo

FileStorageContainer

Trigger

Monitorare le modifiche degli elementi in un contenitore

Attivare quando gli elementi vengono aggiunti, modificati o eliminati in un contenitore di SharePoint Embedded

Monitorare le modifiche degli elementi in un contenitore

ID operazione:

GetChangesContainer

Attivare quando gli elementi vengono aggiunti, modificati o eliminati in un contenitore di SharePoint Embedded

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID contenitore	container-id	True	string	ID del contenitore da monitorare
Intervallo di polling (secondi)	pollingInterval		integer	Frequenza con cui verificare la presenza di modifiche (60-3600 secondi, impostazione predefinita: 300)

Restituisce

Nome	Percorso	Tipo	Descrizione
value	value	array of DriveItem	Elenco di elementi modificati
@odata.deltaLink	@odata.deltaLink	string	Collegamento delta per la richiesta di polling successiva
@odata.context	@odata.context	string	@odata.context

Definizioni

FileStorageContainer

Nome	Percorso	Tipo	Descrizione
ID contenitore	id	string	ID contenitore
ID del tipo di contenitore	containerTypeId	string	ID del tipo di contenitore a cui appartiene questo contenitore
Description	description	string	Descrizione del contenitore
Nome visualizzato	displayName	string	Il nome del contenitore
Ora di creazione	createdDateTime	date-time	Data e ora di creazione del contenitore
customProperties	customProperties	FileStorageContainer.CustomProperties
permissions	permissions	FileStorageContainer.Permissions
status	status	string	Stato del contenitore

FileStorageContainer.List

Nome	Percorso	Tipo	Descrizione
value	value	array of FileStorageContainer

FileStorageContainer.Permissions

Nome	Percorso	Tipo	Descrizione
Elementi		FileStorageContainer.Permission

FileStorageContainer.Permission

Nome	Percorso	Tipo	Descrizione
ID autorizzazione	id	string	ID autorizzazione
Ruoli di autorizzazione	roles	FileStorageContainer.Permission.Roles	Ruoli da concedere all'utente
Nome visualizzato	grantedToV2.user.displayName	string	Nome visualizzato dell'identità
Email	grantedToV2.user.email	string	Indirizzo di posta elettronica di identità
Nome principale dell'utente	grantedToV2.user.userPrincipalName	string	Nome dell'entità utente di identità

FileStorageContainer.Permission.Roles

Ruoli da concedere all'utente

Nome	Percorso	Tipo	Descrizione
Elementi		string

FileStorageContainer.Permissions.List

Nome	Percorso	Tipo	Descrizione
value	value	FileStorageContainer.Permissions

FileStorageContainer.CustomProperties

FileStorageContainer.Column

Nome	Percorso	Tipo	Descrizione
ID colonna	id	string	Identificatore univoco per la colonna
Nome della colonna	name	string	Nome visualizzato della colonna
Description	description	string	Descrizione della colonna
Imponi valori univoci	enforceUniqueValues	boolean	Indica se i valori di colonna devono essere univoci
Nascosto	hidden	boolean	Indica se la colonna viene visualizzata nell'interfaccia utente
Indicizzato	indexed	boolean	Indica se la colonna è indicizzata
Obbligatorio	required	boolean	Indica se la colonna è obbligatoria
Sola lettura	readOnly	boolean	Indica se i valori delle colonne possono essere modificati
Gruppo di colonne	columnGroup	string	Gruppo a cui appartiene questa colonna
Nome visualizzato	displayName	string	Nome visualizzato della colonna
Is Deletable	isDeletable	boolean	Indica se questa colonna può essere eliminata.
Riordinabile	isReorderable	boolean	Indica se questa colonna può essere riordinata.
È sealed	isSealed	boolean	Specifica se la colonna può essere modificata.
Propaga modifiche	propagateChanges	boolean	Se true, le modifiche apportate a questa colonna verranno propagate agli elenchi che implementano la colonna.
Colonna valore predefinito - Formula	defaultValue.formula	string	Formula utilizzata per calcolare il valore predefinito per la colonna.
Colonna valore predefinito - Valore	defaultValue.value	string	Valore diretto da usare come valore predefinito per la colonna.
Colonna di testo - Lunghezza massima	text.maxLength	integer	Lunghezza massima del testo
Colonna di testo - Consenti più righe	text.allowMultipleLines	boolean	Indica se consentire più righe di testo
Colonna di testo - Accodamento modifiche	text.appendChangesToExistingText	boolean	Indica se gli aggiornamenti a questa colonna devono essere aggiunti al testo esistente
Colonna di testo - Righe per la modifica	text.linesForEditing	integer	Numero di righe di testo da visualizzare nei controlli di modifica
Colonna testo - Tipo di testo	text.textType	string	Tipo di testo archiviato
Colonna numero - Posizioni decimali	number.decimalPlaces	string	Numero di posizioni decimali da visualizzare
Colonna numero - Visualizza come	number.displayAs	string	Come visualizzare il numero
Colonna numero - Massimo	number.maximum	number	Valore massimo consentito
Colonna numero - Minimo	number.minimum	number	Valore minimo consentito
boolean	boolean	object	Impostazioni per le colonne booleane
Colonna DateTime - Visualizza come	dateTime.displayAs	string	Come visualizzare la data e l'ora
Colonna DateTime - Formato	dateTime.format	string	Indica se includere l'ora con la data
Colonna Scelta - Consenti voce di testo	choice.allowTextEntry	boolean	Indica se è possibile immettere valori personalizzati
Colonna Scelta - Scelte	choice.choices	array of string	Elenco di scelte per la colonna
Colonna Scelta - Visualizza come	choice.displayAs	string	Come visualizzare le scelte
Colonna di ricerca - Consenti più valori	lookup.allowMultipleValues	boolean	Indica se è possibile selezionare più valori
Colonna di ricerca - Consenti lunghezza illimitata	lookup.allowUnlimitedLength	boolean	Indica se i valori nella colonna devono essere in grado di superare il limite standard di 255 caratteri.
Colonna di ricerca - ID elenco	lookup.listId	string	L'ID dell'elenco da cui proviene questa ricerca ottiene informazioni
Colonna di ricerca - ID colonna di ricerca primaria	lookup.primaryLookupColumnId	string	ID della colonna da cui ottenere informazioni
Colonna Valuta - Impostazioni locali	currency.locale	string	Impostazioni locali per la valuta
Colonna PersonOrGroup - Consenti selezione multipla	personOrGroup.allowMultipleSelection	boolean	Se è possibile selezionare più persone o gruppi
Colonna PersonOrGroup - Scegliere tra tipo	personOrGroup.chooseFromType	string	Tipi di persone o gruppi che possono essere selezionati
Colonna PersonOrGroup - Visualizza come	personOrGroup.displayAs	string	Come visualizzare le persone o i gruppi
Colonna HyperlinkOrPicture - Immagine	hyperlinkOrPicture.isPicture	boolean	Indica se il collegamento ipertestuale è un'immagine
Colonna calcolata - Formula	calculated.formula	string	Formula per il calcolo
Colonna calcolata - Tipo di output	calculated.outputType	string	Tipo dell'output
Colonna calcolata - Formato	calculated.format	string	Indica se includere l'ora con la data
Colonna di georilevazione	geolocation	object	Impostazioni per le colonne di posizione
Proprietà delle colonne di anteprima	thumbnail	object	Impostazioni per le colonne di anteprima
Proprietà della colonna Stato approvazione contenuto	contentApprovalStatus	object	Questa colonna archivia lo stato di approvazione del contenuto.
Colonna termini - Consenti più valori	term.allowMultipleValues	boolean	Indica se è possibile selezionare più valori
Colonna termini - Mostra nome completo	term.showFullyQualifiedName	boolean	Specifica se visualizzare l'intero percorso del termine o solo l'etichetta del termine.
ID tipo di contenuto	sourceContentType.id	string	ID del tipo di contenuto.
Nome tipo di contenuto	sourceContentType.name	string	Nome del tipo di contenuto.

FileStorageContainer.Columns.List

Nome	Percorso	Tipo	Descrizione
value	value	array of FileStorageContainer.Column

DriveItemCollectionPage

Rappresenta una pagina di elementi di unità.

Nome	Percorso	Tipo	Descrizione
value	value	array of DriveItem	Raccolta di elementi unità.
@odata.nextLink	@odata.nextLink	string	URL che può essere usato per recuperare la pagina successiva.

DriveItem

Metadati degli elementi dell'unità

Nome	Percorso	Tipo	Descrizione
Scaricare l'URL	@microsoft.graph.downloadUrl	string	URL che può essere usato per scaricare il contenuto di questo elemento
URL di download (nessuna autenticazione)	@microsoft.graph.downloadUrlNoAuth	string	URL che può essere usato per scaricare il contenuto di questo elemento senza autenticazione
Documento d'identità	id	string	Identificatore univoco del file o della cartella
Nome	name	string	Nome del file o della cartella
Misura	size	integer	Dimensioni del file o della cartella in byte
URL Web	webUrl	string	URL che visualizza l'elemento nel browser
Ora di creazione	createdDateTime	date-time	Data e ora di creazione del file o della cartella
Ora ultima modifica	lastModifiedDateTime	date-time	Data e ora dell'ultima modifica del file o della cartella
Etag	eTag	string	Etag del file o della cartella
CTag	cTag	string	Tag che indica che il contenuto è stato modificato
Tipo di disco	parentReference.driveType	string	Tipo di unità contenente l'elemento
Unità ID	parentReference.driveId	string	ID dell'unità contenente l'elemento
ID padre	parentReference.id	string	ID della cartella padre
Nome padre	parentReference.name	string	Nome della cartella padre
Percorso padre	parentReference.path	string	Percorso della cartella padre
ID sede	parentReference.siteId	string	ID del sito contenente l'elemento
ID dell'applicazione	createdBy.application.id	string	ID dell'applicazione che ha creato l'elemento
Nome dell'applicazione	createdBy.application.displayName	string	Nome visualizzato dell'applicazione che ha creato l'elemento
ID utente	createdBy.user.id	string	ID dell'utente che ha creato l'elemento
Nome utente	createdBy.user.displayName	string	Nome visualizzato dell'utente che ha creato l'elemento
ID dell'applicazione	lastModifiedBy.application.id	string	ID dell'applicazione che ha modificato l'ultimo elemento
Nome dell'applicazione	lastModifiedBy.application.displayName	string	Nome visualizzato dell'applicazione che ha modificato l'ultimo elemento
ID utente	lastModifiedBy.user.id	string	ID dell'utente che ha modificato l'ultimo elemento
Nome utente	lastModifiedBy.user.displayName	string	Nome visualizzato dell'utente che ha modificato l'ultimo elemento
Tipo MIME	file.mimeType	string	Tipo MIME del file
QuickXor Hash	file.hashes.quickXorHash	string	Hash QuickXor del file
Ora di creazione	fileSystemInfo.createdDateTime	date-time	Data e ora di creazione del file o della cartella nel file system
Ora ultima modifica	fileSystemInfo.lastModifiedDateTime	date-time	Data e ora dell'ultima modifica del file o della cartella nel file system
Conteggio figli	folder.childCount	integer	Numero di elementi nella cartella
Ambito di condivisione	shared.scope	string	Ambito della condivisione (utenti, organizzazione o chiunque)

SharingLink

Rappresenta un collegamento di condivisione per un file o una cartella

Nome	Percorso	Tipo	Descrizione
ID collegamento	id	string	Identificatore univoco per il collegamento di condivisione
Tipo di collegamento	link.type	string	Tipo di collegamento di condivisione (visualizzazione, modifica, incorporamento)
Ambito collegamento	link.scope	string	Ambito del collegamento di condivisione
URL Web	link.webUrl	string	URL per il collegamento di condivisione
nome visualizzato	link.application.displayName	string	Nome visualizzato dell'applicazione
id	link.application.id	string	Identificatore univoco per l'applicazione

SharingPermissionResponse

Rappresenta un'autorizzazione per un file o una cartella

Nome	Percorso	Tipo	Descrizione
ID autorizzazione	id	string	Identificatore univoco dell'autorizzazione
Ruoli	roles	array of string	Ruoli concessi per questa autorizzazione
ID condivisione	shareId	string	Token univoco che può essere usato per accedere a questo elemento condiviso tramite l'API delle condivisioni
Nome visualizzato	grantedTo.user.displayName	string	Nome visualizzato dell'utente
Email	grantedTo.user.email	string	Indirizzo di posta elettronica dell'utente
ID utente	grantedTo.user.id	string	Identificatore univoco dell'utente
Ambito collegamento	link.scope	string	Ambito del collegamento
Tipo di collegamento	link.type	string	Tipo di collegamento
URL Web	link.webUrl	string	URL del collegamento
Email	invitation.email	string	Indirizzo di posta elettronica a cui è stato inviato l'invito
Accesso obbligatorio	invitation.signInRequired	boolean	Indica se l'accesso è necessario per accedere all'elemento condiviso
Data di scadenza	expirationDateTime	date-time	Data e ora di scadenza dell'autorizzazione
Concesso alle identità	grantedToIdentities	array of object	Se specificato, limita la condivisione solo agli utenti elencati
Nome visualizzato	grantedToIdentities.user.displayName	string	Nome visualizzato dell'utente
Email	grantedToIdentities.user.email	string	Indirizzo di posta elettronica dell'utente
ID utente	grantedToIdentities.user.id	string	Identificatore univoco dell'utente

SharingPermissionsList

Rappresenta un elenco di autorizzazioni per un file o una cartella

Nome	Percorso	Tipo	Descrizione
value	value	array of SharingPermissionResponse

FileVersion

Rappresenta una versione di un file

Nome	Percorso	Tipo	Descrizione
ID versione	id	string	ID della versione
Modificato da	lastModifiedBy.user.displayName	string	Nome dell'utente che ha modificato la versione
ID utente	lastModifiedBy.user.id	string	ID dell'utente che ha modificato la versione
Ultima modifica	lastModifiedDateTime	date-time	Data e ora dell'ultima modifica di questa versione
Misura	size	integer	Dimensioni della versione in byte
Livello pubblicazione	publication.level	string	Livello di pubblicazione di questa versione (pubblicato o checkout)
ID versione	publication.versionId	string	ID della versione da pubblicare

FileVersions

Rappresenta una raccolta di versioni di file

Nome	Percorso	Tipo	Descrizione
value	value	array of FileVersion	Raccolta di versioni di file

ThumbnailSet

Rappresenta un set di anteprime per un file

Nome	Percorso	Tipo	Descrizione
ID set di anteprime	id	string	Identificatore univoco del set di anteprime
grande	large	Thumbnail	Rappresenta una singola anteprima
medium	medium	Thumbnail	Rappresenta una singola anteprima
piccolo	small	Thumbnail	Rappresenta una singola anteprima
source	source	Thumbnail	Rappresenta una singola anteprima

Immagine di anteprima

Rappresenta una singola anteprima

Nome	Percorso	Tipo	Descrizione
Altezza	height	integer	Altezza dell'anteprima, in pixel
Larghezza	width	integer	Larghezza dell'anteprima, in pixel
URL	url	string	URL dell'anteprima

ThumbnailSets

Rappresenta una raccolta di set di anteprime

Nome	Percorso	Tipo	Descrizione
value	value	array of ThumbnailSet	Raccolta di set di anteprime

RecycleBinItem

Rappresenta un elemento nel Cestino

Nome	Percorso	Tipo	Descrizione
Documento d'identità	id	string	Identificatore univoco dell'elemento riciclato
Nome	name	string	Nome dell'elemento riciclato
Misura	size	integer	Dimensioni dell'elemento in byte
Data eliminata	deletedDateTime	date-time	Data e ora di eliminazione dell'elemento
Eliminato dal percorso	deletedFromLocation	string	URL relativo della posizione che conteneva originariamente l'elemento
Titolo	title	string	Titolo dell'elemento riciclato
Eliminato da	deletedBy.user.displayName	string	Nome visualizzato dell'utente che ha eliminato l'elemento
Email	deletedBy.user.email	string	Messaggio di posta elettronica dell'utente che ha eliminato l'elemento
ID utente	deletedBy.user.id	string	Identificatore univoco dell'utente che ha eliminato l'elemento

RecycleBinItemCollection

Raccolta di elementi nel Cestino

Nome	Percorso	Tipo	Descrizione
value	value	array of RecycleBinItem	Raccolta di elementi nel Cestino

binario

Questo è il tipo di dati di base 'binario'.