REST Resource: files

Risorsa: file

I metadati di un file.

Alcuni metodi delle risorse (ad esempio 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 (User)
  },
  "owners": [
    {
      object (User)
    }
  ],
  "headRevisionId": string,
  "sharingUser": {
    object (User)
  },
  "webViewLink": string,
  "webContentLink": string,
  "size": string,
  "viewersCanCopyContent": boolean,
  "permissions": [
    {
      object (Permission)
    }
  ],
  "hasThumbnail": boolean,
  "spaces": [
    string
  ],
  "folderColorRgb": string,
  "id": string,
  "name": string,
  "description": string,
  "starred": boolean,
  "trashed": boolean,
  "explicitlyTrashed": boolean,
  "createdTime": string,
  "modifiedTime": string,
  "modifiedByMeTime": string,
  "viewedByMeTime": string,
  "sharedWithMeTime": string,
  "quotaBytesUsed": string,
  "version": string,
  "originalFilename": string,
  "ownedByMe": boolean,
  "fullFileExtension": string,
  "properties": {
    string: value,
    ...
  },
  "appProperties": {
    string: value,
    ...
  },
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeViewersCanCopyContent": boolean,
    "canMoveChildrenOutOfDrive": boolean,
    "canReadDrive": boolean,
    "canEdit": boolean,
    "canCopy": boolean,
    "canComment": boolean,
    "canAddChildren": boolean,
    "canDelete": boolean,
    "canDownload": boolean,
    "canListChildren": boolean,
    "canRemoveChildren": boolean,
    "canRename": boolean,
    "canTrash": boolean,
    "canReadRevisions": boolean,
    "canReadTeamDrive": boolean,
    "canMoveTeamDriveItem": boolean,
    "canChangeCopyRequiresWriterPermission": boolean,
    "canMoveItemIntoTeamDrive": boolean,
    "canUntrash": boolean,
    "canModifyContent": boolean,
    "canMoveItemWithinTeamDrive": boolean,
    "canMoveItemOutOfTeamDrive": boolean,
    "canDeleteChildren": boolean,
    "canMoveChildrenOutOfTeamDrive": boolean,
    "canMoveChildrenWithinTeamDrive": boolean,
    "canTrashChildren": boolean,
    "canMoveItemOutOfDrive": boolean,
    "canAddMyDriveParent": boolean,
    "canRemoveMyDriveParent": boolean,
    "canMoveItemWithinDrive": boolean,
    "canShare": boolean,
    "canMoveChildrenWithinDrive": boolean,
    "canModifyContentRestriction": boolean,
    "canAddFolderFromAnotherDrive": boolean,
    "canChangeSecurityUpdateEnabled": boolean,
    "canAcceptOwnership": boolean,
    "canReadLabels": boolean,
    "canModifyLabels": boolean,
    "canModifyEditorContentRestriction": boolean,
    "canModifyOwnerContentRestriction": boolean,
    "canRemoveContentRestriction": boolean,
    "canDisableInheritedPermissions": boolean,
    "canEnableInheritedPermissions": boolean
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "thumbnailVersion": string,
  "trashedTime": string,
  "modifiedByMe": boolean,
  "permissionIds": [
    string
  ],
  "imageMediaMetadata": {
    "flashUsed": boolean,
    "meteringMode": string,
    "sensor": string,
    "exposureMode": string,
    "colorSpace": string,
    "whiteBalance": string,
    "width": integer,
    "height": integer,
    "location": {
      "latitude": number,
      "longitude": number,
      "altitude": number
    },
    "rotation": integer,
    "time": string,
    "cameraMake": string,
    "cameraModel": string,
    "exposureTime": number,
    "aperture": number,
    "focalLength": number,
    "isoSpeed": integer,
    "exposureBias": number,
    "maxApertureValue": number,
    "subjectDistance": integer,
    "lens": string
  },
  "videoMediaMetadata": {
    "width": integer,
    "height": integer,
    "durationMillis": string
  },
  "shortcutDetails": {
    "targetId": string,
    "targetMimeType": string,
    "targetResourceKey": string
  },
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean
}
Campi
kind

string

Solo output. Identifica il tipo di risorsa. Valore: la stringa fissa "drive#file".

driveId

string

Solo output. ID del Drive condiviso in cui si trova il file. Viene compilato solo per gli elementi dei Drive condivisi.

fileExtension

string

Solo output. Il componente finale di fullFileExtension. Disponibile solo per i file con contenuti binari su Google Drive.

copyRequiresWriterPermission

boolean

Indica se le opzioni di copia, stampa o download di questo file devono essere disattivate per lettori e commentatori.

md5Checksum

string

Solo output. Il checksum MD5 per i contenuti del file. Questo vale solo per i file con contenuti binari su Google Drive.

contentHints

object

Informazioni aggiuntive sui contenuti del file. Questi campi non vengono mai compilati nelle risposte.

contentHints.indexableText

string

Testo da indicizzare per il file al fine di migliorare le query fullText. La lunghezza è limitata a 128 KB e può contenere elementi HTML.

contentHints.thumbnail

object

Una miniatura del file. Verrà utilizzata solo se Google Drive non può generare una miniatura standard.

contentHints.thumbnail.image

string (bytes format)

I dati della miniatura codificati in Base64 con protezione dell'URL (sezione 5 di RFC 4648).

Una stringa con codifica Base64.

contentHints.thumbnail.mimeType

string

Il tipo MIME della miniatura.

writersCanShare

boolean

Indica se gli utenti con solo autorizzazione writer possono modificare le autorizzazioni del file. Non viene compilato per gli elementi nei Drive condivisi.

viewedByMe

boolean

Solo output. Indica se il file è stato visualizzato da questo utente.

mimeType

string

Il tipo MIME del file.

Se non viene fornito alcun valore, Google Drive tenta di rilevare automaticamente un valore appropriato dai contenuti caricati. 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 Documenti Google, i contenuti caricati vengono importati, se possibile. I formati di importazione supportati sono pubblicati nella risorsa Informazioni.

parents[]

string

L'ID della cartella principale contenente il file.

Un file può avere una sola cartella principale; la specifica di più cartelle principali non è supportata.

Se non specificato nell'ambito di una richiesta di creazione, il file viene inserito direttamente nella cartella Il mio Drive dell'utente. Se non specificato nell'ambito di una richiesta di copia, il file eredita qualsiasi elemento principale rilevabile del file di origine. Le richieste files.update devono utilizzare i parametri addParents e removeParents per modificare l'elenco dei file principali.

shared

boolean

Solo output. Indica se il file è stato condiviso. Non viene compilato per gli elementi nei Drive condivisi.

lastModifyingUser

object (User)

Solo output. L'ultimo utente che ha modificato il file. Questo campo viene compilato solo se l'ultima modifica è stata eseguita da un utente che ha eseguito l'accesso.

owners[]

object (User)

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

string

Solo output. L'ID della revisione principale del file. Questa opzione è attualmente disponibile solo per i file con contenuti binari su Google Drive.

sharingUser

object (User)

Solo output. L'utente che ha condiviso il file con l'utente che ha effettuato la richiesta, se applicabile.

size

string (int64 format)

Solo output. Dimensioni in byte dei blob e dei file degli editor proprietari. Non verrà compilato per i file senza dimensioni, come scorciatoie e cartelle.

viewersCanCopyContent
(deprecated)

boolean

Deprecato: utilizza copyRequiresWriterPermission.

permissions[]

object (Permission)

Solo output. L'elenco completo delle autorizzazioni per il file. Questa opzione è disponibile solo se l'utente che effettua la richiesta può condividere il file. Non viene compilato per gli elementi nei Drive condivisi.

hasThumbnail

boolean

Solo output. Indica se questo file ha una miniatura. Ciò non indica se l'app richiedente ha accesso alla miniatura. Per controllare l'accesso, cerca la presenza del campo thumbnailLink.

spaces[]

string

Solo output. L'elenco degli spazi che contengono il file. I valori attualmente supportati sono "drive", "appDataFolder" e "photos".

folderColorRgb

string

Il colore di una cartella o di una scorciatoia a una cartella come stringa esadecimale RGB. I colori supportati sono pubblicati nel campo folderColorPalette della risorsa Informazioni.

Se viene specificato un colore non supportato, viene utilizzato il colore più simile nella tavolozza.

id

string

L'ID del file.

name

string

Il nome del file. Non è necessariamente univoco all'interno di una cartella. Tieni presente che per gli elementi immutabili, come le cartelle di primo livello dei Drive condivisi, la cartella principale di Il mio Drive e la cartella Dati dell'applicazione, il nome è costante.

description

string

Una breve descrizione del file.

starred

boolean

Indica se l'utente ha aggiunto il file a Speciali.

trashed

boolean

Indica se il file è stato eliminato, esplicitamente o da una cartella principale eliminata. Solo il proprietario può eliminare un file e gli altri utenti non possono vedere i file nel cestino del proprietario.

explicitlyTrashed

boolean

Solo output. Indica se il file è stato eliminato esplicitamente, anziché eliminato in modo ricorsivo da una cartella principale.

createdTime

string

L'ora in cui è stato creato il file (data e ora RFC 3339).

modifiedTime

string

L'ultima volta che il file è stato modificato da chiunque (data e ora RFC 3339).

Tieni presente che l'impostazione modifiedTime aggiorna anche modifiedByMeTime per l'utente.

modifiedByMeTime

string

Solo output. L'ultima volta che il file è stato modificato dall'utente (data e ora RFC 3339).

viewedByMeTime

string

L'ultima volta che il file è stato visualizzato dall'utente (data e ora RFC 3339).

sharedWithMeTime

string

Solo output. L'ora in cui il file è stato condiviso con l'utente, se applicabile (data e ora RFC 3339).

quotaBytesUsed

string (int64 format)

Solo output. Il numero di byte della quota di spazio di archiviazione utilizzati dal file. Sono incluse la revisione principale e le revisioni precedenti con keepForever abilitato.

version

string (int64 format)

Solo output. Un numero di versione che aumenta in modo monotonico per il file. Questo riflette ogni modifica apportata al file sul server, anche quelle non visibili all'utente.

originalFilename

string

Il nome file originale dei contenuti caricati, se disponibile, oppure il valore originale del campo name. Disponibile solo per i file con contenuti binari su Google Drive.

ownedByMe

boolean

Solo output. Indica se l'utente è proprietario del file. Non viene compilato per gli elementi nei Drive condivisi.

fullFileExtension

string

Solo output. L'estensione completa del file estratta dal campo name. Può contenere più estensioni concatenate, ad esempio "tar.gz". Disponibile solo per i file con contenuti binari su Google Drive.

Questo valore viene aggiornato automaticamente quando cambia il campo name, ma non viene cancellato se il nuovo nome non contiene un'estensione valida.

properties

map (key: string, value: value (Value format))

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 coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

appProperties

map (key: string, value: value (Value format))

Una raccolta di coppie chiave-valore arbitrarie private per l'app che effettua la richiesta.

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 proprietà private.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

isAppAuthorized

boolean

Solo output. Indica se il file è stato creato o aperto dall'app che lo richiede.

teamDriveId
(deprecated)

string

Ritiro: solo output. Utilizza invece driveId.

capabilities

object

Solo output. Funzionalità di cui dispone l'utente corrente su questo file. Ogni funzionalità corrisponde a un'azione granulare che un utente può eseguire.

capabilities.canChangeViewersCanCopyContent
(deprecated)

boolean

Ritiro: solo output.

capabilities.canMoveChildrenOutOfDrive

boolean

Solo output. Indica se l'utente corrente può spostare le cartelle secondarie di questa cartella al di fuori del Drive condiviso. Il valore è falso quando l'elemento non è una cartella. Viene compilato solo per gli elementi dei Drive condivisi.

capabilities.canReadDrive

boolean

Solo output. Indica se l'utente corrente può leggere il Drive condiviso a cui appartiene il file. Viene compilato solo per gli elementi dei Drive condivisi.

capabilities.canEdit

boolean

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 canChangeCopyRequiresWriterPermission o canModifyContent.

capabilities.canCopy

boolean

Solo output. Indica se l'utente corrente può copiare questo file. Per un elemento in un Drive condiviso, indica se l'utente corrente può copiare gli elementi discendenti non di tipo cartella di questo elemento o l'elemento stesso se non è una cartella.

capabilities.canComment

boolean

Solo output. Indica se l'utente corrente può commentare questo file.

capabilities.canAddChildren

boolean

Solo output. Indica se l'utente corrente può aggiungere cartelle secondarie a questa cartella. Questo valore è sempre falso quando l'elemento non è una cartella.

capabilities.canDelete

boolean

Solo output. Indica se l'utente corrente può eliminare questo file.

capabilities.canDownload

boolean

Solo output. Indica se l'utente corrente può scaricare questo file.

capabilities.canListChildren

boolean

Solo output. Indica se l'utente corrente può elencare le cartelle secondarie di questa cartella. Questo valore è sempre falso quando l'elemento non è una cartella.

capabilities.canRemoveChildren

boolean

Solo output. Indica se l'utente corrente può rimuovere gli account secondari da questa cartella. Questo valore è sempre falso quando l'elemento non è una cartella. Per una cartella in un Drive condiviso, utilizza canDeleteChildren o canTrashChildren.

capabilities.canRename

boolean

Solo output. Indica se l'utente corrente può rinominare il file.

capabilities.canTrash

boolean

Solo output. Indica se l'utente corrente può spostare questo file nel cestino.

capabilities.canReadRevisions

boolean

Solo output. Indica se l'utente corrente può leggere la risorsa delle revisioni di questo file. Per un elemento di un Drive condiviso, è possibile leggere le revisioni delle cartelle discendenti non di questo elemento o l'elemento stesso se non è una cartella.

capabilities.canReadTeamDrive
(deprecated)

boolean

Non più supportato: solo output. Utilizza invece canReadDrive.

capabilities.canMoveTeamDriveItem
(deprecated)

boolean

Non più supportato: solo output. Utilizza invece canMoveItemWithinDrive o canMoveItemOutOfDrive.

capabilities.canChangeCopyRequiresWriterPermission

boolean

Solo output. Indica se l'utente corrente può modificare la limitazione copyRequiresWriterPermission di questo file.

capabilities.canMoveItemIntoTeamDrive
(deprecated)

boolean

Ritiro: solo output. Utilizza invece canMoveItemOutOfDrive.

capabilities.canUntrash

boolean

Solo output. Indica se l'utente corrente può ripristinare questo file dal cestino.

capabilities.canModifyContent

boolean

Solo output. Indica se l'utente corrente può modificare i contenuti di questo file.

capabilities.canMoveItemWithinTeamDrive
(deprecated)

boolean

Ritiro: solo output. Utilizza invece canMoveItemWithinDrive.

capabilities.canMoveItemOutOfTeamDrive
(deprecated)

boolean

Ritiro: solo output. Utilizza invece canMoveItemOutOfDrive.

capabilities.canDeleteChildren

boolean

Solo output. Indica se l'utente corrente può eliminare le cartelle secondarie di questa cartella. Il valore è falso quando l'elemento non è una cartella. Viene compilato solo per gli elementi dei Drive condivisi.

capabilities.canMoveChildrenOutOfTeamDrive
(deprecated)

boolean

Ritiro: solo output. Utilizza invece canMoveChildrenOutOfDrive.

capabilities.canMoveChildrenWithinTeamDrive
(deprecated)

boolean

Non più supportato: solo output. Utilizza invece canMoveChildrenWithinDrive.

capabilities.canTrashChildren

boolean

Solo output. Indica se l'utente corrente può spostare nel cestino gli elementi secondari di questa cartella. Il valore è falso quando l'elemento non è una cartella. Viene compilato solo per gli elementi dei Drive condivisi.

capabilities.canMoveItemOutOfDrive

boolean

Solo output. Indica se l'utente corrente può spostare questo elemento all'esterno di questo archivio modificandone l'elemento principale. Tieni presente che una richiesta di modifica dell'elemento principale potrebbe comunque non andare a buon fine a seconda del nuovo elemento principale che viene aggiunto.

capabilities.canAddMyDriveParent

boolean

Solo output. Indica se l'utente corrente può aggiungere un elemento principale per l'elemento senza rimuovere un elemento principale esistente nella stessa richiesta. Non viene compilato per i file del Drive condiviso.

capabilities.canRemoveMyDriveParent

boolean

Solo output. Indica se l'utente corrente può rimuovere un elemento principale dall'elemento senza aggiungerne un altro nella stessa richiesta. Non viene compilato per i file del Drive condiviso.

capabilities.canMoveItemWithinDrive

boolean

Solo output. Indica se l'utente corrente può spostare questo elemento all'interno del drive. Tieni presente che una richiesta di modifica dell'elemento principale potrebbe comunque non andare a buon fine a seconda del nuovo elemento principale che viene aggiunto e di quello che viene rimosso.

capabilities.canShare

boolean

Solo output. Indica se l'utente corrente può modificare le impostazioni di condivisione di questo file.

capabilities.canMoveChildrenWithinDrive

boolean

Solo output. Indica se l'utente corrente può spostare le cartelle secondarie di questa cartella all'interno di questo archivio. Il valore è falso quando l'elemento non è una cartella. Tieni presente che una richiesta di spostamento della cartella secondaria potrebbe comunque non andare a buon fine a seconda dell'accesso dell'utente corrente alla cartella secondaria e alla cartella di destinazione.

capabilities.canModifyContentRestriction
(deprecated)

boolean

Ritiro: solo output. Utilizza canModifyEditorContentRestriction, canModifyOwnerContentRestriction o canRemoveContentRestriction.

capabilities.canAddFolderFromAnotherDrive

boolean

Solo output. Indica se l'utente corrente può aggiungere una cartella da un altro Drive (un Drive condiviso diverso o Il mio Drive) a questa cartella. Il valore è falso quando l'elemento non è una cartella. Viene compilato solo per gli elementi dei Drive condivisi.

capabilities.canChangeSecurityUpdateEnabled

boolean

Solo output. Indica se l'utente corrente può modificare il campo securityUpdateEnabled nei metadati della condivisione tramite link.

capabilities.canAcceptOwnership

boolean

Solo output. Indica se l'utente corrente è il proprietario in attesa del file. Non viene compilato per i file del Drive condiviso.

capabilities.canReadLabels

boolean

Solo output. Indica se l'utente corrente può leggere le etichette del file.

capabilities.canModifyLabels

boolean

Solo output. Indica se l'utente corrente può modificare le etichette del file.

capabilities.canModifyEditorContentRestriction

boolean

Solo output. Indica se l'utente corrente può aggiungere o modificare le limitazioni dei contenuti del file che sono limitate agli editor.

capabilities.canModifyOwnerContentRestriction

boolean

Solo output. Indica se l'utente corrente può aggiungere o modificare le limitazioni dei contenuti che sono limitate dal proprietario.

capabilities.canRemoveContentRestriction

boolean

Solo output. Indica se il file è soggetto a limitazioni relative ai contenuti che possono essere rimosse dall'utente corrente.

capabilities.canDisableInheritedPermissions

boolean

Indica se un utente può disattivare le autorizzazioni ereditate.

capabilities.canEnableInheritedPermissions

boolean

Indica se un utente può riattivare le autorizzazioni ereditate.

hasAugmentedPermissions

boolean

Solo output. Indica se sono presenti autorizzazioni direttamente su questo file. Questo campo viene compilato solo per gli elementi dei Drive condivisi.

trashingUser

object (User)

Solo output. Se il file è stato eliminato esplicitamente, l'utente che lo ha eliminato. Viene compilato solo per gli elementi dei Drive condivisi.

thumbnailVersion

string (int64 format)

Solo output. La versione della miniatura da utilizzare nell'annullamento della convalida della cache delle miniature.

trashedTime

string

Solo output. L'ora in cui l'elemento è stato eliminato (data e ora RFC 3339). Viene compilato solo per gli elementi dei Drive condivisi.

modifiedByMe

boolean

Solo output. Indica se il file è stato modificato da questo utente.

permissionIds[]

string

Solo output. files.list degli ID autorizzazione per gli utenti con accesso a questo file.

imageMediaMetadata

object

Solo output. Metadati aggiuntivi relativi ai contenuti multimediali delle immagini, se disponibili.

imageMediaMetadata.flashUsed

boolean

Solo output. Indica se è stato utilizzato il flash per creare la foto.

imageMediaMetadata.meteringMode

string

Solo output. La modalità di misurazione utilizzata per creare la foto.

imageMediaMetadata.sensor

string

Solo output. Il tipo di sensore utilizzato per creare la foto.

imageMediaMetadata.exposureMode

string

Solo output. La modalità di esposizione utilizzata per creare la foto.

imageMediaMetadata.colorSpace

string

Solo output. Lo spazio colore della foto.

imageMediaMetadata.whiteBalance

string

Solo output. La modalità di bilanciamento del bianco utilizzata per creare la foto.

imageMediaMetadata.width

integer

Solo output. La larghezza dell'immagine in pixel.

imageMediaMetadata.height

integer

Solo output. L'altezza dell'immagine in pixel.

imageMediaMetadata.location

object

Solo output. Informazioni sulla posizione geografica memorizzate nell'immagine.

imageMediaMetadata.location.latitude

number

Solo output. La latitudine archiviata nell'immagine.

imageMediaMetadata.location.longitude

number

Solo output. La longitudine archiviata nell'immagine.

imageMediaMetadata.location.altitude

number

Solo output. L'altitudine memorizzata nell'immagine.

imageMediaMetadata.rotation

integer

Solo output. Il numero di rotazioni di 90 gradi in senso orario applicate dall'orientamento originale dell'immagine.

imageMediaMetadata.time

string

Solo output. La data e l'ora in cui è stata scattata la foto (EXIF DateTime).

imageMediaMetadata.cameraMake

string

Solo output. La marca della fotocamera utilizzata per creare la foto.

imageMediaMetadata.cameraModel

string

Solo output. Il modello della fotocamera utilizzata per creare la foto.

imageMediaMetadata.exposureTime

number

Solo output. La durata dell'esposizione, in secondi.

imageMediaMetadata.aperture

number

Solo output. L'apertura utilizzata per creare la foto (numero f).

imageMediaMetadata.focalLength

number

Solo output. La lunghezza focale utilizzata per creare la foto, in millimetri.

imageMediaMetadata.isoSpeed

integer

Solo output. La sensibilità ISO utilizzata per creare la foto.

imageMediaMetadata.exposureBias

number

Solo output. Il bias di esposizione della foto (valore APEX).

imageMediaMetadata.maxApertureValue

number

Solo output. Il numero f più piccolo dell'obiettivo alla lunghezza focale utilizzata per creare la foto (valore APEX).

imageMediaMetadata.subjectDistance

integer

Solo output. La distanza dal soggetto della foto, in metri.

imageMediaMetadata.lens

string

Solo output. L'obiettivo utilizzato per creare la foto.

videoMediaMetadata

object

Solo output. Metadati aggiuntivi sui contenuti multimediali video. Potrebbe non essere disponibile immediatamente dopo il caricamento.

videoMediaMetadata.width

integer

Solo output. La larghezza del video in pixel.

videoMediaMetadata.height

integer

Solo output. L'altezza del video in pixel.

videoMediaMetadata.durationMillis

string (int64 format)

Solo output. La durata del video in millisecondi.

shortcutDetails

object

Dettagli del file della scorciatoia. Viene compilato solo per i file di scorciatoia, il cui campo mimeType è impostato su application/vnd.google-apps.shortcut. Può essere impostato solo per le richieste files.create.

shortcutDetails.targetId

string

L'ID del file a cui rimanda questa scorciatoia. Può essere impostato solo per le richieste files.create.

shortcutDetails.targetMimeType

string

Solo output. Il tipo MIME del file a cui rimanda questa scorciatoia. Il valore di questo campo è uno snapshot del tipo MIME della destinazione, acquisito al momento della creazione della scorciatoia.

shortcutDetails.targetResourceKey

string

Solo output. La chiave ResourceKey per il file di destinazione.

contentRestrictions[]

object (ContentRestriction)

Restrizioni per l'accesso ai contenuti del file. Viene compilato solo se esiste una limitazione di questo tipo.

resourceKey

string

Solo output. Una chiave necessaria per accedere all'elemento tramite un link condiviso.

linkShareMetadata.securityUpdateEligible

boolean

Solo output. Indica se il file è idoneo per l'aggiornamento della sicurezza.

linkShareMetadata.securityUpdateEnabled

boolean

Solo output. Indica se l'aggiornamento della sicurezza è abilitato per questo file.

labelInfo

object

Solo output. Una panoramica delle etichette del file.

labelInfo.labels[]

object (Label)

Solo output. L'insieme di etichette nel file come richiesto dagli ID etichetta nel parametro includeLabels. Per impostazione predefinita, non vengono restituite etichette.

sha1Checksum

string

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 i file di scorciatoia.

sha256Checksum

string

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 i file di scorciatoia.

inheritedPermissionsDisabled

boolean

Indica se le autorizzazioni ereditate di questo file sono disattivate. Le autorizzazioni ereditate sono attivate per impostazione predefinita.

ContentRestriction

Una limitazione per l'accesso ai contenuti del file.

Rappresentazione JSON
{
  "readOnly": boolean,
  "reason": string,
  "type": string,
  "restrictingUser": {
    object (User)
  },
  "restrictionTime": string,
  "ownerRestricted": boolean,
  "systemRestricted": boolean
}
Campi
readOnly

boolean

Indica se i contenuti del file sono di sola lettura. Se un file è di sola lettura, non è possibile aggiungere una nuova revisione, né commenti, né modificare il titolo.

reason

string

Motivo per cui i contenuti del file sono soggetti a limitazioni. Questo valore è modificabile solo nelle richieste che impostano anche readOnly=true.

type

string

Solo output. Il tipo di limitazione dei contenuti. Al momento, l'unico valore possibile è globalContentRestriction.

restrictingUser

object (User)

Solo output. L'utente che ha impostato la limitazione dei contenuti. Viene compilato solo se readOnly è true.

restrictionTime

string

Solo output. L'ora in cui è stata impostata la limitazione dei contenuti (timestamp RFC 3339 formattato). Viene compilato solo se readOnly è true.

ownerRestricted

boolean

Indica se la limitazione dei contenuti può essere modificata o rimossa solo da un utente che possiede il file. Per i file nei Drive condivisi, qualsiasi utente con funzionalità organizer può modificare o rimuovere questa limitazione dei contenuti.

systemRestricted

boolean

Solo output. Indica se la limitazione dei contenuti è stata applicata dal sistema, ad esempio a causa di una firma elettronica. Gli utenti non possono modificare o rimuovere le limitazioni relative ai contenuti con limitazioni di sistema.

Metodi

copy

Crea una copia di un file e applica gli aggiornamenti richiesti con la semantica delle patch.

create

Crea un nuovo file.

delete

Elimina definitivamente un file di proprietà dell'utente senza spostarlo nel cestino.

download

Scarica i contenuti di un file.

emptyTrash

Consente di eliminare definitivamente tutti i file nel cestino dell'utente.

export

Esporta un documento Google Workspace nel tipo MIME richiesto e restituisce i contenuti in byte esportati.

generateIds

Genera un insieme di ID file che possono essere forniti nelle richieste di creazione o copia.

get

Recupera i metadati o i contenuti di un file per ID.

list

Elenca i file dell'utente.

listLabels

Elenca le etichette di un file.

modifyLabels

Modifica l'insieme di etichette applicate a un file.

update

Aggiorna i metadati e/o i contenuti di un file.

watch

Si iscrive alle modifiche di un file.