Risorsa: file
I metadati di un file.
Alcuni metodi delle risorse (come files.update
) richiedono un fileId
. Utilizza il metodo files.list
per recuperare l'ID di un file.
Rappresentazione JSON |
---|
{ "kind": string, "driveId": string, "fileExtension": string, "copyRequiresWriterPermission": boolean, "md5Checksum": string, "contentHints": { "indexableText": string, "thumbnail": { "image": string, "mimeType": string } }, "writersCanShare": boolean, "viewedByMe": boolean, "mimeType": string, "exportLinks": { string: string, ... }, "parents": [ string ], "thumbnailLink": string, "iconLink": string, "shared": boolean, "lastModifyingUser": { object ( |
Campi | |
---|---|
kind |
Solo output. Identifica il tipo di risorsa. Valore: la stringa fissa |
driveId |
Solo output. ID del Drive condiviso in cui si trova il file. Compilato solo per gli elementi dei Drive condivisi. |
fileExtension |
Solo output. Il componente finale di |
copyRequiresWriterPermission |
Indica se le opzioni per copiare, stampare o scaricare il file devono essere disattivate per lettori e commentatori. |
md5Checksum |
Solo output. Il checksum MD5 per i contenuti del file. Questo vale solo per i file con contenuti binari su Google Drive. |
contentHints |
Ulteriori informazioni sui contenuti del file. Questi campi non vengono mai compilati nelle risposte. |
contentHints.indexableText |
Testo da indicizzare per il file al fine di migliorare le query fullText. Ha una lunghezza massima di 128 kB e può contenere elementi HTML. |
contentHints.thumbnail |
Una miniatura per il file. Verrà utilizzato solo se Google Drive non può generare una miniatura standard. |
contentHints.thumbnail.image |
I dati delle miniature sono codificati con Base64 con protezione dell'URL (RFC 4648 sezione 5). Una stringa con codifica Base64. |
contentHints.thumbnail.mimeType |
Il tipo MIME della miniatura. |
writersCanShare |
Indica se gli utenti con autorizzazione |
viewedByMe |
Solo output. Indica se il file è stato visualizzato da questo utente. |
mimeType |
Il tipo MIME del file. Google Drive tenta di rilevare automaticamente un valore appropriato dai contenuti caricati, se non viene fornito alcun valore. Il valore non può essere modificato a meno che non venga caricata una nuova revisione. Se un file viene creato con un tipo MIME di documento Google, i contenuti caricati vengono importati, se possibile. I formati di importazione supportati sono pubblicati nella risorsa Informazioni. |
exportLinks |
Solo output. Link per esportare i file degli editor di documenti in formati specifici. Un oggetto contenente un elenco di |
parents[] |
Gli ID delle cartelle principali che contengono il file. Se non viene specificato nell'ambito di una richiesta di creazione, il file viene inserito direttamente nella cartella Il mio Drive dell'utente. Se non viene specificato nell'ambito di una richiesta di copia, il file eredita tutti gli elementi principali rilevabili del file di origine. Le richieste file.update devono utilizzare i parametri |
thumbnailLink |
Solo output. Un link di breve durata alla miniatura del file, se disponibile. In genere dura in base a ore. Compilato solo quando l'app richiedente può accedere ai contenuti del file. Se il file non viene condiviso pubblicamente, l'URL restituito in |
iconLink |
Solo output. Un link statico e non autenticato all'icona del file. |
shared |
Solo output. Se il file è stato condiviso. Il campo non viene compilato per gli elementi dei Drive condivisi. |
lastModifyingUser |
Solo output. L'ultimo utente che ha modificato il file. |
owners[] |
Solo output. Il proprietario di questo file. Solo alcuni file precedenti possono avere più di un proprietario. Questo campo non viene compilato per gli elementi dei Drive condivisi. |
headRevisionId |
Solo output. L'ID della revisione principale del file. Questa opzione è attualmente disponibile solo per i file con contenuti binari su Google Drive. |
sharingUser |
Solo output. L'utente che ha condiviso il file con l'utente che ha inviato la richiesta, se applicabile. |
webViewLink |
Solo output. Un link per aprire il file in un editor o un visualizzatore Google pertinente in un browser. |
webContentLink |
Solo output. Un link per scaricare i contenuti del file in un browser. Questa opzione è disponibile solo per i file con contenuti binari su Google Drive. |
size |
Solo output. Dimensioni in byte dei blob e dei file dell'editor proprietario. Non verrà completato per i file senza dimensioni, come scorciatoie e cartelle. |
viewersCanCopyContent |
Obsoleto: utilizza |
permissions[] |
Solo output. L'elenco completo delle autorizzazioni per il file. Questa opzione è disponibile solo se l'utente che ha inviato la richiesta può condividere il file. Il campo non viene compilato per gli elementi dei Drive condivisi. |
hasThumbnail |
Solo output. Indica se il file ha una miniatura. Questo non indica se l'app richiedente ha accesso alla miniatura. Per controllare l'accesso, cerca il campothumbnailLink. |
spaces[] |
Solo output. L'elenco degli spazi che contengono il file. I valori attualmente supportati sono "drive", "appDataCartella" e "foto". |
folderColorRgb |
Il colore di una cartella o una scorciatoia a una cartella come stringa esadecimale RGB. I colori supportati sono pubblicati nel campo Se viene specificato un colore non supportato, viene utilizzato il colore più simile nella tavolozza. |
id |
L'ID del file. |
name |
Il nome del file. Non è necessariamente univoco all'interno di una cartella. Tieni presente che per elementi immutabili, come le cartelle di primo livello dei Drive condivisi, la cartella principale Il mio Drive e la cartella Dati dell'applicazione, il nome è costante. |
description |
Una breve descrizione del file. |
starred |
Indica se l'utente ha aggiunto il file a Speciali. |
trashed |
Indica se il file è stato spostato nel cestino in modo esplicito o da una cartella principale spostata nel cestino. Solo il proprietario può spostare un file nel cestino e gli altri utenti non possono visualizzare i file nel cestino del proprietario. |
explicitlyTrashed |
Solo output. Indica se il file è stato spostato esplicitamente nel cestino anziché in modo ricorsivo da una cartella principale. |
createdTime |
L'ora in cui è stato creato il file (data e ora RFC 3339). |
modifiedTime |
L'ultima volta che il file è stato modificato da un utente (data e ora RFC 3339). Tieni presente che l'impostazione |
modifiedByMeTime |
Solo output. L'ultima volta che il file è stato modificato dall'utente (data e ora RFC 3339). |
viewedByMeTime |
L'ultima volta che il file è stato visualizzato dall'utente (data e ora RFC 3339). |
sharedWithMeTime |
Solo output. L'ora in cui il file è stato condiviso con l'utente, se applicabile (data e ora RFC 3339). |
quotaBytesUsed |
Solo output. Il numero di byte della quota di archiviazione utilizzati dal file. Sono incluse la revisione principale e le revisioni precedenti con |
version |
Solo output. Il numero di versione del file in aumento monotonico. Questo valore riflette tutte le modifiche apportate al file sul server, anche quelle non visibili all'utente. |
originalFilename |
Il nome file originale dei contenuti caricati, se disponibili, oppure il valore originale del campo |
ownedByMe |
Solo output. Indica se l'utente è il proprietario del file. Il campo non viene compilato per gli elementi dei Drive condivisi. |
fullFileExtension |
Solo output. L'estensione completa del file estratta dal campo Viene aggiornato automaticamente quando il campo |
properties |
Una raccolta di coppie chiave-valore arbitrarie visibili a tutte le app. Le voci con valori null vengono cancellate nelle richieste di aggiornamento e copia. Un oggetto contenente un elenco di |
appProperties |
Una raccolta di coppie chiave-valore arbitrarie private per l'app richiedente. Le voci con valori null vengono cancellate nelle richieste di aggiornamento e copia. Queste proprietà possono essere recuperate solo utilizzando una richiesta autenticata. Una richiesta autenticata utilizza un token di accesso ottenuto con un ID client OAuth 2. Non puoi utilizzare una chiave API per recuperare le proprietà private. Un oggetto contenente un elenco di |
isAppAuthorized |
Solo output. Se il file è stato creato o aperto dall'app richiedente. |
teamDriveId |
Deprecato: solo output. Usa invece il criterio |
capabilities |
Solo output. Le capacità dell'utente corrente su questo file. Ogni funzionalità corrisponde a un'azione granulare che un utente può intraprendere. |
capabilities.canChangeViewersCanCopyContent |
Deprecato: solo output. |
capabilities.canMoveChildrenOutOfDrive |
Solo output. Indica se l'utente corrente può spostare elementi secondari di questa cartella all'esterno del Drive condiviso. Questo valore è false quando l'elemento non è una cartella. Compilato solo per gli elementi dei Drive condivisi. |
capabilities.canReadDrive |
Solo output. Indica se l'utente corrente può leggere il Drive condiviso a cui appartiene il file. Compilato solo per gli elementi dei Drive condivisi. |
capabilities.canEdit |
Solo output. Indica se l'utente corrente può modificare questo file. Altri fattori possono limitare il tipo di modifiche che un utente può apportare a un file. Ad esempio, vedi |
capabilities.canCopy |
Solo output. Indica se l'utente corrente può copiare il file. Per un elemento di un Drive condiviso, indica se l'utente corrente può copiare i discendenti dell'elemento che non sono cartelle o l'elemento stesso se non è una cartella. |
capabilities.canComment |
Solo output. Indica se l'utente corrente può commentare questo file. |
capabilities.canAddChildren |
Solo output. Indica se l'utente corrente può aggiungere elementi secondari a questa cartella. Il valore è sempre false quando l'elemento non è una cartella. |
capabilities.canDelete |
Solo output. Indica se l'utente corrente può eliminare il file. |
capabilities.canDownload |
Solo output. Indica se l'utente corrente può scaricare il file. |
capabilities.canListChildren |
Solo output. Indica se l'utente corrente può elencare gli elementi secondari di questa cartella. Il valore è sempre false quando l'elemento non è una cartella. |
capabilities.canRemoveChildren |
Solo output. Indica se l'utente corrente può rimuovere elementi secondari da questa cartella. Il valore è sempre false quando l'elemento non è una cartella. Per una cartella su un Drive condiviso, utilizza invece |
capabilities.canRename |
Solo output. Indica se l'utente corrente può rinominare il file. |
capabilities.canTrash |
Solo output. Indica se l'utente corrente può spostare questo file nel cestino. |
capabilities.canReadRevisions |
Solo output. Indica se l'utente corrente può leggere la risorsa delle revisioni di questo file. Per un elemento di un Drive condiviso, possono essere lette sia le revisioni dei discendenti che non appartengono alla cartella o l'elemento stesso se non è una cartella. |
capabilities.canReadTeamDrive |
Deprecato: solo output. Usa invece il criterio |
capabilities.canMoveTeamDriveItem |
Deprecato: solo output. Usa invece |
capabilities.canChangeCopyRequiresWriterPermission |
Solo output. Indica se l'utente corrente può modificare la limitazione |
capabilities.canMoveItemIntoTeamDrive |
Deprecato: solo output. Usa invece il criterio |
capabilities.canUntrash |
Solo output. Indica se l'utente corrente può ripristinare questo file dal cestino. |
capabilities.canModifyContent |
Solo output. Indica se l'utente corrente può modificare i contenuti di questo file. |
capabilities.canMoveItemWithinTeamDrive |
Deprecato: solo output. Usa invece il criterio |
capabilities.canMoveItemOutOfTeamDrive |
Deprecato: solo output. Usa invece il criterio |
capabilities.canDeleteChildren |
Solo output. Indica se l'utente corrente può eliminare elementi secondari di questa cartella. Questo valore è false quando l'elemento non è una cartella. Compilato solo per gli elementi dei Drive condivisi. |
capabilities.canMoveChildrenOutOfTeamDrive |
Deprecato: solo output. Usa invece il criterio |
capabilities.canMoveChildrenWithinTeamDrive |
Deprecato: solo output. Usa invece il criterio |
capabilities.canTrashChildren |
Solo output. Indica se l'utente corrente può spostare nel cestino elementi secondari di questa cartella. Questo valore è false quando l'elemento non è una cartella. Compilato solo per gli elementi dei Drive condivisi. |
capabilities.canMoveItemOutOfDrive |
Solo output. Indica se l'utente corrente può spostare questo elemento all'esterno di questo Drive modificando l'elemento principale. Tieni presente che una richiesta di modifica dell'elemento principale dell'elemento potrebbe comunque non riuscire, a seconda del nuovo elemento principale che viene aggiunto. |
capabilities.canAddMyDriveParent |
Solo output. Indica se l'utente corrente può aggiungere un elemento principale per l'elemento senza rimuovere un elemento principale esistente nella stessa richiesta. Il campo non viene compilato per i file dei Drive condivisi. |
capabilities.canRemoveMyDriveParent |
Solo output. Indica se l'utente corrente può rimuovere un genitore dall'elemento senza aggiungere un altro genitore nella stessa richiesta. Il campo non viene compilato per i file dei Drive condivisi. |
capabilities.canMoveItemWithinDrive |
Solo output. Indica se l'utente corrente può spostare questo elemento all'interno di questo Drive. Tieni presente che una richiesta di modifica dell'elemento principale dell'elemento potrebbe comunque non riuscire a seconda del nuovo elemento principale che viene aggiunto e dell'elemento principale che viene rimosso. |
capabilities.canShare |
Solo output. Indica se l'utente corrente può modificare le impostazioni di condivisione del file. |
capabilities.canMoveChildrenWithinDrive |
Solo output. Indica se l'utente corrente può spostare elementi secondari di questa cartella all'interno di questo Drive. Questo valore è false quando l'elemento non è una cartella. Tieni presente che una richiesta di spostamento dell'asset secondario potrebbe comunque non riuscire a seconda dell'accesso dell'utente corrente al file secondario e alla cartella di destinazione. |
capabilities.canModifyContentRestriction |
Deprecato: solo output. Usa un'opzione tra |
capabilities.canAddFolderFromAnotherDrive |
Solo output. Indica se l'utente corrente può aggiungere a questa cartella una cartella da un altro Drive (Drive condiviso diverso o Il mio Drive). Questo valore è false quando l'elemento non è una cartella. Compilato solo per gli elementi dei Drive condivisi. |
capabilities.canChangeSecurityUpdateEnabled |
Solo output. Indica se l'utente corrente può modificare il campo securityUpdateEnabled nei metadati della condivisione tramite link. |
capabilities.canAcceptOwnership |
Solo output. Indica se l'utente corrente è il proprietario in sospeso del file. Il campo non viene compilato per i file dei Drive condivisi. |
capabilities.canReadLabels |
Solo output. Indica se l'utente corrente può leggere le etichette del file. |
capabilities.canModifyLabels |
Solo output. Indica se l'utente corrente può modificare le etichette sul file. |
capabilities.canModifyEditorContentRestriction |
Solo output. Indica se l'utente corrente può aggiungere o modificare limitazioni dei contenuti del file che sono limitate dall'editor. |
capabilities.canModifyOwnerContentRestriction |
Solo output. Indica se l'utente corrente può aggiungere o modificare limitazioni dei contenuti limitate dal proprietario. |
capabilities.canRemoveContentRestriction |
Solo output. Indica se il file presenta una limitazione dei contenuti che può essere rimossa dall'utente corrente. |
hasAugmentedPermissions |
Solo output. Indica se esistono autorizzazioni direttamente per questo file. Questo campo viene compilato solo per gli elementi dei Drive condivisi. |
trashingUser |
Solo output. Se il file è stato esplicitamente spostato nel cestino, l'utente che lo ha spostato. Compilato solo per gli elementi dei Drive condivisi. |
thumbnailVersion |
Solo output. La versione della miniatura da utilizzare per l'annullamento della convalida della cache delle miniature. |
trashedTime |
Solo output. L'ora in cui l'elemento è stato spostato nel cestino (data e ora RFC 3339). Compilato solo per gli elementi dei Drive condivisi. |
modifiedByMe |
Solo output. Indica se il file è stato modificato da questo utente. |
permissionIds[] |
Solo output. files.list di ID autorizzazione per gli utenti con accesso a questo file. |
imageMediaMetadata |
Solo output. Metadati aggiuntivi sui contenuti multimediali delle immagini, se disponibili. |
imageMediaMetadata.flashUsed |
Solo output. Indica se è stato utilizzato il flash per creare la foto. |
imageMediaMetadata.meteringMode |
Solo output. La modalità di misurazione utilizzata per creare la foto. |
imageMediaMetadata.sensor |
Solo output. Il tipo di sensore utilizzato per creare la foto. |
imageMediaMetadata.exposureMode |
Solo output. La modalità di esposizione utilizzata per creare la foto. |
imageMediaMetadata.colorSpace |
Solo output. Lo spazio dei colori della foto. |
imageMediaMetadata.whiteBalance |
Solo output. La modalità di bilanciamento del bianco utilizzata per creare la foto. |
imageMediaMetadata.width |
Solo output. La larghezza dell'immagine in pixel. |
imageMediaMetadata.height |
Solo output. L'altezza dell'immagine in pixel. |
imageMediaMetadata.location |
Solo output. Le informazioni sulla posizione geografica memorizzate nell'immagine. |
imageMediaMetadata.location.latitude |
Solo output. La latitudine memorizzata nell'immagine. |
imageMediaMetadata.location.longitude |
Solo output. La longitudine memorizzata nell'immagine. |
imageMediaMetadata.location.altitude |
Solo output. L'altitudine memorizzata nell'immagine. |
imageMediaMetadata.rotation |
Solo output. Il numero di rotazioni di 90 gradi in senso orario applicate dall'orientamento originale dell'immagine. |
imageMediaMetadata.time |
Solo output. La data e l'ora in cui è stata scattata la foto (EXIF DateTime). |
imageMediaMetadata.cameraMake |
Solo output. La marca della fotocamera utilizzata per creare la foto. |
imageMediaMetadata.cameraModel |
Solo output. Il modello della fotocamera utilizzata per creare la foto. |
imageMediaMetadata.exposureTime |
Solo output. La durata dell'esposizione espressa in secondi. |
imageMediaMetadata.aperture |
Solo output. L'apertura utilizzata per creare la foto (numero f). |
imageMediaMetadata.focalLength |
Solo output. La lunghezza focale utilizzata per creare la foto, espressa in millimetri. |
imageMediaMetadata.isoSpeed |
Solo output. La velocità ISO utilizzata per creare la foto. |
imageMediaMetadata.exposureBias |
Solo output. La polarizzazione di esposizione della foto (valore APEX). |
imageMediaMetadata.maxApertureValue |
Solo output. Il numero f più piccolo dell'obiettivo alla lunghezza focale utilizzata per creare la foto (valore APEX). |
imageMediaMetadata.subjectDistance |
Solo output. La distanza dal soggetto della foto, in metri. |
imageMediaMetadata.lens |
Solo output. L'obiettivo utilizzato per creare la foto. |
videoMediaMetadata |
Solo output. Metadati aggiuntivi sui contenuti multimediali dei video. Potrebbe non essere disponibile immediatamente dopo il caricamento. |
videoMediaMetadata.width |
Solo output. La larghezza del video in pixel. |
videoMediaMetadata.height |
Solo output. L'altezza del video in pixel. |
videoMediaMetadata.durationMillis |
Solo output. Durata del video in millisecondi. |
shortcutDetails |
Dettagli file scorciatoia. Compilato solo per i file di scorciatoie, con il campo mimeType impostato su |
shortcutDetails.targetId |
L'ID del file a cui rimanda questa scorciatoia. |
shortcutDetails.targetMimeType |
Solo output. Il tipo MIME del file a cui rimanda questa scorciatoia. Il valore di questo campo è un'istantanea del tipo MIME del target, acquisita al momento della creazione della scorciatoia. |
shortcutDetails.targetResourceKey |
Solo output. Il valore ResourceKey del file di destinazione. |
contentRestrictions[] |
Restrizioni relative all'accesso ai contenuti del file. Compilato solo se esiste una restrizione di questo tipo. |
resourceKey |
Solo output. È necessaria una chiave per accedere all'elemento tramite un link condiviso. |
linkShareMetadata |
Solo output. Dettagli relativi a LinkShare. Contiene i dettagli sugli URL dei link che i client utilizzano per fare riferimento a questo elemento. |
linkShareMetadata.securityUpdateEligible |
Solo output. Indica se il file è idoneo per l'aggiornamento della sicurezza. |
linkShareMetadata.securityUpdateEnabled |
Solo output. Indica se l'aggiornamento della sicurezza è abilitato per questo file. |
labelInfo |
Solo output. Una panoramica delle etichette nel file. |
labelInfo.labels[] |
Solo output. L'insieme di etichette nel file come richiesto dagli ID etichetta nel parametro |
sha1Checksum |
Solo output. Il checksum SHA1 associato a questo file, se disponibile. Questo campo viene compilato solo per i file con contenuti archiviati su Google Drive; non viene compilato per gli editor di documenti o per i file di scorciatoie. |
sha256Checksum |
Solo output. Il checksum SHA256 associato a questo file, se disponibile. Questo campo viene compilato solo per i file con contenuti archiviati su Google Drive; non viene compilato per gli editor di documenti o per i file di scorciatoie. |
ContentRestriction
Una restrizione per accedere ai contenuti del file.
Rappresentazione JSON |
---|
{
"readOnly": boolean,
"reason": string,
"type": string,
"restrictingUser": {
object ( |
Campi | |
---|---|
readOnly |
Indica se i contenuti del file sono di sola lettura. Se un file è di sola lettura, non è possibile aggiungere una nuova revisione, non è possibile aggiungere o modificare i commenti e il titolo del file non può essere modificato. |
reason |
Motivo per cui i contenuti del file sono soggetti a limitazioni. È modificabile solo nelle richieste che impostano anche |
type |
Solo output. Il tipo di limitazione dei contenuti. Attualmente l'unico valore possibile è |
restrictingUser |
Solo output. L'utente che ha impostato la limitazione dei contenuti. Compilato solo se |
restrictionTime |
Solo output. L'ora in cui è stata impostata la limitazione dei contenuti (timestamp RFC 3339). Compilato solo se |
ownerRestricted |
Indica se la limitazione dei contenuti può essere modificata o rimossa solo da un utente proprietario del file. Per i file che si trovano nei Drive condivisi, qualsiasi utente con funzionalità |
Metodi |
|
---|---|
|
Crea una copia di un file e applica eventuali aggiornamenti richiesti con la semantica della patch. |
|
Crea un nuovo file. |
|
Elimina definitivamente un file di proprietà dell'utente senza spostarlo nel cestino. |
|
Elimina definitivamente tutti i file spostati nel cestino dell'utente. |
|
Esporta un documento di Google Workspace nel tipo MIME richiesto e restituisce contenuti in byte esportati. |
|
Genera un insieme di ID file che possono essere forniti nelle richieste di creazione o copia. |
|
Recupera i metadati o i contenuti di un file in base all'ID. |
|
Elenca i file dell'utente. |
|
Elenca le etichette in un file. |
|
Modifica l'insieme di etichette applicate a un file. |
|
Consente di aggiornare i metadati e/o i contenuti di un file. |
|
Sottoscrive le modifiche a un file. |