Questa pagina è stata tradotta dall'API Cloud Translation.

REST Resource: files

Risorsa: file
- Rappresentazione JSON
  - Rappresentazione JSON
- ContentRestriction
  - Rappresentazione JSON
Metodi

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

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 }

{
  "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. Il valore è sempre `drive#file`.
`userPermission`	`object (Permission)` Solo output. Le autorizzazioni dell'utente autenticato in 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 i file di scorciatoia.
`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 i file di scorciatoia.
`selfLink`	`string` Solo output. Un link per tornare a questo file.
`ownerNames[]`	`string` Solo output. Nomi dei proprietari di questo file. Non compilato per gli elementi nei Drive condivisi.
`lastModifyingUserName`	`string` Solo output. Nome dell'ultimo utente che ha modificato questo file.
`editable (deprecated)`	`boolean` Questo elemento è deprecato. Solo output. Deprecato: usa invece `capabilities/canEdit`.
`writersCanShare`	`boolean` Se gli autori possono condividere il documento con altri utenti. Non compilato per gli elementi nei 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 documenti Google o i file di scorciatoia.
`mimeType`	`string` Il tipo MIME del file. Questa opzione è modificabile solo all'aggiornamento quando si caricano nuovi contenuti. Questo campo può essere lasciato vuoto e il tipo MIME verrà determinato in base al tipo MIME dei contenuti caricati.
`exportLinks`	`map (key: string, value: string)` Solo output. Link per esportare i file degli editor di documenti in formati specifici. Un oggetto contenente un elenco di `"key": value` coppie. Esempio: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`driveId`	`string` Solo output. ID del Drive condiviso in cui risiede il file. Compilato solo per gli elementi dei Drive condivisi.
`parents[]`	`object (ParentReference)` L'ID della cartella principale contenente il file. Un file può avere una sola cartella principale. la specifica di più elementi padre non è supportata. Se non viene specificato come parte 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 eredita qualsiasi elemento padre rilevabile del file di origine. Le richieste files.update devono utilizzare i parametri `addParents` e `removeParents` per modificare l'elenco principale.
`thumbnailLink`	`string` Solo output. Un link di breve durata alla miniatura del file, se disponibile. In genere questa operazione dura nell'ordine delle ore. Questa funzione non è destinata all'utilizzo diretto su applicazioni web a causa della condivisione delle risorse tra origini (CORS). Considera l'utilizzo di un server proxy. Compilato solo quando l'app che ha inviato la richiesta può accedere ai contenuti del file. Se il file non viene condiviso pubblicamente, l'URL restituito in `Files.thumbnailLink` deve essere recuperato utilizzando una richiesta con credenziali.
`appDataContents`	`boolean` Solo output. Se il file si trova nella cartella Dati applicazione.
`webViewLink`	`string` Solo output. Un link disponibile solo nelle cartelle pubbliche per visualizzare i relativi asset web statici (HTML, CSS, JS e così via) tramite l'hosting del sito web di Google Drive.
`iconLink`	`string` Solo output. Un link all'icona del file.
`shared`	`boolean` Solo output. Se il file è stato condiviso. Non compilato per gli elementi nei Drive condivisi.
`lastModifyingUser`	`object (User)` Solo output. L'ultimo utente che ha modificato questo 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.
`openWithLinks`	`map (key: string, value: string)` Solo output. Una mappa dell'ID di ciascuna app dell'utente a un link per aprire il file con l'app in questione. Compilato solo quando viene utilizzato l'ambito drive.apps.readonly. Un oggetto contenente un elenco di `"key": value` coppie. Esempio: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`defaultOpenWithLink`	`string` Solo output. Un link per aprire il file con l'app predefinita dell'utente per il file. Compilato solo quando viene utilizzato l'ambito drive.apps.readonly.
`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 i file di scorciatoia.
`properties[]`	`object (Property)` L'elenco delle proprietà.
`copyable (deprecated)`	`boolean` Questo elemento è deprecato. Solo output. Deprecato: usa invece `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.
`alternateLink`	`string` Solo output. Un link per aprire il file in un editor o un visualizzatore Google pertinente.
`embedLink`	`string` Solo output. Un link per incorporare il file.
`webContentLink`	`string` Solo output. Un link per scaricare i contenuti del file in un browser utilizzando l'autenticazione basata su cookie. Nei casi in cui i contenuti sono condivisi pubblicamente, possono essere scaricati senza alcuna credenziale.
`fileSize`	`string (int64 format)` Solo output. Dimensioni in byte dei BLOB e dei file degli editor proprietari. Non verranno compilati per i file che non hanno dimensioni, come scorciatoie e cartelle.
`copyRequiresWriterPermission`	`boolean` Indica se le opzioni per copiare, stampare o scaricare il file devono essere disabilitate per lettori e commentatori.
`permissions[]`	`object (Permission)` Solo output. L'elenco delle autorizzazioni per gli utenti con accesso a questo file. Non compilato per gli elementi nei Drive condivisi.
`hasThumbnail`	`boolean` Solo output. Se il file ha una miniatura. Non indica se l'app che ha inviato la richiesta ha accesso alla miniatura. Per verificare l'accesso, cerca la presenza del campo miniatureLink.
`spaces[]`	`string` Solo output. L'elenco di 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 campofolderColorPalette della risorsa Informazioni. Se viene specificato un colore non supportato, verrà sostituito 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 applicazione, il titolo è costante.
`description`	`string` Una breve descrizione del file.
`labels`	`object` Un gruppo di etichette per il file.
`labels.viewed`	`boolean` Se il file è stato visualizzato da questo utente.
`labels.restricted (deprecated)`	`boolean` Solo output. Deprecato: usa invece `copyRequiresWriterPermission`.
`labels.starred`	`boolean` Se questo file è stato aggiunto a Speciali dall'utente.
`labels.hidden (deprecated)`	`boolean` Solo output. Deprecato.
`labels.trashed`	`boolean` Se il file è stato spostato nel cestino. Questa etichetta si applica a tutti gli utenti che accedono al file. tuttavia, solo i proprietari possono visualizzare i file e spostarli dal cestino.
`labels.modified`	`boolean` Solo output. Se il file è stato modificato da questo utente.
`explicitlyTrashed`	`boolean` Solo output. Indica se il file è stato spostato esplicitamente nel cestino, o meno che in modo ricorsivo.
`createdDate`	`string` Solo output. Crea l'ora per questo file (nel formato RFC 3339 timestamp).
`modifiedDate`	`string` L'ultima volta che questo file è stato modificato da un utente (con il formato RFC 3339 timestamp). È modificabile solo all'aggiornamento quando è impostato il parametro setModificaData.
`modifiedByMeDate`	`string` Solo output. L'ultima volta che questo file è stato modificato dall'utente (nel formato RFC 3339 timestamp). Tieni presente che l'impostazione di questa data comporta anche l'aggiornamento della data di updatedByMe per l'utente che l'ha impostata.
`lastViewedByMeDate`	`string` L'ultima volta che questo file è stato visualizzato dall'utente (con timestamp nel formato RFC 3339).
`markedViewedByMeDate (deprecated)`	`string` Questo elemento è deprecato. Solo output. Deprecato.
`sharedWithMeDate`	`string` Solo output. L'ora in cui il file è stato condiviso con l'utente (timestamp nel 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. Un numero di versione del file che aumenta monotonicamente. Ciò riflette ogni modifica apportata 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 scritti solo)
`indexableText.text`	`string` Il testo da indicizzare per questo file.
`originalFilename`	`string` Il nome file originale dei contenuti caricati, se disponibile, oppure il valore originale del campo `title`. Questa opzione è disponibile solo per i file con contenuti binari su Google Drive.
`ownedByMe`	`boolean` Solo output. Se il file è di proprietà dell'utente corrente. Non compilato per gli elementi nei Drive condivisi.
`canComment (deprecated)`	`boolean` Questo elemento è deprecato. Solo output. Deprecato: usa invece `capabilities/canComment`.
`shareable (deprecated)`	`boolean` Questo elemento è deprecato. Solo output. Deprecato: usa invece `capabilities/canShare`.
`fullFileExtension`	`string` Solo output. L'estensione completa del file; estratti 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 nel titolo aggiorna 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 i file di scorciatoia.
`isAppAuthorized`	`boolean` Solo output. Se il file è stato creato o aperto dall'app richiedente.
`teamDriveId (deprecated)`	`string` Questo elemento è deprecato. Solo output. Deprecato: usa invece `driveId`.
`capabilities`	`object` Solo output. Le funzionalità di cui l'utente corrente dispone 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 gli elementi secondari di questa cartella all'esterno del Drive condiviso. Questo valore è falso quando l'elemento non è una cartella. Compilato solo per gli elementi dei Drive condivisi.
`capabilities.canReadDrive`	`boolean` Solo output. Se l'utente corrente può leggere il Drive condiviso a cui appartiene questo file. Compilato solo per gli elementi dei Drive condivisi.
`capabilities.canEdit`	`boolean` Solo output. 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. Se l'utente corrente può copiare questo file. Per un elemento di un Drive condiviso, indica se l'utente corrente può copiare i discendenti non appartenenti alla cartella di questo elemento o l'elemento stesso se non è una cartella.
`capabilities.canComment`	`boolean` Solo output. Se l'utente corrente può commentare questo file.
`capabilities.canAddChildren`	`boolean` Solo output. Se l'utente corrente può aggiungere figli a questa cartella. È sempre false quando l'elemento non è una cartella.
`capabilities.canDelete`	`boolean` Solo output. Se l'utente corrente può eliminare questo file.
`capabilities.canDownload`	`boolean` Solo output. Se l'utente corrente può scaricare il file.
`capabilities.canListChildren`	`boolean` Solo output. Se l'utente corrente può elencare gli elementi secondari di questa cartella. È sempre false quando l'elemento non è una cartella.
`capabilities.canRemoveChildren`	`boolean` Solo output. Indica se l'utente corrente può rimuovere gli elementi secondari da questa cartella. È sempre false quando l'elemento non è una cartella. Per una cartella in un Drive condiviso, utilizza invece `canDeleteChildren` o `canTrashChildren`.
`capabilities.canRename`	`boolean` Solo output. Se l'utente corrente può rinominare questo file.
`capabilities.canTrash`	`boolean` Solo output. Indica se l'utente corrente può spostare il file nel cestino.
`capabilities.canReadRevisions`	`boolean` Solo output. Se l'utente corrente può leggere la risorsa delle revisioni di questo file. Per un elemento di un Drive condiviso, è possibile leggere le revisioni dei discendenti non appartenenti a cartelle di questo elemento o l'elemento stesso se non è una cartella.
`capabilities.canReadTeamDrive (deprecated)`	`boolean` Solo output. Deprecato: usa invece `canReadDrive`.
`capabilities.canMoveTeamDriveItem (deprecated)`	`boolean` Solo output. Deprecato: usa 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` Solo output. Deprecato: usa invece `canMoveItemOutOfDrive`.
`capabilities.canUntrash`	`boolean` Solo output. Indica se l'utente corrente può ripristinare questo file dal cestino.
`capabilities.canModifyContent`	`boolean` Solo output. Se l'utente corrente può modificare i contenuti di questo file.
`capabilities.canMoveItemWithinTeamDrive (deprecated)`	`boolean` Solo output. Deprecato: usa invece `canMoveItemWithinDrive`.
`capabilities.canMoveItemOutOfTeamDrive (deprecated)`	`boolean` Solo output. Deprecato: usa invece `canMoveItemOutOfDrive`.
`capabilities.canDeleteChildren`	`boolean` Solo output. Se l'utente corrente può eliminare gli elementi secondari di questa cartella. Questo valore è falso quando l'elemento non è una cartella. Compilato solo per gli elementi dei Drive condivisi.
`capabilities.canMoveChildrenOutOfTeamDrive (deprecated)`	`boolean` Solo output. Deprecato: usa invece `canMoveChildrenOutOfDrive`.
`capabilities.canMoveChildrenWithinTeamDrive (deprecated)`	`boolean` Solo output. Deprecato: usa invece `canMoveChildrenWithinDrive`.
`capabilities.canTrashChildren`	`boolean` Solo output. Indica se l'utente corrente può spostare gli elementi secondari di questa cartella nel cestino. Questo valore è falso 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 ancora 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 publisher principale esistente nella stessa richiesta. Non 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 compilato per i file del Drive condiviso.
`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 ancora 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 per il file.
`capabilities.canMoveChildrenWithinDrive`	`boolean` Solo output. Indica se l'utente corrente può spostare gli elementi secondari di questa cartella all'interno dell'unità. Questo valore è falso quando l'elemento non è una cartella. Tieni presente che la richiesta di spostare il file 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 uno 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 condiviso o da Il mio Drive. Questo valore è falso 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. Non compilato per i file del Drive condiviso.
`capabilities.canReadLabels`	`boolean` Solo output. Se l'utente corrente può leggere le etichette sul file.
`capabilities.canModifyLabels`	`boolean` Solo output. 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 limitate all'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 sul file è presente una limitazione dei contenuti che può essere rimossa dall'utente corrente.
`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 spostato esplicitamente nel Cestino, indica l'utente che lo ha spostato. Compilato solo per gli elementi dei Drive condivisi.
`canReadRevisions (deprecated)`	`boolean` Questo elemento è deprecato. Solo output. Deprecato: usa invece `capabilities/canReadRevisions`.
`thumbnailVersion`	`string (int64 format)` Solo output. La versione della miniatura da utilizzare nell'annullamento della convalida della cache delle miniature.
`trashedDate`	`string` Solo output. L'ora in cui l'elemento è stato spostato nel cestino (nel formato 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)` Byte codificati in formato Base64 sicuri per l'URL dell'immagine in miniatura. Deve essere conforme a RFC 4648 sezione 5. 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 immagine e i suoi contenuti dipenderanno da ciò che può essere analizzato dai contenuti dell'immagine.
`imageMediaMetadata.flashUsed`	`boolean` Solo output. Se per creare la foto è stato utilizzato un flash.
`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 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 all'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, 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 velocità ISO utilizzata per creare la foto.
`imageMediaMetadata.exposureBias`	`number` Solo output. La 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. I metadati sui contenuti multimediali dei 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. La durata del video in millisecondi.
`shortcutDetails`	`object` Dettagli del file della scorciatoia. Compilato solo per i file di scorciatoia con il campo mimeType impostato su `application/vnd.google-apps.shortcut`. Può essere impostato solo per le richieste `files.insert`.
`shortcutDetails.targetId`	`string` L'ID del file a cui rimanda questa scorciatoia. Può essere impostato solo per le richieste `files.insert`.
`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 di destinazione, acquisita al momento della creazione della scorciatoia.
`shortcutDetails.targetResourceKey`	`string` Solo output. La chiave Resource per il file di destinazione.
`contentRestrictions[]`	`object (ContentRestriction)` Restrizioni per l'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`	`object` Solo output. Dettagli correlati alla Condivisione tramite link. Contiene i dettagli sugli URL dei link che i client utilizzano per fare riferimento a questo elemento.
`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 delle etichette 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 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.

ContentRestriction

Una restrizione per l'accesso ai contenuti del file.

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

Campi
`readOnly`	`boolean` Se i contenuti del file sono di sola lettura. Se un file è di sola lettura, non è possibile aggiungere una nuova revisione del file, aggiungere o modificare commenti e il titolo del file non può essere modificato.
`reason`	`string` Il motivo per cui i contenuti del file sono soggetti a limitazioni. È modificabile solo per le 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. Compilato solo se `readOnly` è true.
`restrictionDate`	`string` Solo output. L'ora in cui è stata impostata la limitazione dei contenuti (timestamp nel formato 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à di `organizer` può modificare o rimuovere questa limitazione dei contenuti.
`systemRestricted`	`boolean` Solo output. 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 Google Workspace nel tipo MIME richiesto e restituisce i contenuti dei 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 di un file.
`modifyLabels`	Modifica l'insieme di etichette applicate a un file.
`patch`	Aggiorna 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`	Aggiorna i metadati e/o i contenuti di un file.
`watch`	Sottoscrive le modifiche a un file.

REST Resource: files

Risorsa: file

ContentRestriction

Metodi

`copy`

`delete`

`emptyTrash`

`export`

`generateIds`

`get`

`insert`

`list`

`listLabels`

`modifyLabels`

`patch`

`touch`

`trash`

`untrash`

`update`

`watch`