- Richiesta HTTP
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
Inserisce un nuovo file.
Questo metodo supporta un URI /upload e accetta i contenuti multimediali caricati con le seguenti caratteristiche:
- Dimensione massima del file: 5120 GB
- Tipi MIME multimediali accettati:
*/*
Nota: specifica un tipo MIME valido, anziché il valore letterale */*
. Il valore letterale */*
viene utilizzato solo per indicare che è possibile caricare qualsiasi tipo MIME valido.
Per ulteriori informazioni sul caricamento dei file, consulta l'articolo Caricamento dei dati dei file.
Le app che creano scorciatoie con files.insert
devono specificare il tipo MIME application/vnd.google-apps.shortcut
.
Le app devono specificare un'estensione file nella proprietà title
quando vengono inseriti file con l'API. Ad esempio, un'operazione per inserire un file JPEG deve specificare qualcosa come "title": "cat.jpg"
nei metadati.
Le richieste GET
successive includono la proprietà fileExtension
di sola lettura compilata con l'estensione originariamente specificata nella proprietà title
. Quando un utente di Google Drive richiede il download di un file o quando il file viene scaricato tramite il client di sincronizzazione, Drive crea un nome file completo (con estensione) basato sul titolo. Nei casi in cui manca l'estensione, Drive tenta di determinarla in base al tipo MIME del file.
Richiesta HTTP
- URI di caricamento, per le richieste di caricamento di contenuti multimediali:
POST https://www.googleapis.com/upload/drive/v2/files
- URI metadati, per richieste di soli metadati:
POST https://www.googleapis.com/drive/v2/files
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri di ricerca
Parametri | |
---|---|
uploadType |
Il tipo di richiesta di caricamento nell'URI I valori accettati sono:
|
convert |
Indica se convertire questo file nel formato corrispondente degli editor di documenti. |
enforceSingleParent |
Obsoleta: la creazione di file in più cartelle non è più supportata. |
ocr |
Indica se tentare l'OCR sui caricamenti in formato .jpg, .png, .gif o .pdf. |
ocrLanguage |
Se l'ocr è true, suggerisce la lingua da utilizzare. I valori validi sono codici BCP 47. |
pinned |
Indica se fissare la revisione principale del file caricato. Un file può avere al massimo 200 revisioni bloccate. |
supportsAllDrives |
Indica se l'applicazione richiedente supporta sia I miei Drive sia i Drive condivisi. |
supportsTeamDrives |
Obsoleto: utilizza |
timedTextLanguage |
La lingua del testo sincronizzato. |
timedTextTrackName |
Il nome della traccia di testo a tempo. |
useContentAsIndexableText |
Indica se utilizzare i contenuti come testo indicizzabile. |
visibility |
La visibilità del nuovo file. Questo parametro è pertinente solo se convert=false. |
includePermissionsForView |
Specifica quali autorizzazioni di visualizzazione aggiuntive includere nella risposta. È supportato soltanto l'elemento |
includeLabels |
Un elenco separato da virgole di ID delle etichette da includere nella parte |
Corpo della richiesta
Il corpo della richiesta contiene un'istanza di File
.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di File
.
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/docs
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.apps.readonly
https://www.googleapis.com/auth/drive.file
Alcuni ambiti sono limitati e richiedono una valutazione di sicurezza affinché l'app li utilizzi. Per ulteriori informazioni, consulta la Guida alle autorizzazioni.