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 del usuario autenticado en este archivo. |
fileExtension |
Solo salida. El componente final de |
md5Checksum |
Solo salida. Una suma de verificación MD5 para el contenido de este archivo. 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. |
selfLink |
Solo salida. Un vínculo a este archivo. |
ownerNames[] |
Solo salida. Nombre(s) del(los) propietario(s) de este archivo. No se propaga para los elementos de las unidades compartidas. |
lastModifyingUserName |
Solo salida. 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 archivos con contenido almacenado en Google Drive; no se completa para Documentos de Google ni archivos de acceso directo. |
mimeType |
Es el tipo de MIME del archivo. Solo es mutable en la actualización cuando se sube contenido nuevo. Este campo puede quedar 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 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[] |
Es un grupo de carpetas superiores que contienen este archivo. Si no se especifica como parte de una solicitud de inserción, el archivo se colocará directamente en la carpeta Mi unidad del usuario. Si no se especifica como parte de una solicitud de copia, el archivo heredará cualquier elemento superior detectable del archivo fuente. Las solicitudes files.update también pueden usar los parámetros |
thumbnailLink |
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 |
appDataContents |
Solo salida. Si este archivo está en la carpeta de datos de la aplicación. |
webViewLink |
Solo salida. Es un vínculo que solo está disponible en carpetas públicas para ver sus recursos web estáticos (HTML, CSS, JS, etc.) mediante el hosting de sitios web de Google Drive. |
iconLink |
Solo salida. Es un vínculo al ícono del archivo. |
shared |
Solo salida. Indica si el archivo se compartió. No se propaga para los elementos de las unidades compartidas. |
lastModifyingUser |
Solo salida. El último usuario que modificó este archivo. |
owners[] |
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. |
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 propaga cuando se usa el alcance drive.apps.readonly. Es un objeto que contiene una lista de pares |
defaultOpenWithLink |
Solo salida. Un vínculo para abrir este archivo con la aplicación predeterminada del usuario para este archivo. Solo se propaga cuando se usa el permiso drive.apps.readonly. |
headRevisionId |
Solo salida. Es el ID de la revisión principal del archivo. 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. |
properties[] |
Es la lista de propiedades. |
copyable |
Solo salida. Obsoleto: usa |
etag |
Solo salida. 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. Es 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. 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. |
copyRequiresWriterPermission |
Si las opciones de copiar, imprimir o descargar este archivo deben estar inhabilitadas para los lectores y comentaristas |
permissions[] |
Solo salida. Es la lista de permisos de los usuarios con acceso a este archivo. No se propaga para los elementos de las unidades compartidas. |
hasThumbnail |
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. |
spaces[] |
Solo salida. Es la lista de espacios que contienen el archivo. Los valores admitidos son |
folderColorRgb |
El 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 admitidos está disponible en el campo folderColorPalette del recurso About. Si se especifica un color no compatible, se cambiará al color más cercano de la paleta. |
id |
El ID del archivo. |
title |
Es el título de este archivo. Ten en cuenta que en 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 |
Indica si el usuario vio este archivo. |
labels.restricted |
Solo salida. Obsoleto: usa |
labels.starred |
Indica si el usuario destacó este archivo. |
labels.hidden |
Solo salida. Ya no está disponible. |
labels.trashed |
Indica si el archivo se envió a la papelera. Esta etiqueta se aplica a todos los usuarios que acceden al archivo. Sin embargo, solo los propietarios pueden ver y recuperar los archivos de la papelera. |
labels.modified |
Solo salida. Indica si el usuario modificó el archivo. |
explicitlyTrashed |
Solo salida. Indica si el archivo se envió a la papelera de manera explícita, en lugar de a la papelera de manera recursiva. |
createdDate |
Solo salida. Hora de creación de este archivo (marca de tiempo RFC 3339 con formato). |
modifiedDate |
La última vez que alguien modificó este archivo (con formato de marca de tiempo RFC 3339). Solo es mutable en la actualización cuando se establece el parámetro setModifiedDate. |
modifiedByMeDate |
Solo salida. La última vez que el usuario modificó este archivo (con formato de marca de tiempo RFC 3339). Ten en cuenta que la configuración de modifiedDate también actualizará la fecha de modifiedByMe del usuario que estableció la fecha. |
lastViewedByMeDate |
La última vez que el usuario vio este archivo (con formato de marca de tiempo RFC 3339). |
markedViewedByMeDate |
Solo salida. Ya no está disponible. |
sharedWithMeDate |
Solo salida. Hora a la que se compartió este archivo con el usuario (marca de tiempo RFC 3339 con formato). |
quotaBytesUsed |
Solo salida. La cantidad de bytes de cuota que usa este archivo. |
version |
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 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 |
Indica el nombre del archivo original del contenido subido, si está disponible, o bien 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, si cambias la extensión del título, este campo se actualizará. 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. |
isAppAuthorized |
Solo salida. Indica 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. Ya no está disponible. |
capabilities.canMoveChildrenOutOfDrive |
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. |
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 el archivo. Otros factores pueden limitar los tipos 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 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. |
capabilities.canComment |
Solo salida. Indica si el usuario actual puede comentar el archivo. |
capabilities.canAddChildren |
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. |
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 niños de esta carpeta. Esto siempre es falso cuando el elemento no es una carpeta. Para una carpeta de 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 las revisiones de los elementos subordinados que no son carpetas de ese elemento o este elemento en sí 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 este 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 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 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. |
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 la solicitud para cambiar el elemento superior del elemento puede seguir fallando según el nuevo elemento superior que se agregue. |
capabilities.canAddMyDriveParent |
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. |
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 la unidad compartida. |
capabilities.canMoveItemWithinDrive |
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. |
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 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. |
capabilities.canModifyContentRestriction |
Obsoleto: solo salida. Usa |
capabilities.canAddFolderFromAnotherDrive |
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. |
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 la unidad compartida. |
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. Indica si el usuario actual puede agregar o modificar restricciones de contenido en el archivo, las cuales 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. Indica si hay alguna restricción de contenido en el archivo que el usuario actual pueda quitar. |
hasAugmentedPermissions |
Solo salida. Indica si hay permisos directamente en este archivo. 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, indica el usuario que lo envió. Solo se propaga para los elementos de las unidades compartidas. |
canReadRevisions |
Solo salida. Obsoleto: usa |
thumbnailVersion |
Solo salida. La versión de miniatura para usar en la invalidación de caché de miniaturas. |
trashedDate |
Solo salida. La hora en la que se envió el elemento a la papelera (con formato de marca de tiempo RFC 3339). Solo se propaga para los elementos de las unidades compartidas. |
permissionIds[] |
Solo salida. files.list de los IDs de permiso para usuarios con acceso a este archivo. |
thumbnail |
Una miniatura para el 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 la sección 5 de RFC 4648. String codificada en base64. |
thumbnail.mimeType |
El tipo de MIME de la miniatura. |
imageMediaMetadata |
Solo salida. Metadatos sobre el contenido multimedia de la imagen Esto solo estará presente para los tipos de imagen, y su contenido dependerá de lo que se pueda analizar a partir del contenido de la imagen. |
imageMediaMetadata.flashUsed |
Solo salida. Indica si se usó un flash para crear la foto. |
imageMediaMetadata.meteringMode |
Solo salida. Es el modo de medición utilizado para crear la foto. |
imageMediaMetadata.sensor |
Solo salida. Es 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. Modo de balance de blancos que se usa 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 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 almacenada en la imagen. |
imageMediaMetadata.rotation |
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. |
imageMediaMetadata.date |
Solo salida. La fecha y hora en que se tomó la foto (marca de tiempo en formato EXIF). |
imageMediaMetadata.cameraMake |
Solo salida. La marca de la cámara que se usó para crear la foto. |
imageMediaMetadata.cameraModel |
Solo salida. El modelo de la cámara que se utilizó para crear la foto. |
imageMediaMetadata.exposureTime |
Solo salida. Es la duración de la exposición en segundos. |
imageMediaMetadata.aperture |
Solo salida. La apertura que se usó para crear 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 usó para crear la foto. |
imageMediaMetadata.exposureBias |
Solo salida. El sesgo de exposición de la foto (valor APEX). |
imageMediaMetadata.maxApertureValue |
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). |
imageMediaMetadata.subjectDistance |
Solo salida. La distancia en metros al objeto de la foto. |
imageMediaMetadata.lens |
Solo salida. La lente que se usó para crear la foto. |
videoMediaMetadata |
Solo salida. Metadatos sobre el contenido multimedia de video Esta opción solo aparecerá 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 acceso directo. Solo se propaga para los archivos de acceso directo, que tienen el campo mimeType establecido en |
shortcutDetails.targetId |
El ID del archivo al que apunta este acceso directo. |
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 acceder al contenido del archivo. Solo se completa si existe esa restricción. |
resourceKey |
Solo salida. Una clave necesaria para acceder al elemento mediante un vínculo compartido. |
linkShareMetadata |
Solo salida. Detalles relacionados de LinkShare. Contiene detalles sobre las URLs de vínculo que utilizan los clientes para hacer referencia 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 propaga para los archivos con contenido almacenado en Google Drive. No se propaga para los editores de Documentos ni 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 propaga para los archivos con contenido almacenado en Google Drive. No se propaga para los editores de Documentos ni los archivos de acceso directo. |
ContentRestriction
Una restricción para acceder al contenido del archivo.
Representación JSON |
---|
{
"readOnly": boolean,
"reason": string,
"type": string,
"restrictingUser": {
object ( |
Campos | |
---|---|
readOnly |
Indica si el contenido del archivo es de solo lectura. Si un archivo es de solo lectura, es posible que no se agregue una nueva revisión del archivo, que no se agreguen ni modifiquen comentarios ni que se modifique el título del archivo. |
reason |
El motivo por el que se restringió el contenido del archivo. Esto solo es mutable en solicitudes que también configuran |
type |
Solo salida. Es el tipo de restricción de contenido. Por el momento, el único valor posible es |
restrictingUser |
Solo salida. Indica el usuario que estableció la restricción de contenido. Solo se completa si |
restrictionDate |
Solo salida. Es la hora a la que se estableció la restricción de contenido (marca de tiempo RFC 3339 con formato). Solo se completa si |
ownerRestricted |
Si solo el 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 |
Métodos |
|
---|---|
|
Crea una copia del archivo especificado. |
|
Borra permanentemente un archivo que es propiedad del usuario sin moverlo a la papelera. |
|
Borra de forma permanente todos los archivos del usuario que se enviaron a la papelera. |
|
Exporta un documento de Google Workspace al tipo de MIME solicitado y muestra el contenido de bytes exportado. |
|
Genera un conjunto de ID de archivos que se pueden proporcionar en las solicitudes de inserción o copia. |
|
Obtiene los metadatos o el contenido de un archivo por ID. |
|
Inserta un nuevo archivo. |
|
Enumera los archivos del usuario. |
|
Enumera las etiquetas en un archivo. |
|
Modifica el conjunto de etiquetas aplicadas a un archivo. |
|
Actualiza los metadatos o el contenido 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 los metadatos o el contenido de un archivo. |
|
Se suscribe a los cambios en un archivo. |