Colabora con otros desarrolladores

Apps Script proporciona algunas funciones que los ayudan a ti y a otros desarrolladores a compilar y mantener secuencias de comandos, complementos y aplicaciones web juntos.

Conceptos básicos de la colaboración

Para colaborar en un proyecto, tú y tus colaboradores deben tener acceso de editor al archivo del proyecto de Apps Script (y a su contenedor, si es una secuencia de comandos vinculada). Esto permite que todos los miembros de tu equipo vean y hagan cambios en el código de Apps Script. Los editores también pueden crear versiones de código nuevas, implementar complementos y, luego, implementar secuencias de comandos como aplicaciones web o como ejecutables para la API de Apps Script.

Para ayudar a tu equipo, puedes planificar con anticipación cómo manejar la edición, la revisión, el control de versiones y, si corresponde, la implementación y la publicación de tu proyecto, complemento o app web. Por lo general, los proyectos independientes son los más fáciles de colaborar, ya que aparecen directamente en Google Drive y son el tipo de proyecto recomendado para el desarrollo de complementos y apps web.

Un problema común en la colaboración ocurre cuando el propietario de un proyecto de secuencia de comandos abandona el equipo sin transferir la propiedad del proyecto a otra persona. Esto podría provocar que no puedas mantener o actualizar el proyecto. Colocar tu proyecto de secuencia de comandos en una unidad compartida evita este problema, ya que los archivos de una unidad compartida no tienen propietarios específicos.

Colabora con la herramienta de línea de comandos de clasp

clasp te permite sincronizar proyectos entre script.google.com y tu sistema de archivos local. Esto te permite optimizar y automatizar el desarrollo de tu código si tú y tus colaboradores usan un software de administración de control de fuente, como git.

Para obtener más detalles, consulta la interfaz de línea de comandos con la guía clasp.

Colabora con unidades compartidas

Las unidades compartidas (antes conocidas como “unidades de equipo”) proporcionan un espacio compartido en Google Drive donde grupos de usuarios de Drive pueden colaborar de manera más eficaz. Los archivos que se colocan en una unidad compartida pertenecen al grupo en su conjunto, en lugar de a personas individuales. Esto significa que, cuando un colaborador abandona el grupo, no asume la propiedad ni el control del archivo con él.

Las unidades compartidas también te permiten mover archivos entre dominios: una unidad compartida en un dominio puede tener colaboradores de otro dominio que puedan mover archivos de ese dominio a la unidad compartida. Esto puede ser muy valioso para los desarrolladores de Apps Script, ya que proporciona un medio para que un equipo desarrolle complementos, apps web y otros tipos de código para clientes en diferentes dominios.

Cuando uses unidades compartidas para colaborar en proyectos de Apps Script, ten en cuenta lo siguiente:

  1. Los colaboradores con acceso de edición a una unidad compartida pueden crear o mover archivos nuevos a ella. Como editores de secuencia de comandos, pueden ver y editar proyectos de secuencias de comandos, ejecutar código de secuencia de comandos, crear nuevas versiones de secuencias de comandos y publicar complementos.
  2. Si quieres implementar secuencias de comandos como apps web o ejecutables para la API de Apps Script, la cuenta que crea la implementación debe pertenecer al mismo dominio que la unidad compartida en la que se encuentra la secuencia de comandos.
  3. Las unidades compartidas te permiten compartir archivos específicos dentro de ella con otras personas fuera del grupo y actualizar sus permisos de edición y lectura en esos archivos como lo harías con cualquier otro archivo de Drive. Sin embargo, si un usuario forma parte del equipo al que pertenece la unidad compartida, no puedes reducir su acceso a archivos específicos. Por ejemplo, si un usuario tiene acceso de edición a una unidad compartida, no puedes cambiarlo a acceso de solo lectura para un archivo específico dentro de ella.
  4. Los colaboradores con acceso completo a una unidad compartida también pueden borrar archivos y proyectos de Apps Script, y quitar archivos de la unidad compartida.
  5. Todas las secuencias de comandos vinculadas al contenedor usan las mismas listas de acceso de visualizador y editor definidas para el archivo del contenedor. Por ejemplo, si tienes acceso de edición a una hoja de cálculo de Google, también tienes acceso de edición a cualquier código de proyecto de Apps Script adjunto a ella. Si colocas este archivo de contenedor en una unidad compartida, se les otorga a los colaboradores de la unidad compartida el mismo acceso al código de secuencia de comandos que tienen para el contenedor.
  6. Cuando un proyecto de secuencia de comandos reside en una unidad compartida, se puede restringir el acceso a su proyecto de Cloud Platform (GCP). Consulta la sección de la guía Proyectos de GCP y unidades compartidas para obtener más detalles.
  7. Las apps web implementadas en un dominio dejan de funcionar si su propiedad cambia a una unidad compartida o una cuenta en un dominio diferente. Para corregir esto, vuelve a mover la secuencia de comandos a su dominio original.
  8. Del mismo modo, los proyectos de secuencias de comandos que se implementan como un ejecutable de la API de Apps Script dejan de funcionar cuando la API los llama si se mueven de un dominio a otro a través de una unidad compartida. Para corregir esto, vuelve a mover la secuencia de comandos a su dominio original.

Colabora con una carpeta compartida

Si no puedes colaborar con una unidad compartida, puedes usar una carpeta compartida. Cuando creas o mueves un proyecto de Apps Script a una carpeta de Google Drive a la que pueden acceder otras personas, heredan el mismo acceso al proyecto de Apps Script que tienen para la carpeta. Por ejemplo:

  • Si alguien tiene acceso de edición a la carpeta, puede editar o borrar el proyecto de Apps Script y ejecutar la secuencia de comandos.
  • Si alguien solo tiene acceso de lectura a la carpeta, puede ver el proyecto de Apps Script y ejecutar la secuencia de comandos.

Colabora con el uso compartido de proyectos

Puedes colaborar en un proyecto si lo compartes directamente con todos los colaboradores. Puedes compartir directamente proyectos de secuencias de comandos que se encuentren en carpetas normales de Google Drive o en unidades compartidas. Si usas este método, se recomienda que planifiques cuidadosamente quién es propietario y mantiene la secuencia de comandos con el tiempo.

Los proyectos independientes aparecen en Google Drive como un archivo que puedes compartir como cualquier otro archivo. Para obtener más información, consulta Cómo compartir archivos y carpetas.

Los proyectos vinculados a contenedores no son visibles desde tu Google Drive. Para compartir un proyecto vinculado a un contenedor, comparte el archivo de contenedor superior. Por ejemplo, si tienes una secuencia de comandos vinculada a una hoja de cálculo de Google, puedes designar a alguien como editor de la secuencia de comandos convirtiéndola en editor de la hoja de cálculo. Los proyectos vinculados a contenedores heredan la configuración de acceso de visualizador y editor de sus archivos de contenedor.

Todas las secuencias de comandos vinculadas al contenedor usan la misma lista de propietario, visualizador y acceso de editor definida para el archivo del contenedor. El propietario del contenedor asume la propiedad de un proyecto de secuencia de comandos nuevo sin importar quién lo creó.

Recursos de proyectos y colaboración

Los recursos son entidades asociadas con tu proyecto, pero que existen independientemente de su código. En esta sección, se explica cómo la colaboración en un proyecto afecta sus recursos, en particular: el proyecto de Cloud Platform, los activadores, las bibliotecas y las propiedades del usuario.

Colaboración y proyectos de Google Cloud

Cada proyecto de Apps Script tiene un proyecto de Google Cloud asociado. Los proyectos de Google Cloud tienen su propio conjunto de propietarios, editores y otras funciones, que pueden ser diferentes del conjunto de usuarios que pueden acceder al proyecto de secuencia de comandos.

Si el proyecto de secuencia de comandos está destinado a publicarse como un complemento, debe usar un proyecto estándar de Google Cloud. Cuando colabores en una aplicación que usa un proyecto estándar de Google Cloud, te recomendamos que configures los propietarios y las funciones de Google Cloud para asegurarte de que todos tus colaboradores tengan los niveles de acceso adecuados. Esto ayuda a evitar situaciones en las que pierdes el acceso a la configuración de Cloud del proyecto porque sus propietarios ya no están en tu organización. Esto es especialmente importante para los complementos.

Colaboración y activadores

Cuando colaboras en un proyecto, cualquier activador instalable que crees no se comparte con quienes tienen acceso a tu proyecto. Si necesitas tener una configuración de activador coherente para todos los colaboradores, puedes usar el servicio de Script para crear activadores de manera programática en el tiempo de ejecución. Para obtener más información, consulta Administra activadores de manera programática.

Colaboración y bibliotecas

Las bibliotecas incluidas en el proyecto están disponibles para los colaboradores del proyecto. Sin embargo, si no tienen, al menos, acceso de nivel de lectura a una biblioteca incluida, no puede usarlas; en este caso, la secuencia de comandos arroja un error. Para obtener más información sobre las bibliotecas, consulta Cómo administrar bibliotecas.

Colaboración y propiedades del usuario

Las propiedades del usuario son únicas para el usuario que las creó. Esto significa que los colaboradores del proyecto no pueden ver tus propiedades del usuario ni acceder a ellas, y tú no puedes ver las suyas ni acceder a ellas. Usa las propiedades de secuencia de comandos si deseas compartir propiedades específicas del proyecto con los colaboradores. Para obtener más información, consulta la Guía de propiedades.