Apps Script ofrece algunas funciones que te ayudan a ti y a otros desarrolladores a compilar y mantener juntos secuencias de comandos, complementos y aplicaciones web.
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 realicen cambios en el código de Apps Script. Los editores también pueden crear versiones nuevas del código, publicar complementos e implementar secuencias de comandos como apps web o como ejecutables para la API de Apps Script.
Puedes ayudar a tu equipo si planificas de antemano la forma en que manejas 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 aplicaciones web y complementos.
Un problema común en la colaboración se produce cuando el propietario de un proyecto de secuencia de comandos abandona el equipo sin transferir la propiedad del proyecto a alguien más en el equipo. Esto puede hacer que no puedas mantener ni actualizar el proyecto. Colocar tu proyecto de secuencia de comandos en una unidad compartida evita este problema, ya que los archivos en una unidad compartida no tienen propietarios específicos.
Colaboración 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.
Consulta la guía de la línea de comandos mediante clasp para obtener más detalles.
Colabora con unidades compartidas
Las unidades compartidas (antes conocidas como "unidades de equipo") proporcionan un espacio compartido en Google Drive en el que los grupos de usuarios de Drive pueden colaborar de manera más efectiva. Los archivos que se encuentran en una unidad compartida son propiedad del grupo en conjunto, en lugar de personas individuales. Esto significa que, cuando un colaborador abandona el grupo, no se hace cargo de ellos ni se hace cargo de ellos.
Las unidades compartidas también te permiten mover archivos entre dominios. Una unidad compartida de 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, aplicaciones web o cualquier otro código para los clientes en diferentes dominios.
Cuando uses unidades compartidas para colaborar en proyectos de Apps Script, ten en cuenta lo siguiente:
- Los colaboradores con acceso de editor a una unidad compartida pueden crear o mover archivos nuevos a la unidad compartida. Como editores de secuencias de comandos, pueden ver y editar proyectos de secuencias de comandos, ejecutar código de secuencia de comandos, crear nuevas versiones de secuencia de comandos y publicar complementos.
- A fin de implementar secuencias de comandos como aplicaciones 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 reside la secuencia de comandos.
- Las unidades compartidas te permiten compartir archivos específicos de la unidad compartida con otras personas fuera del grupo y actualizar sus permisos de edición y visualización en esos archivos como 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 podrás cambiarla a acceso de solo lectura para un archivo específico dentro de la unidad compartida.
- Los colaboradores con acceso completo a una unidad compartida, además de lo anterior, pueden borrar archivos y proyectos de Apps Script, y quitarlos de la unidad compartida.
- Todas las secuencias de comandos vinculadas a contenedores usan las mismas listas de acceso de visualizador y editor definidas para el archivo de 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. Si colocas este archivo de contenedor en una unidad compartida, les otorgas a los colaboradores de la unidad compartida el mismo acceso al código de la secuencia de comandos que tienen para el contenedor.
- Cuando un proyecto de secuencia de comandos reside en una unidad compartida, el acceso a su proyecto de Cloud Platform (GCP) puede estar restringido. Consulta la sección de proyectos de GCP y unidades compartidas para obtener más detalles.
- Las aplicaciones web implementadas en un dominio dejan de funcionar si su propiedad cambia a una unidad compartida o cuenta de un dominio diferente. Esto se puede corregir si mueves la secuencia de comandos a su dominio original.
- De manera similar, los proyectos de secuencia de comandos que se implementan como un ejecutable de la API de Apps Script fallan para funcionar cuando la API los llama si se mueven a través de una unidad compartida de un dominio a otro. Esto se puede corregir si mueves la secuencia de comandos a su dominio original.
Cómo colaborar con el uso compartido del proyecto
También puedes colaborar en un proyecto si compartes el proyecto directamente con todos los colaboradores. Puedes compartir directamente los proyectos de secuencias de comandos que se encuentran en las carpetas comunes de Google Drive o en las unidades compartidas. Si usas este método, se recomienda que planifiques atentamente quién es el propietario y mantiene la secuencia de comandos a lo largo del tiempo.
Los proyectos independientes aparecen en tu Google Drive como un archivo y puedes compartirlos como cualquier otro archivo. Para obtener más información, consulta Comparte archivos y carpetas.
Los proyectos vinculados a contenedores no son visibles desde tu Google Drive. Para compartir un proyecto vinculado a un contenedor, simplemente comparte el archivo del contenedor superior. Por ejemplo, si tienes una secuencia de comandos vinculada a una Hoja de cálculo de Google, puedes convertir a alguien en editor de la secuencia de comandos. Para ello, debes convertirlo en editor de esa hoja. Todos los proyectos de ese contenedor heredan la configuración de acceso del visualizador y del editor del archivo de contenedor.
Todas las secuencias de comandos vinculadas a contenedores usan el mismo propietario, visualizador y lista de acceso de editor definida para el archivo contenedor. El propietario del contenedor se encarga de un proyecto de secuencia de comandos nuevo, sin importar quién lo creó.
Recursos de proyectos y colaboración
Los recursos son entidades que están asociadas con tu proyecto, pero que son independientes de su código. En esta sección, se explica cómo la colaboración en un proyecto afecta sus recursos, en particular, su proyecto de Cloud Platform, los activadores, las bibliotecas y las propiedades del usuario.
Proyectos de colaboración y de Cloud Platform
Cada proyecto de Apps Script tiene un proyecto de Cloud Platform (GCP) asociado. Los proyectos de GCP 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 la secuencia de comandos está diseñado para publicarse como un complemento, debe usar un proyecto de GCP estándar. Cuando colaboras en una aplicación que usa un proyecto de GCP estándar, te recomendamos que configures las funciones y los propietarios de GCP 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 la nube 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 tengan acceso a tu proyecto. Si necesitas tener una configuración de activador coherente para todos los colaboradores, puedes usar el servicio de secuencia de comandos a fin de crear activadores de manera programática, en 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 podrán usar esas bibliotecas; la secuencia de comandos arrojará un error en este caso. Para obtener más información sobre las bibliotecas, consulta Cómo administrar bibliotecas.
Propiedades de usuario y colaboración
Las propiedades del usuario son únicas para el usuario que las creó. Esto significa que los colaboradores del proyecto no pueden ver las propiedades de usuario ni acceder a ellas. Usa las propiedades de secuencias de comandos si deseas compartir las propiedades específicas del proyecto con los colaboradores. Para obtener más información, consulta la guía de propiedades.