Recurso: Archivo
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 |
---|
{ "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 ( |
Campos | |
---|---|
kind |
Solo salida. Identifica qué tipo de recurso es. Valor: la cadena fija |
drive |
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. |
file |
Solo salida. El componente final de |
copy |
Si se deben inhabilitar las opciones para copiar, imprimir o descargar este archivo para los lectores y comentaristas |
md5 |
Solo salida. La suma de comprobación MD5 del contenido del archivo. Esto solo se aplica a los archivos con contenido binario en Google Drive. |
content |
Información adicional sobre el contenido del archivo. Estos campos nunca se propagan en las respuestas. |
content |
Es el texto que se indexará para que el archivo mejore las consultas de texto completo. Tiene un límite de 128 KB de longitud y puede contener elementos HTML. |
content |
Es una miniatura del archivo. Solo se usará si Google Drive no puede generar una miniatura estándar. |
content |
Los datos de la miniatura codificados con Base64 seguro para URL (sección 5 de la RFC 4648) String codificada en base64. |
content |
Es el tipo de MIME de la miniatura. |
writers |
Indica si los usuarios que solo tienen permiso |
viewed |
Solo salida. Indica si este usuario vio el archivo. |
mime |
Es el tipo MIME del archivo. Si no se proporciona ningún valor, Google Drive intenta detectar automáticamente un valor adecuado 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 importará el contenido subido, si es posible. Los formatos de importación admitidos se publican en el recurso Acerca de. |
export |
Solo salida. Vínculos para exportar archivos de Documentos de Writer a formatos específicos. Es un objeto que contiene una lista de pares |
parents[] |
Es el ID de la carpeta superior 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 de origen. Las solicitudes de files.update deben usar los parámetros |
thumbnail |
Solo salida. Un vínculo de corta duración a la miniatura del archivo, si está disponible Por lo general, dura alrededor de horas. No está diseñado para usarse directamente en aplicaciones web debido a las políticas de uso compartido de recursos entre dominios (CORS). Considera usar un servidor proxy. Solo se propaga cuando la app solicitante puede acceder al contenido del archivo. Si el archivo no se comparte de forma pública, la URL que se muestra en |
icon |
Solo salida. Es un vínculo estático sin autenticar al ícono del archivo. |
shared |
Solo salida. Indica si se compartió el archivo. No se propagan en los elementos de las unidades compartidas. |
last |
Solo salida. 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. |
owners[] |
Solo salida. El propietario de este archivo Solo ciertos archivos heredados pueden tener más de un propietario. Este campo no se completa para los elementos de las unidades compartidas. |
head |
Solo salida. Es el ID de la revisión principal del archivo. Por el momento, esta función solo está disponible para archivos con contenido binario en Google Drive. |
sharing |
Solo salida. El usuario que compartió el archivo con el usuario solicitante, si corresponde |
web |
Solo salida. Un vínculo para abrir el archivo en un editor o visor de Google relevante en un navegador. |
web |
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. |
size |
Solo salida. Es el tamaño en bytes de los blobs y los archivos del editor propios. No se propagará para los archivos que no tengan tamaño, como los accesos directos y las carpetas. |
viewersCanCopyContent |
Obsoleto: Usa |
permissions[] |
Solo salida. La lista completa de permisos del archivo Esta opción solo está disponible si el usuario solicitante puede compartir el archivo. No se propagan para los elementos de las unidades compartidas. |
has |
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 el campo thumbnailLink. |
spaces[] |
Solo salida. Es la lista de espacios que contienen el archivo. Los valores admitidos actualmente son "drive", "appDataFolder" y "photos". |
folder |
Es el color de una carpeta o un acceso directo a una carpeta como una cadena hexadecimal RGB. Los colores admitidos se publican en el campo Si se especifica un color no compatible, se usará el color más cercano de la paleta. |
id |
Es el ID del archivo. |
name |
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 aplicaciones, el nombre es constante. |
description |
Es una descripción breve del archivo. |
starred |
Indica si el usuario destacó el archivo. |
trashed |
Indica si el archivo se envió a la papelera, ya sea de forma explícita o desde una carpeta superior que se encuentra en la papelera. Solo el propietario puede enviar un archivo a la papelera, y los demás usuarios no pueden ver los archivos que se encuentran allí. |
explicitly |
Solo salida. Indica si el archivo se envió a la papelera de forma explícita, en lugar de hacerlo de forma recursiva desde una carpeta superior. |
created |
Es la hora en que se creó el archivo (fecha y hora en formato RFC 3339). |
modified |
La última vez que alguien modificó el archivo (fecha y hora RFC 3339). Ten en cuenta que configurar |
modified |
Solo salida. La última vez que el usuario modificó el archivo (fecha y hora RFC 3339). |
viewed |
La última vez que el usuario vio el archivo (fecha y hora RFC 3339) |
shared |
Solo salida. La hora en la que se compartió el archivo con el usuario, si corresponde (fecha y hora de RFC 3339) |
quota |
Solo salida. Es la cantidad de bytes de cuota de almacenamiento que usa el archivo. Esto incluye la revisión principal y las revisiones anteriores con |
version |
Solo salida. Un número de versión que aumenta de forma monótona para el archivo. Esto refleja todos los cambios realizados en el archivo del servidor, incluso los que no son visibles para el usuario. |
original |
El nombre de archivo original del contenido subido, si está disponible, o el valor original del campo |
owned |
Solo salida. Indica si el usuario es el propietario del archivo. No se propagan para los elementos de las unidades compartidas. |
full |
Solo salida. Es la extensión de archivo completa extraída del campo Este valor se actualiza automáticamente cuando cambia el campo |
properties |
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 |
app |
Es 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 con 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 |
is |
Solo salida. Indica si la app solicitante creó o abrió el archivo. |
teamDriveId |
Obsoleto: Solo salida. Usa |
capabilities |
Solo salida. Son las capacidades que tiene el usuario actual en este archivo. Cada capability corresponde a una acción detallada que puede realizar un usuario. |
capabilities.canChangeViewersCanCopyContent |
Obsoleto: Solo salida. |
capabilities. |
Solo salida. Indica si el usuario actual puede mover 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. |
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. |
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. |
Solo salida. Indica si el usuario actual puede copiar este archivo. Para un elemento de una unidad compartida, indica si el usuario actual puede copiar elementos secundarios que no sean carpetas de este elemento o el propio elemento si no es una carpeta. |
capabilities. |
Solo salida. Indica si el usuario actual puede comentar este archivo. |
capabilities. |
Solo salida. Indica si el usuario actual puede agregar hijos o hijas a esta carpeta. Siempre es falso cuando el elemento no es una carpeta. |
capabilities. |
Solo salida. Indica si el usuario actual puede borrar este archivo. |
capabilities. |
Solo salida. Indica si el usuario actual puede descargar este archivo. |
capabilities. |
Solo salida. Indica si el usuario actual puede enumerar las carpetas secundarias de esta carpeta. Siempre es falso cuando el elemento no es una carpeta. |
capabilities. |
Solo salida. Indica si el usuario actual puede quitar a los hijos o hijas de esta carpeta. Siempre es falso cuando el elemento no es una carpeta. Para una carpeta en una unidad compartida, usa |
capabilities. |
Solo salida. Indica si el usuario actual puede cambiar el nombre de este archivo. |
capabilities. |
Solo salida. Indica si el usuario actual puede mover este archivo a la papelera. |
capabilities. |
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, se pueden leer las revisiones de los elementos secundarios que no sean carpetas de este elemento o el propio elemento si no es una carpeta. |
capabilities.canReadTeamDrive |
Obsoleto: Solo salida. Usa |
capabilities.canMoveTeamDriveItem |
Obsoleto: Solo salida. En su lugar, usa los elementos |
capabilities. |
Solo salida. Indica si el usuario actual puede cambiar la restricción |
capabilities.canMoveItemIntoTeamDrive |
Obsoleto: Solo salida. Usa |
capabilities. |
Solo salida. Indica si el usuario actual puede restablecer este archivo de la papelera. |
capabilities. |
Solo salida. Indica si el usuario actual puede modificar el contenido de este archivo. |
capabilities.canMoveItemWithinTeamDrive |
Obsoleto: Solo salida. Usa |
capabilities.canMoveItemOutOfTeamDrive |
Obsoleto: Solo salida. Usa |
capabilities. |
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 |
Obsoleto: Solo salida. Usa |
capabilities.canMoveChildrenWithinTeamDrive |
Obsoleto: Solo salida. Usa |
capabilities. |
Solo salida. Indica si el usuario actual puede enviar a la papelera los 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. |
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 según el elemento superior nuevo que se agregue. |
capabilities. |
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 propagan en los archivos de unidades compartidas. |
capabilities. |
Solo salida. Indica si el usuario actual puede quitar un elemento superior del elemento sin agregar otro elemento superior en la misma solicitud. No se propagan en los archivos de unidades compartidas. |
capabilities. |
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 según el elemento superior nuevo que se agregue y el que se quite. |
capabilities. |
Solo salida. Indica si el usuario actual puede modificar la configuración de uso compartido de este archivo. |
capabilities. |
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 una solicitud para mover el 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 uno de |
capabilities. |
Solo salida. Indica si el usuario actual puede agregar una carpeta de otra unidad (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. |
Solo salida. Indica si el usuario actual puede cambiar el campo securityUpdateEnabled en los metadatos de uso compartido de vínculos. |
capabilities. |
Solo salida. Indica si el usuario actual es el propietario pendiente del archivo. No se propagan en los archivos de unidades compartidas. |
capabilities. |
Solo salida. Indica si el usuario actual puede leer las etiquetas del archivo. |
capabilities. |
Solo salida. Indica si el usuario actual puede modificar las etiquetas del archivo. |
capabilities. |
Solo salida. Indica si el usuario actual puede agregar o modificar restricciones de contenido en el archivo que están restringidas para el editor. |
capabilities. |
Solo salida. Indica si el usuario actual puede agregar o modificar restricciones de contenido que están restringidas por el propietario. |
capabilities. |
Solo salida. Indica si hay una restricción de contenido en el archivo que el usuario actual puede quitar. |
capabilities. |
Indica si un usuario puede inhabilitar los permisos heredados. |
capabilities. |
Indica si un usuario puede volver a habilitar los permisos heredados. |
has |
Solo salida. Si hay permisos directamente en este archivo Este campo solo se propaga para los elementos de las unidades compartidas. |
trashing |
Solo salida. Si el archivo se envió a la papelera de forma explícita, el usuario que lo hizo Solo se completa para los elementos de las unidades compartidas. |
thumbnail |
Solo salida. Es la versión de la miniatura que se usa en la invalidación de la caché de miniaturas. |
trashed |
Solo salida. Es la hora en que se envió el elemento a la papelera (fecha y hora en formato RFC 3339). Solo se completa para los elementos de las unidades compartidas. |
modified |
Solo salida. Indica si este usuario modificó el archivo. |
permission |
Solo salida. files.list de IDs de permisos para los usuarios con acceso a este archivo. |
image |
Solo salida. Metadatos adicionales sobre el contenido multimedia de la imagen, si está disponible |
image |
Solo salida. Indica si se usó un flash para crear la foto. |
image |
Solo salida. Es el modo de medición que se usó para crear la foto. |
image |
Solo salida. Es el tipo de sensor que se usó para crear la foto. |
image |
Solo salida. Es el modo de exposición que se usó para crear la foto. |
image |
Solo salida. Es el espacio de color de la foto. |
image |
Solo salida. Es el modo de balance de blancos que se usó para crear la foto. |
image |
Solo salida. El ancho de la imagen en píxeles. |
image |
Solo salida. La altura de la imagen en píxeles. |
image |
Solo salida. Es la información de ubicación geográfica almacenada en la imagen. |
image |
Solo salida. Es la latitud almacenada en la imagen. |
image |
Solo salida. Es la longitud almacenada en la imagen. |
image |
Solo salida. La altitud almacenada en la imagen. |
image |
Solo salida. Es la cantidad de rotaciones de 90 grados en el sentido de las manecillas del reloj aplicadas desde la orientación original de la imagen. |
image |
Solo salida. La fecha y hora en que se tomó la foto (EXIF DateTime) |
image |
Solo salida. Es la marca de la cámara que se usó para crear la foto. |
image |
Solo salida. Es el modelo de la cámara que se usó para crear la foto. |
image |
Solo salida. Es la duración de la exposición, en segundos. |
image |
Solo salida. Es la apertura que se usó para crear la foto (número f). |
image |
Solo salida. Es la distancia focal que se usó para crear la foto, en milímetros. |
image |
Solo salida. La velocidad ISO que se usó para crear la foto. |
image |
Solo salida. Es la compensación de exposición de la foto (valor de APEX). |
image |
Solo salida. Es el número f más bajo del lente en la distancia focal que se usó para crear la foto (valor de APEX). |
image |
Solo salida. Es la distancia al sujeto de la foto, en metros. |
image |
Solo salida. Es el lente que se usó para crear la foto. |
video |
Solo salida. Metadatos adicionales sobre el contenido multimedia de video Es posible que no esté disponible de inmediato después de la carga. |
video |
Solo salida. Es el ancho del video en píxeles. |
video |
Solo salida. Es la altura del video en píxeles. |
video |
Solo salida. Es la duración del video, expresada en milisegundos. |
shortcut |
Detalles del archivo del atajo Solo se completa para los archivos de acceso directo, que tienen el campo mimeType configurado como |
shortcut |
Es el ID del archivo al que apunta este atajo. Solo se puede configurar en solicitudes |
shortcut |
Solo salida. Es el tipo MIME del archivo al que apunta este atajo. El valor de este campo es una instantánea del tipo de MIME del destino, que se captura cuando se crea el atajo. |
shortcut |
Solo salida. Es el ResourceKey del archivo de destino. |
content |
Restricciones para acceder al contenido del archivo Solo se completa si existe esa restricción. |
resource |
Solo salida. Es una clave necesaria para acceder al elemento a través de un vínculo compartido. |
link |
Solo salida. Detalles relacionados con LinkShare Contiene detalles sobre las URLs de vínculo que usan los clientes para hacer referencia a este artículo. |
link |
Solo salida. Indica si el archivo es apto para la actualización de seguridad. |
link |
Solo salida. Indica si la actualización de seguridad está habilitada para este archivo. |
label |
Solo salida. Una descripción general de las etiquetas del archivo. |
label |
Solo salida. Es el conjunto de etiquetas del archivo según lo soliciten los IDs de etiqueta en el parámetro |
sha1 |
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 completa para los Editores de Documentos ni los archivos de acceso directo. |
sha256 |
Solo salida. La suma de comprobació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 completa para los Editores de Documentos ni los archivos de acceso directo. |
inherited |
Indica si este archivo tiene inhabilitados los permisos heredados. Los permisos heredados están habilitados de forma predeterminada. |
ContentRestriction
Es una restricción para acceder al contenido del archivo.
Representación JSON |
---|
{
"readOnly": boolean,
"reason": string,
"type": string,
"restrictingUser": {
object ( |
Campos | |
---|---|
read |
Indica si el contenido del archivo es de solo lectura. Si un archivo es de solo lectura, es posible que no se pueda agregar una nueva revisión, que no se puedan agregar ni modificar comentarios, ni que se pueda modificar el título del archivo. |
reason |
Es el motivo por el que se restringió el contenido del archivo. Esto solo es mutable en las solicitudes que también establecen |
type |
Solo salida. Es el tipo de restricción de contenido. Actualmente, el único valor posible es |
restricting |
Solo salida. El usuario que estableció la restricción de contenido Solo se propaga si |
restriction |
Solo salida. Es la hora en la que se estableció la restricción de contenido (marca de tiempo en formato RFC 3339). Solo se propaga si |
owner |
Indica si solo el usuario propietario del archivo puede modificar o quitar la restricción de contenido. En el caso de los archivos de las unidades compartidas, cualquier usuario con capacidades de |
system |
Solo salida. 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 de un archivo y aplica las actualizaciones solicitadas con semántica de parche. |
|
Crea un archivo nuevo. |
|
Borra de forma permanente un archivo que pertenece al usuario sin moverlo a la papelera. |
|
Descarga el contenido de un archivo. |
|
Borra de forma permanente todos los archivos de 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 archivos que se pueden proporcionar en solicitudes de creación o copia. |
|
Obtiene los metadatos o el contenido de un archivo por ID. |
|
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 los metadatos o el contenido de un archivo. |
|
Se suscribe a los cambios de un archivo. |