Questa pagina è stata tradotta dall'API Cloud Translation.

Method: files.update

Richiesta HTTP
Parametri del percorso
Parametri di ricerca
Corpo della richiesta
Corpo della risposta
Ambiti di autorizzazione
Prova!

Aggiorna i metadati e/o i contenuti 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:*/*

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.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri

Parametri
`fileId`	`string` L'ID del file.

fileId

string

L'ID del file.

Parametri di query

Parametri
`addParents`	`string` Un elenco separato da virgole di ID entità principali da aggiungere.
`enforceSingleParent (deprecated)`	`boolean` Ritiro: l'aggiunta di file a più cartelle non è più supportata. Utilizza le scorciatoie.
`keepRevisionForever`	`boolean` Indica se impostare il campo "keepForever" nella nuova revisione della sezione head. Questo vale solo per i file con contenuti binari su Google Drive. È possibile conservare definitivamente solo 200 revisioni del file. Se il limite è raggiunto, prova a eliminare le revisioni bloccate.
`ocrLanguage`	`string` Un suggerimento per la lingua per l'elaborazione OCR durante l'importazione delle immagini (codice ISO 639-1).
`removeParents`	`string` Un elenco separato da virgole di ID entità principali da rimuovere.
`supportsAllDrives`	`boolean` Indica se l'applicazione richiedente supporta sia Il mio Drive sia i Drive condivisi.
`supportsTeamDrives (deprecated)`	`boolean` Deprecato: utilizza `supportsAllDrives`.
`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 caricati come testo indicizzato.
`includePermissionsForView`	`string` Specifica le autorizzazioni di visualizzazione aggiuntive da includere nella risposta. È supportato solo il valore "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/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 per poter essere utilizzati dalla tua app. Per ulteriori informazioni, consulta la Guida all'autorizzazione.