Method: files.update

Aggiorna i metadati, i contenuti o entrambi di un file.

Quando chiami questo metodo, compila solo i campi della richiesta che vuoi modificare. Quando aggiorni i campi, alcuni 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: */*

    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, vedi Tipi MIME supportati per Google Workspace e Google Drive.

Per ulteriori informazioni sul caricamento dei file, consulta Caricare i dati dei file.

Richiesta HTTP

  • URI di caricamento, per le richieste di caricamento dei contenuti multimediali:
    PUT https://www.googleapis.com/upload/drive/v2/files/{fileId}
  • URI dei metadati, per le richieste solo con metadati:
    PUT https://www.googleapis.com/drive/v2/files/{fileId}

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
fileId

string

L'ID del file da aggiornare.

Parametri di query

Parametri
addParents

string

Elenco separato da virgole di ID genitori da aggiungere.
convert
(deprecated)

boolean

Deprecato: questo parametro non ha alcuna funzione.
enforceSingleParent
(deprecated)

boolean

Ritirato: l'aggiunta di file a più cartelle non è più supportata. Utilizza invece shortcuts.
modifiedDateBehavior

enum (ModifiedDateBehavior)

Determina il comportamento di aggiornamento di modifiedDate. Questa azione sostituisce setModifiedDate.
newRevision

boolean

Indica se il caricamento di un blob deve creare una nuova revisione. Se è false, i dati blob nella revisione principale corrente vengono sostituiti. Se è true o non è impostato, viene creato un nuovo blob come revisione principale e le revisioni precedenti non bloccate vengono conservate per un breve periodo di tempo. Le revisioni bloccate vengono archiviate a tempo indeterminato, utilizzando una quota di spazio di archiviazione aggiuntiva, fino a un massimo di 200 revisioni. Per informazioni dettagliate su come vengono conservate le revisioni, consulta il Centro assistenza Drive.
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

Se fissare la nuova revisione. Un file può avere un massimo di 200 revisioni bloccate.
removeParents

string

Elenco separato da virgole di ID genitori da rimuovere.
setModifiedDate

boolean

Indica se impostare la data di modifica utilizzando il valore fornito nel corpo della richiesta. Impostare questo campo su true equivale a modifiedDateBehavior=fromBodyOrNow, mentre false equivale a modifiedDateBehavior=now. Per impedire modifiche alla data di modifica impostata modifiedDateBehavior=noChange.
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 codificato.
updateViewedDate

boolean

Se aggiornare la data della visualizzazione dopo l'aggiornamento del file.
uploadType

string

Il tipo di richiesta di caricamento all'URI /upload. Se carichi dati con un URI /upload, questo campo è obbligatorio. Se crei 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 sia 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.
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
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.scripts

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.