Se usó la API de Cloud Translation para traducir esta página.

Class File

Un archivo en Google Drive Se puede acceder a los archivos o crearlos desde DriveApp.

// Trash every untitled spreadsheet that hasn't been updated in a week.
var files = DriveApp.getFilesByName('Untitled spreadsheet');
while (files.hasNext()) {
  var file = files.next();
  if (new Date() - file.getLastUpdated() > 7 * 24 * 60 * 60 * 1000) {
    file.setTrashed(true);
  }
}

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`addCommenter(emailAddress)`	`File`	Agrega el usuario específico a la lista de comentaristas de `File`.
`addCommenter(user)`	`File`	Agrega el usuario específico a la lista de comentaristas de `File`.
`addCommenters(emailAddresses)`	`File`	Agrega el array de usuarios determinado a la lista de comentaristas de `File`.
`addEditor(emailAddress)`	`File`	Agrega el usuario determinado a la lista de editores de `File`.
`addEditor(user)`	`File`	Agrega el usuario determinado a la lista de editores de `File`.
`addEditors(emailAddresses)`	`File`	Agrega el array determinado de usuarios a la lista de editores de `File`.
`addViewer(emailAddress)`	`File`	Agrega el usuario específico a la lista de lectores de `File`.
`addViewer(user)`	`File`	Agrega el usuario específico a la lista de lectores de `File`.
`addViewers(emailAddresses)`	`File`	Agrega el array determinado de usuarios a la lista de visualizadores de `File`.
`getAccess(email)`	`Permission`	Obtiene el permiso otorgado al usuario determinado.
`getAccess(user)`	`Permission`	Obtiene el permiso otorgado al usuario determinado.
`getAs(contentType)`	`Blob`	Muestra los datos dentro de este objeto como un BLOB convertido al tipo de contenido especificado.
`getBlob()`	`Blob`	Muestra los datos dentro de este objeto como un BLOB.
`getDateCreated()`	`Date`	Obtiene la fecha en que se creó el `File`.
`getDescription()`	`String`	Obtiene la descripción del `File`.
`getDownloadUrl()`	`String`	Obtiene la URL que se puede usar para descargar el archivo.
`getEditors()`	`User[]`	Obtiene la lista de editores de este `File`.
`getId()`	`String`	Obtiene el ID del `File`.
`getLastUpdated()`	`Date`	Obtiene la fecha de la última actualización del `File`.
`getMimeType()`	`String`	Obtiene el tipo de MIME del archivo.
`getName()`	`String`	Obtiene el nombre del `File`.
`getOwner()`	`User`	Obtiene el propietario del archivo.
`getParents()`	`FolderIterator`	Obtiene una colección de carpetas que son elementos superiores inmediatos de `File`.
`getResourceKey()`	`String`	Obtiene la clave de recurso del `File` que se requiere para acceder a los elementos que se compartieron mediante un vínculo.
`getSecurityUpdateEligible()`	`Boolean`	Determina si este `File` es apto para aplicar la actualización de seguridad que requiere una clave de recurso para acceder cuando se comparte mediante un vínculo.
`getSecurityUpdateEnabled()`	`Boolean`	Obtiene si este `File` requiere una clave de recurso para acceder cuando es compartida mediante un vínculo.
`getSharingAccess()`	`Access`	Obtiene qué clase de usuarios puede acceder a `File`, además de cualquier usuario individual usuarios a los que se les otorgó acceso explícitamente.
`getSharingPermission()`	`Permission`	Obtiene el permiso que se otorga a los usuarios que pueden acceder a `File`. además de los usuarios individuales a los que se les otorgó acceso explícito.
`getSize()`	`Integer`	Obtiene la cantidad de bytes usados para almacenar el `File` en Drive.
`getTargetId()`	`String`	Si se trata de un acceso directo, muestra el ID del elemento al que apunta.
`getTargetMimeType()`	`String`	Si se trata de un acceso directo, muestra el tipo de MIME del elemento al que apunta.
`getTargetResourceKey()`	`String`	Si el archivo es una combinación de teclas, muestra la clave del recurso del elemento al que apunta.
`getThumbnail()`	`Blob`	Obtiene una imagen en miniatura para el archivo o `null` si no existe una miniatura.
`getUrl()`	`String`	Obtiene la URL que se puede usar para abrir `File` en una app de Google, como Drive o Documentos.
`getViewers()`	`User[]`	Obtiene la lista de lectores y comentaristas de este `File`.
`isShareableByEditors()`	`Boolean`	Determina si los usuarios con permisos de edición para `File` pueden hacer lo siguiente: compartir con otros usuarios ni cambiar los permisos.
`isStarred()`	`Boolean`	Determina si se destacó `File` en la unidad de Drive del usuario.
`isTrashed()`	`Boolean`	Determina si `File` está en la papelera de Drive del usuario.
`makeCopy()`	`File`	Crea una copia del archivo.
`makeCopy(destination)`	`File`	Crea una copia del archivo en el directorio de destino.
`makeCopy(name)`	`File`	Crea una copia del archivo y le asigna el nombre proporcionado.
`makeCopy(name, destination)`	`File`	Crea una copia del archivo en el directorio de destino y le asigna el nombre proporcionado.
`moveTo(destination)`	`File`	Mueve este elemento a la carpeta de destino proporcionada.
`removeCommenter(emailAddress)`	`File`	Quita al usuario determinado de la lista de comentaristas de `File`.
`removeCommenter(user)`	`File`	Quita al usuario determinado de la lista de comentaristas de `File`.
`removeEditor(emailAddress)`	`File`	Quita al usuario determinado de la lista de editores de `File`.
`removeEditor(user)`	`File`	Quita al usuario determinado de la lista de editores de `File`.
`removeViewer(emailAddress)`	`File`	Quita al usuario específico de la lista de lectores y comentaristas de `File`.
`removeViewer(user)`	`File`	Quita al usuario específico de la lista de lectores y comentaristas de `File`.
`revokePermissions(emailAddress)`	`File`	Revoca el acceso al `File` otorgado al usuario determinado.
`revokePermissions(user)`	`File`	Revoca el acceso al `File` otorgado al usuario determinado.
`setContent(content)`	`File`	Reemplaza el contenido del archivo con un reemplazo específico.
`setDescription(description)`	`File`	Establece la descripción del `File`.
`setName(name)`	`File`	Establece el nombre de `File`.
`setOwner(emailAddress)`	`File`	Cambia el propietario de `File`.
`setOwner(user)`	`File`	Cambia el propietario de `File`.
`setSecurityUpdateEnabled(enabled)`	`File`	Establece si `File` requiere una clave de recurso para acceder cuando es compartida mediante un vínculo.
`setShareableByEditors(shareable)`	`File`	Establece si los usuarios con permisos de edición en `File` pueden compartir contenido con otros usuarios o cambiar los permisos.
`setSharing(accessType, permissionType)`	`File`	Establece qué clase de usuarios puede acceder a `File` y qué permisos se otorgan esos usuarios, además de los usuarios individuales a los que se les otorgó acceso explícitamente.
`setStarred(starred)`	`File`	Establece si se destaca `File` en la unidad de Drive del usuario.
`setTrashed(trashed)`	`File`	Establece si el elemento `File` está en la papelera de Drive del usuario.

Documentación detallada

`addCommenter(emailAddress)`

Agrega el usuario específico a la lista de comentaristas de File. Si el usuario era que ya está en la lista de usuarios, este método asciende al usuario fuera de la lista de usuarios.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace 'cloudysanfrancisco@gmail.com' with the email address that you
// want to add as a commenter.
while (files.hasNext()) {
  const file = files.next();
  email = 'cloudysanfrancisco@gmail.com';
  console.log(file.addCommenter(email));
}

Parámetros

Nombre	Tipo	Descripción
`emailAddress`	`String`	La dirección de correo electrónico del usuario que se agregará.

Volver

File: Este File, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`addCommenter(user)`

Agrega el usuario específico a la lista de comentaristas de File. Si el usuario era que ya está en la lista de usuarios, este método asciende al usuario fuera de la lista de usuarios.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Adds the active user as a commenter.
while (files.hasNext()) {
  const file = files.next();
  file.addCommenter(Session.getActiveUser());
}

Parámetros

Nombre	Tipo	Descripción
`user`	`User`	Es una representación del usuario que se agregará.

Volver

File: Este File, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`addCommenters(emailAddresses)`

Agrega el array de usuarios determinado a la lista de comentaristas de File. Si corresponde de los usuarios ya estaban en la lista de usuarios, este método los hace desaparecer de la lista de usuarios.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

while (files.hasNext()) {
  const file = files.next();
  // TODO(developer): Replace 'cloudysanfrancisco@gmail.com' and
  // 'baklavainthebalkans@gmail.com' with the email addresses to add as commenters.
  const emails = ['cloudysanfrancisco@gmail.com','baklavainthebalkans@gmail.com'];
  console.log(file.addCommenters(emails));
}

Parámetros

Nombre	Tipo	Descripción
`emailAddresses`	`String[]`	Un array de direcciones de correo electrónico de los usuarios que se agregarán.

Volver

File: Este File, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`addEditor(emailAddress)`

Agrega el usuario determinado a la lista de editores de File. Si el usuario ya estaba en la lista de usuarios, este método asciende al usuario fuera de la lista de usuarios.

Parámetros

Nombre	Tipo	Descripción
`emailAddress`	`String`	La dirección de correo electrónico del usuario que se agregará.

Volver

File: Este File, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`addEditor(user)`

Agrega el usuario determinado a la lista de editores de File. Si el usuario ya estaba en la lista de usuarios, este método asciende al usuario fuera de la lista de usuarios.

Parámetros

Nombre	Tipo	Descripción
`user`	`User`	Es una representación del usuario que se agregará.

Volver

File: Este File, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`addEditors(emailAddresses)`

Agrega el array determinado de usuarios a la lista de editores de File. Si alguno de los usuarios ya estaban en la lista de usuarios; este método los hace desaparecer de la lista de usuarios.

Parámetros

Nombre	Tipo	Descripción
`emailAddresses`	`String[]`	Un array de direcciones de correo electrónico de los usuarios que se agregarán.

Volver

File: Este File, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`addViewer(emailAddress)`

Agrega el usuario determinado a la lista de lectores de File. Si el usuario ya estaba en la lista de editores, este método no tiene efecto.

Parámetros

Nombre	Tipo	Descripción
`emailAddress`	`String`	La dirección de correo electrónico del usuario que se agregará.

Volver

File: Este File, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`addViewer(user)`

Agrega el usuario determinado a la lista de lectores de File. Si el usuario ya estaba en la lista de editores, este método no tiene efecto.

Parámetros

Nombre	Tipo	Descripción
`user`	`User`	Es una representación del usuario que se agregará.

Volver

File: Este File, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`addViewers(emailAddresses)`

Agrega el array de usuarios determinado a la lista de visualizadores de File. Si alguno de los ya estaban en la lista de editores, este método no tiene efecto para ellos.

Parámetros

Nombre	Tipo	Descripción
`emailAddresses`	`String[]`	Un array de direcciones de correo electrónico de los usuarios que se agregarán.

Volver

File: Este File, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`getAccess(email)`

Obtiene el permiso otorgado al usuario determinado.

Parámetros

Nombre	Tipo	Descripción
`email`	`String`	La dirección de correo electrónico del usuario cuyos permisos deben verificarse

Volver

Permission: Son los permisos otorgados al usuario.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getAccess(user)`

Obtiene el permiso otorgado al usuario determinado.

Parámetros

Nombre	Tipo	Descripción
`user`	`User`	una representación del usuario cuyos permisos deben verificarse

Volver

Permission: Son los permisos otorgados al usuario.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getAs(contentType)`

Muestra los datos dentro de este objeto como un BLOB convertido al tipo de contenido especificado. Esta agrega la extensión adecuada al nombre del archivo, por ejemplo, "miarchivo.pdf". Sin embargo, supone que la parte del nombre de archivo que sigue al último punto (si corresponde) es una parte extensión que debe reemplazarse. Por lo tanto, "ShoppingList.12.25.2014" se convierte en “ShoppingList.12.25.pdf”.

Para ver las cuotas diarias de las conversiones, consulta Cuotas para Google Servicios Es posible que los dominios de Google Workspace recién creados estén sujetos temporalmente a restricciones y cuotas.

Parámetros

Nombre	Tipo	Descripción
`contentType`	`String`	El tipo de MIME en el que se convertirá. Para la mayoría de los BLOB, `'application/pdf'` es la única opción válida. En el caso de las imágenes en formato BMP, GIF, JPEG o PNG, también se aplica cualquiera de los siguientes valores: `'image/bmp'`, `'image/gif'`, `'image/jpeg'` o `'image/png'`. válido. `'text/markdown'` también es válido para Documentos de Google.

Volver

Blob: Los datos como un BLOB.

`getBlob()`

Muestra los datos dentro de este objeto como un BLOB.

Volver

Blob: Los datos como un BLOB.

`getDateCreated()`

Obtiene la fecha en que se creó el File.

Volver

Date: Es la fecha en que se creó el File.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getDescription()`

Obtiene la descripción del File.

Volver

String: Es la descripción de File.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getDownloadUrl()`

Obtiene la URL que se puede usar para descargar el archivo. Solo los usuarios con permiso para abrir el archivo de Google Drive pueden acceder a la URL. Puedes usar esta URL en un navegador para descargar el archivo, pero no puedes usar para recuperar el archivo con UrlFetchApp. Si quieres que el contenido de la en la secuencia de comandos, usa getBlob().

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files and logs the download URLs to the console.
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getDownloadUrl());
}

Volver

String: Es la URL que se puede usar para descargar el archivo.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getEditors()`

Obtiene la lista de editores de este File. Si el usuario que ejecuta la secuencia de comandos no tiene acceso de edición a File, este método muestra un array vacío.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Adds the email addresses in the array as editors of each file.
  // TODO(developer): Replace 'cloudysanfrancisco@gmail.com'
  // and 'baklavainthebalkans@gmail.com' with valid email addresses.
  file.addEditors(['cloudysanfrancisco@gmail.com', 'baklavainthebalkans@gmail.com']);

  // Gets a list of the file editors.
  const editors = file.getEditors();

  // For each file, logs the editors' email addresses to the console.
  for (const editor of editors) {
    console.log(editor.getEmail());
  }
}

Volver

User[]: Si el usuario tiene acceso de edición para este File, muestra la lista de editores. Si el usuario no tiene acceso de edición, muestra un array vacío.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getId()`

Obtiene el ID del File.

Volver

String: Es el ID de File.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getLastUpdated()`

Obtiene la fecha de la última actualización del File.

Volver

Date: Es la fecha en la que se actualizó el File por última vez.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getMimeType()`

Obtiene el tipo de MIME del archivo.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files and logs the MIME type to the console.
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getMimeType());
}

Volver

String: Es el tipo de MIME del archivo.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getName()`

Obtiene el nombre del File.

Volver

String: Es el nombre de File.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getOwner()`

Obtiene el propietario del archivo.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files and logs the names of the file owners to the console.
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getOwner().getName());
}

Volver

User: Es el propietario del archivo.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getParents()`

Obtiene una colección de carpetas que son elementos superiores inmediatos de File.

Volver

FolderIterator: Es una colección de carpetas que son elementos superiores inmediatos de File.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getResourceKey()`

Obtiene la clave de recurso del File que se requiere para acceder a los elementos que se compartieron mediante un vínculo.

Volver

String: Es la clave de recurso de File.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getSecurityUpdateEligible()`

Determina si este File es apto para aplicar la actualización de seguridad que requiere una clave de recurso para acceder cuando se comparte mediante un vínculo.

Drive requiere una clave de recurso para acceder a algunos archivos o carpetas que se compartieron con una enlace. Este cambio forma parte de una actualización de seguridad. La actualización está activada de forma predeterminada para archivos y carpetas. Para activar o desactivar el requisito de clave de recursos para los archivos aptos, usa setSecurityUpdateEnabled

Obtén más información sobre la Actualización de seguridad para Google Drive.

Volver

Boolean: Indica si el requisito de clave de recursos se puede aplicar para File.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getSecurityUpdateEnabled()`

Obtiene si este File requiere una clave de recurso para acceder cuando es compartida mediante un vínculo. Este requisito está activado de forma predeterminada para las carpetas y los archivos aptos. Para activar o desactivar el requisito de clave de recursos para los archivos aptos, usa setSecurityUpdateEnabled.

Obtén más información sobre la Actualización de seguridad para Google Drive.

Volver

Boolean: Indica si el requisito de clave de recursos está habilitado para este File.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getSharingAccess()`

Obtiene qué clase de usuarios puede acceder a File, además de cualquier usuario individual usuarios a los que se les otorgó acceso explícitamente.

Volver

Access: Indica qué clase de usuarios puede acceder a File.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getSharingPermission()`

Obtiene el permiso que se otorga a los usuarios que pueden acceder a File. además de los usuarios individuales a los que se les otorgó acceso explícito.

Volver

Permission: Son los permisos otorgados a los usuarios que pueden acceder a File.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getSize()`

Obtiene la cantidad de bytes usados para almacenar el File en Drive. Ten en cuenta que Los archivos de las aplicaciones de Google Workspace no se consideran en los límites de almacenamiento de Drive y, por lo tanto, se devuelven 0 bytes.

Volver

Integer: Es la cantidad de bytes que se usan para almacenar File en Drive.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getTargetId()`

Si se trata de un acceso directo, muestra el ID del elemento al que apunta.

De lo contrario, muestra null.

// The ID of the file for which to make a shortcut and the ID of
// the folder to which you want to add the shortcut.
// TODO(developer): Replace the file and folder IDs with your IDs.
const fileId = 'abc123456';
const folderId = 'xyz987654';

// Gets the folder to add the shortcut to.
const folder = DriveApp.getFolderById(folderId);

// Creates a shortcut of the file and moves it to the specified folder.
const shortcut = DriveApp.createShortcut(fileId).moveTo(folder);

// Logs the target ID of the shortcut.
console.log(`${shortcut.getName()}=${shortcut.getTargetId()}`);

Volver

String: Es el ID del elemento de destino.

`getTargetMimeType()`

Si se trata de un acceso directo, muestra el tipo de MIME del elemento al que apunta.

De lo contrario, muestra null.

// The ID of the file for which to make a shortcut and the ID of
// the folder to which you want to add the shortcut.
// TODO(developer): Replace the file and folder IDs with your IDs.
const fileId = 'abc123456';
const folderId = 'xyz987654';

// Gets the folder to add the shortcut to.
const folder = DriveApp.getFolderById(folderId);

// Creates a shortcut of the file and moves it to the specified folder.
const shortcut = DriveApp.createShortcut(fileId).moveTo(folder);

// Logs the MIME type of the file that the shortcut points to.
console.log(`MIME type of the shortcut: ${shortcut.getTargetMimeType()}`);

Volver

String: Es el tipo de MIME del elemento de destino.

`getTargetResourceKey()`

Si el archivo es una combinación de teclas, muestra la clave del recurso del elemento al que apunta. Una clave de recurso es un parámetro adicional que debes pasar para acceder a los archivos que se compartieron con un enlace.

Si el archivo no es un acceso directo, muestra null.

// Gets a file by its ID.
// TODO(developer): Replace 'abc123456' with your file ID.
const file = DriveApp.getFileById('abc123456');

// If the file is a shortcut, returns the resource key of the file that it points to.
console.log(file.getTargetResourceKey());

Volver

String: Es la clave de recurso del elemento de destino o null si el archivo no es un acceso directo.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getThumbnail()`

Obtiene una imagen en miniatura para el archivo o null si no existe una miniatura.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Logs the thumbnail image for each file to the console as a blob,
  // or null if no thumbnail exists.
  console.log(file.getThumbnail());
}

Volver

Blob: Es la imagen en miniatura del archivo.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getUrl()`

Obtiene la URL que se puede usar para abrir File en una app de Google, como Drive o Documentos.

Volver

String: Es la URL que se puede usar para ver este File en una app de Google, como Drive o Documentos

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getViewers()`

Obtiene la lista de lectores y comentaristas de este File. Si el usuario que ejecuta la secuencia de comandos no tiene acceso de edición a File, este método devuelve un array vacío.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // For each file, logs the viewers' email addresses to the console.
  const viewers = file.getViewers();
  for (viewer of viewers) {
    console.log(viewer.getEmail());
  }
}

Volver

User[]: Si el usuario tiene acceso de edición para este File, muestra la lista de de usuarios y comentaristas. Si el usuario no tiene acceso de edición, muestra un array vacío.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`isShareableByEditors()`

Determina si los usuarios con permisos de edición para File pueden hacer lo siguiente: compartir con otros usuarios ni cambiar los permisos.

Volver

Boolean: true si los usuarios con permisos de edición pueden compartir contenido con otros usuarios o cambiar los permisos false si no es así

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`isStarred()`

Determina si se destacó File en la unidad de Drive del usuario.

Volver

Boolean: Es true si la File está destacada en la unidad de Drive del usuario. false si no es así

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`isTrashed()`

Determina si File está en la papelera de Drive del usuario.

Volver

Boolean: true si File está en la papelera de Drive del usuario false si no es así

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`makeCopy()`

Crea una copia del archivo.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Creates a copy of each file and logs the file name to the console.
  console.log(file.makeCopy().getName());
}

Volver

File: Es la copia nueva.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`makeCopy(destination)`

Crea una copia del archivo en el directorio de destino.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Creates a copy of each file and adds it to the specified folder.
  // TODO(developer): Replace the folder ID with your own.
  const destination = DriveApp.getFolderById('123456abcxyz');
  const copiedFile = file.makeCopy(destination);

  // Logs the file names to the console.
  console.log(copiedFile.getName());
}

Parámetros

Nombre	Tipo	Descripción
`destination`	`Folder`	El directorio en el que se copiará el archivo.

Volver

File: Es la copia nueva.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`makeCopy(name)`

Crea una copia del archivo y le asigna el nombre proporcionado.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Creates a copy of each file and sets the name to 'Test-Copy.'
  const filename = file.makeCopy('Test-Copy');

  // Logs the copied file's name to the console.
  console.log(filename.getName());
}

Parámetros

Nombre	Tipo	Descripción
`name`	`String`	El nombre del archivo que se debe aplicar a la copia nueva.

Volver

File: Es la copia nueva.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`makeCopy(name, destination)`

Crea una copia del archivo en el directorio de destino y le asigna el nombre proporcionado.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Creates a copy of each file, sets the file name, and adds the copied file
  // to the specified folder.
  // TODO(developer): Replace the folder ID with your own.
  const destination = DriveApp.getFolderById('123456abcxyz');
  const copiedFile = file.makeCopy('Test-Copy', destination);

  // Logs the file names to the console.
  console.log(copiedFile.getName());
}

Parámetros

Nombre	Tipo	Descripción
`name`	`String`	El nombre del archivo que se debe aplicar a la copia nueva.
`destination`	`Folder`	El directorio en el que se copiará el archivo.

Volver

File: Es la copia nueva.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`moveTo(destination)`

Mueve este elemento a la carpeta de destino proporcionada.

El usuario actual debe ser el propietario del archivo o tener, al menos, acceso de edición al elemento carpeta superior actual para mover el elemento a la carpeta de destino.

Parámetros

Nombre	Tipo	Descripción
`destination`	`Folder`	La carpeta que se convierte en el nuevo elemento superior.

Volver

File: Este File, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`removeCommenter(emailAddress)`

Quita al usuario determinado de la lista de comentaristas de File. Este método no impide que los usuarios accedan a File si pertenecen a una clase de usuarios que tienen acceso general (por ejemplo, si el File se comparte con el dominio completo.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Removes the given user from the list of commenters for each file.
  // TODO(developer): Replace the email with the email of the user you want to remove.
  file.removeCommenter('cloudysanfrancisco@gmail.com');
}

Parámetros

Nombre	Tipo	Descripción
`emailAddress`	`String`	La dirección de correo electrónico del usuario que se quitará.

Volver

File: Este File, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`removeCommenter(user)`

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Removes the given user from the list of commenters for each file.
  console.log(file.removeCommenter(Session.getActiveUser()));
}

Parámetros

Nombre	Tipo	Descripción
`user`	`User`	Una representación del usuario que se quitará.

Volver

File: Este File, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`removeEditor(emailAddress)`

Quita al usuario determinado de la lista de editores de File. Este método no impedir que los usuarios accedan a File si pertenecen a una clase de usuarios que tienen Acceso general (por ejemplo, si el File se comparte con todo el dominio, o si File está en una unidad compartida a la que el usuario puede acceder.

En el caso de los archivos de Drive, también se quita al usuario de la lista de lectores.

Parámetros

Nombre	Tipo	Descripción
`emailAddress`	`String`	La dirección de correo electrónico del usuario que se quitará.

Volver

File: Este File, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`removeEditor(user)`

En el caso de los archivos de Drive, también se quita al usuario de la lista de lectores.

Parámetros

Nombre	Tipo	Descripción
`user`	`User`	Una representación del usuario que se quitará.

Volver

File: Este File, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`removeViewer(emailAddress)`

Quita al usuario específico de la lista de lectores y comentaristas de File. Esta no tiene efecto si el usuario es editor, no visualizador ni comentarista. Este método también no impida que los usuarios accedan a File si pertenecen a una clase de usuarios que tener acceso general (por ejemplo, si el File se comparte con la cuenta de usuario todo el dominio o si File está en una unidad compartida a la que el usuario puede acceder.

En el caso de los archivos de Drive, también se quita al usuario de la lista de editores.

Parámetros

Nombre	Tipo	Descripción
`emailAddress`	`String`	La dirección de correo electrónico del usuario que se quitará.

Volver

File: Indica este File para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`removeViewer(user)`

Quita al usuario específico de la lista de lectores y comentaristas de File. Esta no tiene efecto si el usuario es editor y no visualizador. Este método tampoco bloquea que los usuarios accedan a File si pertenecen a una clase de usuarios que tienen permisos generales (por ejemplo, si File se comparte con todo el dominio del usuario) Si File está en una unidad compartida a la que el usuario pueda acceder.

En el caso de los archivos de Drive, también se quita al usuario de la lista de editores.

Parámetros

Nombre	Tipo	Descripción
`user`	`User`	Una representación del usuario que se quitará.

Volver

File: Indica este File para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`revokePermissions(emailAddress)`

Revoca el acceso al File otorgado al usuario determinado. Este método no Impedir que los usuarios accedan a File si pertenecen a una clase de usuarios que tener acceso general (por ejemplo, si el File se comparte con el dominio completo.

Parámetros

Nombre	Tipo	Descripción
`emailAddress`	`String`	La dirección de correo electrónico del usuario cuyo acceso se debe revocar.

Volver

File: Este File, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`revokePermissions(user)`

Parámetros

Nombre	Tipo	Descripción
`user`	`User`	Una representación del usuario cuyo acceso se debe revocar.

Volver

File: Este File, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`setContent(content)`

Reemplaza el contenido del archivo con un reemplazo específico. Muestra una excepción si content supera los 10 MB.

// Creates a text file with the content 'Hello, world!'
file = DriveApp.createFile('New Text File', 'Hello, world!');

// Logs the content of the text file to the console.
console.log(file.getBlob().getDataAsString());

// Updates the content of the text file to 'Updated text!'
file.setContent('Updated text!')

// Logs content of the text file to the console.
console.log(file.getBlob().getDataAsString());

Parámetros

Nombre	Tipo	Descripción
`content`	`String`	El contenido nuevo del archivo.

Volver

File: Este File, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`setDescription(description)`

Establece la descripción del File.

Parámetros

Nombre	Tipo	Descripción
`description`	`String`	la nueva descripción de `File`

Volver

File: este File, para encadenamiento

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`setName(name)`

Establece el nombre de File.

Parámetros

Nombre	Tipo	Descripción
`name`	`String`	el nombre nuevo de `File`

Volver

File: este File, para encadenamiento

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`setOwner(emailAddress)`

Cambia el propietario de File. Este método también le otorga al propietario anterior acceso de edición explícito a File.

Parámetros

Nombre	Tipo	Descripción
`emailAddress`	`String`	la dirección de correo electrónico del usuario que debería convertirse en el nuevo propietario

Volver

File: este File, para encadenamiento

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`setOwner(user)`

Cambia el propietario de File. Este método también le otorga al propietario anterior acceso de edición explícito a File.

Parámetros

Nombre	Tipo	Descripción
`user`	`User`	una representación del usuario que debería convertirse en el nuevo propietario

Volver

File: este File, para encadenamiento

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`setSecurityUpdateEnabled(enabled)`

Establece si File requiere una clave de recurso para acceder cuando es compartida mediante un vínculo. Los archivos y las carpetas aptos están habilitados de forma predeterminada.

Obtén más información sobre la Actualización de seguridad para Google Drive.

Parámetros

Nombre	Tipo	Descripción
`enabled`	`Boolean`	Establece si se habilita el requisito de clave de recursos para `File`.

Volver

File: Este File, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`setShareableByEditors(shareable)`

Establece si los usuarios con permisos de edición en File pueden compartir contenido con otros usuarios o cambiar los permisos. El valor predeterminado de un objeto File nuevo es true

Parámetros

Nombre	Tipo	Descripción
`shareable`	`Boolean`	`true` si los usuarios con permisos de edición deben poder compartir contenido con otros usuarios o cambiar los permisos `false` si no es así

Volver

File: este File, para encadenamiento

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`setSharing(accessType, permissionType)`

Establece qué clase de usuarios puede acceder a File y qué permisos se otorgan esos usuarios, además de los usuarios individuales a los que se les otorgó acceso explícitamente.

// Creates a folder that anyone on the Internet can read from and write to. (Domain
// administrators can prohibit this setting for users of a Google Workspace domain.)
var folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

Parámetros

Nombre	Tipo	Descripción
`accessType`	`Access`	qué clase de usuarios debería poder acceder a `File`
`permissionType`	`Permission`	los permisos que se deben otorgar a los usuarios que pueden acceder a `File`

Volver

File: este File, para encadenamiento

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`setStarred(starred)`

Establece si se destaca File en la unidad de Drive del usuario. La configuración predeterminada los nuevos File son false.

Parámetros

Nombre	Tipo	Descripción
`starred`	`Boolean`	`true` si el `File` debe destacarse en el Drive; `false` si no es así

Volver

File: este File, para encadenamiento

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive

`setTrashed(trashed)`

Establece si el elemento File está en la papelera de Drive del usuario. Solo los el propietario puede enviar File a la papelera. El valor predeterminado para File nuevos es false.

Parámetros

Nombre	Tipo	Descripción
`trashed`	`Boolean`	`true` si se debe mover `File` a la papelera de la unidad de Drive del usuario; `false` si no es así

Volver

File: este File, para encadenamiento

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

https://www.googleapis.com/auth/drive