Un archivo en Google Drive Se puede acceder a los archivos o crearlos desde Drive.
// Trash every untitled spreadsheet that hasn't been updated in a week. const files = DriveApp.getFilesByName('Untitled spreadsheet'); while (files.hasNext()) { const 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 |
|---|---|---|
add | File | Agrega el usuario determinado a la lista de comentaristas del File. |
add | File | Agrega el usuario determinado a la lista de comentaristas del File. |
add | File | Agrega el array de usuarios proporcionado a la lista de comentaristas del File. |
add | File | Agrega el usuario especificado a la lista de editores del File. |
add | File | Agrega el usuario especificado a la lista de editores del File. |
add | File | Agrega el array de usuarios proporcionado a la lista de editores del File. |
add | File | Agrega el usuario determinado a la lista de usuarios que pueden ver el File. |
add | File | Agrega el usuario determinado a la lista de usuarios que pueden ver el File. |
add | File | Agrega el array de usuarios proporcionado a la lista de usuarios que pueden ver el File. |
get | Permission | Obtiene el permiso otorgado a un usuario específico. |
get | Permission | Obtiene el permiso otorgado a un usuario específico. |
get | Blob | Devuelve los datos dentro de este objeto como un blob convertido al tipo de contenido especificado. |
get | Blob | Devuelve los datos dentro de este objeto como un blob. |
get | Date | Obtiene la fecha en que se creó el objeto File. |
get | String | Obtiene la descripción del File. |
get | String | Obtiene la URL que se puede usar para descargar el archivo. |
get | User[] | Obtiene la lista de editores de este File. |
get | String | Obtiene el ID del File. |
get | Date | Obtiene la fecha en que se actualizó por última vez el objeto File. |
get | String | Obtiene el tipo de MIME del archivo. |
get | String | Obtiene el nombre del File. |
get | User | Obtiene el propietario del archivo. |
get | Folder | Obtiene una colección de carpetas que son superiores inmediatas del File. |
get | String | Obtiene la clave de recurso del File que se requiere para acceder a los elementos que se compartieron con un vínculo. |
get | Boolean | Obtiene si este File es apto para aplicar la actualización de seguridad que requiere una clave de recurso para acceder cuando se comparte con un vínculo. |
get | Boolean | Indica si este File requiere una clave de recurso para acceder a él cuando se comparte a través de un vínculo. |
get | Access | Obtiene la clase de usuarios que pueden acceder al File, además de los usuarios individuales a los que se les otorgó acceso de forma explícita. |
get | Permission | Obtiene el permiso otorgado a los usuarios que pueden acceder a File, además de los usuarios individuales a los que se les otorgó acceso de forma explícita. |
get | Integer | Obtiene la cantidad de bytes que se usan para almacenar el objeto File en Drive. |
get | String | Si se trata de un acceso directo, devuelve el ID del elemento al que apunta. |
get | String | Si se trata de un acceso directo, devuelve el tipo de MIME del elemento al que apunta. |
get | String | Si el archivo es un acceso directo, devuelve la clave de recurso del elemento al que apunta. |
get | Blob|null | Obtiene una imagen en miniatura del archivo o null si no existe ninguna miniatura. |
get | String | Obtiene la URL que se puede usar para abrir el objeto File en una app de Google, como Drive o Documentos. |
get | User[] | Obtiene la lista de lectores y comentaristas de este File. |
is | Boolean | Determina si los usuarios con permisos de edición para el File pueden compartirlo con otros usuarios o cambiar los permisos. |
is | Boolean | Determina si el File se marcó como destacado en el Drive del usuario. |
is | Boolean | Determina si el elemento File está en la papelera de la unidad del usuario. |
make | File | Crea una copia del archivo. |
make | File | Crea una copia del archivo en el directorio de destino. |
make | File | Crea una copia del archivo y le asigna el nombre proporcionado. |
make | File | Crea una copia del archivo en el directorio de destino y le asigna el nombre proporcionado. |
move | File | Mueve este elemento a la carpeta de destino proporcionada. |
remove | File | Quita al usuario determinado de la lista de comentaristas del File. |
remove | File | Quita al usuario determinado de la lista de comentaristas del File. |
remove | File | Quita al usuario especificado de la lista de editores del File. |
remove | File | Quita al usuario especificado de la lista de editores del File. |
remove | File | Quita al usuario determinado de la lista de usuarios que pueden ver y comentar el File. |
remove | File | Quita al usuario determinado de la lista de usuarios que pueden ver y comentar el File. |
revoke | File | Revoca el acceso a File que se otorgó al usuario determinado. |
revoke | File | Revoca el acceso a File que se otorgó al usuario determinado. |
set | File | Reemplaza el contenido del archivo por un reemplazo determinado. |
set | File | Establece la descripción del File. |
set | File | Establece el nombre del File. |
set | File | Cambia el propietario de File. |
set | File | Cambia el propietario de File. |
set | File | Establece si File requiere una clave de recurso para acceder cuando se comparte a través de un vínculo. |
set | File | Establece si los usuarios con permisos de edición para el File pueden compartirlo con otros usuarios o cambiar los permisos. |
set | File | Establece qué clase de usuarios puede acceder a File y qué permisos se les otorgan, además de los usuarios individuales a los que se les otorgó acceso de forma explícita. |
set | File | Establece si el File se destaca en la unidad del usuario. |
set | File | Establece si el elemento File está en la papelera de la unidad del usuario. |
Documentación detallada
add Commenter(emailAddress)
Agrega el usuario determinado a la lista de comentaristas del File. Si el usuario ya estaba en la lista de usuarios con permiso de visualización, este método lo quita de ella.
const files = DriveApp.getFilesByName('Test'); // Loops through the files while (files.hasNext()) { const file = files.next(); file.addCommenter('hello@example.com'); }
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
email | String | Es 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
add Commenter(user)
Agrega el usuario determinado a la lista de comentaristas del File. Si el usuario ya estaba en la lista de usuarios con permiso de visualización, este método lo quita de ella.
// 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
add Commenters(emailAddresses)
Agrega el array de usuarios proporcionado a la lista de comentaristas del File. Si alguno de los usuarios ya estaba en la lista de visualizadores, este método lo quita de ella.
// 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 |
|---|---|---|
email | String[] | Es 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
add Editor(emailAddress)
Agrega el usuario especificado a la lista de editores del File. Si el usuario ya estaba en la lista de usuarios, este método lo promueve fuera de ella.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
email | String | Es 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
add Editor(user)
Agrega el usuario especificado a la lista de editores del File. Si el usuario ya estaba en la lista de usuarios, este método lo promueve fuera de ella.
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
add Editors(emailAddresses)
Agrega el array de usuarios proporcionado a la lista de editores del File. Si alguno de los usuarios ya estaba en la lista de usuarios con acceso, este método los quita de ella.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
email | String[] | Es 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
add Viewer(emailAddress)
Agrega el usuario determinado a la lista de usuarios que pueden ver el File. Si el usuario ya estaba en la lista de editores, este método no tiene efecto.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
email | String | Es 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
add Viewer(user)
Agrega el usuario determinado a la lista de usuarios que pueden ver el 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
add Viewers(emailAddresses)
Agrega el array de usuarios proporcionado a la lista de usuarios que pueden ver el File. Si alguno de los usuarios ya estaba en la lista de editores, este método no tendrá efecto en ellos.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
email | String[] | Es 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
get Access(email)
Obtiene el permiso otorgado a un usuario específico. El método no admite la devolución de permisos para un Grupo de Google ni los permisos heredados a través de Grupos de Google.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
email | String | Es la dirección de correo electrónico del usuario cuyos permisos se deben verificar. No se admiten los Grupos de Google. |
Volver
Permission: Son los permisos que se otorgan 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
get Access(user)
Obtiene el permiso otorgado a un usuario específico. El método no admite la devolución de permisos para un Grupo de Google ni los permisos heredados a través de Grupos de Google.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
user | User | Es una representación del usuario cuyos permisos se deben verificar. |
Volver
Permission: Son los permisos que se otorgan 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
get As(contentType)
Devuelve los datos dentro de este objeto como un blob convertido al tipo de contenido especificado. Este método 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 hay alguno) es una extensión existente que se debe reemplazar. Por lo tanto, "ShoppingList.12.25.2014" se convierte en "ShoppingList.12.25.pdf".
Para ver las cuotas diarias de conversiones, consulta Cuotas para los servicios de Google. Es posible que los dominios de Google Workspace recién creados estén sujetos temporalmente a cuotas más estrictas.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
content | String | Es el tipo de MIME al que se convertirá el archivo. Para la mayoría de los BLOBs, 'application/pdf' es la única opción válida. Para las imágenes en formato BMP, GIF, JPEG o PNG, también son válidos cualquiera de los valores 'image/bmp', 'image/gif', 'image/jpeg' o 'image/png'. En el caso de un documento de Documentos de Google, 'text/markdown' también es válido. |
Volver
Blob: Los datos como un BLOB.
get Blob()
get Date Created()
Obtiene la fecha en que se creó el objeto File.
Volver
Date: Es la fecha en la 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
get Description()
get Download Url()
Obtiene la URL que se puede usar para descargar el archivo. Solo los usuarios con permiso para abrir el archivo en Google Drive pueden acceder a la URL. Puedes usar esta URL en un navegador para descargar el archivo, pero no puedes usarla para recuperarlo con Url. Si quieres que el contenido del archivo esté en la secuencia de comandos, usa get.
// 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
get Editors()
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 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(); // 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, devuelve la lista de editores. Si el usuario no tiene acceso de edición, se 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
get Id()
get Last Updated()
Obtiene la fecha en que se actualizó por última vez el objeto 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
get Mime Type()
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
get Name()
get Owner()
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
get Parents()
Obtiene una colección de carpetas que son superiores inmediatas del File.
Volver
Folder: Es una colección de carpetas que son las carpetas superiores inmediatas del 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
get Resource Key()
Obtiene la clave de recurso del File que se requiere para acceder a los elementos que se compartieron con un vínculo.
Volver
String: Es la clave del 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
get Security Update Eligible()
Obtiene si este File es apto para aplicar la actualización de seguridad que requiere una clave de recurso para acceder cuando se comparte con un vínculo.
Drive requiere una clave de recurso para acceder a algunos archivos o carpetas que se compartieron con un vínculo. Este cambio forma parte de una actualización de seguridad. La actualización está activada de forma predeterminada para los archivos y las carpetas aptos. Para activar o desactivar el requisito de clave de recurso para los archivos aptos, usa set.
Obtén más información sobre la actualización de seguridad para compartir archivos de Google Drive.
Volver
Boolean: Indica si se puede aplicar el requisito de clave de recurso 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
get Security Update Enabled()
Indica si este File requiere una clave de recurso para acceder a él cuando se comparte a través de un vínculo. Este requisito está activado de forma predeterminada para los archivos y las carpetas aptos.
Para activar o desactivar el requisito de clave de recurso para los archivos aptos, usa
setSecurityUpdateEnabled.
Obtén más información sobre la actualización de seguridad para compartir archivos de Google Drive.
Volver
Boolean: Indica si el requisito de clave de recurso 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
get Sharing Access()
Obtiene la clase de usuarios que pueden acceder al File, además de los usuarios individuales a los que se les otorgó acceso de forma explícita.
Volver
Access: 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
get Sharing Permission()
Obtiene el permiso otorgado a los usuarios que pueden acceder a File, además de los usuarios individuales a los que se les otorgó acceso de forma explícita.
Volver
Permission: Son los permisos que se otorgan 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
get Size()
Obtiene la cantidad de bytes que se usan para almacenar el objeto File en Drive. Ten en cuenta que los archivos de aplicaciones de Google Workspace no se incluyen en los límites de almacenamiento de Drive y, por lo tanto, devuelven 0 bytes.
Volver
Integer: Es la cantidad de bytes que se usan para almacenar el objeto 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
get Target Id()
Si se trata de un acceso directo, devuelve el ID del elemento al que apunta.
De lo contrario, devuelve 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 artículo objetivo.
get Target Mime Type()
Si se trata de un acceso directo, devuelve el tipo de MIME del elemento al que apunta.
De lo contrario, devuelve 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.
get Target Resource Key()
Si el archivo es un acceso directo, devuelve la clave de 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 a través de un vínculo.
Si el archivo no es un acceso directo, se 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
get Thumbnail()
Obtiene una imagen en miniatura del archivo o null si no existe ninguna 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|null: 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
get Url()
Obtiene la URL que se puede usar para abrir el objeto 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
get Viewers()
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 al objeto 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 (const viewer of viewers) { console.log(viewer.getEmail()); } }
Volver
User[]: Si el usuario tiene acceso de edición para este File, devuelve la lista de lectores y comentaristas. Si el usuario no tiene acceso de edición, se 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
is Starred()
Determina si el File se marcó como destacado en el Drive del usuario.
Volver
Boolean: true si el elemento File se destaca 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
is Trashed()
Determina si el elemento File está en la papelera de la unidad del usuario.
Volver
Boolean: true si el File está en la papelera del 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
make Copy()
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
make Copy(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 | Es 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
make Copy(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 | Es el nombre de 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
make Copy(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 | Es el nombre de archivo que se debe aplicar a la copia nueva. |
destination | Folder | Es 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
move To(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 a la carpeta principal actual del elemento para moverlo a la carpeta de destino.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
destination | Folder | Es la carpeta que se convierte en la nueva carpeta 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
remove Commenter(emailAddress)
Quita al usuario determinado de la lista de comentaristas del 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 todo el dominio del usuario.
// 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 |
|---|---|---|
email | String | Es 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
remove Commenter(user)
Quita al usuario determinado de la lista de comentaristas del 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 todo el dominio del usuario.
// 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 | Es 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
remove Editor(emailAddress)
Quita al usuario especificado de la lista de editores del File. Este método no impide que los usuarios accedan al File si pertenecen a una clase de usuarios que tienen acceso general, por ejemplo, si el File se comparte con todo el dominio del usuario o si el File está en una unidad compartida a la que el usuario puede acceder.
En el caso de los archivos de Drive, esta acción también quita al usuario de la lista de visualizadores.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
email | String | Es 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
remove Editor(user)
Quita al usuario especificado de la lista de editores del File. Este método no impide que los usuarios accedan al File si pertenecen a una clase de usuarios que tienen acceso general, por ejemplo, si el File se comparte con todo el dominio del usuario o si el File está en una unidad compartida a la que el usuario puede acceder.
En el caso de los archivos de Drive, esta acción también quita al usuario de la lista de visualizadores.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
user | User | Es 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
remove Viewer(emailAddress)
Quita al usuario determinado de la lista de usuarios que pueden ver y comentar el File. Este método no tiene efecto si el usuario es editor, no visualizador ni comentarista. Este método tampoco impide que los usuarios accedan al File si pertenecen a una clase de usuarios que tienen acceso general, por ejemplo, si el File se comparte con todo el dominio del usuario o si el File se encuentra 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 |
|---|---|---|
email | String | Es la dirección de correo electrónico del usuario que se quitará. |
Volver
File: Es 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
remove Viewer(user)
Quita al usuario determinado de la lista de usuarios que pueden ver y comentar el File. Este método no tiene efecto si el usuario es editor y no visualizador. Este método tampoco impide que los usuarios accedan al File si pertenecen a una clase de usuarios que tienen acceso general, por ejemplo, si el File se comparte con todo el dominio del usuario o si el File se encuentra 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 |
|---|---|---|
user | User | Es una representación del usuario que se quitará. |
Volver
File: Es 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
revoke Permissions(emailAddress)
Revoca el acceso a File que se otorgó al usuario determinado. 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 todo el dominio del usuario.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
email | String | Es 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
revoke Permissions(user)
Revoca el acceso a File que se otorgó al usuario determinado. 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 todo el dominio del usuario.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
user | User | Es 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
set Content(content)
Reemplaza el contenido del archivo por un reemplazo determinado. Arroja una excepción si content es mayor que 10 MB.
// Creates a text file with the content 'Hello, world!' const 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 | Es 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
set Description(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 encadenar
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
set Name(name)
Establece el nombre del File.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
name | String | El nombre nuevo del File |
Volver
File: Este File, para encadenar
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
set Owner(emailAddress)
Cambia el propietario de File. Este método también otorga al propietario anterior acceso explícito de edición al File.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
email | String | La dirección de correo electrónico del usuario que debería convertirse en el nuevo propietario |
Volver
File: Este File, para encadenar
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
set Owner(user)
Cambia el propietario de File. Este método también otorga al propietario anterior acceso explícito de edición al 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 encadenar
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
set Security Update Enabled(enabled)
Establece si File requiere una clave de recurso para acceder cuando se comparte a través de 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 compartir archivos de Google Drive.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
enabled | Boolean | Indica si se debe habilitar el requisito de clave de recurso 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
set Sharing(accessType, permissionType)
Establece qué clase de usuarios puede acceder a File y qué permisos se les otorgan, además de los usuarios individuales a los que se les otorgó acceso de forma explícita.
// 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.) const folder = DriveApp.createFolder('Shared Folder'); folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
access | Access | qué clase de usuarios debería poder acceder a File |
permission | Permission | Los permisos que se deben otorgar a los usuarios que pueden acceder a File |
Volver
File: Este File, para encadenar
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
set Starred(starred)
Establece si el File se destaca en la unidad del usuario. El valor predeterminado para los File nuevos es false.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
starred | Boolean | true si el File debe destacarse en la unidad de Drive del usuario; false si no |
Volver
File: Este File, para encadenar
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
set Trashed(trashed)
Establece si el elemento File está en la papelera de la unidad del usuario. Solo el propietario puede enviar el File a la papelera. El valor predeterminado para los File nuevos es false.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
trashed | Boolean | true si el File se debe mover a la papelera de la unidad de Drive del usuario; false si no |
Volver
File: Este File, para encadenar
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