REST Resource: files

Recurso: File

Son los metadatos de un archivo.

Algunos métodos de recursos (como files.update) requieren un fileId. Usa el método files.list para recuperar el ID de un archivo.

Representación JSON
{
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    string
  ],
  "owners": [
    {
      object (User)
    }
  ],
  "permissions": [
    {
      object (Permission)
    }
  ],
  "spaces": [
    string
  ],
  "properties": {
    string: value,
    ...
  },
  "appProperties": {
    string: value,
    ...
  },
  "permissionIds": [
    string
  ],
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "kind": string,
  "driveId": string,
  "fileExtension": string,
  "copyRequiresWriterPermission": boolean,
  "md5Checksum": string,
  "contentHints": {
    "indexableText": string,
    "thumbnail": {
      "image": string,
      "mimeType": string
    }
  },
  "writersCanShare": boolean,
  "viewedByMe": boolean,
  "mimeType": string,
  "thumbnailLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "headRevisionId": string,
  "sharingUser": {
    object (User)
  },
  "webViewLink": string,
  "webContentLink": string,
  "size": string,
  "viewersCanCopyContent": boolean,
  "hasThumbnail": boolean,
  "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,
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeViewersCanCopyContent": boolean,
    "canMoveChildrenOutOfDrive": boolean,
    "canReadDrive": boolean,
    "canEdit": boolean,
    "canCopy": boolean,
    "canComment": boolean,
    "canAddChildren": boolean,
    "canDelete": boolean,
    "canDownload": boolean,
    "canListChildren": boolean,
    "canRemoveChildren": boolean,
    "canRename": boolean,
    "canTrash": boolean,
    "canReadRevisions": boolean,
    "canReadTeamDrive": boolean,
    "canMoveTeamDriveItem": boolean,
    "canChangeCopyRequiresWriterPermission": boolean,
    "canMoveItemIntoTeamDrive": boolean,
    "canUntrash": boolean,
    "canModifyContent": boolean,
    "canMoveItemWithinTeamDrive": boolean,
    "canMoveItemOutOfTeamDrive": boolean,
    "canDeleteChildren": boolean,
    "canMoveChildrenOutOfTeamDrive": boolean,
    "canMoveChildrenWithinTeamDrive": boolean,
    "canTrashChildren": boolean,
    "canMoveItemOutOfDrive": boolean,
    "canAddMyDriveParent": boolean,
    "canRemoveMyDriveParent": boolean,
    "canMoveItemWithinDrive": boolean,
    "canShare": boolean,
    "canMoveChildrenWithinDrive": boolean,
    "canModifyContentRestriction": boolean,
    "canAddFolderFromAnotherDrive": boolean,
    "canChangeSecurityUpdateEnabled": boolean,
    "canAcceptOwnership": boolean,
    "canReadLabels": boolean,
    "canModifyLabels": boolean,
    "canModifyEditorContentRestriction": boolean,
    "canModifyOwnerContentRestriction": boolean,
    "canRemoveContentRestriction": boolean,
    "canDisableInheritedPermissions": boolean,
    "canEnableInheritedPermissions": boolean,
    "canChangeItemDownloadRestriction": boolean
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "thumbnailVersion": string,
  "trashedTime": string,
  "modifiedByMe": boolean,
  "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
  },
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean,
  "downloadRestrictions": {
    object (DownloadRestrictionsMetadata)
  }
}
Campos
parents[]

string

ID de la carpeta principal que contiene el archivo.

Un archivo solo puede tener una carpeta superior. No se admite especificar varias carpetas superiores.

Si no se especifica como parte de una solicitud de creación, el archivo se coloca directamente en la carpeta Mi unidad del usuario. Si no se especifica como parte de una solicitud de copia, el archivo hereda cualquier elemento superior detectable del archivo fuente. Las solicitudes de files.update deben usar los parámetros addParents y removeParents para modificar la lista de elementos superiores.

owners[]

object (User)

Solo salida. Propietario de este archivo Solo algunos archivos heredados pueden tener más de un propietario. Este campo no se completa para los elementos de unidades compartidas.

permissions[]

object (Permission)

Solo salida. Es la lista completa de permisos para el archivo. Solo está disponible si el usuario solicitante puede compartir el archivo. No se propaga para los elementos de las unidades compartidas.

spaces[]

string

Solo salida. Es la lista de espacios que contienen el archivo. Actualmente, se admiten los valores "drive", "appDataFolder" y "photos".

properties

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

Es una colección de pares clave-valor arbitrarios que son visibles para todas las apps.

Las entradas con valores nulos se borran en las solicitudes de actualización y copia.

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

appProperties

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

Es una colección de pares clave-valor arbitrarios que son privados para la app que realiza la solicitud.

Las entradas con valores nulos se borran en las solicitudes de actualización y copia.

Estas propiedades solo se pueden recuperar con una solicitud autenticada. Una solicitud autenticada usa un token de acceso que se obtuvo con un ID de cliente de OAuth 2. No puedes usar una clave de API para recuperar propiedades privadas.

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

permissionIds[]

string

Solo salida. Es la lista de IDs de permisos para los usuarios con acceso a este archivo.

contentRestrictions[]

object (ContentRestriction)

Son las restricciones para acceder al contenido del archivo. Solo se completa si existe tal restricción.

kind

string

Solo salida. Identifica qué tipo de recurso es este. El valor es la cadena fija "drive#file".

driveId

string

Solo salida. Es el ID de la unidad compartida en la que reside el archivo. Solo se completa para los elementos de las unidades compartidas.

fileExtension

string

Solo salida. Es el componente final de fullFileExtension. Esta opción solo está disponible para los archivos con contenido binario en Google Drive.

copyRequiresWriterPermission

boolean

Indica si se deben inhabilitar las opciones para copiar, imprimir o descargar este archivo para los lectores y comentaristas.

md5Checksum

string

Solo salida. Es la suma de verificación MD5 del contenido del archivo. Esto solo se aplica a los archivos con contenido binario en Google Drive.

contentHints

object

Es información adicional sobre el contenido del archivo. Estos campos nunca se propagan en las respuestas.

contentHints.indexableText

string

Es el texto que se indexará para que el archivo mejore las consultas de fullText. Este campo está limitado a 128 KB de longitud y puede contener elementos HTML.

contentHints.thumbnail

object

Es una miniatura del archivo. Solo se usará si Google Drive no puede generar una miniatura estándar.

contentHints.thumbnail.image

string (bytes format)

Son los datos de la miniatura codificados con Base64 seguro para URL (sección 5 del RFC 4648).

String codificada en base64.

contentHints.thumbnail.mimeType

string

Tipo de MIME de la miniatura.

writersCanShare

boolean

Indica si los usuarios con permiso de writer pueden modificar los permisos del archivo. No se propaga para los elementos de las unidades compartidas.

viewedByMe

boolean

Solo salida. Indica si el usuario vio el archivo.

mimeType

string

Tipo MIME del archivo.

Si no se proporciona ningún valor, Google Drive intenta detectar automáticamente un valor adecuado a partir del contenido subido. El valor no se puede cambiar, a menos que se suba una revisión nueva.

Si se crea un archivo con un tipo de MIME de Documentos de Google, se importa el contenido subido, si es posible. Los formatos de importación admitidos se publican en el recurso About.

shared

boolean

Solo salida. Indica si se compartió el archivo. No se propaga para los elementos de las unidades compartidas.

lastModifyingUser

object (User)

Solo salida. Es el último usuario que modificó el archivo. Este campo solo se completa cuando la última modificación la realizó un usuario que accedió a su cuenta.

headRevisionId

string

Solo salida. ID de la revisión principal del archivo. Por el momento, esta opción solo está disponible para archivos con contenido binario en Google Drive.

sharingUser

object (User)

Solo salida. Es el usuario que compartió el archivo con el usuario solicitante, si corresponde.

size

string (int64 format)

Solo salida. Tamaño en bytes de los BLOB y los archivos del editor de origen. No se completará para los archivos que no tienen tamaño, como los accesos directos y las carpetas.

viewersCanCopyContent
(deprecated)

boolean

Obsoleto: Usa copyRequiresWriterPermission en su lugar.

hasThumbnail

boolean

Solo salida. Indica si este archivo tiene una miniatura. Esto no indica si la app solicitante tiene acceso a la miniatura. Para verificar el acceso, busca la presencia del campo thumbnailLink.

folderColorRgb

string

Color de una carpeta o de un acceso directo a una carpeta como una cadena hexadecimal RGB. Los colores admitidos se publican en el campo folderColorPalette del recurso About.

Si se especifica un color no admitido, se usará el color más cercano de la paleta.

id

string

Es el ID del archivo.

name

string

Es el nombre del archivo. No es necesariamente único dentro de una carpeta. Ten en cuenta que, para los elementos inmutables, como las carpetas de nivel superior de las unidades compartidas, la carpeta raíz de Mi unidad y la carpeta Datos de la aplicación, el nombre es constante.

description

string

Es una breve descripción del archivo.

starred

boolean

Indica si el usuario destacó el archivo.

trashed

boolean

Indica si el archivo se envió a la papelera, ya sea de forma explícita o desde una carpeta superior que se envió a la papelera. Solo el propietario puede enviar un archivo a la papelera, y los demás usuarios no pueden ver los archivos en la papelera del propietario.

explicitlyTrashed

boolean

Solo salida. Indica si el archivo se envió explícitamente a la papelera, a diferencia de si se envió de forma recursiva desde una carpeta superior.

createdTime

string

Fecha y hora de creación del archivo (RFC 3339).

modifiedTime

string

Fecha y hora (RFC 3339) de la última vez que alguien modificó el archivo.

Ten en cuenta que configurar modifiedTime también actualiza modifiedByMeTime para el usuario.

modifiedByMeTime

string

Solo salida. Fecha y hora (RFC 3339) en que el usuario modificó el archivo por última vez.

viewedByMeTime

string

Fecha y hora (RFC 3339) en que el usuario vio el archivo por última vez.

sharedWithMeTime

string

Solo salida. Fecha y hora en la que se compartió el archivo con el usuario, si corresponde (fecha y hora según RFC 3339).

quotaBytesUsed

string (int64 format)

Solo salida. Es la cantidad de bytes de la cuota de almacenamiento que usa el archivo. Esto incluye la revisión principal y las revisiones anteriores con keepForever habilitado.

version

string (int64 format)

Solo salida. Es un número de versión que aumenta de forma monótona para el archivo. Esto refleja cada cambio que se realiza en el archivo del servidor, incluso aquellos que no son visibles para el usuario.

originalFilename

string

Nombre de archivo original del contenido subido, si está disponible, o bien el valor original del campo name Esta opción solo está disponible para los archivos con contenido binario en Google Drive.

ownedByMe

boolean

Solo salida. Indica si el usuario es propietario del archivo. No se propaga para los elementos de las unidades compartidas.

fullFileExtension

string

Solo salida. Es la extensión de archivo completa extraída del campo name. Puede contener varias extensiones concatenadas, como "tar.gz". Esta opción solo está disponible para los archivos con contenido binario en Google Drive.

Este campo se actualiza automáticamente cuando cambia el campo name, pero no se borra si el nombre nuevo no contiene una extensión válida.

isAppAuthorized

boolean

Solo salida. Indica si la app solicitante creó o abrió el archivo.

teamDriveId
(deprecated)

string

Obsoleto: Solo salida. Usa driveId en su lugar.

capabilities

object

Solo salida. Son las capacidades que tiene el usuario actual en este archivo. Cada capacidad corresponde a una acción detallada que puede realizar un usuario.

capabilities.canChangeViewersCanCopyContent
(deprecated)

boolean

Obsoleto: Solo salida.

capabilities.canMoveChildrenOutOfDrive

boolean

Solo salida. Indica si el usuario actual puede trasladar los elementos secundarios de esta carpeta fuera de la unidad compartida. Es falso cuando el elemento no es una carpeta. Solo se completa para los elementos de las unidades compartidas.

capabilities.canReadDrive

boolean

Solo salida. Indica si el usuario actual puede leer la unidad compartida a la que pertenece este archivo. Solo se completa para los elementos de las unidades compartidas.

capabilities.canEdit

boolean

Solo salida. Indica si el usuario actual puede editar este archivo. Otros factores pueden limitar el tipo de cambios que un usuario puede realizar en un archivo. Por ejemplo, consulta canChangeCopyRequiresWriterPermission o canModifyContent.

capabilities.canCopy

boolean

Solo salida. Indica si el usuario actual puede copiar este archivo. En el caso de un elemento en una unidad compartida, indica si el usuario actual puede copiar los elementos secundarios que no son carpetas de este elemento o este elemento en sí si no es una carpeta.

capabilities.canComment

boolean

Solo salida. Indica si el usuario actual puede comentar este archivo.

capabilities.canAddChildren

boolean

Solo salida. Indica si el usuario actual puede agregar elementos secundarios a esta carpeta. Siempre es falso cuando el elemento no es una carpeta.

capabilities.canDelete

boolean

Solo salida. Indica si el usuario actual puede borrar este archivo.

capabilities.canDownload

boolean

Solo salida. Indica si el usuario actual puede descargar este archivo.

capabilities.canListChildren

boolean

Solo salida. Indica si el usuario actual puede enumerar los elementos secundarios de esta carpeta. Siempre es falso cuando el elemento no es una carpeta.

capabilities.canRemoveChildren

boolean

Solo salida. Indica si el usuario actual puede quitar elementos secundarios de esta carpeta. Siempre es falso cuando el elemento no es una carpeta. En el caso de una carpeta en una unidad compartida, usa canDeleteChildren o canTrashChildren.

capabilities.canRename

boolean

Solo salida. Indica si el usuario actual puede cambiar el nombre de este archivo.

capabilities.canTrash

boolean

Solo salida. Indica si el usuario actual puede mover este archivo a la papelera.

capabilities.canReadRevisions

boolean

Solo salida. Indica si el usuario actual puede leer el recurso de revisiones de este archivo. En el caso de un elemento de unidad compartida, indica si se pueden leer las revisiones de los elementos secundarios que no son carpetas de este elemento o este elemento en sí si no es una carpeta.

capabilities.canReadTeamDrive
(deprecated)

boolean

Obsoleto: Solo salida. Usa canReadDrive en su lugar.

capabilities.canMoveTeamDriveItem
(deprecated)

boolean

Obsoleto: Solo salida. En su lugar, usa los elementos canMoveItemWithinDrive o canMoveItemOutOfDrive.

capabilities.canChangeCopyRequiresWriterPermission

boolean

Solo salida. Indica si el usuario actual puede cambiar la restricción copyRequiresWriterPermission de este archivo.

capabilities.canMoveItemIntoTeamDrive
(deprecated)

boolean

Obsoleto: Solo salida. Usa canMoveItemOutOfDrive en su lugar.

capabilities.canUntrash

boolean

Solo salida. Indica si el usuario actual puede restablecer este archivo de la papelera.

capabilities.canModifyContent

boolean

Solo salida. Indica si el usuario actual puede modificar el contenido de este archivo.

capabilities.canMoveItemWithinTeamDrive
(deprecated)

boolean

Obsoleto: Solo salida. Usa canMoveItemWithinDrive en su lugar.

capabilities.canMoveItemOutOfTeamDrive
(deprecated)

boolean

Obsoleto: Solo salida. Usa canMoveItemOutOfDrive en su lugar.

capabilities.canDeleteChildren

boolean

Solo salida. Indica si el usuario actual puede borrar elementos secundarios de esta carpeta. Es falso cuando el elemento no es una carpeta. Solo se completa para los elementos de las unidades compartidas.

capabilities.canMoveChildrenOutOfTeamDrive
(deprecated)

boolean

Obsoleto: Solo salida. Usa canMoveChildrenOutOfDrive en su lugar.

capabilities.canMoveChildrenWithinTeamDrive
(deprecated)

boolean

Obsoleto: Solo salida. Usa canMoveChildrenWithinDrive en su lugar.

capabilities.canTrashChildren

boolean

Solo salida. Indica si el usuario actual puede descartar elementos secundarios de esta carpeta. Es falso cuando el elemento no es una carpeta. Solo se completa para los elementos de las unidades compartidas.

capabilities.canMoveItemOutOfDrive

boolean

Solo salida. Indica si el usuario actual puede mover este elemento fuera de esta unidad cambiando su elemento superior. Ten en cuenta que es posible que una solicitud para cambiar el elemento superior del elemento siga fallando según el nuevo elemento superior que se agregue.

capabilities.canAddMyDriveParent

boolean

Solo salida. Indica si el usuario actual puede agregar un elemento superior para el elemento sin quitar un elemento superior existente en la misma solicitud. No se propaga para los archivos de unidades compartidas.

capabilities.canRemoveMyDriveParent

boolean

Solo salida. Indica si el usuario actual puede quitar a un padre o madre del elemento sin agregar a otro en la misma solicitud. No se propaga para los archivos de unidades compartidas.

capabilities.canMoveItemWithinDrive

boolean

Solo salida. Indica si el usuario actual puede mover este elemento dentro de esta unidad. Ten en cuenta que es posible que una solicitud para cambiar el elemento superior del elemento siga fallando según el nuevo elemento superior que se agregue y el elemento superior que se quite.

capabilities.canShare

boolean

Solo salida. Indica si el usuario actual puede modificar la configuración de uso compartido de este archivo.

capabilities.canMoveChildrenWithinDrive

boolean

Solo salida. Indica si el usuario actual puede mover elementos secundarios de esta carpeta dentro de esta unidad. Es falso cuando el elemento no es una carpeta. Ten en cuenta que es posible que la solicitud para mover el elemento secundario siga fallando según el acceso del usuario actual al elemento secundario y a la carpeta de destino.

capabilities.canModifyContentRestriction
(deprecated)

boolean

Obsoleto: Solo salida. Usa uno de los siguientes: canModifyEditorContentRestriction, canModifyOwnerContentRestriction o canRemoveContentRestriction.

capabilities.canAddFolderFromAnotherDrive

boolean

Solo salida. Indica si el usuario actual puede agregar una carpeta de otra unidad (otra unidad compartida o Mi unidad) a esta carpeta. Es falso cuando el elemento no es una carpeta. Solo se completa para los elementos de las unidades compartidas.

capabilities.canChangeSecurityUpdateEnabled

boolean

Solo salida. Indica si el usuario actual puede cambiar el campo securityUpdateEnabled en los metadatos de uso compartido de vínculos.

capabilities.canAcceptOwnership

boolean

Solo salida. Indica si el usuario actual es el propietario pendiente del archivo. No se propaga para los archivos de unidades compartidas.

capabilities.canReadLabels

boolean

Solo salida. Indica si el usuario actual puede leer las etiquetas del archivo.

capabilities.canModifyLabels

boolean

Solo salida. Indica si el usuario actual puede modificar las etiquetas del archivo.

capabilities.canModifyEditorContentRestriction

boolean

Solo salida. Indica si el usuario actual puede agregar o modificar las restricciones de contenido en el archivo que están restringidas para los editores.

capabilities.canModifyOwnerContentRestriction

boolean

Solo salida. Indica si el usuario actual puede agregar o modificar restricciones de contenido que están restringidas para el propietario.

capabilities.canRemoveContentRestriction

boolean

Solo salida. Indica si hay una restricción de contenido en el archivo que el usuario actual puede quitar.

capabilities.canDisableInheritedPermissions

boolean

Indica si un usuario puede inhabilitar los permisos heredados.

capabilities.canEnableInheritedPermissions

boolean

Indica si un usuario puede volver a habilitar los permisos heredados.

capabilities.canChangeItemDownloadRestriction

boolean

Solo salida. Indica si el usuario actual puede cambiar las restricciones de descarga del archivo aplicadas por el propietario o el organizador.

hasAugmentedPermissions

boolean

Solo salida. Indica si hay permisos directamente en este archivo. Este campo solo se propaga para los elementos de unidades compartidas.

trashingUser

object (User)

Solo salida. Si el archivo se envió explícitamente a la papelera, el usuario que lo hizo. Solo se completa para los elementos de las unidades compartidas.

thumbnailVersion

string (int64 format)

Solo salida. Es la versión de la miniatura que se usará para invalidar la caché de miniaturas.

trashedTime

string

Solo salida. Fecha y hora en que se envió el elemento a la papelera (fecha y hora según RFC 3339). Solo se completa para los elementos de las unidades compartidas.

modifiedByMe

boolean

Solo salida. Indica si el usuario modificó el archivo.

imageMediaMetadata

object

Solo salida. Son metadatos adicionales sobre el contenido multimedia de la imagen, si están disponibles.

imageMediaMetadata.flashUsed

boolean

Solo salida. Indica si se usó flash para crear la foto.

imageMediaMetadata.meteringMode

string

Solo salida. Es el modo de medición que se usó para crear la foto.

imageMediaMetadata.sensor

string

Solo salida. Es el tipo de sensor que se usó para crear la foto.

imageMediaMetadata.exposureMode

string

Solo salida. Es el modo de exposición que se usó para crear la foto.

imageMediaMetadata.colorSpace

string

Solo salida. Es el espacio de color de la foto.

imageMediaMetadata.whiteBalance

string

Solo salida. Es el modo de balance de blancos que se usó para crear la foto.

imageMediaMetadata.width

integer

Solo salida. El ancho de la imagen en píxeles.

imageMediaMetadata.height

integer

Solo salida. La altura de la imagen en píxeles.

imageMediaMetadata.location

object

Solo salida. Es la información de ubicación geográfica almacenada en la imagen.

imageMediaMetadata.location.latitude

number

Solo salida. Es la latitud almacenada en la imagen.

imageMediaMetadata.location.longitude

number

Solo salida. Es la longitud almacenada en la imagen.

imageMediaMetadata.location.altitude

number

Solo salida. Es la altitud almacenada en la imagen.

imageMediaMetadata.rotation

integer

Solo salida. Es la cantidad de rotaciones de 90 grados en sentido horario que se aplicaron desde la orientación original de la imagen.

imageMediaMetadata.time

string

Solo salida. La fecha y hora en que se tomó la foto (DateTime de EXIF).

imageMediaMetadata.cameraMake

string

Solo salida. Marca de la cámara que se usó para crear la foto.

imageMediaMetadata.cameraModel

string

Solo salida. Es el modelo de la cámara que se usó para crear la foto.

imageMediaMetadata.exposureTime

number

Solo salida. Es la duración de la exposición en segundos.

imageMediaMetadata.aperture

number

Solo salida. Es la apertura que se usó para crear la foto (número f).

imageMediaMetadata.focalLength

number

Solo salida. Es la distancia focal que se usó para crear la foto, en milímetros.

imageMediaMetadata.isoSpeed

integer

Solo salida. Es la velocidad ISO que se usó para crear la foto.

imageMediaMetadata.exposureBias

number

Solo salida. Es la compensación de exposición de la foto (valor APEX).

imageMediaMetadata.maxApertureValue

number

Solo salida. Es el número f más pequeño del lente en la distancia focal que se usó para crear la foto (valor APEX).

imageMediaMetadata.subjectDistance

integer

Solo salida. Es la distancia al sujeto de la foto, en metros.

imageMediaMetadata.lens

string

Solo salida. Es el lente que se usó para crear la foto.

videoMediaMetadata

object

Solo salida. Son metadatos adicionales sobre el contenido multimedia de video. Es posible que no esté disponible de inmediato después de la carga.

videoMediaMetadata.width

integer

Solo salida. Ancho del video en píxeles.

videoMediaMetadata.height

integer

Solo salida. Altura del video en píxeles.

videoMediaMetadata.durationMillis

string (int64 format)

Solo salida. Es la duración del video, expresada en milisegundos.

shortcutDetails

object

Son los detalles del archivo de acceso directo. Solo se completa para los archivos de acceso directo, que tienen el campo mimeType establecido en application/vnd.google-apps.shortcut. Solo se puede configurar en solicitudes files.create.

shortcutDetails.targetId

string

ID del archivo al que apunta este acceso directo. Solo se puede configurar en solicitudes files.create.

shortcutDetails.targetMimeType

string

Solo salida. Tipo de MIME del archivo al que apunta este acceso directo. El valor de este campo es una instantánea del tipo de MIME del destino, que se captura cuando se crea el acceso directo.

shortcutDetails.targetResourceKey

string

Solo salida. Es el ResourceKey del archivo de destino.

resourceKey

string

Solo salida. Es una clave necesaria para acceder al elemento a través de un vínculo compartido.

linkShareMetadata.securityUpdateEligible

boolean

Solo salida. Indica si el archivo es apto para la actualización de seguridad.

linkShareMetadata.securityUpdateEnabled

boolean

Solo salida. Indica si la actualización de seguridad está habilitada para este archivo.

labelInfo

object

Solo salida. Es una descripción general de las etiquetas del archivo.

labelInfo.labels[]

object (Label)

Solo salida. Es el conjunto de etiquetas del archivo, según lo solicitado por los IDs de etiqueta en el parámetro includeLabels. De forma predeterminada, no se devuelven etiquetas.

sha1Checksum

string

Solo salida. Suma de comprobación SHA1 asociada a este archivo, si está disponible. Este campo solo se completa para los archivos con contenido almacenado en Google Drive, no para los archivos de acceso directo ni de los editores de Documentos.

sha256Checksum

string

Solo salida. Suma de verificación SHA256 asociada a este archivo, si está disponible. Este campo solo se completa para los archivos con contenido almacenado en Google Drive, no para los archivos de acceso directo ni de los editores de Documentos.

inheritedPermissionsDisabled

boolean

Indica si este archivo tiene inhabilitados los permisos heredados. Los permisos heredados están habilitados de forma predeterminada.

downloadRestrictions

object (DownloadRestrictionsMetadata)

Se aplicaron restricciones de descarga al archivo.

ContentRestriction

Es una restricción para acceder al contenido del archivo.

Representación JSON
{
  "readOnly": boolean,
  "reason": string,
  "type": string,
  "restrictingUser": {
    object (User)
  },
  "restrictionTime": string,
  "ownerRestricted": boolean,
  "systemRestricted": boolean
}
Campos
readOnly

boolean

Indica si el contenido del archivo es de solo lectura. Si un archivo es de solo lectura, es posible que no se agregue una revisión nueva, que no se agreguen ni modifiquen comentarios, y que no se modifique el título del archivo.

reason

string

Es el motivo por el que se restringe el contenido del archivo. Solo se puede modificar en solicitudes que también establecen readOnly=true.

type

string

Solo salida. Es el tipo de restricción de contenido. Actualmente, el único valor posible es globalContentRestriction.

restrictingUser

object (User)

Solo salida. Es el usuario que estableció la restricción de contenido. Solo se propaga si readOnly es verdadero.

restrictionTime

string

Solo salida. Es la fecha y hora en que se estableció la restricción de contenido (marca de tiempo con formato RFC 3339). Solo se propaga si readOnly es verdadero.

ownerRestricted

boolean

Indica si solo un usuario que es propietario del archivo puede modificar o quitar la restricción de contenido. En el caso de los archivos de unidades compartidas, cualquier usuario con capacidades de organizer puede modificar o quitar esta restricción de contenido.

systemRestricted

boolean

Solo salida. Indica si el sistema aplicó la restricción de contenido, por ejemplo, debido a una firma electrónica. Los usuarios no pueden modificar ni quitar las restricciones de contenido restringido por el sistema.

DownloadRestrictionsMetadata

Se aplicaron restricciones de descarga al archivo.

Representación JSON
{
  "itemDownloadRestriction": {
    object (DownloadRestriction)
  },
  "effectiveDownloadRestrictionWithContext": {
    object (DownloadRestriction)
  }
}
Campos
itemDownloadRestriction

object (DownloadRestriction)

Restricción de descarga del archivo aplicada directamente por el propietario o el organizador Esto no tiene en cuenta la configuración de la unidad compartida ni las reglas de DLP.

effectiveDownloadRestrictionWithContext

object (DownloadRestriction)

Solo salida. Es la restricción de descarga efectiva que se aplica a este archivo. Esto tiene en cuenta todos los parámetros de configuración de restricción y las reglas de DLP.

DownloadRestriction

Es una restricción para copiar y descargar el archivo.

Representación JSON
{
  "restrictedForReaders": boolean,
  "restrictedForWriters": boolean
}
Campos
restrictedForReaders

boolean

Indica si se restringen las opciones de descarga y copia para los lectores.

restrictedForWriters

boolean

Indica si se restringen las opciones de descarga y copia para los escritores. Si es verdadero, la descarga también está restringida para los lectores.

Métodos

copy

Crea una copia de un archivo y aplica las actualizaciones solicitadas con semántica de parche.

create

Crea un archivo nuevo.

delete

Borra de forma permanente un archivo que pertenece al usuario sin moverlo a la papelera.

download

Descarga el contenido de un archivo.

emptyTrash

Borra de forma permanente todos los archivos del usuario que se encuentran en la papelera.

export

Exporta un documento de Google Workspace al tipo de MIME solicitado y devuelve el contenido de bytes exportado.

generateIds

Genera un conjunto de IDs de archivo que se pueden proporcionar en solicitudes de creación o copia.

get

Obtiene el contenido o los metadatos de un archivo por su ID.

list

Enumera los archivos del usuario.

listLabels

Enumera las etiquetas de un archivo.

modifyLabels

Modifica el conjunto de etiquetas aplicadas a un archivo.

update

Actualiza el contenido o los metadatos de un archivo.

watch

Se suscribe a los cambios de un archivo.