- Richiesta HTTP
- Parametri del percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
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 cambiare automaticamente, ad esempio modifiedDate. Questo metodo supporta la semantica delle patch.
Richiesta HTTP
PATCH 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 ricerca
Parametri | |
---|---|
addParents |
Elenco separato da virgole di ID principali da aggiungere. |
convert |
Deprecato: questo parametro non contiene funzioni. |
enforceSingleParent |
Obsoleto: l'aggiunta di file a più cartelle non è più supportata. Usa invece il criterio |
modifiedDateBehavior |
Determina il comportamento in cui viene aggiornato |
newRevision |
Indica se il caricamento di un blob deve creare una nuova revisione. Se il valore è false, i dati del blob nell'attuale revisione della testa vengono sostituiti. Se il valore viene impostato su true o non viene impostato, viene creato un nuovo blob come revisione principale e le revisioni sbloccate precedenti 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. Tieni presente che questo campo viene ignorato se la richiesta non contiene alcun payload. |
ocr |
Indica se tentare l'OCR sui caricamenti in formato .jpg, .png, .gif o .pdf. |
ocrLanguage |
Se l'ocr è true, suggerisce la lingua da utilizzare. I valori validi sono codici BCP 47. |
pinned |
Se fissare la nuova revisione. Un file può avere al massimo 200 revisioni bloccate. Tieni presente che questo campo viene ignorato se la richiesta non contiene alcun payload. |
removeParents |
Elenco separato da virgole di ID padre da rimuovere. |
setModifiedDate |
Indica se impostare la data di modifica utilizzando il valore fornito nel corpo della richiesta. L'impostazione di questo campo su |
supportsAllDrives |
Indica se l'applicazione richiedente supporta sia I miei Drive sia i Drive condivisi. |
supportsTeamDrives |
Obsoleto: utilizza |
timedTextLanguage |
La lingua del testo sincronizzato. |
timedTextTrackName |
Il nome della traccia di testo a tempo. |
updateViewedDate |
Indica se aggiornare la data di visualizzazione dopo aver aggiornato il file. |
useContentAsIndexableText |
Indica se utilizzare i contenuti come testo indicizzabile. |
includePermissionsForView |
Specifica quali autorizzazioni di visualizzazione aggiuntive includere nella risposta. È supportato soltanto l'elemento |
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 affinché l'app li utilizzi. Per ulteriori informazioni, consulta la Guida alle autorizzazioni.