Proyectos de Google Cloud

Cada proyecto de Apps Script usa Google Cloud para administrar la autorización, servicios avanzados y otros detalles. Para establecer y administrar estos parámetros de configuración, cada proyecto de Apps Script tiene una el proyecto de Google Cloud asociado. Tu proyecto de secuencia de comandos puede usar una proyecto default que Apps Script crea automáticamente proyecto estándar que crees tú mismo. En general, los proyectos predeterminados son útiles para tareas cotidianas secuencias de comandos, pero deberías usar un proyecto estándar para cualquier aplicación que es compleja, de calidad comercial o que pretendes publicar.

Puedes cambiar de un proyecto predeterminado a uno estándar en cualquier momento, pero no puedes volver a usar un proyecto predeterminado. Es lo mejor para seleccionar el proyecto de Cloud que tu secuencia de comandos usará al principio del desarrollo. Cambiar más tarde puede causar complicaciones, como exigir a los usuarios que hagan lo siguiente: y vuelve a autorizarlo.

Proyectos de Cloud predeterminados

Cuando creas un proyecto de Apps Script, Apps Script crea un proyecto de Cloud predeterminada que opera en segundo plano.

  • Para la mayoría de las secuencias de comandos, nunca tendrás que ver o ajustar este proyecto predeterminado. Aplicaciones La secuencia de comandos controla las interacciones necesarias con Google Cloud. Por ejemplo, activa un servicio avanzado en el editor de Apps Script, Apps Script activa el servicio avanzado en el proyecto predeterminado de Cloud cuando guarda el proyecto de secuencia de comandos.
  • Para algunas secuencias de comandos, debes interactuar con la consola de Google Cloud. En estas en algunos casos, tu secuencia de comandos debe usar un proyecto estándar de Cloud. Para Por ejemplo, para ver los registros de Google Cloud en la consola, tu secuencia de comandos debe usar un proyecto estándar.

De forma predeterminada, los proyectos de Cloud tienen una cuenta de Identity (IAM) con una entrada, una cuenta de servicio de Google que actúe como propietaria de el proyecto predeterminado. La cuenta de servicio de Google es appsdev-apps-dev-script-auth@system.gserviceaccount.com

Visualiza o actualiza proyectos predeterminados de Cloud

La mayoría de los usuarios no pueden ubicar, ver ni editar proyectos predeterminados directamente en la console de Google Cloud. Si eres administrador, consulta Visualiza los 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 puedes acceder en la consola de Google Cloud. Para acceder al proyecto predeterminado, ve a la configuración del proyecto de secuencia de comandos y haz clic en el número del proyecto.

Borrar proyectos predeterminados de Cloud

Si eres administrador, puedes borrar proyectos de Cloud predeterminados como lo harías proyectos de Google Cloud estándar. 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 las siguientes situaciones:

  • Si eliminas el proyecto de script o lo cambias para usar un proyecto estándar, Google Apps Script borra el proyecto predeterminado que se adjuntó a la secuencia de comandos junto con configuración o la información que contiene.
  • Si una secuencia de comandos no se ejecuta durante 180 días o más, Apps Script borra su proyecto predeterminado asociado. Si la secuencia de comandos se ejecuta después Apps Script borra el proyecto predeterminado, y Apps Script crea uno para la secuencia de comandos.

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 Cambia tu proyecto de secuencia de comandos al 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 de Cloud estándar

Debes usar un proyecto estándar en las siguientes situaciones:

Propiedades estándar del proyecto de Cloud

Los proyectos estándar tienen las siguientes propiedades:

  • Puedes acceder a toda la configuración de Google Cloud del proyecto directamente. desde la consola de Google Cloud. Esto te permite activar APIs, ajustar la autorización credenciales y configurar otros detalles.
  • Cuando borras un proyecto de secuencia de comandos o lo cambias a usar otro proyecto estándar, el proyecto estándar original se mantiene y puede reutilizados.
  • 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 aplicaciones pueden compartir la misma proyecto estándar. Si quieres publicar un proyecto de secuencia de comandos al Google Workspace Marketplace como complemento, debe tener su propio proyecto estándar. Las apps publicadas no pueden compartir contenido proyectos de Google Cloud con otras apps.
  • Si quieres ejecutar funciones en un proyecto de secuencia de comandos desde otra app usando 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 en un proyecto final.
  • Cuando Apps Script le pide a un usuario que autorice una secuencia de comandos que usa un estándar proyecto, el nombre del proyecto de Cloud se usa para identificar la secuencia de comandos (no el nombre de proyecto de la secuencia de comandos). Por este motivo, asegúrate de establecer un Nombre del proyecto de Google Cloud.

Accede a un proyecto de Cloud estándar

Para acceder al proyecto estándar asociado con tu secuencia de comandos proyecto, haz lo siguiente:

  1. Abre el proyecto Apps Script.
  2. A la izquierda, haz clic en Configuración del proyecto .
  3. En Proyecto de Google Cloud Platform (GCP), haz clic en el número del 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 de 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:

  1. Abre el proyecto de Cloud.
  2. Haz clic en el menú . > APIs y Servicios.
  3. Haz clic en Habilitar APIs y servicios.
  4. En el cuadro de búsqueda, ingresa la API que deseas activar y presiona Intro.
  5. Haz clic en la API de los resultados de la búsqueda y, luego, en Habilitar para activar la API de este proyecto de Cloud.

Es posible que se te solicite que aceptes las Condiciones del Servicio para APIs de Google o Google Cloud. Revisar las condiciones del Servicio con atención antes de aceptarlas.

Según la aplicación, es posible que también debas configurar la API seleccionándolo en la pestaña APIs y de Google Cloud.

Determina el ID y el número de un proyecto de Cloud estándar

Todos los proyectos de Cloud tienen un nombre, un ID y un número de proyecto. A veces, 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:

  1. Abre el proyecto de Cloud.
  2. En la esquina superior derecha, haz clic en Más . > Configuración del proyecto.
  3. Consulta el Nombre del proyecto, el ID del proyecto y el Número del proyecto en el panel Configuración resultante. El número de proyecto solo contiene dígitos, mientras que el ID de proyecto es alfanumérico. Puedes editar el Nombre del proyecto, que se muestra a los usuarios durante los mensajes de autorización.

Ver registros de Google Cloud y informes de errores 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:

  1. Abre el proyecto de Cloud.
  2. Haz clic en el menú .
  3. Desplázate hacia abajo hasta la sección Operaciones. y haz clic en Logging > Explorador de registros.
  4. 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 la generación de informes de errores, significa que tu proyecto de secuencia de comandos aún no registró ninguna excepción.

Cuando se usan servicios que requieren OAuth, Google les solicita a los usuarios que autoricen esos servicios. La configuración de la pantalla de consentimiento de OAuth te permite establecer 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 de Cloud predeterminados 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 la nube estándar para personalizar esta información. Puedes configurar el consentimiento de la secuencia de comandos la pantalla de la siguiente manera:

  1. Abre el proyecto de Cloud.
  2. Haz clic en Menú > APIs y servicios > Credenciales.
  3. Haz clic en Configurar pantalla de consentimiento.
  4. Completa cada sección del flujo de trabajo de la pantalla de consentimiento.
  5. 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 reglas Credenciales de OAuth (IDs de cliente y secretos del cliente). Puedes hacerlo solo con proyectos estándar.

Para crear un ID de cliente y un secreto de cliente para tu proyecto de secuencia de comandos, sigue estos pasos: lo siguiente:

  1. Abre el proyecto de Cloud.
  2. Haz clic en el menú . > APIs y Servicios > Credenciales.
  3. Haz clic en Crear credenciales >. ID de cliente de OAuth.
  4. En Tipo de aplicación, selecciona el tipo de aplicación y complete el formulario que se genera si es necesario. Cuando termines, haz clic en Crear.
  5. En el cuadro de diálogo que aparece, haz clic en Descargar JSON. Puedes usa este archivo para configurar OAuth.

Agrega propietarios adicionales a un proyecto de Cloud estándar

Puedes agregar propietarios adicionales o bien otros roles a un proyecto estándar. Si estás colaborando en un proyecto, esto ayuda a garantizar que alguien de tu siempre tiene acceso a la configuración de Google Cloud del proyecto de secuencia de comandos.

Para agregar propietarios adicionales o otros roles a un proyecto estándar, haz lo siguiente: Debes tener permisos de edición para que el proyecto realice alguna de estos cambios:

  1. Determina quiénes deben ser tus colaboradores. Te recomendamos crear un Grupo de Google o usar uno existente. También puedes especificar dominios en la lista de colaboradores para incluir a todos los usuarios de ese dominio.
  2. Abre el proyecto de Cloud de la secuencia de comandos.
  3. Haz clic en Menú > IAM y administración > IAM.
  4. En la parte superior, haz clic en Agregar.
  5. 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 dominios como miembros nuevos.
  6. Haz clic en Guardar.

Agrupa varias secuencias de comandos con un solo proyecto de Cloud

Puedes hacer que varios proyectos de Apps Script compartan el mismo estándar Cloud. Para ello, crea un proyecto estándar y, luego, cambia cada proyecto de secuencia de comandos para usarlo. No puedes hacerlo con proyectos predeterminados.

Usa un proyecto de Cloud estándar diferente

Puedes cambiar un proyecto de secuencia de comandos para que utilice un estándar diferente Cloud. Si tu secuencia de comandos requiere una configuración manual del de Google Cloud, debes cambiar de un proyecto predeterminado a uno estándar en un proyecto final. Para aprender sobre cuándo necesitas usar un proyecto estándar, consulta proyectos estándar de Google Cloud.

Efectos de cambiar a un proyecto de Cloud estándar diferente

Si cambias tu secuencia de comandos de un proyecto predeterminado o a un estándar diferente proyecto, tiene los siguientes efectos:

  • Si activaste servicios avanzados para la secuencia de comandos, debes activar el APIs correspondientes en el nuevo proyecto de Cloud. Pierdes todos los datos vinculados a la configuración avanzada servicios en el proyecto anterior de Cloud. Para saber cómo activar las APIs del proyecto de Cloud, consulta Habilita las APIs de Google Workspace.
  • Si tu secuencia de comandos utiliza el servicio integrado de Google Drive, debes activar el API de Drive en proyectos estándar de Cloud.

    En tu proyecto estándar de Cloud, activa la API de Drive:

    Activar la API de Drive

  • Todos los usuarios que autorizaron anteriormente la secuencia de comandos deben volver a autorizarla. En la mayoría de los casos, todos los usuarios que hayan autorizado previamente apps asociadas con el proyecto nuevo también deben volver a autorizarlas.
  • Si tu secuencia de comandos está asociada con una ficha de la app en Google Workspace Marketplace, la ficha de la app, los usuarios y las opiniones no se transferirán a proyecto nuevo. Debes crear una ficha de app en el proyecto nuevo, y tus usuarios deben reinstalar la app. Para obtener información sobre cómo crear una ficha de app nueva, consulta Cómo publicar una app.
  • No puedes volver a cambiar una secuencia de comandos a un proyecto predeterminado. Operaciones de eliminación de Apps Script proyectos predeterminados después de configurar la secuencia de comandos para que use un proyecto estándar.

Cambia a otro proyecto de Cloud estándar

Cambiar el proyecto de Cloud existente de una secuencia de comandos a otro de Google Cloud, sigue estos pasos:

  1. Si no tienes un proyecto de Cloud adecuado, crea una siguiendo la sección Crea un proyecto instrucciones. Establece un nombre de proyecto fácil de recordar lo ubicas en la página Administrar recursos de la consola de Google Cloud. Apps Script usa este nombre cuando pedirles a los usuarios que autoricen la secuencia de comandos.
  2. Si deseas usar un proyecto existente, abre la página Administrar recursos de la consola de Google Cloud y busca un proyecto existente para usarlo. Debes tener el Roles del navegador del proyecto y del editor de configuración de OAuth, o roles con el equivalente permisos, para el en un proyecto final. No puedes usar un proyecto que se creó automáticamente con Apps Secuencia de comandos
  3. Determina el Número de proyecto de tu proyecto de Cloud.
  4. Abre la secuencia de comandos cuyo proyecto de Cloud deseas reemplazar.
  5. A la izquierda, haz clic en Configuración del proyecto.
  6. En Proyecto de Google Cloud Platform (GCP), haz clic en Cambiar proyecto.
  7. Ingresa el número del proyecto nuevo y haz clic en Configurar proyecto.

de Google Cloud unidades compartidas

Las unidades compartidas (anteriormente, Unidades de equipo) brindan Espacios compartidos en los que grupos de usuarios de Drive pueden colaborar en Apps Script proyectos 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 a lo que podía hacer con los proyectos predeterminados de Cloud más antiguos.

En la siguiente lista de restricciones, se describe cómo interactúan los proyectos de Cloud con 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ó el 8 de abril de 2019 o después, no hay restricciones adicionales cuando el proyecto de secuencia de comandos reside en una unidad compartida.
  • Si tu proyecto de secuencia de comandos utiliza un proyecto predeterminado que se creó antes A partir del 8 de abril de 2019, se aplicarán las siguientes restricciones mientras la secuencia de comandos proyecto reside en una unidad compartida:
    1. No puedes acceder al proyecto predeterminado con la IU de Apps Script o la consola de Google Cloud. Esta restricción te impide usar que requieren acceso directo al proyecto.
    2. No puedes activar los servicios avanzados. Para activar los servicios avanzados, cambia a una opción estándar en un proyecto final.
    3. Cuando mueves un proyecto de Apps Script existente a una unidad compartida, Google restringe el acceso al proyecto de Cloud predeterminado. Aún puedes acceder al proyecto predeterminado si tenías acceso antes del traslado. Para ejemplo, si creaste una secuencia de comandos en la carpeta Mi unidad y, luego, la trasladaste a una unidad compartida, todavía podrías acceder a la carpeta Cloud. Es posible que tus colaboradores de la unidad compartida no puedan hacerlo.
    4. Una secuencia de comandos conserva el nombre del proyecto de Cloud que tenía antes de ser se trasladó a una unidad compartida. Incluso si cambias el nombre del proyecto en la unidad compartida, Los usuarios que autoricen la secuencia de comandos seguirán viendo el nombre anterior en la autorización. los diálogos.

Para evitar las restricciones anteriores en las secuencias de comandos más antiguas, cambia a un proyecto estándar.

Obtén una lista de proyectos en la nube de Apps Script

Si tienes el permiso resourcemanager.projects.list para tu de proyectos de Apps Script de tu organización, puedes ver todos los proyectos predeterminados de Cloud de Apps Script dentro de la carpeta.

  1. Abre la página Administrar recursos de la consola de Google Cloud.
  2. Junto a la carpeta Apps Script, copia el ID.
  3. Haz clic en Filtrar > ID superior y pega el ID de la carpeta de Apps Script.

Borra proyectos de Apps Script de Cloud

Para borrar un proyecto de Apps Script en la nube, sigue los pasos que se indican en Obtén una lista de proyectos de Apps Script en la nube, selecciona el proyecto que quieres 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

Para obtener más información sobre cómo borrar proyectos de Cloud, consulta Cerrar proyectos (borrarlos).