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 salida. Identifica qué tipo de recurso es este. Valor: la cadena fija "drive#file".

string

Solo salida. ID de la unidad compartida en la que se encuentra el archivo. Solo se propaga para los elementos de las unidades compartidas.

string

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

boolean

Si las opciones de copiar, imprimir o descargar este archivo deben estar inhabilitadas para los lectores y comentaristas

string

Solo salida. La suma de verificación MD5 para el contenido del archivo. Esto solo se aplica a archivos con contenido binario en Google Drive.

object

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

string

Texto que se indexará para el archivo a fin de mejorar las consultas fullText. Tiene un límite de 128 KB de longitud y puede contener elementos HTML.

object

Una miniatura para el archivo. Solo se usará si Google Drive no puede generar una miniatura estándar.

string (bytes format)

Los datos de la miniatura codificados con Base64 seguro para URL (RFC 4648, sección 5).

String codificada en base64.

string

El tipo de MIME de la miniatura.

boolean

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

boolean

Solo salida. Indica si el usuario vio el archivo.

string

Es el tipo de MIME del archivo.

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

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

map (key: string, value: string)

Solo salida. Vínculos para exportar archivos de Editores de Documentos a formatos específicos.

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

string

Los ID de las carpetas superiores que contienen el archivo.

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 los elementos superiores detectables del archivo de origen. Las solicitudes files.update deben usar los parámetros addParents y removeParents para modificar la lista de elementos superiores.

string

Solo salida. Es un vínculo de corta duración a la miniatura del archivo, si está disponible. Suele durar alrededor de horas. Solo se propaga cuando la app que realiza la solicitud puede acceder al contenido del archivo. Si el archivo no se comparte públicamente, la URL que se muestra en Files.thumbnailLink se debe recuperar mediante una solicitud con credenciales.

string

Solo salida. Un vínculo estático y no autenticado al ícono del archivo.

boolean

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

object (User)

Solo salida. El último usuario que modificó el archivo.

object (User)

Solo salida. El propietario de este archivo. Solo ciertos archivos heredados pueden tener más de un propietario. Este campo no se propaga para los elementos de las unidades compartidas.

string

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

object (User)

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

string

Solo salida. Un vínculo para abrir el archivo en un editor o visualizador de Google relevante en un navegador.

string

Solo salida. Es un vínculo para descargar el contenido del archivo en un navegador. Esta opción solo está disponible para archivos con contenido binario en Google Drive.

string (int64 format)

Solo salida. Tamaño en bytes de BLOB y archivos de editor propios. No se propagarán para los archivos que no tienen tamaño, como accesos directos y carpetas.

boolean

Obsoleto: usa copyRequiresWriterPermission en su lugar.

object (Permission)

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

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

string

Solo salida. Es la lista de espacios que contienen el archivo. Los valores admitidos actualmente son "drive", "appDataFolder" y "photos".

string

El color de una carpeta o un acceso directo a una carpeta, como una cadena hexadecimal RGB. Los colores compatibles se publican en el campo folderColorPalette del recurso Acerca de.

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

string

El ID del archivo.

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 de datos de la aplicación, el nombre es el mismo.

string

Es una descripción breve del archivo.

boolean

Si el usuario destacó el archivo.

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 podrán verlo.

boolean

Solo salida. Indica si el archivo se envió a la papelera de manera explícita, en lugar de a la papelera de manera recurrente desde una carpeta superior.

string

La hora en la que se creó el archivo (fecha y hora RFC 3339).

string

Corresponde a la última vez que alguien modificó el archivo (fecha y hora RFC 3339).

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

string

Solo salida. La última vez que el usuario modificó el archivo (fecha y hora RFC 3339).

string

Corresponde a la última vez que el usuario vio el archivo (fecha y hora RFC 3339).

string

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

string (int64 format)

Solo salida. La cantidad de bytes de la cuota de almacenamiento que usa el archivo. Esto incluye la revisión principal, así como las revisiones anteriores con keepForever habilitado.

string (int64 format)

Solo salida. Es un número de versión que aumenta monótonamente para el archivo. Esto refleja todos los cambios realizados en el archivo en el servidor, incluso aquellos que el usuario no puede ver.

string

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

boolean

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

string

Solo salida. 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 archivos con contenido binario en Google Drive.

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

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

Una colección de pares clave-valor arbitrarios que pueden ver 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" }.

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

Una colección de pares clave-valor arbitrarios que son privados para la app solicitante.

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

Estas propiedades solo se pueden recuperar mediante una solicitud autenticada. Una solicitud autenticada usa un token de acceso obtenido 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" }.

boolean

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

string

Obsoleto: solo salida. Usa driveId en su lugar.

object

Solo salida. Funciones que tiene el usuario actual en este archivo Cada función corresponde a una acción detallada que un usuario puede realizar.

boolean

Obsoleto: solo salida.

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

Solo salida. Indica si el usuario actual puede agregar niños a esta carpeta. Esto siempre es falso cuando el elemento no es una carpeta.

boolean

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

boolean

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

boolean

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

boolean

Solo salida. Indica si el usuario actual puede quitar niños de esta carpeta. Esto siempre es falso cuando el elemento no es una carpeta. Para una carpeta de una unidad compartida, usa canDeleteChildren o canTrashChildren en su lugar.

boolean

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

boolean

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

boolean

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

boolean

Obsoleto: solo salida. Usa canReadDrive en su lugar.

boolean

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

boolean

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

boolean

Obsoleto: solo salida. Usa canMoveItemOutOfDrive en su lugar.

boolean

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

boolean

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

boolean

Obsoleto: solo salida. Usa canMoveItemWithinDrive en su lugar.

boolean

Obsoleto: solo salida. Usa canMoveItemOutOfDrive en su lugar.

boolean

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

boolean

Obsoleto: solo salida. Usa canMoveChildrenOutOfDrive en su lugar.

boolean

Obsoleto: solo salida. Usa canMoveChildrenWithinDrive en su lugar.

boolean

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

boolean

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

boolean

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

boolean

Solo salida. Indica si el usuario actual puede quitar un elemento superior del elemento sin agregar otro superior en la misma solicitud. No se propaga para los archivos de la unidad compartida.

boolean

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

boolean

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

boolean

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

boolean

Obsoleto: solo salida. Usa canModifyEditorContentRestriction, canModifyOwnerContentRestriction o canRemoveContentRestriction.

boolean

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

boolean

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

boolean

Solo salida. Si el usuario actual es el propietario pendiente del archivo No se propaga para los archivos de la unidad compartida.

boolean

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

boolean

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

boolean

Solo salida. Indica si el usuario actual puede agregar o modificar restricciones de contenido en el archivo, las cuales están restringidas por el editor.

boolean

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

boolean

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

boolean

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

object (User)

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

string (int64 format)

Solo salida. La versión de miniatura para usar en la invalidación de caché de miniaturas.

string

Solo salida. La hora en la que se envió el elemento a la papelera (fecha y hora de RFC 3339). Solo se propaga para los elementos de las unidades compartidas.

boolean

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

string

Solo salida. files.list de los IDs de permiso para usuarios con acceso a este archivo.

object

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

boolean

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

string

Solo salida. Es el modo de medición utilizado para crear la foto.

string

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

string

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

string

Solo salida. El espacio de color de la foto

string

Solo salida. Modo de balance de blancos que se usa para crear la foto.

integer

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

integer

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

object

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

number

Solo salida. La latitud almacenada en la imagen.

number

Solo salida. La longitud almacenada en la imagen.

number

Solo salida. La altitud almacenada en la imagen.

integer

Solo salida. La cantidad de rotaciones de 90 grados en el sentido de las manecillas del reloj aplicadas desde la orientación original de la imagen.

string

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

string

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

string

Solo salida. El modelo de la cámara que se utilizó para crear la foto.

number

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

number

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

number

Solo salida. Es la longitud focal utilizada para crear la foto, en milímetros.

integer

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

number

Solo salida. El sesgo de exposición de la foto (valor APEX).

number

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

integer

Solo salida. La distancia en metros al objeto de la foto.

string

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

object

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

integer

Solo salida. Es el ancho del video en píxeles.

integer

Solo salida. Es la altura del video en píxeles.

string (int64 format)

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

object

Detalles del archivo de acceso directo. Solo se propaga para los archivos de acceso directo, que tienen el campo mimeType establecido en application/vnd.google-apps.shortcut.

string

El ID del archivo al que apunta este acceso directo.

string

Solo salida. El 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.

string

Solo salida. La ResourceKey para el archivo de destino.

object (ContentRestriction)

Restricciones para acceder al contenido del archivo. Solo se completa si existe esa restricción.

string

Solo salida. Una clave necesaria para acceder al elemento mediante un vínculo compartido.

object

Solo salida. Detalles relacionados de LinkShare. Contiene detalles sobre las URLs de vínculo que utilizan los clientes para hacer referencia a este elemento.

boolean

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

boolean

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

object

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

object (Label)

Solo salida. El conjunto de etiquetas en el archivo según lo solicitan los IDs de etiqueta en el parámetro includeLabels. De forma predeterminada, no se muestran etiquetas.

string

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

string

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