Method: files.insert

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 dei contenuti 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.

Quando inseriscono file con l'API, le app devono specificare un'estensione del file nella proprietà title. Ad esempio, un'operazione per inserire un file JPEG deve specificare qualcosa come "title": "cat.jpg" nei metadati.

Le successive richieste GET 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. Nei casi in cui 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 dei contenuti multimediali:
    POST https://www.googleapis.com/upload/drive/v2/files
  • URI dei metadati, per le richieste solo con metadati:
    POST https://www.googleapis.com/drive/v2/files

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
convert

boolean

Se convertire questo file nel formato corrispondente degli editor di documenti.
enforceSingleParent
(deprecated)

boolean

Ritirato: la creazione di file in più cartelle non è più supportata.
ocr

boolean

Se tentare l'OCR sui caricamenti di file .jpg, .png, .gif o .pdf.
ocrLanguage

string

Se ocr è true, suggerimenti sulla 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

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 in formato timed text.
timedTextTrackName

string

Il nome della traccia di testo in formato timed text.
uploadType

string

Il tipo di richiesta di caricamento all'URI /upload. Se carichi dati con un URI /upload, questo campo è obbligatorio. Se stai creando un file solo con i metadati, questo campo non è obbligatorio. Inoltre, questo campo non viene visualizzato nel widget "Prova questo metodo" perché non supporta i caricamenti di dati.

I valori accettabili sono:

  • media - Caricamento semplice. Carica solo i contenuti multimediali, senza metadati.
  • multipart - Caricamento in più parti. Carica sia i contenuti multimediali che i relativi metadati in un'unica richiesta.
  • resumable - Caricamento ripristinabile. Carica il file in modo ripristinabile, utilizzando una serie di almeno due richieste in cui la prima include i metadati.
useContentAsIndexableText

boolean

Se utilizzare i contenuti come testo indicizzabile.
visibility

enum (Visibility)

La visibilità del nuovo file. Le autorizzazioni vengono comunque ereditate dalle cartelle principali. Questo parametro è pertinente solo quando convert=false.
includePermissionsForView

string

Specifica quali autorizzazioni di visualizzazione aggiuntive 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 soggetti a restrizioni e richiedono una valutazione della sicurezza per poter essere utilizzati dalla tua app. Per ulteriori informazioni, consulta la Guida all'autorizzazione.