Questa pagina è stata tradotta dall'API Cloud Translation.

Method: files.insert

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 Caricare i 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 del file nella proprietà title quando inseriscono file con l'API. Ad esempio, un'operazione per inserire un file JPEG deve specificare qualcosa di simile a "title": "cat.jpg" nei metadati.

Le richieste GET successive includono la proprietà di sola lettura fileExtension compilata con l'estensione specificata originariamente nella proprietà title. Quando un utente di Google Drive richiede di scaricare un file o quando il file viene scaricato tramite il client di sincronizzazione, Drive crea un nome file completo (con estensione) in base al titolo. Se l'estensione non è presente, 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 dei metadati, per le richieste solo di metadati:
POST https://www.googleapis.com/drive/v2/files

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
`convert`	`boolean` Indica se convertire questo file nel formato dell'editor di Documenti corrispondente.
`enforceSingleParent (deprecated)`	`boolean` Ritiro: la creazione di file in più cartelle non è più supportata.
`ocr`	`boolean` Se tentare l'OCR sui caricamenti in formato .jpg, .png, .gif o .pdf.
`ocrLanguage`	`string` Se ocr è true, suggerisce la lingua da utilizzare. I valori validi sono i codici BCP 47.
`pinned`	`boolean` Indica se bloccare la revisione principale del file caricato. Un file può avere un massimo di 200 revisioni bloccate.
`supportsAllDrives`	`boolean` Indica se l'applicazione richiedente supporta sia Il mio Drive sia i Drive condivisi.
`supportsTeamDrives (deprecated)`	`boolean` Deprecato: utilizza `supportsAllDrives`.
`timedTextLanguage`	`string` La lingua del testo sincronizzato.
`timedTextTrackName`	`string` Il nome della traccia di testo sincronizzato.
`uploadType`	`string` Il tipo di richiesta di caricamento all'URI `/upload`. Se carichi i dati con un URI `/upload`, questo campo è obbligatorio. Se stai creando un file solo di metadati, questo campo non è obbligatorio. Inoltre, questo campo non viene visualizzato nel widget "Prova questo metodo" perché il widget non supporta i caricamenti di dati. I valori accettabili sono: `media` - Caricamento semplice. Carica solo i contenuti multimediali, senza metadati. `multipart` - Caricamento suddiviso in più parti. Carica sia i contenuti multimediali sia i relativi metadati in un'unica richiesta. `resumable` - Caricamento ripristinabile. Carica il file in modo da poterlo riprendere, utilizzando una serie di almeno due richieste in cui la prima include i metadati.
`useContentAsIndexableText`	`boolean` Indica se utilizzare i contenuti come testo indicizzato.
`visibility`	`enum (Visibility)` La visibilità del nuovo file. Questo parametro è pertinente solo quando convert=false.
`includePermissionsForView`	`string` Specifica le autorizzazioni di visualizzazione aggiuntive da includere nella risposta. È supportato solo `published`.
`includeLabels`	`string` Un elenco separato da virgole di ID delle etichette da includere nella parte `labelInfo` della risposta.

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 per poter essere utilizzati dalla tua app. Per ulteriori informazioni, consulta la Guida all'autorizzazione.