Method: files.update

Consente di aggiornare i metadati e/o i contenuti di un file. Quando chiami questo metodo, compila solo i campi della richiesta che vuoi modificare. Durante l'aggiornamento dei campi, alcuni campi potrebbero essere modificati automaticamente, ad esempio modifiedDate. Questo metodo supporta la semantica delle patch.

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.

Richiesta HTTP

  • URI di caricamento, per le richieste di caricamento di contenuti multimediali:
    PATCH https://www.googleapis.com/upload/drive/v3/files/{fileId}
  • URI metadati, per richieste di soli metadati:
    PATCH https://www.googleapis.com/drive/v3/files/{fileId}

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
uploadType

string

Il tipo di richiesta di caricamento nell'URI /upload. Se carichi dati con un URI /upload, questo campo è obbligatorio. Se stai creando un file di soli 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 accettati sono:

  • media - Caricamento semplice. Carica solo i contenuti multimediali, senza metadati.
  • multipart - Caricamento multiparte. 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 richiesta include i metadati.
fileId

string

L'ID del file.

Parametri di ricerca

Parametri
uploadType

string

Il tipo di richiesta di caricamento nell'URI /upload. Se carichi dati con un URI /upload, questo campo è obbligatorio. Se stai creando un file di soli 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 accettati sono:

  • media - Caricamento semplice. Carica solo i contenuti multimediali, senza metadati.
  • multipart - Caricamento multiparte. 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 richiesta include i metadati.
addParents

string

Un elenco separato da virgole di ID principali da aggiungere.
enforceSingleParent
(deprecated)

boolean

Obsoleto: l'aggiunta di file a più cartelle non è più supportata. Usa le scorciatoie.
keepRevisionForever

boolean

Indica se impostare il campo "keepForever" nella nuova revisione principale. Questo vale solo per i file con contenuti binari su Google Drive. Puoi conservare per sempre solo 200 revisioni del file. Se viene raggiunto il limite, prova a eliminare le revisioni bloccate.
ocrLanguage

string

Suggerimento sulla lingua per l'elaborazione del riconoscimento ottico dei caratteri (OCR) durante l'importazione delle immagini (codice ISO 639-1).
removeParents

string

Un elenco separato da virgole di ID principali da rimuovere.
supportsAllDrives

boolean

Indica se l'applicazione richiedente supporta sia I miei Drive sia i Drive condivisi.
supportsTeamDrives
(deprecated)

boolean

Obsoleto: utilizza supportsAllDrives.
useContentAsIndexableText

boolean

Indica se utilizzare i contenuti caricati come testo indicizzabile.
includePermissionsForView

string

Specifica quali autorizzazioni di visualizzazione aggiuntive includere nella risposta. È supportato solo lo stato "pubblicato".
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/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.scripts

Alcuni ambiti sono limitati e richiedono una valutazione di sicurezza affinché l'app li utilizzi. Per ulteriori informazioni, consulta la Guida alle autorizzazioni.