Si quieres obtener una lista de métodos para este recurso, consulta el final de esta página.
Representaciones de recursos
Los metadatos de un archivo.
{ "kind": "drive#file", "id": string, "name": string, "mimeType": string, "description": string, "starred": boolean, "trashed": boolean, "explicitlyTrashed": boolean, "trashingUser": { "kind": "drive#user", "displayName": string, "photoLink": string, "me": boolean, "permissionId": string, "emailAddress": string }, "trashedTime": datetime, "parents": [ string ], "properties": { (key): string }, "appProperties": { (key): string }, "spaces": [ string ], "version": long, "webContentLink": string, "webViewLink": string, "iconLink": string, "hasThumbnail": boolean, "thumbnailLink": string, "thumbnailVersion": long, "viewedByMe": boolean, "viewedByMeTime": datetime, "createdTime": datetime, "modifiedTime": datetime, "modifiedByMeTime": datetime, "modifiedByMe": boolean, "sharedWithMeTime": datetime, "sharingUser": { "kind": "drive#user", "displayName": string, "photoLink": string, "me": boolean, "permissionId": string, "emailAddress": string }, "owners": [ { "kind": "drive#user", "displayName": string, "photoLink": string, "me": boolean, "permissionId": string, "emailAddress": string } ], "teamDriveId": string, "driveId": string, "lastModifyingUser": { "kind": "drive#user", "displayName": string, "photoLink": string, "me": boolean, "permissionId": string, "emailAddress": string }, "shared": boolean, "ownedByMe": boolean, "capabilities": { "canAcceptOwnership": boolean, "canAddChildren": boolean, "canAddFolderFromAnotherDrive": boolean, "canAddMyDriveParent": boolean, "canChangeCopyRequiresWriterPermission": boolean, "canChangeSecurityUpdateEnabled": boolean, "canChangeViewersCanCopyContent": boolean, "canComment": boolean, "canCopy": boolean, "canDelete": boolean, "canDeleteChildren": boolean, "canDownload": boolean, "canEdit": boolean, "canListChildren": boolean, "canModifyContent": boolean, "canModifyContentRestriction": boolean, "canModifyLabels": boolean, "canMoveChildrenOutOfTeamDrive": boolean, "canMoveChildrenOutOfDrive": boolean, "canMoveChildrenWithinTeamDrive": boolean, "canMoveChildrenWithinDrive": boolean, "canMoveItemIntoTeamDrive": boolean, "canMoveItemOutOfTeamDrive": boolean, "canMoveItemOutOfDrive": boolean, "canMoveItemWithinTeamDrive": boolean, "canMoveItemWithinDrive": boolean, "canMoveTeamDriveItem": boolean, "canReadLabels": boolean, "canReadRevisions": boolean, "canReadTeamDrive": boolean, "canReadDrive": boolean, "canRemoveChildren": boolean, "canRemoveMyDriveParent": boolean, "canRename": boolean, "canShare": boolean, "canTrash": boolean, "canTrashChildren": boolean, "canUntrash": boolean }, "viewersCanCopyContent": boolean, "copyRequiresWriterPermission": boolean, "writersCanShare": boolean, "permissions": [ permissions Resource ], "permissionIds": [ string ], "hasAugmentedPermissions": boolean, "folderColorRgb": string, "originalFilename": string, "fullFileExtension": string, "fileExtension": string, "md5Checksum": string, "sha1Checksum": string, "sha256Checksum": string, "size": long, "quotaBytesUsed": long, "headRevisionId": string, "contentHints": { "thumbnail": { "image": bytes, "mimeType": string }, "indexableText": string }, "imageMediaMetadata": { "width": integer, "height": integer, "rotation": integer, "location": { "latitude": double, "longitude": double, "altitude": double }, "time": string, "cameraMake": string, "cameraModel": string, "exposureTime": float, "aperture": float, "flashUsed": boolean, "focalLength": float, "isoSpeed": integer, "meteringMode": string, "sensor": string, "exposureMode": string, "colorSpace": string, "whiteBalance": string, "exposureBias": float, "maxApertureValue": float, "subjectDistance": integer, "lens": string }, "videoMediaMetadata": { "width": integer, "height": integer, "durationMillis": long }, "isAppAuthorized": boolean, "exportLinks": { (key): string }, "shortcutDetails": { "targetId": string, "targetMimeType": string, "targetResourceKey": string }, "contentRestrictions": [ { "readOnly": boolean, "reason": string, "restrictingUser": { "kind": "drive#user", "displayName": string, "photoLink": string, "me": boolean, "permissionId": string, "emailAddress": string }, "restrictionTime": datetime, "type": string } ], "labelInfo": { "labels": [ { "kind": "drive#label", "id": string, "revisionId": string, "fields": { (key): { "kind": "drive#labelField", "id": string, "valueType": string, "dateString": [ date ], "integer": [ long ], "selection": [ string ], "text": [ string ], "user": [ { "kind": "drive#user", "displayName": string, "photoLink": string, "me": boolean, "permissionId": string, "emailAddress": string } ] } } } ] }, "resourceKey": string, "linkShareMetadata": { "securityUpdateEligible": boolean, "securityUpdateEnabled": boolean } }
Nombre de la propiedad | Valor | Descripción | Notas |
---|---|---|---|
kind |
string |
Identifica de qué tipo de recurso se trata. Valor. La string fija "drive#file" . |
|
id |
string |
El ID del archivo. | admite escritura |
name |
string |
El nombre del archivo. Esto no es necesariamente único dentro de una carpeta. Tenga en cuenta que para los elementos inmutables, como las carpetas de nivel superior de las unidades compartidas, la carpeta raíz de Mi unidad y la carpeta Datos de la aplicación, el nombre es constante. | admite escritura |
mimeType |
string |
Es el tipo de MIME del archivo. Google Drive intentará detectar automáticamente un valor adecuado del contenido subido si no se proporciona un valor. 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 Documentos de Google, el contenido subido se importará si es posible. Los formatos de importación admitidos se publican en el recurso About. |
admite escritura |
description |
string |
Una descripción breve del archivo. | admite escritura |
starred |
boolean |
Indica si el usuario destacó el archivo. | admite escritura |
trashed |
boolean |
Si el archivo se envió a la papelera, ya sea de forma explícita o desde una carpeta superior Solo el propietario puede enviar un archivo a la papelera. El elemento en la papelera se excluye de todas las respuestas de files.list que se muestran para cualquier usuario que no sea propietario del archivo. Sin embargo, todos los usuarios con acceso al archivo pueden ver los metadatos del elemento enviado a la papelera en una respuesta de la API. Todos los usuarios con acceso pueden copiar, descargar, exportar y compartir el archivo. | admite escritura |
explicitlyTrashed |
boolean |
Indica si el archivo se envió a la papelera de forma explícita, en lugar de hacerlo de forma recursiva desde una carpeta superior. | |
parents[] |
list |
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 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 de origen. Las solicitudes de actualización deben usar los parámetros |
admite escritura |
properties |
object |
Una colección de pares clave-valor arbitrarios visibles para todas las apps Las entradas con valores nulos se borran en las solicitudes de actualización y de copia. |
admite escritura |
properties.(key) |
string |
||
appProperties |
object |
Una colección de pares clave-valor arbitrarios que son privados para la aplicación solicitante Las entradas con valores nulos se borran en las solicitudes de actualización y de 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. |
admite escritura |
appProperties.(key) |
string |
||
spaces[] |
list |
La lista de espacios que contienen el archivo. Los valores admitidos actualmente son 'drive', 'appDataFolder' y 'photos'. | |
version |
long |
Un número de versión monótonamente creciente del archivo. Esto refleja cada cambio realizado en el archivo en el servidor, incluso aquellos no visibles para el usuario. | |
webContentLink |
string |
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. | |
webViewLink |
string |
Un vínculo para abrir el archivo en un visualizador o editor de Google relevante en un navegador | |
iconLink |
string |
Un vínculo estático y no autenticado al ícono del archivo | |
thumbnailLink |
string |
Un vínculo de corta duración a la miniatura del archivo, si está disponible. Por lo general, dura alrededor de horas. Solo se propaga cuando la app solicitante 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. |
|
viewedByMe |
boolean |
Indica si el usuario vio el archivo. | |
viewedByMeTime |
datetime |
La última vez que el usuario vio el archivo (fecha y hora de RFC 3339). | admite escritura |
createdTime |
datetime |
La hora en la que se creó el archivo (fecha y hora de RFC 3339). | admite escritura |
modifiedTime |
datetime |
La última vez que alguien modificó el archivo (fecha y hora de RFC 3339). Ten en cuenta que, si modificas el parámetro timeTime, también se modificará el valor modificadoByMeTime para el usuario. |
admite escritura |
modifiedByMeTime |
datetime |
La última vez que el usuario modificó el archivo (fecha y hora de RFC 3339). | |
sharedWithMeTime |
datetime |
La hora a la que se compartió el archivo con el usuario, si corresponde (fecha y hora RFC 3339). | |
sharingUser |
nested object |
El usuario que compartió el archivo con el usuario que lo solicitó (si corresponde). | |
sharingUser.kind |
string |
Identifica de qué tipo de recurso se trata. Valor. La string fija "drive#user" . |
|
sharingUser.displayName |
string |
Un nombre visible y sin formato para este usuario. | |
sharingUser.photoLink |
string |
Un vínculo a la foto de perfil del usuario, si está disponible. | |
sharingUser.me |
boolean |
Indica si este usuario es el usuario que realiza la solicitud. | |
sharingUser.permissionId |
string |
El ID del usuario, como se muestra en los recursos de permisos. | |
sharingUser.emailAddress |
string |
La dirección de correo electrónico del usuario. Es posible que esto no esté presente en determinados contextos si el usuario no hizo visible su dirección de correo electrónico para el solicitante. | |
owners[] |
list |
El propietario de este archivo. Solo algunos archivos heredados pueden tener más de un propietario. Este campo no se propaga para los elementos de las unidades compartidas. | |
owners[].kind |
string |
Identifica de qué tipo de recurso se trata. Valor. La string fija "drive#user" . |
|
owners[].displayName |
string |
Un nombre visible y sin formato para este usuario. | |
owners[].photoLink |
string |
Un vínculo a la foto de perfil del usuario, si está disponible. | |
owners[].me |
boolean |
Indica si este usuario es el usuario que realiza la solicitud. | |
owners[].permissionId |
string |
El ID del usuario, como se muestra en los recursos de permisos. | |
owners[].emailAddress |
string |
La dirección de correo electrónico del usuario. Es posible que esto no esté presente en determinados contextos si el usuario no hizo visible su dirección de correo electrónico para el solicitante. | |
lastModifyingUser |
nested object |
El último usuario que modifica el archivo. | |
lastModifyingUser.kind |
string |
Identifica de qué tipo de recurso se trata. Valor. La string fija "drive#user" . |
|
lastModifyingUser.displayName |
string |
Un nombre visible y sin formato para este usuario. | |
lastModifyingUser.photoLink |
string |
Un vínculo a la foto de perfil del usuario, si está disponible. | |
lastModifyingUser.me |
boolean |
Indica si este usuario es el usuario que realiza la solicitud. | |
lastModifyingUser.permissionId |
string |
El ID del usuario, como se muestra en los recursos de permisos. | |
lastModifyingUser.emailAddress |
string |
La dirección de correo electrónico del usuario. Es posible que esto no esté presente en determinados contextos si el usuario no hizo visible su dirección de correo electrónico para el solicitante. | |
shared |
boolean |
Indica si el archivo se compartió. No se propaga para los elementos de las unidades compartidas. | |
ownedByMe |
boolean |
Indica si el usuario es el propietario del archivo. No se propaga para los elementos de las unidades compartidas. | |
viewersCanCopyContent |
boolean |
Obsoleto. En su lugar, usa copyRequiresWriterPermission . |
|
writersCanShare |
boolean |
Indica si los usuarios que solo tienen el permiso writer pueden modificar los permisos del archivo. No se propaga para los elementos de las unidades compartidas. |
admite escritura |
permissions[] |
list |
La lista completa de permisos para el archivo. Esta opción solo está disponible si el usuario que realizó la solicitud puede compartir el archivo. No se propaga para los elementos de las unidades compartidas. | |
folderColorRgb |
string |
El color de una carpeta o el acceso directo a una carpeta como una string hexadecimal RGB Los colores compatibles se publican en el campo folderColorPalette del recurso About. Si se especifica un color no admitido, se usará el más cercano de la paleta. |
admite escritura |
originalFilename |
string |
El nombre de archivo original del contenido subido, si está disponible, o el valor original del campo name . Esta opción solo está disponible para archivos con contenido binario en Google Drive. |
admite escritura |
fullFileExtension |
string |
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. Esto se actualiza automáticamente cuando el campo |
|
fileExtension |
string |
El componente final de fullFileExtension . Esta opción solo está disponible para archivos con contenido binario en Google Drive. |
|
md5Checksum |
string |
La suma de verificación MD5 del contenido del archivo Esto solo se aplica a los archivos con contenido binario en Google Drive. | |
size |
long |
El tamaño del contenido del archivo en bytes. Este campo se completa con los archivos que incluyen contenido binario almacenado en Google Drive y con los archivos de Editores de Documentos. No se propaga para los accesos directos ni las carpetas. | |
quotaBytesUsed |
long |
La cantidad de bytes de cuota de almacenamiento que usa el archivo. Esto incluye la revisión principal y las revisiones anteriores con keepForever habilitado. |
|
headRevisionId |
string |
El ID de la revisión principal del archivo. Por el momento, solo está disponible para archivos con contenido binario en Google Drive. | |
contentHints |
object |
Información adicional sobre el contenido del archivo. Estos campos nunca se propagan en las respuestas. | |
contentHints.thumbnail |
object |
Miniatura del archivo. Solo se usará si Google Drive no puede generar una miniatura estándar. | |
contentHints.thumbnail.image |
bytes |
Los datos de miniaturas codificados con Base64 resguardadora de URL (RFC 4648 sección 5). | admite escritura |
contentHints.thumbnail.mimeType |
string |
Tipo MIME de la miniatura. | admite escritura |
contentHints.indexableText |
string |
Texto que se indexará para que el archivo mejore las consultas de fullText. El límite es de 128 KB y puede contener elementos HTML. Para obtener más información, consulta Administra metadatos de archivos. | admite escritura |
imageMediaMetadata |
object |
Metadatos adicionales sobre los medios de imagen, si están disponibles. | |
imageMediaMetadata.width |
integer |
El ancho de la imagen en píxeles. | |
imageMediaMetadata.height |
integer |
La altura de la imagen en píxeles. | |
imageMediaMetadata.rotation |
integer |
Número de rotaciones en sentido horario de las 90 grados aplicadas desde la orientación original de la imagen | |
imageMediaMetadata.location |
object |
Información de ubicación geográfica almacenada en la imagen. | |
imageMediaMetadata.location.latitude |
double |
Es la latitud almacenada en la imagen. | |
imageMediaMetadata.location.longitude |
double |
Es la longitud almacenada en la imagen. | |
imageMediaMetadata.location.altitude |
double |
La altitud almacenada en la imagen. | |
imageMediaMetadata.time |
string |
Fecha y hora en que se tomó la foto (EXIF DateTime). | |
imageMediaMetadata.cameraMake |
string |
La marca de la cámara que se usó para crear la foto. | |
imageMediaMetadata.cameraModel |
string |
El modelo de la cámara que se usó para crear la foto. | |
imageMediaMetadata.exposureTime |
float |
La duración en segundos de la exposición. | |
imageMediaMetadata.aperture |
float |
Apertura utilizada para crear la foto (número f). | |
imageMediaMetadata.flashUsed |
boolean |
Si se utilizó un flash para crear la foto. | |
imageMediaMetadata.focalLength |
float |
Longitud focal que se usa para crear la foto, en milímetros. | |
imageMediaMetadata.isoSpeed |
integer |
Es la velocidad ISO que se utiliza para crear la foto. | |
imageMediaMetadata.meteringMode |
string |
El modo de medición que se usa para crear la foto. | |
imageMediaMetadata.sensor |
string |
Es el tipo de sensor que se usa para crear la foto. | |
imageMediaMetadata.exposureMode |
string |
Modo de exposición usado para crear la foto | |
imageMediaMetadata.colorSpace |
string |
El espacio de color de la foto. | |
imageMediaMetadata.whiteBalance |
string |
El modo de balance de blancos utilizado para crear la foto. | |
imageMediaMetadata.exposureBias |
float |
El sesgo de exposición de la foto (valor APEX). | |
imageMediaMetadata.maxApertureValue |
float |
El número f más bajo de la lente en la longitud focal utilizada para crear la foto (valor APEX). | |
imageMediaMetadata.subjectDistance |
integer |
La distancia en metros del sujeto de la foto. | |
imageMediaMetadata.lens |
string |
El lente que se usó para crear la foto. | |
videoMediaMetadata |
object |
Metadatos adicionales sobre los medios de video Es posible que no esté disponible inmediatamente después de subirlo. | |
videoMediaMetadata.width |
integer |
El ancho en píxeles del video. | |
videoMediaMetadata.height |
integer |
La altura del video en píxeles. | |
videoMediaMetadata.durationMillis |
long |
Es la duración del video en milisegundos. | |
capabilities |
object |
Funciones que tiene el usuario actual en este archivo. Cada función corresponde a una acción detallada que un usuario puede realizar. | |
capabilities.canEdit |
boolean |
Si el usuario actual puede editar este archivo. Otros factores pueden limitar el tipo de cambios que puede realizar un usuario en un archivo. Por ejemplo, consulta canChangeCopyRequiresWriterPermission o canModifyContent . |
|
capabilities.canComment |
boolean |
Indica si el usuario actual puede comentar este archivo. | |
capabilities.canShare |
boolean |
Si el usuario actual puede modificar la configuración de uso compartido de este archivo. | |
capabilities.canCopy |
boolean |
Indica si el usuario actual puede copiar este archivo. Para un elemento de una unidad compartida, indica si el usuario actual puede copiar elementos subordinados que no sean carpetas de este elemento o el elemento en sí si no es una carpeta. | |
capabilities.canReadRevisions |
boolean |
Indica si el usuario actual puede leer el recurso de revisiones de este archivo. Para un elemento de una unidad compartida, se pueden leer las revisiones de los elementos subordinados que no son carpetas de este elemento o este elemento en sí mismo si no es una carpeta. | |
isAppAuthorized |
boolean |
Indica si la app solicitante creó o abrió el archivo. | |
hasThumbnail |
boolean |
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. | |
thumbnailVersion |
long |
La versión en miniatura que se usa en la invalidación de caché de miniaturas. | |
modifiedByMe |
boolean |
Indica si el usuario modificó el archivo. | |
trashingUser |
nested object |
Si el archivo se envió a la papelera de manera explícita, el usuario que lo envió a la papelera lo envió. Solo se propaga para los elementos de las unidades compartidas. | |
trashingUser.kind |
string |
Identifica de qué tipo de recurso se trata. Valor. La string fija "drive#user" . |
|
trashingUser.displayName |
string |
Un nombre visible y sin formato para este usuario. | |
trashingUser.photoLink |
string |
Un vínculo a la foto de perfil del usuario, si está disponible. | |
trashingUser.me |
boolean |
Indica si este usuario es el usuario que realiza la solicitud. | |
trashingUser.permissionId |
string |
El ID del usuario, como se muestra en los recursos de permisos. | |
trashingUser.emailAddress |
string |
La dirección de correo electrónico del usuario. Es posible que esto no esté presente en determinados contextos si el usuario no hizo visible su dirección de correo electrónico para el solicitante. | |
trashedTime |
datetime |
La hora a la que se envió el elemento a la papelera (fecha y hora RFC 3339). Solo se propaga para los elementos de las unidades compartidas. | |
teamDriveId |
string |
Obsoleto. En su lugar, usa driveId . |
|
capabilities.canAddChildren |
boolean |
Si el usuario actual puede agregar elementos secundarios a esta carpeta. Esto siempre es falso cuando el elemento no es una carpeta. | |
capabilities.canDelete |
boolean |
Indica si el usuario actual puede borrar este archivo. | |
capabilities.canDownload |
boolean |
Indica si el usuario actual puede descargar este archivo. | |
capabilities.canListChildren |
boolean |
Indica si el usuario actual puede mostrar una lista de los elementos secundarios de esta carpeta. Esto siempre es falso cuando el elemento no es una carpeta. | |
capabilities.canMoveTeamDriveItem |
boolean |
Obsoleto. En su lugar, usa canMoveItemWithinDrive o canMoveItemOutOfDrive . |
|
capabilities.canMoveItemIntoTeamDrive |
boolean |
Obsoleto. En su lugar, usa canMoveItemOutOfDrive . |
|
capabilities.canReadTeamDrive |
boolean |
Obsoleto. En su lugar, usa canReadDrive . |
|
capabilities.canRemoveChildren |
boolean |
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 de una unidad compartida, usa canDeleteChildren o canTrashChildren . |
|
capabilities.canRename |
boolean |
Indica si el usuario actual puede cambiar el nombre de este archivo. | |
capabilities.canTrash |
boolean |
Indica si el usuario actual puede enviar este archivo a la papelera. | |
capabilities.canUntrash |
boolean |
Si el usuario actual puede restablecer este archivo de la papelera | |
hasAugmentedPermissions |
boolean |
Indica si hay permisos directamente en este archivo. Este campo solo se propaga para los elementos de las unidades compartidas. | |
capabilities.canChangeViewersCanCopyContent |
boolean |
Baja | |
permissionIds[] |
list |
Lista de los ID de permiso de los usuarios con acceso a este archivo. | |
capabilities.canChangeCopyRequiresWriterPermission |
boolean |
Si el usuario actual puede cambiar la restricción copyRequiresWriterPermission de este archivo. |
|
copyRequiresWriterPermission |
boolean |
Si las opciones para copiar, imprimir o descargar este archivo deben estar inhabilitadas para los lectores y comentaristas. | admite escritura |
capabilities.canDeleteChildren |
boolean |
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 |
boolean |
Obsoleto. En su lugar, usa canMoveChildrenOutOfDrive . |
|
capabilities.canMoveChildrenWithinTeamDrive |
boolean |
Obsoleto. En su lugar, usa canMoveChildrenWithinDrive . |
|
capabilities.canMoveItemOutOfTeamDrive |
boolean |
Obsoleto. En su lugar, usa canMoveItemOutOfDrive . |
|
capabilities.canMoveItemWithinTeamDrive |
boolean |
Obsoleto. En su lugar, usa canMoveItemWithinDrive . |
|
capabilities.canTrashChildren |
boolean |
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. | |
exportLinks |
object |
Vínculos para exportar archivos de Editores de Documentos a formatos específicos. | |
exportLinks.(key) |
string |
Una asignación del formato de exportación a la URL | |
driveId |
string |
ID de la unidad compartida en la que reside el archivo. Solo se propaga para los elementos de las unidades compartidas. | |
capabilities.canMoveChildrenOutOfDrive |
boolean |
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.canMoveChildrenWithinDrive |
boolean |
Indica si el usuario actual puede mover los elementos secundarios de esta carpeta dentro de la unidad. Esto 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 actual del usuario al elemento secundario y a la carpeta de destino. | |
capabilities.canMoveItemOutOfDrive |
boolean |
Si el usuario actual puede quitar este elemento de esta unidad cambiando su elemento superior Ten en cuenta que una solicitud para cambiar el elemento superior del elemento puede fallar según el nuevo elemento superior que se agregue. | |
capabilities.canMoveItemWithinDrive |
boolean |
Indica si el usuario actual puede mover este elemento dentro de esta unidad. Ten en cuenta que una solicitud para cambiar el elemento superior del elemento puede fallar según el nuevo elemento superior que se agregue y el elemento superior que se quite. | |
capabilities.canReadDrive |
boolean |
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.canModifyContent |
boolean |
Indica si el usuario actual puede modificar el contenido de este archivo. | |
capabilities.canAddMyDriveParent |
boolean |
Si el usuario actual puede agregar un elemento superior para el elemento sin quitar un elemento superior existente en la misma solicitud No se propaga para los archivos de unidades compartidas. | |
capabilities.canRemoveMyDriveParent |
boolean |
Si el usuario actual puede quitar un elemento superior del elemento sin agregar otro elemento superior en la misma solicitud No se propaga para los archivos de unidades compartidas. | |
shortcutDetails |
object |
Detalles del archivo de acceso directo. Solo se propaga para los archivos de acceso directo, que tienen el campo mimeType configurado como application/vnd.google-apps.shortcut . |
|
shortcutDetails.targetId |
string |
El ID del archivo al que apunta esta combinación de teclas. | admite escritura |
shortcutDetails.targetMimeType |
string |
El tipo de MIME del archivo al que apunta este acceso directo. El valor de este campo es una instantánea del tipo MIME del destino, capturado cuando se crea el acceso directo. | |
capabilities.canAddFolderFromAnotherDrive |
boolean |
Si el usuario actual puede agregar una carpeta de otra unidad (diferente 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.canModifyContentRestriction |
boolean |
Si el usuario actual puede modificar las restricciones del contenido de este archivo. | |
contentRestrictions[] |
list |
Restricciones para acceder al contenido del archivo. Solo se propaga si existe tal restricción. | |
contentRestrictions[].readOnly |
boolean |
Indica si el contenido del archivo es de solo lectura. Si un archivo es de solo lectura, es posible que no se agreguen ni modifiquen comentarios nuevos. Además, es posible que no se modifique el título del archivo. | admite escritura |
contentRestrictions[].reason |
string |
Motivo por el que se restringe el contenido del archivo. Esto solo se puede mutar en las solicitudes que también configuran readOnly=true . |
admite escritura |
contentRestrictions[].restrictingUser |
nested object |
El usuario que estableció la restricción de contenido. Solo se propaga si readOnly es verdadero. |
|
contentRestrictions[].restrictingUser.kind |
string |
Identifica de qué tipo de recurso se trata. Valor. La string fija "drive#user" . |
|
contentRestrictions[].restrictingUser.displayName |
string |
Un nombre visible y sin formato para este usuario. | |
contentRestrictions[].restrictingUser.photoLink |
string |
Un vínculo a la foto de perfil del usuario, si está disponible. | |
contentRestrictions[].restrictingUser.me |
boolean |
Indica si este usuario es el usuario que realiza la solicitud. | |
contentRestrictions[].restrictingUser.permissionId |
string |
El ID del usuario, como se muestra en los recursos de permisos. | |
contentRestrictions[].restrictingUser.emailAddress |
string |
La dirección de correo electrónico del usuario. Es posible que esto no esté presente en determinados contextos si el usuario no hizo visible su dirección de correo electrónico para el solicitante. | |
contentRestrictions[].restrictionTime |
datetime |
El momento en que se estableció la restricción de contenido (marca de tiempo RFC 3339 con formato). Solo se propaga si readOnly es verdadero. |
|
contentRestrictions[].type |
string |
Es el tipo de restricción de contenido. Actualmente, el único valor posible es globalContentRestriction . |
|
capabilities.canChangeSecurityUpdateEnabled |
boolean |
Si el usuario actual puede cambiar el campo securityUpdateEnabled en los metadatos de uso compartido de vínculos. | |
shortcutDetails.targetResourceKey |
string |
La ResourceResource para el archivo de destino. | |
resourceKey |
string |
Una clave necesaria para acceder al elemento a través de un vínculo compartido. | |
linkShareMetadata |
object |
Contiene detalles sobre las URL de vínculo que los clientes utilizan para referirse a este elemento. | |
linkShareMetadata.securityUpdateEligible |
boolean |
Indica si el archivo es apto para la actualización de seguridad. | |
linkShareMetadata.securityUpdateEnabled |
boolean |
Indica si la actualización de seguridad está habilitada para este archivo. | |
capabilities.canAcceptOwnership |
boolean |
Si el usuario actual es el propietario pendiente del archivo. No se propaga para los archivos de unidades compartidas. | |
capabilities.canModifyLabels |
boolean |
Indica si el usuario actual puede modificar las etiquetas en este archivo. | |
capabilities.canReadLabels |
boolean |
Indica si el usuario actual puede leer las etiquetas en este archivo. | |
labelInfo |
object |
Una descripción general de las etiquetas del archivo. | |
labelInfo.labels[] |
list |
El conjunto de etiquetas en el archivo, como lo solicitan los ID de etiqueta en el parámetro includeLabels . De forma predeterminada, no se muestran etiquetas. |
|
labelInfo.labels[].kind |
string |
Este siempre es drive#label | |
labelInfo.labels[].id |
string |
El ID de la etiqueta. | |
labelInfo.labels[].revisionId |
string |
El ID de revisión de la etiqueta. | |
labelInfo.labels[].fields |
object |
Un mapa de los campos de la etiqueta con clave según el ID del campo. | |
labelInfo.labels[].fields.(key) |
nested object |
||
labelInfo.labels[].fields.(key).kind |
string |
Esto siempre es drive#labelField. | |
labelInfo.labels[].fields.(key).id |
string |
El identificador de este campo. | |
labelInfo.labels[].fields.(key).valueType |
string |
El tipo de campo. Aunque se pueden admitir valores nuevos en el futuro, se permite lo siguiente:
|
|
labelInfo.labels[].fields.(key).dateString[] |
list |
Solo está presente si valueType es dateString . Fecha con formato RFC 3339: AAAA-MM-DD. |
|
labelInfo.labels[].fields.(key).integer[] |
list |
Solo está presente si valueType es integer . |
|
labelInfo.labels[].fields.(key).selection[] |
list |
Solo está presente si valueType es selection . |
|
labelInfo.labels[].fields.(key).text[] |
list |
Solo está presente si valueType es text . |
|
labelInfo.labels[].fields.(key).user[] |
list |
Solo está presente si valueType es user . |
|
labelInfo.labels[].fields.(key).user[].kind |
string |
Identifica de qué tipo de recurso se trata. Valor. La string fija "drive#user" . |
|
labelInfo.labels[].fields.(key).user[].displayName |
string |
Un nombre visible y sin formato para este usuario. | |
labelInfo.labels[].fields.(key).user[].photoLink |
string |
Un vínculo a la foto de perfil del usuario, si está disponible. | |
labelInfo.labels[].fields.(key).user[].me |
boolean |
Indica si este usuario es el usuario que realiza la solicitud. | |
labelInfo.labels[].fields.(key).user[].permissionId |
string |
El ID del usuario, como se muestra en los recursos de permisos. | |
labelInfo.labels[].fields.(key).user[].emailAddress |
string |
La dirección de correo electrónico del usuario. Es posible que esto no esté presente en determinados contextos si el usuario no hizo visible su dirección de correo electrónico para el solicitante. | |
sha1Checksum |
string |
La suma de verificación SHA1 asociada con este archivo, si está disponible. Este campo solo se propaga en los archivos con contenido almacenado en Google Drive, no en los editores de Documentos ni en los archivos de acceso directo. | |
sha256Checksum |
string |
La suma de verificación SHA256 asociada con este archivo, si está disponible. Este campo solo se propaga en los archivos con contenido almacenado en Google Drive, no en los editores de Documentos ni en los archivos de acceso directo. |
Métodos
- copia
- Crea una copia de un archivo y aplica las actualizaciones solicitadas con semántica de parches. No se pueden copiar las carpetas.
- crear
- Crea un archivo.
- borrar
- Borra de forma permanente un archivo que pertenece al usuario sin moverlo a la papelera. Si el archivo pertenece a una unidad compartida, el usuario debe ser organizador en la unidad superior. Si el destino es una carpeta, también se borran todos los descendientes que pertenecen al usuario.
- vacío
- Borra permanentemente todos los archivos de la papelera del usuario.
- exportar
- Exporta un documento de Google Workspace al tipo de MIME solicitado y muestra el contenido de bytes exportado. Ten en cuenta que el contenido exportado tiene un límite de 10 MB.
- generateIds
- Genera un conjunto de ID de archivo que se pueden proporcionar en las solicitudes de creación o copia.
- obtener
- Obtiene los metadatos o el contenido de un archivo por ID.
- list
- Enumera o busca archivos.
- actualizar
- Actualiza los metadatos o el contenido de un archivo. Cuando llames a este método, solo propaga los campos en la solicitud que deseas modificar. Cuando actualizas campos, algunos pueden cambiar de forma automática, como se modificó. Este método es compatible con la semántica de parches.
- reloj
- Suscríbete a los cambios de un archivo. Si bien puedes establecer un canal para los cambios en un archivo de una unidad compartida, los cambios en un archivo de una unidad compartida no crearán una notificación.
- listasdeetiquetas
- Muestra las etiquetas de un archivo.
- modifyLabels
- Modifica el conjunto de etiquetas en un archivo.