REST Resource: files

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,
  "userPermission": {
    object (Permission)
  },
  "fileExtension": string,
  "md5Checksum": string,
  "selfLink": string,
  "ownerNames": [
    string
  ],
  "lastModifyingUserName": string,
  "editable": boolean,
  "writersCanShare": boolean,
  "downloadUrl": string,
  "mimeType": string,
  "exportLinks": {
    string: string,
    ...
  },
  "driveId": string,
  "parents": [
    {
      object (ParentReference)
    }
  ],
  "thumbnailLink": string,
  "appDataContents": boolean,
  "webViewLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "owners": [
    {
      object (User)
    }
  ],
  "openWithLinks": {
    string: string,
    ...
  },
  "defaultOpenWithLink": string,
  "headRevisionId": string,
  "properties": [
    {
      object (Property)
    }
  ],
  "copyable": boolean,
  "etag": string,
  "sharingUser": {
    object (User)
  },
  "alternateLink": string,
  "embedLink": string,
  "webContentLink": string,
  "fileSize": string,
  "copyRequiresWriterPermission": boolean,
  "permissions": [
    {
      object (Permission)
    }
  ],
  "hasThumbnail": boolean,
  "spaces": [
    string
  ],
  "folderColorRgb": string,
  "id": string,
  "title": string,
  "description": string,
  "labels": {
    "viewed": boolean,
    "restricted": boolean,
    "starred": boolean,
    "hidden": boolean,
    "trashed": boolean,
    "modified": boolean
  },
  "explicitlyTrashed": boolean,
  "createdDate": string,
  "modifiedDate": string,
  "modifiedByMeDate": string,
  "lastViewedByMeDate": string,
  "markedViewedByMeDate": string,
  "sharedWithMeDate": string,
  "quotaBytesUsed": string,
  "version": string,
  "indexableText": {
    "text": string
  },
  "originalFilename": string,
  "ownedByMe": boolean,
  "canComment": boolean,
  "shareable": boolean,
  "fullFileExtension": string,
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeRestrictedDownload": 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
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "canReadRevisions": boolean,
  "thumbnailVersion": string,
  "trashedDate": string,
  "permissionIds": [
    string
  ],
  "thumbnail": {
    "image": string,
    "mimeType": 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,
    "date": 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
}
Campi
kind

string

Solo output. Il tipo di file. È sempre drive#file.

userPermission

object (Permission)

Solo output. Le autorizzazioni per l'utente autenticato per questo file.

fileExtension

string

Solo output. Il componente finale di fullFileExtension con testo finale che non sembra far parte dell'estensione rimossa. 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.

md5Checksum

string

Solo output. Un checksum MD5 per i contenuti di questo file. 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.

ownerNames[]

string

Solo output. Nomi dei proprietari di questo file. Il campo non viene compilato per gli elementi dei Drive condivisi.

lastModifyingUserName

string

Solo output. Nome dell'ultimo utente che ha modificato il file.

editable
(deprecated)

boolean

Solo output. Obsoleto: utilizza capabilities/canEdit.

writersCanShare

boolean

Se gli autori possono condividere il documento con altri utenti. Il campo non viene compilato per gli elementi dei Drive condivisi.

downloadUrl

string

Solo output. URL di download di breve durata per il file. Questo campo viene compilato solo per i file con contenuti archiviati su Google Drive; non viene compilato per i file di Documenti Google o di scorciatoie.

mimeType

string

Il tipo MIME del file. È possibile modificare questa impostazione solo all'aggiornamento durante il caricamento di nuovi contenuti. Questo campo può essere lasciato vuoto e il tipo MIME verrà determinato dal tipo MIME dei contenuti caricati.

driveId

string

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

parents[]

object (ParentReference)

Raccolta di cartelle principali che contengono questo file.

Se non viene specificato nell'ambito di una richiesta di inserimento, 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 erediterà tutte le eventuali origini principali rilevabili del file di origine. Le richieste file.update possono anche utilizzare i parametri addParents e removeParents per modificare l'elenco principale.

appDataContents

boolean

Solo output. Indica se il file si trova nella cartella Application Data.

shared

boolean

Solo output. Se il file è stato condiviso. Il campo non viene compilato per gli elementi dei Drive condivisi.

lastModifyingUser

object (User)

Solo output. L'ultimo utente che ha modificato il file.

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. 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.

properties[]

object (Property)

L'elenco delle proprietà.

copyable
(deprecated)

boolean

Solo output. Obsoleto: utilizza capabilities/canCopy.

etag

string

Solo output. ETag del file.

sharingUser

object (User)

Solo output. Utente che ha condiviso l'elemento con l'utente corrente, se disponibile.

fileSize

string (int64 format)

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.

copyRequiresWriterPermission

boolean

Indica se le opzioni per copiare, stampare o scaricare il file devono essere disattivate per lettori e commentatori.

permissions[]

object (Permission)

Solo output. L'elenco delle autorizzazioni degli utenti con accesso a questo file. Il campo non viene compilato per gli elementi dei Drive condivisi.

hasThumbnail

boolean

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[]

string

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

folderColorRgb

string

Colore della cartella come stringa esadecimale RGB se il file è una cartella o una scorciatoia a una cartella. L'elenco dei colori supportati è disponibile nel campo cartellaColorPalette della risorsa Informazioni. Se viene specificato un colore non supportato, verrà sostituito con il colore più simile nella tavolozza.

id

string

L'ID del file.

title

string

Il titolo di questo file. 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 titolo è costante.

description

string

Una breve descrizione del file.

labels

object

Un gruppo di etichette per il file.

labels.viewed

boolean

Indica se il file è stato visualizzato da questo utente.

labels.restricted
(deprecated)

boolean

Solo output. Obsoleto: utilizza copyRequiresWriterPermission.

labels.starred

boolean

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

labels.hidden
(deprecated)

boolean

Solo output. Deprecato.

labels.trashed

boolean

Indica se il file è stato spostato nel cestino. L'etichetta si applica a tutti gli utenti che accedono al file, ma solo i proprietari possono visualizzare e rimuovere i file dal cestino.

labels.modified

boolean

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

explicitlyTrashed

boolean

Solo output. Indica se il file è stato spostato esplicitamente nel cestino, anziché in modo ricorsivo.

createdDate

string

Solo output. Crea l'ora per questo file (con formato timestamp RFC 3339).

modifiedDate

string

L'ultima volta che questo file è stato modificato da qualcuno (timestamp in formato RFC 3339). È modificabile solo in fase di aggiornamento, se è impostato il parametro setModifiedDate.

modifiedByMeDate

string

Solo output. L'ultima volta che questo file è stato modificato dall'utente (timestamp RFC 3339). Tieni presente che l'impostazione modificataDate aggiorna anche la data modificata dall'utente per l'utente che l'ha impostata.

lastViewedByMeDate

string

L'ultima volta che questo file è stato visualizzato dall'utente (timestamp in formato RFC 3339).

markedViewedByMeDate
(deprecated)

string

Solo output. Deprecato.

sharedWithMeDate

string

Solo output. Ora in cui il file è stato condiviso con l'utente (timestamp in formato RFC 3339).

quotaBytesUsed

string (int64 format)

Solo output. Il numero di byte di quota utilizzati da questo file.

version

string (int64 format)

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 che ha inviato la richiesta.

indexableText

object

Attributi di testo indicizzabili per il file (possono essere solo scritti)

indexableText.text

string

Il testo da indicizzare per questo file.

originalFilename

string

Il nome file originale dei contenuti caricati, se disponibili, oppure il valore originale del campo title. Questa opzione è disponibile solo per i file con contenuti binari su Google Drive.

ownedByMe

boolean

Solo output. Indica se il file è di proprietà dell'utente corrente. Il campo non viene compilato per gli elementi dei Drive condivisi.

canComment
(deprecated)

boolean

Solo output. Obsoleto: utilizza capabilities/canComment.

shareable
(deprecated)

boolean

Solo output. Obsoleto: utilizza capabilities/canShare.

fullFileExtension

string

Solo output. L'estensione completa del file; estratta dal titolo. Può contenere più estensioni concatenate, ad esempio "tar.gz". La rimozione di un'estensione dal titolo non cancella questo campo; tuttavia, la modifica dell'estensione dal titolo comporterà l'aggiornamento di questo campo. 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.

isAppAuthorized

boolean

Solo output. Se il file è stato creato o aperto dall'app richiedente.

teamDriveId
(deprecated)

string

Solo output. Obsoleto: utilizza driveId.

capabilities

object

Solo output. Le capacità dell'utente corrente su questo file. Ogni funzionalità corrisponde a un'azione granulare che un utente può intraprendere.

capabilities.canChangeRestrictedDownload
(deprecated)

boolean

Solo output. Deprecato.

capabilities.canMoveChildrenOutOfDrive

boolean

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

boolean

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

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 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

boolean

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

capabilities.canAddChildren

boolean

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

boolean

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

capabilities.canDownload

boolean

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

capabilities.canListChildren

boolean

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

boolean

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 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, possono essere lette sia le revisioni dei discendenti che non appartengono alla cartella o l'elemento stesso se non è una cartella.

capabilities.canReadTeamDrive
(deprecated)

boolean

Solo output. Obsoleto: utilizza canReadDrive.

capabilities.canMoveTeamDriveItem
(deprecated)

boolean

Solo output. Obsoleto: utilizza 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

Solo output. Obsoleto: utilizza 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

Solo output. Obsoleto: utilizza canMoveItemWithinDrive.

capabilities.canMoveItemOutOfTeamDrive
(deprecated)

boolean

Solo output. Obsoleto: utilizza canMoveItemOutOfDrive.

capabilities.canDeleteChildren

boolean

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
(deprecated)

boolean

Solo output. Obsoleto: utilizza canMoveChildrenOutOfDrive.

capabilities.canMoveChildrenWithinTeamDrive
(deprecated)

boolean

Solo output. Obsoleto: utilizza canMoveChildrenWithinDrive.

capabilities.canTrashChildren

boolean

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

boolean

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

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. Il campo non viene compilato per i file dei Drive condivisi.

capabilities.canRemoveMyDriveParent

boolean

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

boolean

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

boolean

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

capabilities.canMoveChildrenWithinDrive

boolean

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
(deprecated)

boolean

Deprecato: solo output. Usa un'opzione tra canModifyEditorContentRestriction, canModifyOwnerContentRestriction o canRemoveContentRestriction.

capabilities.canAddFolderFromAnotherDrive

boolean

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

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 sospeso del file. Il campo non viene compilato per i file dei Drive condivisi.

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 sul file.

capabilities.canModifyEditorContentRestriction

boolean

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

capabilities.canModifyOwnerContentRestriction

boolean

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

capabilities.canRemoveContentRestriction

boolean

Solo output. Indica se il file presenta una limitazione dei contenuti che può essere rimossa dall'utente corrente.

hasAugmentedPermissions

boolean

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

trashingUser

object (User)

Solo output. Se il file è stato esplicitamente spostato nel cestino, l'utente che lo ha spostato. Compilato solo per gli elementi dei Drive condivisi.

canReadRevisions
(deprecated)

boolean

Solo output. Obsoleto: utilizza capabilities/canReadRevisions.

thumbnailVersion

string (int64 format)

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

trashedDate

string

Solo output. L'ora in cui l'elemento è stato spostato nel cestino (timestamp RFC 3339). Compilato solo per gli elementi dei Drive condivisi.

permissionIds[]

string

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

thumbnail

object

Una miniatura per il file. Verrà utilizzato solo se non è possibile generare una miniatura standard.

thumbnail.image

string (bytes format)

I byte codificati in formato Base64 con protezione dell'URL dell'immagine in miniatura. Deve essere conforme alla sezione 5 di RFC 4648.

Una stringa con codifica Base64.

thumbnail.mimeType

string

Il tipo MIME della miniatura.

imageMediaMetadata

object

Solo output. Metadati relativi ai contenuti multimediali delle immagini. Sarà presente solo per i tipi di immagini e i suoi contenuti dipenderanno da ciò che può essere analizzato dai contenuti dell'immagine.

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 dei colori 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. Le informazioni sulla posizione geografica memorizzate nell'immagine.

imageMediaMetadata.location.latitude

number

Solo output. La latitudine memorizzata nell'immagine.

imageMediaMetadata.location.longitude

number

Solo output. La longitudine memorizzata 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.date

string

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

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 espressa 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, espressa in millimetri.

imageMediaMetadata.isoSpeed

integer

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

imageMediaMetadata.exposureBias

number

Solo output. La polarizzazione 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 relativi ai contenuti multimediali del video. Sarà presente solo per i tipi di video.

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. Durata del video in millisecondi.

shortcutDetails

object

Dettagli file scorciatoia. Compilato solo per i file di scorciatoie, con il campo mimeType impostato su application/vnd.google-apps.shortcut.

shortcutDetails.targetId

string

L'ID del file a cui rimanda questa scorciatoia.

shortcutDetails.targetMimeType

string

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

string

Solo output. Il valore ResourceKey del file di destinazione.

contentRestrictions[]

object (ContentRestriction)

Restrizioni relative all'accesso ai contenuti del file. Compilato solo se esiste una restrizione di questo tipo.

resourceKey

string

Solo output. È necessaria una chiave 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 nel 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 viene restituita alcuna etichetta.

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

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

ContentRestriction

Una restrizione per accedere ai contenuti del file.

Rappresentazione JSON
{
  "readOnly": boolean,
  "reason": string,
  "type": string,
  "restrictingUser": {
    object (User)
  },
  "restrictionDate": 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, non è possibile aggiungere o modificare i commenti e il titolo del file non può essere modificato.

reason

string

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

type

string

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

restrictingUser

object (User)

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

restrictionDate

string

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

ownerRestricted

boolean

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à 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 del file specificato.

delete

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

emptyTrash

Elimina definitivamente tutti i file spostati nel cestino dell'utente.

export

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

generateIds

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

get

Recupera i metadati o i contenuti di un file in base all'ID.

insert

Inserisce un nuovo file.

list

Elenca i file dell'utente.

listLabels

Elenca le etichette in un file.

modifyLabels

Modifica l'insieme di etichette applicate a un file.

patch

Consente di aggiornare i metadati e/o i contenuti di un file.

touch

Imposta l'ora aggiornata del file sull'ora attuale del server.

trash

Sposta un file nel cestino.

untrash

Ripristina un file dal cestino.

update

Consente di aggiornare i metadati e/o i contenuti di un file.

watch

Sottoscrive le modifiche a un file.