Proyectos de Google Cloud

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

Cada proyecto de Apps Script usa 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 la secuencia de comandos puede usar un proyecto predeterminado que Apps Script crea de forma automática o un proyecto estándar que tú mismo creas. En general, los proyectos predeterminados son buenos para secuencias de comandos diarias o simples, pero debes usar un proyecto estándar en cualquier aplicación que sea compleja, de calidad comercial o esté destinada a la publicación.

Puedes cambiar de un proyecto predeterminado a un proyecto estándar en cualquier momento, pero no puedes volver a usar un proyecto predeterminado. Es mejor seleccionar el proyecto de Google Cloud que usa la secuencia de comandos al principio del desarrollo. Cambiar más tarde puede causar complicaciones, como requerir que los usuarios se vuelvan a autorizar.

Proyectos predeterminados de Google Cloud

Cuando creas un proyecto de Apps Script, Apps Script crea un proyecto predeterminado de Google 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, se activará el servicio avanzado en el proyecto predeterminado de Google Cloud cuando guardes el proyecto de secuencia de comandos.
  • Para algunas secuencias de comandos, debes interactuar con Google Cloud Console. En estos casos, la secuencia de comandos debe usar un proyecto de Google Cloud estándar. Por ejemplo, para ver los registros de Google Cloud en Google Cloud Console, tu secuencia de comandos debe usar un proyecto estándar.

Ver o actualizar proyectos predeterminados de Google Cloud

La mayoría de los usuarios no pueden ubicar, ver ni editar directamente los proyectos predeterminados en Google Cloud Console. Los administradores y los usuarios del dominio que tienen el permiso resourcemanager.projects.list en la carpeta superior de Google Cloud pueden ver y configurar proyectos predeterminados.

  • Para los clientes de Google Workspace, los proyectos predeterminados se encuentran en la carpeta Organization root > system-gsuite apps-script Jerarquía en Cloud Resource. No borres estas carpetas. Si lo haces, las secuencias de comandos no pueden crear proyectos predeterminados y no se ejecutarán de forma correcta.
  • En el caso de los clientes ajenos a Google Workspace, la jerarquía de recursos no obtiene los proyectos predeterminados.

Borra los proyectos predeterminados de Google Cloud

Si eres administrador, puedes borrar proyectos predeterminados de Google Cloud como lo harías con proyectos estándar de Google Cloud. Consulta Borra proyectos de Google Cloud para Apps Script.

Si no eres administrador, no podrás borrar los proyectos predeterminados. Sin embargo, Apps Script borra los proyectos predeterminados en las siguientes situaciones:

  • Si borras el proyecto de secuencia de comandos o lo cambias para usar un proyecto estándar, Apps Script borrará el proyecto predeterminado adjunto a la secuencia de comandos junto con la 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 borrará su 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 de comandos.

Proyectos estándar de Google Cloud

Los proyectos predeterminados de Google Cloud son la mejor opción para la mayoría de los proyectos de secuencias de comandos, a menos que necesites configurarlos 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, sus propiedades 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 Google Cloud

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

Propiedades del proyecto estándar de Google 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 API, 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 de forma manual 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, debe tener su propio proyecto estándar. Las apps publicadas no pueden compartir proyectos de Google Cloud con otras apps.
  • Si deseas ejecutar funciones en un proyecto de secuencia de comandos desde otra app mediante 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 solicita a un usuario que autorice una secuencia de comandos que usa un proyecto estándar, el nombre del proyecto de Google Cloud se usa para identificar la secuencia de comandos (no el nombre del proyecto de secuencia de comandos). Por este motivo, asegúrate de configurar un nombre de proyecto de Google Cloud adecuado.

Accede a un proyecto estándar de Google Cloud

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

Nuevo editor

  1. Abre el proyecto de Apps Script.
  2. A la izquierda, haz clic en Configuración del proyecto .
  3. En Proyecto de Google Cloud Platform (GCP), haga clic en el número de proyecto.

Editor heredado

  1. Abre la secuencia de comandos en el editor de Apps Script.
  2. Selecciona Recursos > proyecto de Cloud Platform.
  3. En el cuadro de diálogo que se abre, haz clic en el vínculo superior que hace referencia al nombre del proyecto de GCP.

También puedes encontrar un proyecto estándar directamente en la página Administrar recursos de Google Cloud Console.

Activa una API en un proyecto estándar de Google Cloud

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 Google Cloud correspondiente. Para activar una API, haz lo siguiente:

  1. Abre el proyecto de Google Cloud.
  2. Haz clic en Menú > API &Services.
  3. Haga clic en Habilitar API y servicios.
  4. En el cuadro de búsqueda, ingrese la API que desea activar y presione Intro.
  5. Haz clic en la API en los resultados de la búsqueda y, luego, en Habilitar para activar la API en este proyecto de Google Cloud.

Es posible que se te solicite aceptar las Condiciones del Servicio para las API de Google o Google Cloud. Revisa las Condiciones del Servicio con atención antes de aceptarlas.

Según la aplicación, es posible que también debas configurar la API en el panel de API y servicios.

Determinar el ID # de un proyecto estándar de Google Cloud

Todos los proyectos de Google 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 estándar de tu proyecto, haz lo siguiente:

  1. Abre el proyecto de Google 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 del proyecto es alfanumérico. Puedes editar el Nombre del proyecto, que se muestra a los usuarios durante los mensajes de autorización.

Cómo ver los informes de errores y registros de Google Cloud en Google Cloud Console

Si usas Cloud Logging o Error Reporting para tu proyecto de secuencia de comandos, puedes ver esos registros y los informes en Google Cloud Console de la siguiente manera:

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

Cuando se usan 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 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 predeterminados de Google 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 estándar de Google Cloud te permiten personalizar esta información. Puedes configurar la pantalla de consentimiento de tu secuencia de comandos de la siguiente manera:

  1. Abre el proyecto de Google Cloud.
  2. Haz clic en Menú > API &Services > Credentials.
  3. Haz clic en Configurar pantalla de consentimiento.
  4. Complete 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 credenciales de OAuth adicionales (ID 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:

  1. Abre el proyecto de Google Cloud.
  2. Haz clic en Menú > API &Services > Credentials.
  3. Haz clic en Crear credenciales > ID de cliente de OAuth.
  4. En Tipo de aplicación, selecciona tu tipo de aplicación y completa el formulario resultante si es necesario. Cuando termines, haz clic en Crear.
  5. 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 estándar de Google Cloud

Puedes agregar propietarios adicionales y otras funciones 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.

Para agregar propietarios adicionales y otras funciones a un proyecto estándar, haz lo siguiente. Debes tener permisos de edición para el proyecto a fin de realizar cualquiera de estos cambios:

  1. Determina quiénes deben 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 a todos los usuarios de ese dominio.
  2. Abre el proyecto de Google Cloud de la secuencia de comandos.
  3. Haz clic en Menú > IAM & admin 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 funciones al proyecto de Google Cloud. Puedes agregar correos electrónicos individuales, Grupos de Google o dominios como miembros nuevos.
  6. Haga clic en Guardar.

Agrupar varias secuencias de comandos con un solo proyecto de Google Cloud

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

Cambia a otro proyecto estándar de Google Cloud

Puedes cambiar un proyecto de secuencia de comandos para que use un proyecto de Google Cloud estándar diferente. Debes cambiar a un proyecto estándar si tu secuencia de comandos requiere una configuración manual del proyecto de Google Cloud. Para obtener más información sobre cuándo necesitas usar un proyecto estándar, consulta Proyectos estándar de Google Cloud.

Para cambiar un proyecto de Google Cloud existente de una secuencia de comandos a otro proyecto de Google Cloud, sigue estos pasos:

Nuevo editor

  1. Si no tienes un proyecto de Google Cloud adecuado, sigue las instrucciones en Crea un proyecto para crear uno. Establece un nombre de proyecto memorable para que puedas ubicarlo en la página Administrar recursos de Google Cloud Console. Apps Script usa este nombre cuando les pide a los usuarios que autoricen la secuencia de comandos.
  2. Si deseas usar un proyecto existente, abre la página Administrar recursos en Google Cloud Console y ubica un proyecto existente para usar. Debes tener permisos resourcemanager.projects.update para el proyecto. No puedes usar un proyecto que Apps Script creó automáticamente.
  3. Determina el número de proyecto de tu proyecto de Google Cloud.
  4. Abre la secuencia de comandos cuyo proyecto de Google Cloud deseas reemplazar.
  5. A la izquierda, haz clic en Project Settings .
  6. En Proyecto de Google Cloud Platform (GCP), haga clic en Cambiar proyecto.
  7. Ingresa el número de proyecto nuevo y haz clic en Establecer proyecto.

Editor heredado

  1. Si no tienes un proyecto de GCP adecuado, sigue las instrucciones en Crea un proyecto para crear uno nuevo. De lo contrario, abre la página Administrar recursos en Google Cloud Console y ubica un proyecto de GCP existente para usar. Debes tener permisos de edición para el proyecto de GCP y poder ver su configuración en Google Cloud Console. El nuevo proyecto no puede ser creado automáticamente por Apps Script.
  2. Configura un nombre de proyecto de GCP memorable para que puedas ubicarlo con más facilidad en la página Administrar recursos de Google Cloud Console. Este nombre también se usa para identificar la secuencia de comandos cuando Apps Script solicita a los usuarios que la autoricen.
  3. Determina el número de proyecto de tu proyecto de GCP.
  4. En el editor de Apps Script, abre la secuencia de comandos cuyo proyecto de GCP deseas reemplazar.
  5. Haz clic en Recursos > proyecto de Cloud Platform.
  6. En la sección Cambiar proyecto, pega el número de proyecto que copiaste en el campo de texto y haz clic en Establecer proyecto.
  7. Una pantalla de advertencia explica los efectos del cambio del proyecto de Cloud Platform. Lea la notificación detenidamente y haga clic en Confirmar.

Proyectos de Google Cloud y unidades compartidas

Las unidades compartidas (antes conocidas como unidades de equipo) ofrecen espacios compartidos en los que los grupos de usuarios de Drive pueden colaborar en proyectos y documentos de Drive en Apps Script. Las unidades compartidas son valiosas cuando se desarrollan secuencias de comandos, complementos y aplicaciones web con un equipo, pero se aplican algunas restricciones sobre lo que puedes hacer con los proyectos predeterminados de Google Cloud más antiguos.

En la siguiente lista de restricciones, se describe cómo los proyectos de Google Cloud interactúan con unidades compartidas:

  • Si tu proyecto de secuencia de comandos usa un proyecto estándar, no hay restricciones adicionales cuando el proyecto 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 de esa fecha, 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ó antes del 8 de abril de 2019, se aplican las siguientes restricciones mientras el proyecto de secuencia de comandos se encuentre en una unidad compartida:
    1. No puedes acceder al proyecto predeterminado mediante la IU de Apps Script o Google Cloud Console. Esta restricción impide que realices acciones que requieran acceso directo al proyecto.
    2. No puedes activar los servicios avanzados. Para activar los servicios avanzados, cambia a un proyecto estándar.
    3. Cuando mueves un proyecto existente de Apps Script a una unidad compartida, Google restringe el acceso al proyecto predeterminado de Google Cloud. Aún puedes acceder al proyecto predeterminado si tenías acceso 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 Google Cloud de la secuencia de comandos. Es posible que los colaboradores de la unidad compartida no puedan hacerlo.
    4. Una secuencia de comandos conserva el nombre del proyecto de Google Cloud que tenía antes de moverlo 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 los diálogos de autorización.

A fin de evitar las restricciones anteriores para secuencias de comandos más antiguas, cambia a un proyecto estándar.

Obtén una lista de proyectos de Apps Script de Google Cloud

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 Google Cloud estándar y predeterminados de Apps Script dentro de la carpeta.

  1. Abre la página Administrar recursos de Google Cloud Console.
  2. Al lado de la carpeta de Apps Script, copie el ID.
  3. Haz clic en Filtrar > Parent ID y pega el ID de la carpeta de Apps Script.

Borrar proyectos de Google Cloud de Apps Script

Para borrar un proyecto de Google Cloud de Apps Script, sigue los pasos en Obtén una lista de proyectos de Google Cloud de Apps Script, 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

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