Todos los proyectos de Apps Script usan Google Cloud para administrar la autorización, los servicios avanzados y otros detalles. Para establecer y administrar esta configuración, cada proyecto de Apps Script tiene un proyecto de Google Cloud asociado. El proyecto de secuencia de comandos puede usar un proyecto predeterminado que Apps Script crea automáticamente o un proyecto estándar que tú mismo creas. En general, los proyectos predeterminados son útiles para secuencias de comandos comunes o simples, pero debes usar un proyecto estándar para cualquier aplicación que sea compleja o de calidad comercial, o que desees publicar.
Puedes cambiar de un proyecto predeterminado a un proyecto estándar en cualquier momento, pero no puedes volver a usar un proyecto predeterminado. Se recomienda seleccionar el proyecto de Cloud que usa tu secuencia de comandos al comienzo del desarrollo. El cambio más adelante puede causar complicaciones, como requerir que los usuarios vuelvan a autorizar.
Proyectos de Cloud predeterminados
Cuando creas un proyecto de Apps Script, este último crea un proyecto predeterminado de Cloud que opera en segundo plano.
- Para la mayoría de las secuencias de comandos, nunca necesitas ver ni ajustar este proyecto predeterminado. Apps Script controla las interacciones necesarias con Google Cloud. Por ejemplo, si activas un servicio avanzado en el editor de Apps Script, este servicio también se activa en el proyecto de Cloud predeterminado cuando guardas el proyecto de secuencia de comandos.
- Para algunas secuencias de comandos, debes interactuar con la consola de Google Cloud. En estos casos, la secuencia de comandos debe usar un proyecto estándar de Cloud. Por ejemplo, para ver los registros de Google Cloud en la consola de Google Cloud, tu secuencia de comandos debe usar un proyecto estándar.
De forma predeterminada, los proyectos de Cloud tienen una política de administración de identidades y accesos (IAM) con una entrada, una cuenta de servicio de Google que actúa como propietario del proyecto predeterminado. La cuenta de servicio de Google es appsdev-apps-dev-script-auth@system.gserviceaccount.com
.
Visualiza o actualiza los proyectos predeterminados de Cloud
La mayoría de los usuarios no pueden ubicar, ver ni editar proyectos predeterminados directamente en la consola de Google Cloud. Si eres administrador, consulta Ver proyectos predeterminados de Google Cloud.
Si creaste tu proyecto de secuencia de comandos antes del 8 de abril de 2019, puedes usar un proyecto predeterminado al que puedas acceder en la consola de Google Cloud. Para acceder al proyecto predeterminado, ve a la configuración del proyecto de la secuencia de comandos y haz clic en el número del proyecto.
Borra los proyectos de Cloud predeterminados
Si eres administrador, puedes borrar los proyectos de Cloud predeterminados como lo harías con los proyectos estándar de Cloud. Consulta Borra proyectos de Cloud de Apps Script.
Si no eres administrador, no puedes borrar los proyectos predeterminados. Sin embargo, Apps Script borra proyectos predeterminados en los siguientes casos:
- Si borras el proyecto de secuencia de comandos o lo cambias para utilizar un proyecto estándar, Apps Script borrará el proyecto predeterminado adjunto a la secuencia de comandos junto con cualquier configuración o información que contenga.
- Si una secuencia de comandos no se ejecuta durante 180 días o más, Apps Script borra el proyecto predeterminado asociado. Si la secuencia de comandos se ejecuta después de que Apps Script borra su proyecto predeterminado, Apps Script crea uno para la secuencia.
Proyectos de Cloud estándar
Los proyectos predeterminados de Cloud son la mejor opción para la mayoría de los proyectos de secuencias de comandos, a menos que debas configurar el proyecto de forma manual. En estas situaciones, debes cambiar tu proyecto de secuencia de comandos para usar un proyecto estándar.
En las siguientes secciones, se describe cuándo Apps Script requiere un proyecto estándar, las propiedades de esos proyectos y las tareas comunes que se realizan con ellos. Solo puedes realizar las siguientes tareas con proyectos estándar.
Cuando Apps Script requiere proyectos estándar de Cloud
Debes usar un proyecto estándar en las siguientes situaciones:
- Para publicar tu proyecto de secuencia de comandos como un complemento en Google Workspace Marketplace, sigue estos pasos:
- Verificar el cliente de OAuth del proyecto de la secuencia de comandos.
- Cuando tienes una aplicación que necesita ejecutar funciones en tu proyecto de secuencia de comandos con el método
scripts.run
de la API de Apps Script, - Para ver los registros de Google Cloud del proyecto de la secuencia de comandos en la consola de Google Cloud, La consola de Google Cloud proporciona más herramientas para filtrar y ver registros, y puede ser más útil que la vista simplificada que proporciona el panel de Apps Script.
- Para ver los informes de errores del proyecto de la secuencia de comandos con Error Reporting.
- Para crear un diálogo de abrir archivo.
- Cuando necesites control manual de la configuración de Google Cloud del proyecto.
Propiedades estándar de los proyectos de Cloud
Los proyectos estándar tienen las siguientes propiedades:
- Puedes acceder a toda la configuración de Google Cloud para el proyecto directamente desde Google Cloud Console. Esto te permite activar las APIs, ajustar las credenciales de autorización y configurar otros detalles.
- Cuando borras un proyecto de secuencia de comandos o lo cambias para usar otro proyecto estándar, el proyecto estándar original permanece y se puede volver a usar.
- Cuando activas un servicio avanzado en un proyecto de secuencia de comandos, debes activar manualmente la API correspondiente en el proyecto estándar.
- Varios proyectos de secuencias de comandos y otras apps pueden compartir el mismo proyecto estándar. Si quieres publicar un proyecto de secuencia de comandos en Google Workspace Marketplace como un complemento, este debe tener su propio proyecto estándar. Las apps publicadas no pueden compartir proyectos de Cloud con otras apps.
- Si deseas ejecutar funciones en un proyecto de secuencia de comandos desde otra app con el método
scripts.run
de la API de Apps Script, el proyecto de secuencia de comandos y la aplicación que realiza la llamada deben compartir el mismo proyecto estándar. - Cuando Apps Script le solicita a un usuario que autorice una secuencia de comandos que usa un proyecto estándar, el nombre del proyecto de Cloud se usa para identificar la secuencia de comandos (no el nombre del proyecto). Por este motivo, asegúrate de establecer un nombre de proyecto de Cloud apropiado.
Accede a un proyecto de Cloud estándar
Para acceder al proyecto estándar asociado con tu proyecto de secuencia de comandos, haz lo siguiente:
- Abre el proyecto Apps Script.
- A la izquierda, haz clic en Configuración del proyecto .
- En Proyecto de Google Cloud Platform (GCP), haz clic en el número de proyecto.
También puedes encontrar un proyecto estándar directamente en la página Administrar recursos de la consola de Google Cloud.
Activa una API en un proyecto de Cloud estándar
A menudo, una aplicación Apps Script necesita acceso a otra API de Google. Para ello, debes activar la API en el proyecto de Cloud correspondiente. Para activar una API, haz lo siguiente:
- Abre el proyecto de Cloud.
- Haz clic en Menú > APIs y servicios.
- Haz clic en Habilitar APIs y servicios.
- En el cuadro de búsqueda, ingresa la API que quieras activar y presiona Intro.
- Haz clic en la API en los resultados de la búsqueda y, luego, en Habilitar a fin de activar la API para este proyecto de Cloud.
Es posible que se te solicite aceptar las Condiciones del Servicio de las API de Google o Google Cloud. Revisa atentamente las Condiciones del servicio antes de aceptarlas.
Según la aplicación, es posible que también debas configurar la API. Para ello, selecciónala en el panel API y servicios (APIs & Services).
Determina el ID y la cantidad de un proyecto de Cloud estándar
Todos los proyectos de Cloud tienen un nombre, un ID y un número de proyecto. En ocasiones, debes tener estos identificadores para configurar servicios o completar otras tareas.
Para determinar el ID y el número de tu proyecto estándar, haz lo siguiente:
- Abre el proyecto de Cloud.
- En la esquina superior derecha, haz clic en Más > Configuración del proyecto.
- Visualiza el Nombre del proyecto, el ID del proyecto y el Número del proyecto en el panel Configuración resultante. El número del proyecto consta solo de dígitos, mientras que el ID del proyecto es alfanumérico. Puedes editar el Nombre del proyecto, que se mostrará a los usuarios durante los mensajes de autorización.
Consulta los informes de errores y los registros de Google Cloud en la consola de Google Cloud
Si usas Google Cloud Logging o error Reporting para tu proyecto de secuencia de comandos, puedes ver esos informes y registros en la consola de Google Cloud de la siguiente manera:
- Abre el proyecto de Cloud.
- Haz clic en el menú .
- Desplázate hacia abajo hasta la sección Operaciones y haz clic en Logging > Explorador de registros.
- Para ver los informes de errores, desplázate hacia abajo hasta la sección Operaciones y haz clic en Error Reporting. Si se te solicita que configures el informe de errores, esto significa que tu proyecto de secuencia de comandos aún no registró ninguna excepción.
Completa la pantalla de consentimiento de OAuth
Cuando se utilizan servicios que requieren OAuth, Google solicita a los usuarios que autoricen esos servicios. La configuración de la pantalla de consentimiento de OAuth te permite configurar parte de la información que Google presenta a los usuarios, como el nombre de la aplicación y la URL de las Condiciones del Servicio.
Los proyectos predeterminados de Cloud crean una pantalla de consentimiento automáticamente a partir de los detalles del proyecto de Apps Script; no puedes ajustar esa configuración. Los proyectos de Cloud estándar te permiten personalizar esta información. Para configurar la pantalla de consentimiento de la secuencia de comandos, haz lo siguiente:
- Abre el proyecto de Cloud.
- Haz clic en Menú > APIs y servicios > Credenciales.
- Haz clic en Configurar pantalla de consentimiento.
- Completa cada sección del flujo de trabajo de la pantalla de consentimiento.
- Para registrar los cambios en cada etapa del flujo de trabajo, haz clic en Guardar y continuar.
Crear credenciales OAuth
Por lo general, Apps Script configura OAuth para los servicios que usa tu secuencia de comandos. Para algunas aplicaciones, debes crear credenciales de OAuth adicionales (IDs de cliente y secretos del cliente). Solo puedes hacerlo con proyectos estándar.
A fin de crear un ID de cliente y un secreto de cliente para tu proyecto de secuencia de comandos, haz lo siguiente:
- Abre el proyecto de Cloud.
- Haz clic en Menú > APIs y servicios > Credenciales.
- Haz clic en Crear credenciales > ID de cliente de OAuth.
- En Tipo de aplicación, selecciona el tipo de aplicación y completa el formulario resultante si es necesario. Cuando termines, haz clic en Crear.
- En el cuadro de diálogo que aparece, haz clic en Descargar JSON. Puedes usar este archivo para configurar OAuth.
Agrega propietarios adicionales a un proyecto de Cloud estándar
Puedes agregar otros propietarios y otros roles a un proyecto estándar. Si colaboras en un proyecto, esto ayuda a garantizar que alguien de tu equipo siempre tenga acceso a la configuración de Google Cloud del proyecto de secuencia de comandos.
Puedes agregar propietarios adicionales o, también, otras funciones a un proyecto estándar de la siguiente manera. Debes tener permisos de edición para que el proyecto pueda realizar cualquiera de estos cambios:
- Determina quiénes deberían ser tus colaboradores. Te recomendamos que crees o uses un Grupo de Google existente. También puedes especificar dominios en la lista de colaboradores para incluir todos los usuarios en ese dominio.
- Abre el proyecto de Cloud de la secuencia de comandos.
- Haz clic en Menú > IAM y administración > IAM.
- En la parte superior, haz clic en Agregar.
- Sigue las instrucciones en pantalla para agregar uno o más miembros nuevos y sus roles al proyecto de Cloud. Puedes agregar correos electrónicos individuales, Grupos de Google o dominios como miembros nuevos.
- Haz clic en Guardar.
Agrupa varias secuencias de comandos con un solo proyecto de Cloud
Puedes tener varios proyectos de Apps Script que compartan el mismo proyecto estándar de Cloud. Para ello, crea un proyecto estándar y, luego, cambia cada proyecto de secuencia de comandos a fin de usarlo. No puedes hacer esto con los proyectos predeterminados.
Usar un proyecto de Cloud estándar diferente
Puedes cambiar un proyecto de secuencia de comandos para que use un proyecto estándar de Cloud diferente. Si la secuencia de comandos requiere la configuración manual del proyecto de Cloud, debes cambiar de un proyecto predeterminado a un proyecto estándar. Para obtener más información sobre cuándo necesitas usar un proyecto estándar, consulta Proyectos estándar de Cloud.
Efectos de cambiar a un proyecto de Cloud estándar diferente
Si cambias la secuencia de comandos de un proyecto predeterminado o de un proyecto estándar diferente, esto tendrá los siguientes efectos:
- Si activaste los servicios avanzados para la secuencia de comandos, debes activar las APIs correspondientes en el proyecto de Cloud nuevo. Se pierden todos los datos vinculados a los servicios avanzados en el proyecto de Cloud anterior. Para obtener información sobre cómo activar las APIs en tu proyecto de Cloud, consulta Habilita las APIs de Google Workspace.
- Si tu secuencia de comandos usa el servicio integrado de Google Drive, debes activar la API de Drive en los proyectos estándar de Cloud.
En tu proyecto de Cloud estándar, activa la API de Drive:
- Todos los usuarios que hayan autorizado previamente la secuencia de comandos deberán volver a autorizarla. En la mayoría de los casos, todos los usuarios que autorizaron previamente las apps asociadas con el proyecto nuevo también deben volver a autorizarlas.
- Si la secuencia de comandos está asociada con una ficha de la app en Google Workspace Marketplace, la ficha, los usuarios y las opiniones de la app no se transfieren al proyecto nuevo. Debes crear una ficha de la app dentro del proyecto nuevo y los usuarios deberán volver a instalarla. Para obtener información sobre cómo crear una ficha nueva de la app, consulta Cómo publicar una app.
- No puedes volver a cambiar una secuencia de comandos a un proyecto predeterminado. Apps Script borra los proyectos predeterminados después de que configuras la secuencia de comandos para que use un proyecto estándar.
Cambia a un proyecto de Cloud estándar diferente
Para cambiar el proyecto de Cloud existente de una secuencia de comandos a otro proyecto de Cloud, sigue estos pasos:
- Si no tienes un proyecto de Cloud adecuado, sigue las instrucciones que se indican en Crea un proyecto para crear uno. Establece un nombre de proyecto fácil de recordar para poder encontrarlo en la página Administrar recursos de la consola de Google Cloud. Apps Script usa este nombre cuando les solicita a los usuarios que autoricen la secuencia de comandos.
- Si quieres usar un proyecto existente, abre la página Administrar recursos de la consola de Google Cloud y busca el proyecto existente que quieras usar. Debes tener los roles de navegador del proyecto y de editor de configuración de OAuth, o roles con los permisos equivalentes, para el proyecto. No puedes usar un proyecto que Apps Script haya creado automáticamente.
- Determina el Número de proyecto de tu proyecto de Cloud.
- Abre la secuencia de comandos cuyo proyecto de Cloud deseas reemplazar.
- A la izquierda, haz clic en Configuración del proyecto .
- En Proyecto de Google Cloud Platform (GCP), haz clic en Cambiar proyecto.
- Ingresa el número de proyecto nuevo y haz clic en Establecer proyecto.
Proyectos en la nube y unidades compartidas
Las unidades compartidas (anteriormente, unidades de equipo) proporcionan espacios compartidos en los que grupos de usuarios de Drive pueden colaborar en proyectos de Apps Script y documentos de Drive. Las unidades compartidas son valiosas cuando se desarrollan secuencias de comandos, complementos y aplicaciones web con un equipo, pero imponen algunas restricciones sobre lo que puedes hacer con proyectos de Cloud predeterminados anteriores.
En la siguiente lista de restricciones, se describe cómo interactúan los proyectos de Cloud con las unidades compartidas:
- Si tu proyecto de secuencia de comandos usa un proyecto estándar, no hay restricciones adicionales cuando el proyecto de secuencia de comandos reside en una unidad compartida.
- Si tu proyecto de secuencia de comandos usa un proyecto predeterminado que se creó a partir del 8 de abril de 2019, no hay restricciones adicionales cuando el proyecto resida en una unidad compartida.
- Si tu proyecto de secuencia de comandos usa un proyecto predeterminado que se creó antes del 8 de abril de 2019, se aplican las siguientes restricciones mientras el proyecto de secuencia de comandos reside en una unidad compartida:
- No puedes acceder al proyecto predeterminado con la IU de Apps Script o la consola de Google Cloud. Esta restricción te impide realizar acciones que requieren acceso directo al proyecto.
- No puedes activar los servicios avanzados. Para activar los servicios avanzados, cambia a un proyecto estándar.
- Cuando trasladas un proyecto existente de Apps Script a una unidad compartida, Google restringe el acceso al proyecto predeterminado de Cloud. Aún puedes acceder al proyecto predeterminado si lo tenías antes del traslado. Por ejemplo, si creaste una secuencia de comandos en tu carpeta Mi unidad y, luego, la moviste a una unidad compartida, aún puedes acceder al proyecto de Cloud de la secuencia de comandos. Es posible que los colaboradores de la unidad compartida no puedan hacerlo.
- Una secuencia de comandos conserva el nombre del proyecto de Cloud que tenía antes de trasladarse a una unidad compartida. Incluso si cambias el nombre del proyecto en la unidad compartida, los usuarios que autorizan la secuencia de comandos seguirán viendo el nombre anterior en los diálogos de autorización.
A fin de evitar las restricciones anteriores para las secuencias de comandos más antiguas, cambia a un proyecto estándar.
Obtén una lista de proyectos de Cloud de Apps Script
Si tienes el permiso resourcemanager.projects.list
para la carpeta del proyecto de Apps Script de tu organización, puedes ver todos los proyectos de Apps Script Cloud estándar y predeterminados dentro de la carpeta.
- Abre la página Administrar recursos de la consola de Google Cloud.
- Junto a la carpeta Apps Script, copia el ID.
- Haz clic en Filtrar > ID superior y pega el ID de la carpeta de Apps Script.
Borrar proyectos de Apps Script Cloud
Para borrar un proyecto de Apps Script Cloud, sigue los pasos que se indican en Obtén una lista de proyectos de Apps Script Cloud, selecciona el proyecto que deseas borrar y haz clic en Borrar.
Para borrar un proyecto de Apps Script con gcloud
, usa los siguientes comandos.
gcloud projects list --filter='parent.id=APPS_SCRIPT_FOLDER_ID'
gcloud projects delete PROJECT_ID
Si quieres obtener más información para borrar proyectos de Cloud, consulta Cierra (borra) proyectos.