Files

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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 addParents y removeParents para modificar la lista superior.

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.
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.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[].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.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 name cambia; sin embargo, no se borra si el nombre nuevo no contiene una extensión válida.

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.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.(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.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:
  • String de fecha
  • integer
  • de atributos
  • texto
  • usuario
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[].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.