REST Resource: files

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

string

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

string

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

string

Solo output. Il componente finale di fullFileExtension. Questa opzione è disponibile solo per i file con contenuti binari su Google Drive.

boolean

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

string

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

object

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

string

Testo da indicizzare per il file per migliorare le query fullText. Ha una lunghezza massima di 128 kB e può contenere elementi HTML.

object

Una miniatura per il file. Questa opzione verrà utilizzata solo se Google Drive non può generare una miniatura standard.

string (bytes format)

I dati delle miniature codificati con il formato Base64 con protezione dell'URL (RFC 4648 sezione 5).

Una stringa con codifica base64.

string

Il tipo MIME della miniatura.

boolean

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

boolean

Solo output. Se il file è stato visualizzato da questo utente.

string

Il tipo MIME del file.

Google Drive tenta di rilevare automaticamente un valore appropriato dai contenuti caricati, se non viene fornito alcun valore. Il valore non può essere modificato se non viene caricata una nuova revisione.

Se un file viene creato con un tipo MIME di documento Google, vengono importati i contenuti caricati, se possibile. I formati di importazione supportati sono pubblicati nella risorsa Informazioni.

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

string

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

string

Solo output. Un link di breve durata alla miniatura del file, se disponibile. In genere questa operazione dura nell'ordine delle ore. Questa opzione non è destinata all'utilizzo diretto su applicazioni web a causa dei criteri di 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.

string

Solo output. Un link statico e non autenticato all'icona del file.

boolean

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

object (User)

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

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.

string

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

object (User)

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

string

Solo output. Un link per aprire il file in un editor o visualizzatore Google pertinente in un browser.

string

Solo output. Un link per scaricare i contenuti del file in un browser. Questa opzione è disponibile solo per i file con contenuti binari su Google Drive.

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.

boolean

Deprecato: usa invece copyRequiresWriterPermission.

object (Permission)

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

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.

string

Solo output. L'elenco di spazi che contengono il file. I valori attualmente supportati sono "drive", "appDataCartelle" e "foto".

string

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

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

string

L'ID del file.

string

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

string

Una breve descrizione del file.

boolean

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

boolean

Indica se il file è stato spostato nel cestino, in modo esplicito o da una cartella principale spostata nel cestino. Solo il proprietario può spostare un file nel cestino, mentre gli altri utenti non possono vederlo.

boolean

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

string

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

string

L'ultima volta che il file è stato modificato da un utente (data-ora RFC 3339).

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

string

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

string

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

string

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

string (int64 format)

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

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.

string

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

boolean

Solo output. Se l'utente è il proprietario del file. Non compilato per gli elementi nei Drive condivisi.

string

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

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

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

Una raccolta di coppie chiave-valore arbitrarie che sono visibili a tutte le app.

Le voci con valori nulli vengono cancellate nelle richieste di aggiornamento e copia.

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

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

Una raccolta di coppie chiave-valore arbitrarie private per l'app richiedente.

Le voci con valori nulli vengono cancellate nelle richieste di aggiornamento e copia.

Queste proprietà possono essere recuperate solo utilizzando una richiesta autenticata. Una richiesta autenticata utilizza un token di accesso ottenuto con un ID client OAuth 2. Non puoi utilizzare una chiave API per recuperare proprietà private.

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

boolean

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

string

Deprecato: solo output. Usa invece il criterio driveId.

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.

boolean

Deprecato: solo output.

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.

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.

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.

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.

boolean

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

boolean

Solo output. Se l'utente corrente può aggiungere figli a questa cartella. È sempre false quando l'elemento non è una cartella.

boolean

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

boolean

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

boolean

Solo output. Se l'utente corrente può elencare gli elementi secondari di questa cartella. È sempre false quando l'elemento non è una cartella.

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.

boolean

Solo output. Se l'utente corrente può rinominare questo file.

boolean

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

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.

boolean

Deprecato: solo output. Usa invece il criterio canReadDrive.

boolean

Deprecato: solo output. Usa invece canMoveItemWithinDrive o canMoveItemOutOfDrive.

boolean

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

boolean

Deprecato: solo output. Usa invece il criterio canMoveItemOutOfDrive.

boolean

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

boolean

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

boolean

Deprecato: solo output. Usa invece il criterio canMoveItemWithinDrive.

boolean

Deprecato: solo output. Usa invece il criterio canMoveItemOutOfDrive.

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.

boolean

Deprecato: solo output. Usa invece il criterio canMoveChildrenOutOfDrive.

boolean

Deprecato: solo output. Usa invece il criterio canMoveChildrenWithinDrive.

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.

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.

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.

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.

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.

boolean

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

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.

boolean

Deprecato: solo output. Usa uno tra canModifyEditorContentRestriction, canModifyOwnerContentRestriction o canRemoveContentRestriction.

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.

boolean

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

boolean

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

boolean

Solo output. Se l'utente corrente può leggere le etichette sul file.

boolean

Solo output. Se l'utente corrente può modificare le etichette sul file.

boolean

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

boolean

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

boolean

Solo output. Indica se sul file è presente una limitazione dei contenuti che può essere rimossa dall'utente corrente.

boolean

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

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.

string (int64 format)

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

string

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

boolean

Solo output. Se il file è stato modificato da questo utente.

string

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

object

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

boolean

Solo output. Se per creare la foto è stato utilizzato un flash.

string

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

string

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

string

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

string

Solo output. Lo spazio colore della foto.

string

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

integer

Solo output. La larghezza dell'immagine in pixel.

integer

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

object

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

number

Solo output. La latitudine memorizzata nell'immagine.

number

Solo output. La longitudine memorizzata nell'immagine.

number

Solo output. L'altitudine memorizzata nell'immagine.

integer

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

string

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

string

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

string

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

number

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

number

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

number

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

integer

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

number

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

number

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

integer

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

string

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

object

Solo output. Metadati aggiuntivi sui contenuti multimediali dei video. Questa opzione potrebbe non essere disponibile subito dopo il caricamento.

integer

Solo output. La larghezza del video in pixel.

integer

Solo output. L'altezza del video in pixel.

string (int64 format)

Solo output. La durata del video in millisecondi.

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

string

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

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.

string

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

object (ContentRestriction)

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

string

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

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.

boolean

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

boolean

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

object

Solo output. Una panoramica delle etichette del file.

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.

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.

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.