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 di risorse (come files.update) richiedono un fileId. Utilizza il metodo files.list per recuperare l'ID di un file.

Rappresentazione JSON

Rappresentazione JSON
{ "ownerNames": [ string ], "exportLinks": { string: string, ... }, "parents": [ { object (`ParentReference`) } ], "owners": [ { object (`User`) } ], "openWithLinks": { string: string, ... }, "properties": [ { object (`Property`) } ], "permissions": [ { object (`Permission`) } ], "spaces": [ string ], "permissionIds": [ string ], "contentRestrictions": [ { object (`ContentRestriction`) } ], "kind": string, "userPermission": { object (`Permission`) }, "fileExtension": string, "md5Checksum": string, "selfLink": string, "lastModifyingUserName": string, "editable": boolean, "writersCanShare": boolean, "downloadUrl": string, "mimeType": string, "driveId": string, "thumbnailLink": string, "appDataContents": boolean, "webViewLink": string, "iconLink": string, "shared": boolean, "lastModifyingUser": { object (`User`) }, "defaultOpenWithLink": string, "headRevisionId": string, "copyable": boolean, "etag": string, "sharingUser": { object (`User`) }, "alternateLink": string, "embedLink": string, "webContentLink": string, "fileSize": string, "copyRequiresWriterPermission": boolean, "hasThumbnail": boolean, "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, "canDisableInheritedPermissions": boolean, "canEnableInheritedPermissions": boolean }, "hasAugmentedPermissions": boolean, "trashingUser": { object (`User`) }, "canReadRevisions": boolean, "thumbnailVersion": string, "trashedDate": 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 }, "resourceKey": string, "linkShareMetadata": { "securityUpdateEligible": boolean, "securityUpdateEnabled": boolean }, "labelInfo": { "labels": [ { object (`Label`) } ] }, "sha1Checksum": string, "sha256Checksum": string, "inheritedPermissionsDisabled": boolean }

{
  "ownerNames": [
    string
  ],
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    {
      object (ParentReference)
    }
  ],
  "owners": [
    {
      object (User)
    }
  ],
  "openWithLinks": {
    string: string,
    ...
  },
  "properties": [
    {
      object (Property)
    }
  ],
  "permissions": [
    {
      object (Permission)
    }
  ],
  "spaces": [
    string
  ],
  "permissionIds": [
    string
  ],
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "kind": string,
  "userPermission": {
    object (Permission)
  },
  "fileExtension": string,
  "md5Checksum": string,
  "selfLink": string,
  "lastModifyingUserName": string,
  "editable": boolean,
  "writersCanShare": boolean,
  "downloadUrl": string,
  "mimeType": string,
  "driveId": string,
  "thumbnailLink": string,
  "appDataContents": boolean,
  "webViewLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "defaultOpenWithLink": string,
  "headRevisionId": string,
  "copyable": boolean,
  "etag": string,
  "sharingUser": {
    object (User)
  },
  "alternateLink": string,
  "embedLink": string,
  "webContentLink": string,
  "fileSize": string,
  "copyRequiresWriterPermission": boolean,
  "hasThumbnail": boolean,
  "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,
    "canDisableInheritedPermissions": boolean,
    "canEnableInheritedPermissions": boolean
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "canReadRevisions": boolean,
  "thumbnailVersion": string,
  "trashedDate": 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
  },
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean
}

Campi
`ownerNames[]`	`string` Solo output. Nome o nomi del proprietario o dei proprietari di questo file. Non compilato per gli elementi dei Drive condivisi.
`exportLinks`	`map (key: string, value: string)` Solo output. Link per l'esportazione dei file degli editor di documenti in formati specifici. Un oggetto contenente un elenco di coppie `"key": value`. Esempio: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`parents[]`	`object (ParentReference)` L'ID della cartella principale che contiene 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 inserimento, 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 degli elementi principali.
`owners[]`	`object (User)` Solo output. Il proprietario di questo file. Solo alcuni file legacy 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 delle app dell'utente a un link per aprire questo file con l'app. Viene compilata solo quando viene utilizzato l'ambito drive.apps.readonly. Un oggetto contenente un elenco di coppie `"key": value`. Esempio: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`properties[]`	`object (Property)` L'elenco delle proprietà.
`permissions[]`	`object (Permission)` Solo output. L'elenco delle autorizzazioni per gli utenti con accesso a questo file. Non compilato per gli elementi dei Drive condivisi.
`spaces[]`	`string` Solo output. L'elenco degli spazi che contengono il file. I valori supportati sono `drive`, `appDataFolder` e `photos`.
`permissionIds[]`	`string` Solo output. files.list of permission IDs for users with access to this file.
`contentRestrictions[]`	`object (ContentRestriction)` Limitazioni per l'accesso ai contenuti del file. Compilato solo se esiste una limitazione di questo tipo.
`kind`	`string` Solo output. Il tipo di file. Questo valore è sempre `drive#file`.
`userPermission`	`object (Permission)` Solo output. Le autorizzazioni per l'utente autenticato su questo file.
`fileExtension`	`string` Solo output. Il componente finale di `fullFileExtension` con il testo finale che non sembra far parte dell'estensione rimosso. Questo campo viene compilato solo per i file con contenuti memorizzati in 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 memorizzati in Google Drive; non viene compilato per gli editor di documenti o i file di scorciatoia.
`selfLink`	`string` Solo output. Un link a questo file.
`lastModifyingUserName`	`string` Solo output. Nome dell'ultimo utente che ha modificato questo file.
`editable (deprecated)`	`boolean` Questo elemento è deprecato. Solo output. Deprecato: utilizza `capabilities/canEdit`.
`writersCanShare`	`boolean` Se gli autori possono condividere il documento con altri utenti. Non compilato per gli elementi dei Drive condivisi.
`downloadUrl`	`string` Solo output. URL di download temporaneo del file. Questo campo viene compilato solo per i file con contenuti memorizzati in Google Drive; non viene compilato per i file di Documenti Google o per i file di scorciatoia.
`mimeType`	`string` Il tipo MIME del file. Questo valore è modificabile solo durante l'aggiornamento al 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. L'ID del Drive condiviso in cui si trova il file. Compilato solo per gli elementi dei Drive condivisi.
`thumbnailLink`	`string` Solo output. Un link temporaneo alla miniatura del file, se disponibile. In genere dura qualche ora. Non è destinato all'utilizzo diretto nelle applicazioni web a causa della condivisione delle risorse tra origini (CORS), valuta la possibilità di utilizzare un server proxy. Viene compilato solo quando l'app richiedente può accedere ai contenuti del file. Se il file non è condiviso pubblicamente, l'URL restituito in `Files.thumbnailLink` deve essere recuperato utilizzando una richiesta con credenziali.
`appDataContents`	`boolean` Solo output. Se questo file si trova nella cartella Dati applicazioni.
`webViewLink`	`string` Solo output. Un link disponibile solo nelle cartelle pubbliche per visualizzare le risorse web statiche (HTML, CSS, JS e così via) tramite l'hosting di siti 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 dei Drive condivisi.
`lastModifyingUser`	`object (User)` Solo output. L'ultimo utente che ha modificato questo file. Questo campo viene compilato solo quando l'ultima modifica è stata eseguita da un utente che ha eseguito l'accesso.
`defaultOpenWithLink`	`string` Solo output. Un link per aprire questo file con l'app predefinita dell'utente per questo file. Viene 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 memorizzati in Google Drive; non viene compilato per gli editor di documenti o i file di scorciatoia.
`copyable (deprecated)`	`boolean` Questo elemento è deprecato. Solo output. Deprecato: utilizza `capabilities/canCopy`.
`etag`	`string` Solo output. ETag del file.
`sharingUser`	`object (User)` Solo output. L'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 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 sui cookie. Nei casi in cui i contenuti vengono condivisi pubblicamente, possono essere scaricati senza credenziali.
`fileSize`	`string (int64 format)` Solo output. Le dimensioni in byte dei blob e dei file dell'editor proprietario. Non verrà compilato per i file senza dimensioni, come scorciatoie e cartelle.
`copyRequiresWriterPermission`	`boolean` Se le opzioni per copiare, stampare o scaricare questo file devono essere disattivate per lettori e commentatori.
`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.
`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 folderColorPalette della risorsa About. Se viene specificato un colore non supportato, questo verrà modificato con il colore più simile della tavolozza.
`id`	`string` L'ID del file.
`title`	`string` Il titolo di questo file. 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 delle applicazioni, il titolo è costante.
`description`	`string` Una breve descrizione del file.
`labels`	`object` Un gruppo di etichette per il file.
`labels.viewed`	`boolean` Indica se questo file è stato visualizzato da questo utente.
`labels.restricted (deprecated)`	`boolean` Solo output. Deprecato: utilizza `copyRequiresWriterPermission`.
`labels.starred`	`boolean` Indica se l'utente ha aggiunto questo file ai preferiti.
`labels.hidden (deprecated)`	`boolean` Solo output. Deprecato.
`labels.trashed`	`boolean` Indica se questo file è stato spostato nel cestino. Questa etichetta si applica a tutti gli utenti che accedono al file, ma solo i proprietari sono autorizzati a visualizzare e ripristinare i file.
`labels.modified`	`boolean` Solo output. Indica se il file è stato modificato da questo utente.
`explicitlyTrashed`	`boolean` Solo output. Indica se questo file è stato eliminato in modo esplicito, anziché ricorsivo.
`createdDate`	`string` Solo output. Ora di creazione di questo file (timestamp RFC 3339 formattato).
`modifiedDate`	`string` L'ultima volta che questo file è stato modificato da un utente (timestamp RFC 3339 formattato). Questo valore è modificabile solo in caso di aggiornamento quando è impostato il parametro setModifiedDate.
`modifiedByMeDate`	`string` Solo output. L'ultima volta che questo file è stato modificato dall'utente (timestamp RFC 3339 formattato). Tieni presente che l'impostazione di modifiedDate aggiornerà anche la data modifiedByMe per l'utente che ha impostato la data.
`lastViewedByMeDate`	`string` L'ultima volta che l'utente ha visualizzato questo file (timestamp RFC 3339 formattato).
`markedViewedByMeDate (deprecated)`	`string` Questo elemento è deprecato. Solo output. Deprecato.
`sharedWithMeDate`	`string` Solo output. Ora in cui questo file è stato condiviso con l'utente (timestamp RFC 3339 formattato).
`quotaBytesUsed`	`string (int64 format)` Solo output. Il numero di byte della quota utilizzati da questo file.
`version`	`string (int64 format)` Solo output. Un numero di versione del file che aumenta monotonicamente. Questo riflette ogni modifica apportata al file sul server, anche quelle non visibili all'utente che ha effettuato 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 disponibile, altrimenti il valore originale del campo `title`. Disponibile solo per i file con contenuti binari su Google Drive.
`ownedByMe`	`boolean` Solo output. Indica se il file è di proprietà dell'utente corrente. Non compilato per gli elementi dei Drive condivisi.
`canComment (deprecated)`	`boolean` Questo elemento è deprecato. Solo output. Deprecato: utilizza `capabilities/canComment`.
`shareable (deprecated)`	`boolean` Questo elemento è deprecato. Solo output. Deprecato: 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, ma la modifica dell'estensione nel titolo aggiorna questo campo. Questo campo viene compilato solo per i file con contenuti memorizzati in Google Drive; non viene compilato per gli editor di documenti o i file di scorciatoia.
`isAppAuthorized`	`boolean` Solo output. Indica se il file è stato creato o aperto dall'app richiedente.
`teamDriveId (deprecated)`	`string` Questo elemento è deprecato. Solo output. Deprecato: utilizza `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ò intraprendere.
`capabilities.canChangeRestrictedDownload (deprecated)`	`boolean` Solo output. Deprecato.
`capabilities.canMoveChildrenOutOfDrive`	`boolean` Solo output. Se l'utente corrente può spostare i figli di questa cartella al di fuori del Drive condiviso. È false 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 in un Drive condiviso, indica se l'utente attuale può copiare i discendenti non cartelle 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. Indica se l'utente corrente può aggiungere figli a questa cartella. Questo valore è 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 questo file.
`capabilities.canListChildren`	`boolean` Solo output. Se l'utente corrente può elencare i figli di questa cartella. Questo valore è sempre false quando l'elemento non è una cartella.
`capabilities.canRemoveChildren`	`boolean` Solo output. Indica se l'utente corrente può rimuovere i bambini da questa cartella. Questo valore è sempre false 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 questo file.
`capabilities.canTrash`	`boolean` Solo output. 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 Drive condiviso, se è possibile leggere le revisioni dei discendenti non cartelle di questo elemento o l'elemento stesso se non è una cartella.
`capabilities.canReadTeamDrive (deprecated)`	`boolean` Solo output. Deprecato: utilizza `canReadDrive`.
`capabilities.canMoveTeamDriveItem (deprecated)`	`boolean` Solo output. Deprecato: 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. Deprecato: utilizza `canMoveItemOutOfDrive`.
`capabilities.canUntrash`	`boolean` Solo output. 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: utilizza `canMoveItemWithinDrive`.
`capabilities.canMoveItemOutOfTeamDrive (deprecated)`	`boolean` Solo output. Deprecato: utilizza `canMoveItemOutOfDrive`.
`capabilities.canDeleteChildren`	`boolean` Solo output. Indica se l'utente corrente può eliminare i figli di questa cartella. È false quando l'elemento non è una cartella. Compilato solo per gli elementi dei Drive condivisi.
`capabilities.canMoveChildrenOutOfTeamDrive (deprecated)`	`boolean` Solo output. Deprecato: utilizza `canMoveChildrenOutOfDrive`.
`capabilities.canMoveChildrenWithinTeamDrive (deprecated)`	`boolean` Solo output. Deprecato: utilizza `canMoveChildrenWithinDrive`.
`capabilities.canTrashChildren`	`boolean` Solo output. Se l'utente corrente può spostare nel cestino gli elementi secondari di questa cartella. È false quando l'elemento non è una cartella. Compilato solo per gli elementi dei Drive condivisi.
`capabilities.canMoveItemOutOfDrive`	`boolean` Solo output. Indica se l'utente attuale può spostare questo elemento al di fuori di questo drive modificandone il genitore. Tieni presente che una richiesta di modifica dell'elemento principale dell'elemento 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 attuale può aggiungere un elemento principale per l'elemento senza rimuovere un elemento principale esistente nella stessa richiesta. Non compilato per i file del Drive condiviso.
`capabilities.canRemoveMyDriveParent`	`boolean` Solo output. Indica se l'utente attuale può rimuovere un genitore dall'elemento senza aggiungerne un altro nella stessa richiesta. Non compilato per i file del Drive condiviso.
`capabilities.canMoveItemWithinDrive`	`boolean` Solo output. Se l'utente corrente può spostare questo elemento all'interno di questo 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 attuale può modificare le impostazioni di condivisione per questo file.
`capabilities.canMoveChildrenWithinDrive`	`boolean` Solo output. Se l'utente corrente può spostare i contenuti secondari di questa cartella all'interno di questo drive. È false quando l'elemento non è una cartella. Tieni presente che una richiesta di spostamento del bambino potrebbe comunque non riuscire a seconda dell'accesso dell'utente corrente al bambino e alla cartella di destinazione.
`capabilities.canModifyContentRestriction (deprecated)`	`boolean` Ritirato: solo output. Utilizza uno dei seguenti valori: `canModifyEditorContentRestriction`, `canModifyOwnerContentRestriction` o `canRemoveContentRestriction`.
`capabilities.canAddFolderFromAnotherDrive`	`boolean` Solo output. Indica se l'utente corrente può aggiungere una cartella da un altro drive (un altro Drive condiviso o Il mio Drive) a questa cartella. È 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 di condivisione dei link.
`capabilities.canAcceptOwnership`	`boolean` Solo output. Indica se l'utente corrente è il proprietario in attesa del file. Non 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 attuale può aggiungere o modificare le limitazioni ai contenuti del file che sono limitate all'editor.
`capabilities.canModifyOwnerContentRestriction`	`boolean` Solo output. Indica se l'utente attuale può aggiungere o modificare le limitazioni dei contenuti con restrizioni del proprietario.
`capabilities.canRemoveContentRestriction`	`boolean` Solo output. Indica se sul file è presente una limitazione dei contenuti che può essere rimossa dall'utente attuale.
`capabilities.canDisableInheritedPermissions`	`boolean` Solo output. Se un utente può disattivare le autorizzazioni ereditate.
`capabilities.canEnableInheritedPermissions`	`boolean` Solo output. 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 in modo esplicito, l'utente che lo ha eliminato. Compilato solo per gli elementi dei Drive condivisi.
`canReadRevisions (deprecated)`	`boolean` Questo elemento è deprecato. Solo output. Deprecato: 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 cestinato (timestamp RFC 3339 formattato). Compilato solo per gli elementi dei Drive condivisi.
`thumbnail`	`object` Una miniatura per il file. Verrà utilizzata solo se non è possibile generare una miniatura standard.
`thumbnail.image`	`string (bytes format)` I byte con codifica Base64 sicura per gli URL dell'immagine in miniatura. Deve essere conforme alla sezione 5 della RFC 4648. Una stringa con codifica Base64.
`thumbnail.mimeType`	`string` Il tipo MIME della miniatura.
`imageMediaMetadata`	`object` Solo output. Metadati relativi ai contenuti multimediali dell'immagine. Questa sezione sarà presente solo per i tipi di immagini e i relativi contenuti dipenderanno da ciò che può essere analizzato dai contenuti dell'immagine.
`imageMediaMetadata.flashUsed`	`boolean` Solo output. Se è stato utilizzato un 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 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 rispetto 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, espressa in millimetri.
`imageMediaMetadata.isoSpeed`	`integer` Solo output. La velocità ISO utilizzata per creare la foto.
`imageMediaMetadata.exposureBias`	`number` Solo output. Il bias 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 video. Questa opzione è disponibile 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, il cui campo mimeType è impostato su `application/vnd.google-apps.shortcut`. Può essere impostato solo sulle richieste `files.insert`.
`shortcutDetails.targetId`	`string` L'ID del file a cui punta questa scorciatoia. Può essere impostato solo sulle richieste `files.insert`.
`shortcutDetails.targetMimeType`	`string` Solo output. Il tipo MIME del file a cui punta questa scorciatoia. Il valore di questo campo è un'istantanea del tipo MIME della destinazione, acquisita al momento della creazione della scorciatoia.
`shortcutDetails.targetResourceKey`	`string` Solo output. ResourceKey per il file di destinazione.
`resourceKey`	`string` Solo output. Una chiave necessaria per accedere all'elemento tramite un link condiviso.
`linkShareMetadata`	`object` Solo output. Dettagli correlati a LinkShare. Contiene dettagli sugli URL dei link che i clienti 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 sul file.
`labelInfo.labels[]`	`object (Label)` Solo output. Il set 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 memorizzati in 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 memorizzati in Google Drive; non viene compilato per gli editor di documenti o i file di scorciatoia.
`inheritedPermissionsDisabled`	`boolean` Indica se le autorizzazioni ereditate per questo file sono disattivate. Le autorizzazioni ereditate sono attive per impostazione predefinita.

ContentRestriction

Una limitazione 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 il contenuto del file è di sola lettura. Se un file è di sola lettura, non è possibile aggiungere una nuova revisione, aggiungere o modificare commenti e modificare il titolo del file.
`reason`	`string` Il motivo per cui i contenuti del file sono soggetti a limitazioni. Questo campo è 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.
`restrictionDate`	`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` Se la limitazione dei contenuti può essere modificata o rimossa solo da un utente proprietario del file. Per i file nei Drive condivisi, qualsiasi utente con funzionalità `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 dei contenuti con restrizioni 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 cestinati 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 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 il set di etichette applicate a un file.
`patch`	Aggiorna i metadati e/o i contenuti di un file.
`touch`	Imposta l'ora di aggiornamento del file sull'ora corrente 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`	Si iscrive alle modifiche apportate 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`

REST Resource: files Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Risorsa: File

ContentRestriction

Metodi

REST Resource: files