Recurso: Archivo
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 |
---|
{ "kind": string, "userPermission": { object ( |
Campos | |
---|---|
kind |
Solo salida. Es el tipo de archivo. Siempre es |
userPermission |
Solo salida. Los permisos para el usuario autenticado en este archivo. |
fileExtension |
Solo salida. Se quitó el componente final de |
md5Checksum |
Solo salida. Una suma de verificación MD5 para el contenido de este archivo. Este campo solo se completa para los archivos con contenido almacenado en Google Drive. No se propaga para los editores de Documentos ni para los archivos de acceso directo. |
selfLink |
Solo salida. Un vínculo a este archivo. |
ownerNames[] |
Solo salida. Son los nombres de los propietarios de este archivo. No se propaga para los elementos de las unidades compartidas. |
lastModifyingUserName |
Solo salida. Es el nombre del último usuario que modificó este archivo. |
editable |
Solo salida. Obsoleto: Usa |
writersCanShare |
Si los escritores pueden compartir el documento con otros usuarios. No se propaga para los elementos de las unidades compartidas. |
downloadUrl |
Solo salida. URL de descarga de corta duración para el archivo. Este campo solo se completa para los archivos con contenido almacenado en Google Drive. No se propaga para los archivos de Documentos de Google o de acceso directo. |
mimeType |
Es el tipo de MIME del archivo. Esto solo es mutable en la actualización cuando se sube contenido nuevo. Este campo puede dejarse en blanco, y el tipo MIME se determinará a partir del tipo de MIME del contenido subido. |
exportLinks |
Solo salida. Vínculos para exportar archivos de los editores de Documentos a formatos específicos. Es un objeto que contiene una lista de pares |
driveId |
Solo salida. ID de la unidad compartida en la que se encuentra el archivo. Solo se propaga para los elementos de las unidades compartidas. |
parents[] |
El ID de la carpeta superior que contiene el archivo. Un archivo solo puede tener una carpeta superior. no se admite la especificación de varios superiores. Si no se especifica como parte de una solicitud de inserción, se coloca el archivo 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 de origen. Las solicitudes files.update deben usar los parámetros |
thumbnailLink |
Solo salida. Es un vínculo de corta duración a la miniatura del archivo, si está disponible. Por lo general, dura unas horas. No está diseñada para uso directo en aplicaciones web debido al uso compartido de recursos entre dominios (CORS), considera usar un servidor proxy. Solo se completa cuando la app solicitante puede acceder al contenido del archivo. Si el archivo no se comparte públicamente, la URL que se muestra en |
appDataContents |
Solo salida. Indica si este archivo se encuentra en la carpeta Datos de aplicaciones. |
webViewLink |
Solo salida. Un vínculo solo está disponible en carpetas públicas para ver sus recursos web estáticos (HTML, CSS, JS, etc.) a través del hosting de sitios web de Google Drive. |
iconLink |
Solo salida. Un vínculo al ícono del archivo. |
shared |
Solo salida. Si el archivo se compartió. No se propaga para los elementos de las unidades compartidas. |
lastModifyingUser |
Solo salida. El último usuario en modificar este archivo. Este campo solo se completa cuando un usuario que accedió a su cuenta realizó la última modificación. |
owners[] |
Solo salida. Es el propietario de este archivo. Solo algunos archivos heredados pueden tener más de un propietario. Este campo no se propagó para los elementos de las unidades compartidas. |
openWithLinks |
Solo salida. Un mapa del ID de cada una de las apps del usuario a un vínculo para abrir este archivo con esa app. Solo se completa cuando se usa el permiso drive.apps.readonly. Es un objeto que contiene una lista de pares |
defaultOpenWithLink |
Solo salida. Es un vínculo para abrir este archivo con la app predeterminada del usuario. Solo se completa cuando se usa el permiso drive.apps.readonly. |
headRevisionId |
Solo salida. El ID de la revisión principal del archivo. Este campo solo se completa para los archivos con contenido almacenado en Google Drive. No se propaga para los editores de Documentos ni para los archivos de acceso directo. |
properties[] |
Es la lista de propiedades. |
copyable |
Solo salida. Obsoleto: Usa |
etag |
Solo salida. La ETag del archivo. |
sharingUser |
Solo salida. Usuario que compartió el elemento con el usuario actual, si está disponible. |
alternateLink |
Solo salida. Un vínculo para abrir el archivo en un editor o visualizador de Google relevante. |
embedLink |
Solo salida. Un vínculo para incorporar el archivo |
webContentLink |
Solo salida. Un vínculo para descargar el contenido del archivo en un navegador mediante la autenticación basada en cookies. En los casos en que el contenido se comparte públicamente, el contenido se puede descargar sin ninguna credencial. |
fileSize |
Solo salida. Es el tamaño en bytes de los BLOB y archivos de editores propios. No se propagarán para los archivos que no tengan tamaño, como los accesos directos y las carpetas. |
copyRequiresWriterPermission |
Si las opciones de copiar, imprimir o descargar este archivo deben estar inhabilitadas para los lectores y los comentaristas. |
permissions[] |
Solo salida. Es la lista de permisos para los usuarios que tienen acceso a este archivo. No se propaga para los elementos de las unidades compartidas. |
hasThumbnail |
Solo salida. Si este archivo tiene una miniatura. Esto no indica si la app solicitante tiene acceso a la miniatura. Para comprobar el acceso, busca el campo minliaLink. |
spaces[] |
Solo salida. La lista de espacios que contienen el archivo. Los valores admitidos son |
folderColorRgb |
Color de la carpeta como una cadena hexadecimal RGB si el archivo es una carpeta o un acceso directo a una carpeta La lista de colores compatibles está disponible en el campo folderColorPalette del recurso Acerca de. Si se especifica un color no admitido, se cambiará al color más cercano de la paleta. |
id |
Es el ID del archivo. |
title |
Es el título de este archivo. 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 título es constante. |
description |
Es una descripción breve del archivo. |
labels |
Un grupo de etiquetas para el archivo. |
labels.viewed |
Si este usuario vio este archivo. |
labels.restricted |
Solo salida. Obsoleto: Usa |
labels.starred |
Si el usuario destacó este archivo. |
labels.hidden |
Solo salida. Obsoleta. |
labels.trashed |
Si este archivo se envió a la papelera Esta etiqueta se aplica a todos los usuarios que acceden al archivo. Sin embargo, solo los propietarios tienen permitido ver y recuperar los archivos de la papelera. |
labels.modified |
Solo salida. Si este usuario modificó el archivo. |
explicitlyTrashed |
Solo salida. Si este archivo se envió explícitamente a la papelera o no de forma recurrente. |
createdDate |
Solo salida. Hora de creación de este archivo (marca de tiempo con formato RFC 3339). |
modifiedDate |
La última vez que alguien modificó este archivo (marca de tiempo con formato RFC 3339). Esto solo es mutable en la actualización cuando se establece el parámetro setModifiedDate. |
modifiedByMeDate |
Solo salida. Última vez que el usuario modificó este archivo (marca de tiempo con formato RFC 3339). Ten en cuenta que, si estableces la fecha modificada, también actualizará la fecha en la que se puede modificar el usuario que estableció la fecha. |
lastViewedByMeDate |
Última vez que el usuario vio este archivo (marca de tiempo con formato RFC 3339). |
markedViewedByMeDate |
Solo salida. Obsoleta. |
sharedWithMeDate |
Solo salida. Hora en la que se compartió este archivo con el usuario (marca de tiempo con formato RFC 3339). |
quotaBytesUsed |
Solo salida. La cantidad de bytes de la cuota que usa este archivo. |
version |
Solo salida. Es un número de versión que aumenta de forma monótona para el archivo. Esto refleja todos los cambios realizados en el archivo en el servidor, incluso aquellos que no son visibles para el usuario solicitante. |
indexableText |
Atributos de texto indexables del archivo (solo se pueden escribir) |
indexableText.text |
El texto que se indexará para este archivo. |
originalFilename |
Es el nombre de archivo original del contenido subido (si está disponible) o el valor original del campo |
ownedByMe |
Solo salida. Si el archivo es propiedad del usuario actual No se propaga para los elementos de las unidades compartidas. |
canComment |
Solo salida. Obsoleto: Usa |
shareable |
Solo salida. Obsoleto: Usa |
fullFileExtension |
Solo salida. la extensión de archivo completa; extraída del título. Puede contener varias extensiones concatenadas, como "tar.gz". Quitar una extensión del título no borra este campo. Sin embargo, al cambiar la extensión del título, este campo se actualiza. Este campo solo se completa para los archivos con contenido almacenado en Google Drive. No se propaga para los editores de Documentos ni para los archivos de acceso directo. |
isAppAuthorized |
Solo salida. Si la app solicitante creó o abrió el archivo. |
teamDriveId |
Solo salida. Obsoleto: Usa |
capabilities |
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. |
capabilities.canChangeRestrictedDownload |
Solo salida. Obsoleta. |
capabilities.canMoveChildrenOutOfDrive |
Solo salida. Indica si el usuario actual puede mover los 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. |
capabilities.canReadDrive |
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. |
capabilities.canEdit |
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 |
capabilities.canCopy |
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 elementos subordinados que no sean de carpeta o este mismo elemento si no es una carpeta. |
capabilities.canComment |
Solo salida. Indica si el usuario actual puede comentar este archivo. |
capabilities.canAddChildren |
Solo salida. Indica si el usuario actual puede agregar elementos secundarios a esta carpeta. Esto siempre es falso cuando el elemento no es una carpeta. |
capabilities.canDelete |
Solo salida. Indica si el usuario actual puede borrar este archivo. |
capabilities.canDownload |
Solo salida. Indica si el usuario actual puede descargar este archivo. |
capabilities.canListChildren |
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. |
capabilities.canRemoveChildren |
Solo salida. Indica si el usuario actual puede quitar elementos secundarios de esta carpeta. Esto siempre es falso cuando el elemento no es una carpeta. Para una carpeta en una unidad compartida, usa |
capabilities.canRename |
Solo salida. Indica si el usuario actual puede cambiar el nombre de este archivo. |
capabilities.canTrash |
Solo salida. Indica si el usuario actual puede mover este archivo a la papelera. |
capabilities.canReadRevisions |
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 tanto las revisiones de elementos subordinados de este elemento que no son de carpeta, o bien este mismo elemento si no es una carpeta. |
capabilities.canReadTeamDrive |
Solo salida. Obsoleto: Usa |
capabilities.canMoveTeamDriveItem |
Solo salida. Obsoleto: usa |
capabilities.canChangeCopyRequiresWriterPermission |
Solo salida. Indica si el usuario actual puede cambiar la restricción |
capabilities.canMoveItemIntoTeamDrive |
Solo salida. Obsoleto: Usa |
capabilities.canUntrash |
Solo salida. Indica si el usuario actual puede restablecer el archivo desde la papelera. |
capabilities.canModifyContent |
Solo salida. Indica si el usuario actual puede modificar el contenido de este archivo. |
capabilities.canMoveItemWithinTeamDrive |
Solo salida. Obsoleto: Usa |
capabilities.canMoveItemOutOfTeamDrive |
Solo salida. Obsoleto: Usa |
capabilities.canDeleteChildren |
Solo salida. Indica si el usuario actual puede borrar 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. |
capabilities.canMoveChildrenOutOfTeamDrive |
Solo salida. Obsoleto: Usa |
capabilities.canMoveChildrenWithinTeamDrive |
Solo salida. Obsoleto: Usa |
capabilities.canTrashChildren |
Solo salida. Indica si el usuario actual puede enviar a la papelera 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. |
capabilities.canMoveItemOutOfDrive |
Solo salida. Indica si el usuario actual puede mover este elemento fuera de esta unidad cambiando su elemento superior. Ten en cuenta que una solicitud para cambiar el elemento superior puede fallar de todas formas según el nuevo elemento superior que se agregue. |
capabilities.canAddMyDriveParent |
Solo salida. Indica si el usuario actual puede agregar un elemento superior para el elemento sin quitar uno existente en la misma solicitud. No se propaga para los archivos de unidades compartidas. |
capabilities.canRemoveMyDriveParent |
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 unidades compartidas. |
capabilities.canMoveItemWithinDrive |
Solo salida. Indica si el usuario actual puede mover este elemento dentro de esta unidad. Ten en cuenta que una solicitud para cambiar el elemento superior puede fallar de todas formas según el elemento superior nuevo que se agregue y el elemento superior que se quitará. |
capabilities.canShare |
Solo salida. Indica si el usuario actual puede modificar la configuración de uso compartido de este archivo. |
capabilities.canMoveChildrenWithinDrive |
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 una solicitud para mover al elemento secundario puede fallar según el acceso del usuario actual al elemento secundario y a la carpeta de destino. |
capabilities.canModifyContentRestriction |
Obsoleto: solo salida. Usa una de las siguientes opciones: |
capabilities.canAddFolderFromAnotherDrive |
Solo salida. Si el usuario actual puede agregar una carpeta de otra unidad (una unidad compartida diferente 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. |
capabilities.canChangeSecurityUpdateEnabled |
Solo salida. Indica si el usuario actual puede cambiar el campo securityUpdateEnabled en los metadatos de uso compartido de vínculos. |
capabilities.canAcceptOwnership |
Solo salida. Si el usuario actual es el propietario pendiente del archivo No se propaga para los archivos de unidades compartidas. |
capabilities.canReadLabels |
Solo salida. Si el usuario actual puede leer las etiquetas del archivo. |
capabilities.canModifyLabels |
Solo salida. Indica si el usuario actual puede modificar las etiquetas del archivo. |
capabilities.canModifyEditorContentRestriction |
Solo salida. Si el usuario actual puede agregar o modificar restricciones de contenido del archivo que están restringidas por el editor. |
capabilities.canModifyOwnerContentRestriction |
Solo salida. Indica si el usuario actual puede agregar o modificar restricciones de contenido que están restringidas por el propietario. |
capabilities.canRemoveContentRestriction |
Solo salida. Si hay una restricción de contenido en el archivo que el usuario actual puede quitar |
hasAugmentedPermissions |
Solo salida. Si este archivo tiene permisos directamente. Este campo solo se propaga para los elementos de las unidades compartidas. |
trashingUser |
Solo salida. Si el archivo se envió explícitamente a la papelera, quiere decir el usuario que lo envió. Solo se propaga para los elementos de las unidades compartidas. |
canReadRevisions |
Solo salida. Obsoleto: Usa |
thumbnailVersion |
Solo salida. Es la versión de la miniatura que se usará en la invalidación de la caché de miniaturas. |
trashedDate |
Solo salida. La hora en que el elemento se envió a la papelera (marca de tiempo con formato RFC 3339). Solo se propaga para los elementos de las unidades compartidas. |
permissionIds[] |
Solo salida. files.list de IDs de permisos de los usuarios que tienen acceso a este archivo. |
thumbnail |
Una miniatura del archivo. Solo se usará si no se puede generar una miniatura estándar. |
thumbnail.image |
Los bytes codificados en Base64 seguros para URL de la imagen en miniatura. Debe cumplir con el artículo 5 de RFC 4648. String codificada en base64. |
thumbnail.mimeType |
Es el tipo de MIME de la miniatura. |
imageMediaMetadata |
Solo salida. Metadatos sobre contenido multimedia de imágenes Solo estará presente para los tipos de imágenes y su contenido dependerá de lo que se pueda analizar a partir del contenido de la imagen. |
imageMediaMetadata.flashUsed |
Solo salida. Si se usó flash para crear la foto |
imageMediaMetadata.meteringMode |
Solo salida. El modo de medición que se usó para crear la foto. |
imageMediaMetadata.sensor |
Solo salida. El tipo de sensor que se usa para crear la foto. |
imageMediaMetadata.exposureMode |
Solo salida. El modo de exposición que se usó para crear la foto |
imageMediaMetadata.colorSpace |
Solo salida. El espacio de color de la foto. |
imageMediaMetadata.whiteBalance |
Solo salida. El modo de balance de blancos que se usó para crear la foto. |
imageMediaMetadata.width |
Solo salida. El ancho de la imagen en píxeles. |
imageMediaMetadata.height |
Solo salida. La altura de la imagen en píxeles. |
imageMediaMetadata.location |
Solo salida. La información de la ubicación geográfica almacenada en la imagen. |
imageMediaMetadata.location.latitude |
Solo salida. La latitud almacenada en la imagen. |
imageMediaMetadata.location.longitude |
Solo salida. La longitud almacenada en la imagen. |
imageMediaMetadata.location.altitude |
Solo salida. La altitud que se almacena en la imagen. |
imageMediaMetadata.rotation |
Solo salida. Cantidad de rotaciones de 90 grados en el sentido de las manecillas del reloj desde la orientación original de la imagen. |
imageMediaMetadata.date |
Solo salida. Es la fecha y la hora en que se tomó la foto (marca de tiempo en formato EXIF). |
imageMediaMetadata.cameraMake |
Solo salida. Indica la marca de la cámara que se usó para tomar la foto. |
imageMediaMetadata.cameraModel |
Solo salida. El modelo de la cámara que se usó para crear la foto. |
imageMediaMetadata.exposureTime |
Solo salida. Es la duración de la exposición en segundos. |
imageMediaMetadata.aperture |
Solo salida. Apertura utilizada para tomar la foto (número f). |
imageMediaMetadata.focalLength |
Solo salida. Es la longitud focal utilizada para crear la foto, en milímetros. |
imageMediaMetadata.isoSpeed |
Solo salida. La velocidad ISO que se usa para crear la foto. |
imageMediaMetadata.exposureBias |
Solo salida. El sesgo de exposición de la foto (valor de APEX). |
imageMediaMetadata.maxApertureValue |
Solo salida. Es el número f más pequeño del lente en la longitud focal utilizada para crear la foto (valor APEX). |
imageMediaMetadata.subjectDistance |
Solo salida. La distancia al objeto de la foto, en metros. |
imageMediaMetadata.lens |
Solo salida. El lente que se usó para crear la foto |
videoMediaMetadata |
Solo salida. Metadatos sobre contenido multimedia de video Solo estará presente para los tipos de video. |
videoMediaMetadata.width |
Solo salida. Es el ancho del video en píxeles. |
videoMediaMetadata.height |
Solo salida. Es la altura del video en píxeles. |
videoMediaMetadata.durationMillis |
Solo salida. Es la duración del video, expresada en milisegundos. |
shortcutDetails |
Detalles del archivo de atajos. Solo se propaga para los archivos de accesos directos, que tienen el campo mimeType establecido en |
shortcutDetails.targetId |
El ID del archivo al que apunta este acceso directo. Solo se puede configurar en solicitudes |
shortcutDetails.targetMimeType |
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. |
shortcutDetails.targetResourceKey |
Solo salida. La ResourceKey para el archivo de destino. |
contentRestrictions[] |
Restricciones para el acceso al contenido del archivo. Solo se completa si existe tal restricción. |
resourceKey |
Solo salida. Se necesita una clave para acceder al elemento a través de un vínculo compartido. |
linkShareMetadata |
Solo salida. VínculoCompartir detalles relacionados. Contiene detalles acerca de las URL del vínculo que los clientes utilizan para referirse a este elemento. |
linkShareMetadata.securityUpdateEligible |
Solo salida. Si el archivo es apto para la actualización de seguridad |
linkShareMetadata.securityUpdateEnabled |
Solo salida. Indica si la actualización de seguridad está habilitada para este archivo. |
labelInfo |
Solo salida. Una descripción general de las etiquetas del archivo. |
labelInfo.labels[] |
Solo salida. El conjunto de etiquetas en el archivo según lo solicitan los IDs de etiqueta en el parámetro |
sha1Checksum |
Solo salida. La suma de comprobación SHA1 asociada con este archivo, si está disponible. Este campo solo se completa para los archivos con contenido almacenado en Google Drive. No se propaga para los editores de Documentos ni para los archivos de acceso directo. |
sha256Checksum |
Solo salida. La suma de verificación SHA256 asociada con este archivo, si está disponible. Este campo solo se completa para los archivos con contenido almacenado en Google Drive. No se propaga para los editores de Documentos ni para los archivos de acceso directo. |
ContentRestriction
Es una restricción para acceder al contenido del archivo.
Representación JSON |
---|
{
"readOnly": boolean,
"reason": string,
"type": string,
"restrictingUser": {
object ( |
Campos | |
---|---|
readOnly |
Si el contenido del archivo es de solo lectura. Si un archivo es de solo lectura, no se podrá agregar una nueva revisión del archivo, no se podrán agregar ni modificar comentarios ni modificar el título del archivo. |
reason |
Motivo por el que se restringió el contenido del archivo. Esto solo es mutable en las solicitudes que también configuran |
type |
Solo salida. Es el tipo de restricción de contenido. Actualmente, el único valor posible es |
restrictingUser |
Solo salida. El usuario que estableció la restricción de contenido. Solo se completa si |
restrictionDate |
Solo salida. La hora en la que se estableció la restricción de contenido (marca de tiempo con formato RFC 3339). Solo se completa si |
ownerRestricted |
Si solo el usuario propietario del archivo puede modificar o quitar la restricción de contenido. Cualquier usuario con las capacidades de |
systemRestricted |
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 del sistema. |
Métodos |
|
---|---|
|
Crea una copia del archivo especificado. |
|
Borra de manera definitiva un archivo que es propiedad del usuario sin moverlo a la papelera. |
|
Borra de manera permanente todos los archivos enviados a la papelera del usuario. |
|
Exporta un documento de Google Workspace al tipo de MIME solicitado y muestra el contenido de bytes exportado. |
|
Genera un conjunto de IDs de archivo que se pueden proporcionar en las solicitudes de inserción o de copia. |
|
Obtiene los metadatos o el contenido de un archivo por ID. |
|
Inserta un archivo nuevo. |
|
Muestra una lista de los archivos del usuario. |
|
Muestra una lista de las etiquetas de un archivo. |
|
Modifica el conjunto de etiquetas aplicadas a un archivo. |
|
Actualiza el contenido o los metadatos de un archivo. |
|
Establece la hora actualizada del archivo en la hora actual del servidor. |
|
Mueve un archivo a la papelera. |
|
Restablece un archivo de la papelera. |
|
Actualiza el contenido o los metadatos de un archivo. |
|
Se suscribe a los cambios de un archivo. |