- 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:
PUT https://www.googleapis.com/upload/drive/v2/files/{fileId}
- URI dei metadati, per le richieste solo di metadati:
PUT https://www.googleapis.com/drive/v2/files/{fileId}
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
fileId |
L'ID del file da aggiornare. |
Parametri di query
Parametri | |
---|---|
addParents |
Elenco separato da virgole di ID entità principali da aggiungere. |
convert |
Deprecato: questo parametro non ha alcuna funzione. |
enforceSingleParent |
Ritiro: l'aggiunta di file a più cartelle non è più supportata. Utilizza invece |
modifiedDateBehavior |
Determina il comportamento in cui viene aggiornato |
newRevision |
Indica se un caricamento di blob deve creare una nuova revisione. Se false, i dati del 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, visita il Centro assistenza Drive. |
ocr |
Se tentare l'OCR sui caricamenti in formato .jpg, .png, .gif o .pdf. |
ocrLanguage |
Se ocr è true, suggerisce la lingua da utilizzare. I valori validi sono i codici BCP 47. |
pinned |
Se fissare la nuova revisione. Un file può avere un massimo di 200 revisioni bloccate. |
removeParents |
Elenco separato da virgole di ID entità principali da rimuovere. |
setModifiedDate |
Indica se impostare la data di modifica utilizzando il valore fornito nel corpo della richiesta. Impostare questo campo su |
supportsAllDrives |
Indica se l'applicazione richiedente supporta sia Il mio Drive sia i Drive condivisi. |
supportsTeamDrives |
Deprecato: utilizza |
timedTextLanguage |
La lingua del testo sincronizzato. |
timedTextTrackName |
Il nome della traccia di testo sincronizzato. |
updateViewedDate |
Indica se aggiornare la data della visualizzazione dopo l'aggiornamento del file. |
uploadType |
Il tipo di richiesta di caricamento all'URI I valori accettabili sono:
|
useContentAsIndexableText |
Indica se utilizzare i contenuti come testo indicizzato. |
includePermissionsForView |
Specifica le autorizzazioni di visualizzazione aggiuntive da includere nella risposta. È supportato solo |
includeLabels |
Un elenco separato da virgole di ID delle etichette da includere nella parte |
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 limitati e richiedono una valutazione di sicurezza per poter essere utilizzati dalla tua app. Per ulteriori informazioni, consulta la Guida all'autorizzazione.