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

Drive Service

Este servicio permite que las secuencias de comandos creen, busquen y modifiquen archivos y carpetas en Google Drive. Si bien el servicio de Drive integrado es más fácil de usar, tiene algunas limitaciones. Para acceder a las funciones y la asistencia más recientes, y para acceder a archivos o carpetas en unidades compartidas, usa el servicio avanzado de Drive.

Si tu secuencia de comandos usa un proyecto de Cloud estándar en lugar de un proyecto de Cloud predeterminado, debes activar la API de Drive de forma manual. En tu proyecto estándar de Cloud, activa la API de Drive:

Activa la API de Drive

En la siguiente muestra de código, se muestra cómo registrar los nombres de cada archivo en la carpeta Mi unidad del usuario:

// Logs the name of every file in the user's Drive.
var files = DriveApp.getFiles();
while (files.hasNext()) {
  var file = files.next();
  console.log(file.getName());
}

Nota: Los administradores de Google Workspace pueden desactivar el SDK de Drive para su dominio, lo que impide que los usuarios instalen y usen las apps de Google Drive. Este parámetro de configuración también impide que los usuarios usen secuencias de comandos de Apps Script, apps web y complementos que usen el servicio de Drive o el servicio avanzado de Drive (incluso si el complemento o la app web se instalaron antes de que el administrador desactivara el SDK de Drive).

Sin embargo, si se publica un complemento que usa el servicio de Drive para la instalación en todo el dominio y el administrador lo instala para algunos o todos los usuarios del dominio, o bien si se publica cualquier secuencia de comandos que el administrador del dominio haya incluido en la lista de entidades permitidas del cliente de OAuth, el complemento funcionará para esos usuarios incluso si el SDK de Drive está desactivado en el dominio.

Clases

Nombre	Descripción breve
`Access`	Es una enumeración que representa las clases de usuarios que pueden acceder a un archivo o una carpeta, además de los usuarios individuales a los que se les otorgó acceso de forma explícita.
`DriveApp`	Permite que las secuencias de comandos creen, encuentren y modifiquen archivos y carpetas en Google Drive.
`File`	Un archivo en Google Drive
`FileIterator`	Es un iterador que permite que las secuencias de comandos iteren en una colección de archivos potencialmente grande.
`Folder`	Es una carpeta en Google Drive.
`FolderIterator`	Es un objeto que permite que las secuencias de comandos iteren en una colección de carpetas potencialmente grande.
`Permission`	Es una enumeración que representa los permisos otorgados a los usuarios que pueden acceder a un archivo o una carpeta, además de los usuarios individuales a los que se les otorgó acceso de forma explícita.
`User`	Es un usuario asociado a un archivo en Google Drive.

`Access`

Propiedades

Propiedad	Tipo	Descripción
`ANYONE`	`Enum`	Cualquier persona en Internet puede encontrarlo y acceder a él.
`ANYONE_WITH_LINK`	`Enum`	Cualquier persona que tenga el vínculo puede acceder al elemento.
`DOMAIN`	`Enum`	Las personas de tu dominio pueden encontrarlo y acceder a él.
`DOMAIN_WITH_LINK`	`Enum`	Pueden acceder las personas de tu dominio que tengan el vínculo.
`PRIVATE`	`Enum`	Solo pueden acceder las personas a las que se les otorgó el permiso explícito.

`DriveApp`

Propiedades

Propiedad	Tipo	Descripción
`Access`	`Access`	Es una enumeración que representa las clases de usuarios que pueden acceder a un archivo o una carpeta, además de los usuarios individuales a los que se les otorgó acceso de forma explícita.
`Permission`	`Permission`	Es una enumeración que representa los permisos otorgados a los usuarios que pueden acceder a un archivo o una carpeta, además de los usuarios individuales a los que se les otorgó acceso de forma explícita.

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`continueFileIterator(continuationToken)`	`FileIterator`	Reanuda una iteración de archivos con un token de continuación de un iterador anterior.
`continueFolderIterator(continuationToken)`	`FolderIterator`	Reanuda la iteración de una carpeta con un token de continuación de un iterador anterior.
`createFile(blob)`	`File`	Crea un archivo en la raíz de la unidad de Drive del usuario a partir de un `Blob` determinado de datos arbitrarios.
`createFile(name, content)`	`File`	Crea un archivo de texto en la raíz de la unidad del usuario con el nombre y el contenido especificados.
`createFile(name, content, mimeType)`	`File`	Crea un archivo en la raíz de la unidad del usuario con el nombre, el contenido y el tipo de MIME proporcionados.
`createFolder(name)`	`Folder`	Crea una carpeta en la raíz de la unidad de Drive del usuario con el nombre proporcionado.
`createShortcut(targetId)`	`File`	Crea un acceso directo al ID del elemento de Drive proporcionado y lo devuelve.
`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`	`File`	Crea un acceso directo al ID del elemento de Drive y a la clave de recurso proporcionados, y lo devuelve.
`enforceSingleParent(value)`	`void`	Habilita o inhabilita el comportamiento de enforceSingleParent para todas las llamadas que afectan a los elementos superiores.
`getFileById(id)`	`File`	Obtiene el archivo con el ID determinado.
`getFileByIdAndResourceKey(id, resourceKey)`	`File`	Obtiene el archivo con el ID y la clave de recurso determinados.
`getFiles()`	`FileIterator`	Obtiene una colección de todos los archivos en el Drive del usuario.
`getFilesByName(name)`	`FileIterator`	Obtiene una colección de todos los archivos de la unidad de Drive del usuario que tienen el nombre determinado.
`getFilesByType(mimeType)`	`FileIterator`	Obtiene una colección de todos los archivos de la unidad del usuario que tienen el tipo de MIME determinado.
`getFolderById(id)`	`Folder`	Obtiene la carpeta con el ID determinado.
`getFolderByIdAndResourceKey(id, resourceKey)`	`Folder`	Obtiene la carpeta con el ID y la clave de recurso determinados.
`getFolders()`	`FolderIterator`	Obtiene una colección de todas las carpetas en la unidad de Drive del usuario.
`getFoldersByName(name)`	`FolderIterator`	Obtiene una colección de todas las carpetas del Drive del usuario que tienen el nombre determinado.
`getRootFolder()`	`Folder`	Obtiene la carpeta raíz de la unidad de Drive del usuario.
`getStorageLimit()`	`Integer`	Obtiene la cantidad de bytes que el usuario puede almacenar en Drive.
`getStorageUsed()`	`Integer`	Obtiene la cantidad de bytes que el usuario almacena actualmente en Drive.
`getTrashedFiles()`	`FileIterator`	Obtiene una colección de todos los archivos de la papelera del Drive del usuario.
`getTrashedFolders()`	`FolderIterator`	Obtiene una colección de todas las carpetas de la papelera de la unidad de Drive del usuario.
`searchFiles(params)`	`FileIterator`	Obtiene una colección de todos los archivos en la unidad del usuario que coinciden con los criterios de búsqueda proporcionados.
`searchFolders(params)`	`FolderIterator`	Obtiene una colección de todas las carpetas en la unidad del usuario que coinciden con los criterios de búsqueda proporcionados.

`File`

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`addCommenter(emailAddress)`	`File`	Agrega el usuario determinado a la lista de comentaristas del `File`.
`addCommenter(user)`	`File`	Agrega el usuario determinado a la lista de comentaristas del `File`.
`addCommenters(emailAddresses)`	`File`	Agrega el array de usuarios proporcionado a la lista de comentaristas del `File`.
`addEditor(emailAddress)`	`File`	Agrega el usuario especificado a la lista de editores del `File`.
`addEditor(user)`	`File`	Agrega el usuario especificado a la lista de editores del `File`.
`addEditors(emailAddresses)`	`File`	Agrega el array de usuarios proporcionado a la lista de editores del `File`.
`addViewer(emailAddress)`	`File`	Agrega el usuario determinado a la lista de usuarios que pueden ver el `File`.
`addViewer(user)`	`File`	Agrega el usuario determinado a la lista de usuarios que pueden ver el `File`.
`addViewers(emailAddresses)`	`File`	Agrega el array de usuarios proporcionado a la lista de usuarios que pueden ver el `File`.
`getAccess(email)`	`Permission`	Obtiene el permiso otorgado a un usuario específico.
`getAccess(user)`	`Permission`	Obtiene el permiso otorgado a un usuario específico.
`getAs(contentType)`	`Blob`	Devuelve los datos dentro de este objeto como un blob convertido al tipo de contenido especificado.
`getBlob()`	`Blob`	Devuelve los datos dentro de este objeto como un blob.
`getDateCreated()`	`Date`	Obtiene la fecha en que se creó el objeto `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 en que se actualizó por última vez el objeto `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 superiores inmediatas del `File`.
`getResourceKey()`	`String`	Obtiene la clave de recurso del `File` que se requiere para acceder a los elementos que se compartieron con un vínculo.
`getSecurityUpdateEligible()`	`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.
`getSecurityUpdateEnabled()`	`Boolean`	Indica si este `File` requiere una clave de recurso para acceder a él cuando se comparte a través de un vínculo.
`getSharingAccess()`	`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.
`getSharingPermission()`	`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.
`getSize()`	`Integer`	Obtiene la cantidad de bytes que se usan para almacenar el objeto `File` en Drive.
`getTargetId()`	`String`	Si se trata de un acceso directo, devuelve el ID del elemento al que apunta.
`getTargetMimeType()`	`String`	Si se trata de un acceso directo, devuelve el tipo de MIME del elemento al que apunta.
`getTargetResourceKey()`	`String`	Si el archivo es un acceso directo, devuelve la clave de recurso del elemento al que apunta.
`getThumbnail()`	`Blob\|null`	Obtiene una imagen en miniatura del archivo o `null` si no existe ninguna miniatura.
`getUrl()`	`String`	Obtiene la URL que se puede usar para abrir el objeto `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 el `File` pueden compartirlo con otros usuarios o cambiar los permisos.
`isStarred()`	`Boolean`	Determina si el `File` se marcó como destacado en el Drive del usuario.
`isTrashed()`	`Boolean`	Determina si el elemento `File` está en la papelera de la unidad 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 del `File`.
`removeCommenter(user)`	`File`	Quita al usuario determinado de la lista de comentaristas del `File`.
`removeEditor(emailAddress)`	`File`	Quita al usuario especificado de la lista de editores del `File`.
`removeEditor(user)`	`File`	Quita al usuario especificado de la lista de editores del `File`.
`removeViewer(emailAddress)`	`File`	Quita al usuario determinado de la lista de usuarios que pueden ver y comentar el `File`.
`removeViewer(user)`	`File`	Quita al usuario determinado de la lista de usuarios que pueden ver y comentar el `File`.
`revokePermissions(emailAddress)`	`File`	Revoca el acceso a `File` que se otorgó al usuario determinado.
`revokePermissions(user)`	`File`	Revoca el acceso a `File` que se otorgó al usuario determinado.
`setContent(content)`	`File`	Reemplaza el contenido del archivo por un reemplazo determinado.
`setDescription(description)`	`File`	Establece la descripción del `File`.
`setName(name)`	`File`	Establece el nombre del `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 se comparte a través de un vínculo.
`setShareableByEditors(shareable)`	`File`	Establece si los usuarios con permisos de edición para el `File` pueden compartirlo con otros usuarios o cambiar los permisos.
`setSharing(accessType, permissionType)`	`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.
`setStarred(starred)`	`File`	Establece si el `File` se destaca en la unidad del usuario.
`setTrashed(trashed)`	`File`	Establece si el elemento `File` está en la papelera de la unidad del usuario.

`FileIterator`

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`getContinuationToken()`	`String`	Obtiene un token que se puede usar para reanudar esta iteración más adelante.
`hasNext()`	`Boolean`	Determina si llamar a `next()` devolverá un elemento.
`next()`	`File`	Obtiene el siguiente elemento de la colección de archivos o carpetas.

`Folder`

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`addEditor(emailAddress)`	`Folder`	Agrega el usuario especificado a la lista de editores del `Folder`.
`addEditor(user)`	`Folder`	Agrega el usuario especificado a la lista de editores del `Folder`.
`addEditors(emailAddresses)`	`Folder`	Agrega el array de usuarios proporcionado a la lista de editores del `Folder`.
`addViewer(emailAddress)`	`Folder`	Agrega el usuario determinado a la lista de usuarios que pueden ver el `Folder`.
`addViewer(user)`	`Folder`	Agrega el usuario determinado a la lista de usuarios que pueden ver el `Folder`.
`addViewers(emailAddresses)`	`Folder`	Agrega el array de usuarios proporcionado a la lista de usuarios que pueden ver el `Folder`.
`createFile(blob)`	`File`	Crea un archivo en la carpeta actual a partir de un `Blob` determinado de datos arbitrarios.
`createFile(name, content)`	`File`	Crea un archivo de texto en la carpeta actual con el nombre y el contenido especificados.
`createFile(name, content, mimeType)`	`File`	Crea un archivo en la carpeta actual con el nombre, el contenido y el tipo de MIME especificados.
`createFolder(name)`	`Folder`	Crea una carpeta en la carpeta actual con el nombre indicado.
`createShortcut(targetId)`	`File`	Crea un acceso directo al ID del elemento de Drive proporcionado y lo devuelve.
`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`	`File`	Crea un acceso directo al ID del elemento de Drive y a la clave de recurso proporcionados, y lo devuelve.
`getAccess(email)`	`Permission`	Obtiene el permiso otorgado a un usuario específico.
`getAccess(user)`	`Permission`	Obtiene el permiso otorgado a un usuario específico.
`getDateCreated()`	`Date`	Obtiene la fecha en que se creó el objeto `Folder`.
`getDescription()`	`String`	Obtiene la descripción del `Folder`.
`getEditors()`	`User[]`	Obtiene la lista de editores de este `Folder`.
`getFiles()`	`FileIterator`	Obtiene una colección de todos los archivos que son secundarios de la carpeta actual.
`getFilesByName(name)`	`FileIterator`	Obtiene una colección de todos los archivos que son elementos secundarios de la carpeta actual y tienen el nombre determinado.
`getFilesByType(mimeType)`	`FileIterator`	Obtiene una colección de todos los archivos que son elementos secundarios de la carpeta actual y tienen el tipo de MIME determinado.
`getFolders()`	`FolderIterator`	Obtiene una colección de todas las carpetas secundarias de la carpeta actual.
`getFoldersByName(name)`	`FolderIterator`	Obtiene una colección de todas las carpetas que son secundarias de la carpeta actual y tienen el nombre determinado.
`getId()`	`String`	Obtiene el ID del `Folder`.
`getLastUpdated()`	`Date`	Obtiene la fecha en que se actualizó por última vez el objeto `Folder`.
`getName()`	`String`	Obtiene el nombre del `Folder`.
`getOwner()`	`User`	Obtiene el propietario de este `Folder`.
`getParents()`	`FolderIterator`	Obtiene una colección de carpetas que son superiores inmediatas del `Folder`.
`getResourceKey()`	`String`	Obtiene la clave de recurso del `Folder` que se requiere para acceder a los elementos que se compartieron con un vínculo.
`getSecurityUpdateEligible()`	`Boolean`	Obtiene si este `Folder` es apto para aplicar la actualización de seguridad que requiere una clave de recurso para acceder cuando se comparte con un vínculo.
`getSecurityUpdateEnabled()`	`Boolean`	Indica si este `Folder` requiere una clave de recurso para acceder a él cuando se comparte a través de un vínculo.
`getSharingAccess()`	`Access`	Obtiene la clase de usuarios que pueden acceder al `Folder`, además de los usuarios individuales a los que se les otorgó acceso de forma explícita.
`getSharingPermission()`	`Permission`	Obtiene el permiso otorgado a los usuarios que pueden acceder a `Folder`, además de los usuarios individuales a los que se les otorgó acceso de forma explícita.
`getSize()`	`Integer`	Obtiene la cantidad de bytes que se usan para almacenar el objeto `Folder` en Drive.
`getUrl()`	`String`	Obtiene la URL que se puede usar para abrir el objeto `Folder` en una app de Google, como Drive o Documentos.
`getViewers()`	`User[]`	Obtiene la lista de lectores y comentaristas de este `Folder`.
`isShareableByEditors()`	`Boolean`	Determina si los usuarios con permisos de edición para el `Folder` pueden compartirlo con otros usuarios o cambiar los permisos.
`isStarred()`	`Boolean`	Determina si el `Folder` se marcó como destacado en el Drive del usuario.
`isTrashed()`	`Boolean`	Determina si el elemento `Folder` está en la papelera de la unidad del usuario.
`moveTo(destination)`	`Folder`	Mueve este elemento a la carpeta de destino proporcionada.
`removeEditor(emailAddress)`	`Folder`	Quita al usuario especificado de la lista de editores del `Folder`.
`removeEditor(user)`	`Folder`	Quita al usuario especificado de la lista de editores del `Folder`.
`removeViewer(emailAddress)`	`Folder`	Quita al usuario determinado de la lista de usuarios que pueden ver y comentar el `Folder`.
`removeViewer(user)`	`Folder`	Quita al usuario determinado de la lista de usuarios que pueden ver y comentar el `Folder`.
`revokePermissions(emailAddress)`	`Folder`	Revoca el acceso a `Folder` que se otorgó al usuario determinado.
`revokePermissions(user)`	`Folder`	Revoca el acceso a `Folder` que se otorgó al usuario determinado.
`searchFiles(params)`	`FileIterator`	Obtiene una colección de todos los archivos que son elementos secundarios de la carpeta actual y que coinciden con los criterios de búsqueda proporcionados.
`searchFolders(params)`	`FolderIterator`	Obtiene una colección de todas las carpetas secundarias de la carpeta actual que coinciden con los criterios de búsqueda proporcionados.
`setDescription(description)`	`Folder`	Establece la descripción del `Folder`.
`setName(name)`	`Folder`	Establece el nombre del `Folder`.
`setOwner(emailAddress)`	`Folder`	Cambia el propietario de `Folder`.
`setOwner(user)`	`Folder`	Cambia el propietario de `Folder`.
`setSecurityUpdateEnabled(enabled)`	`Folder`	Establece si `Folder` requiere una clave de recurso para acceder cuando se comparte a través de un vínculo.
`setShareableByEditors(shareable)`	`Folder`	Establece si los usuarios con permisos de edición para el `Folder` pueden compartirlo con otros usuarios o cambiar los permisos.
`setSharing(accessType, permissionType)`	`Folder`	Establece qué clase de usuarios puede acceder a `Folder` y qué permisos se les otorgan, además de los usuarios individuales a los que se les otorgó acceso de forma explícita.
`setStarred(starred)`	`Folder`	Establece si el `Folder` se destaca en la unidad del usuario.
`setTrashed(trashed)`	`Folder`	Establece si el elemento `Folder` está en la papelera de la unidad del usuario.

`FolderIterator`

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`getContinuationToken()`	`String`	Obtiene un token que se puede usar para reanudar esta iteración más adelante.
`hasNext()`	`Boolean`	Determina si llamar a `next()` devolverá un elemento.
`next()`	`Folder`	Obtiene el siguiente elemento de la colección de archivos o carpetas.

`Permission`

Propiedades

Propiedad	Tipo	Descripción
`VIEW`	`Enum`	Los usuarios que pueden acceder al archivo o la carpeta solo pueden verlo o copiarlo.
`EDIT`	`Enum`	Los usuarios que pueden acceder al archivo o la carpeta pueden editarlo.
`COMMENT`	`Enum`	Los usuarios que pueden acceder al archivo o la carpeta solo pueden verlo, copiarlo o comentarlo.
`OWNER`	`Enum`	El usuario es propietario del archivo o la carpeta.
`ORGANIZER`	`Enum`	Usuarios que pueden organizar archivos y carpetas dentro de una unidad compartida
`FILE_ORGANIZER`	`Enum`	Usuarios que pueden editar, descartar y mover contenido dentro de una unidad compartida.
`NONE`	`Enum`	El usuario no tiene permisos para el archivo o la carpeta.

`User`

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`getDomain()`	`String\|null`	Obtiene el nombre de dominio asociado a la cuenta del usuario.
`getEmail()`	`String\|null`	Obtiene la dirección de correo electrónico del usuario.
`getName()`	`String\|null`	Obtiene el nombre del usuario.
`getPhotoUrl()`	`String\|null`	Obtiene la URL de la foto del usuario.

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

Clases

Propiedades

Propiedades

Métodos

Métodos

Métodos

Métodos

Métodos

Propiedades

Métodos

Drive Service