Apps Script ofrece algunas funciones que te ayudan a ti y a otros desarrolladores a crear y mantener juntas las secuencias de comandos, los complementos y las aplicaciones web.
Conceptos básicos de la colaboración
Para colaborar en un proyecto, tú y tus colaboradores deben tener de editor al archivo del proyecto de Apps Script (y a su contenedor, si es una secuencia de comandos vinculada). Esto permitirá que todos los miembros de tu equipo ver y realizar cambios en el código de Apps Script. Los editores también pueden crear código nuevo publicar complementos e implementar secuencias de comandos como aplicaciones web o ejecutables para la API de Apps Script.
Puedes ayudar a tu equipo planificando de antemano cómo manejarás la edición, revisar, controlar las versiones y (si corresponde) la implementación y publicación de sus proyecto, complemento o aplicación web. Los proyectos independientes suelen ser los más fáciles para colaborar, porque aparecen directamente en Google Drive y son 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 otro miembro del equipo. Esto puede hacer que no puedas mantener o actualizar el proyecto. Ubicar 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.
Colaborar con la herramienta de línea de comandos de clasp
clasp te permite sincronizar proyectos entre script.google.com y tu archivo local
en un sistema de archivos. Esto te permite optimizar y automatizar el desarrollo de código si
y tus colaboradores usan software de administración de control de fuente, como
git
Para obtener más información, consulta Interfaz de línea de comandos
con la guía de clasp
Colabora con unidades compartidas
Unidades compartidas (antes conocidas como "Unidades de equipo") ofrecen un espacio compartido en una unidad de Google Drive donde los grupos los usuarios puedan colaborar de manera más eficaz. Los archivos que se colocan en una unidad compartida son de propiedad por el grupo como un todo, en lugar de por los individuos. Esto significa que cuando un El colaborador abandona el grupo, ya que no asume la propiedad ni el control del archivo. de ellos.
Las unidades compartidas también te permiten transferir archivos entre dominios, es decir, una unidad compartida de un dominio pueden tener colaboradores de otro dominio que pueden mover archivos de ese dominio en la unidad compartida. Esto puede ser muy valioso para Apps Script desarrolladores, ya que es un medio para que un equipo pueda desarrollar complementos, aplicaciones web, o algún otro código para clientes en dominios diferentes.
Cuando uses unidades compartidas para colaborar en proyectos de Apps Script, mantén la lo siguiente:
- Los colaboradores con acceso de edición 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 secuencias de comandos, crear nuevas versiones de estas publicar complementos.
- Para implementar secuencias de comandos como aplicaciones web o ejecutables de la API de Apps Script, sigue estos pasos: la cuenta que crea la implementación debe pertenecer al mismo dominio que unidad compartida en la que reside la secuencia de comandos.
- Las unidades compartidas te permiten compartir archivos específicos dentro de la unidad compartida con a las demás personas ajenas al grupo y a actualizar sus permisos de edición y lectura en esos archivos como cualquier otro archivo de Drive. Sin embargo, si un usuario está parte del equipo al que pertenece la unidad compartida, no puedes reducir su acceso para determinados archivos. Por ejemplo, si un usuario tiene acceso de edición a una unidad compartida, no podrás cámbialo al acceso de solo lectura de un archivo específico de la unidad compartida.
- Los colaboradores con acceso completo a una unidad compartida también pueden borrar archivos y proyectos de Apps Script, y transferir archivos de la unidad compartida.
- Todas las secuencias de comandos vinculadas al contenedor Usar las mismas listas de acceso de visualizador y editor que se definen para el archivo 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. Ubicar un archivo de contenedor en una unidad compartida otorga a sus colaboradores el mismo acceso al código de 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) pueden restringirse. Consulta la Proyectos de GCP y unidades compartidas sección de la guía para obtener más detalles.
- Apps web implementadas en un dominio dejan de funcionar si su propiedad cambia a unidad compartida o cuenta en un dominio diferente. Esto se puede corregir mover la secuencia de comandos de vuelta a su dominio original.
- De forma similar, los proyectos de secuencias de comandos que son implementado como un ejecutable de la API de Apps Script dejan de funcionar cuando la API lo llama si se trasladan a través de una unidad compartida desde de un dominio a otro. Esto se puede corregir si vuelves a mover la secuencia de comandos a su dominio original.
Cómo colaborar con una carpeta compartida
Si no puedes colaborar con una unidad compartida, puedes usar una carpeta compartida, en su lugar. Cuando creas o mueves un proyecto de Apps Script a una a la carpeta de Google Drive a la que pueden acceder otras personas, heredan el mismo acceso. al proyecto de Apps Script que tiene para la carpeta. Por ejemplo:
- Si alguien tiene acceso de edición a la carpeta, puede editar o eliminar el proyecto de Apps Script y ejecutar la secuencia de comandos.
- Si alguien solo tiene acceso de lectura a la carpeta, podrá ver el proyecto de Apps Script y ejecutar la secuencia de comandos.
Colabora con el uso compartido de proyectos
Puedes colaborar en un proyecto compartiéndolo directamente con todos los colaboradores. Puede compartir directamente los proyectos de secuencias de comandos que residen en en carpetas de Google Drive o en unidades compartidas. Si usas este método, se recomendó que planificaras cuidadosamente quién es el propietario y quién mantiene el guion a lo largo del tiempo.
Los proyectos independientes aparecen en tu unidad de Google Drive como un archivo y puedes compartirlos como cualquier otro archivo. Para ver más información, consulta Cómo compartir archivos y carpetas
Los proyectos vinculados al contenedor no son visibles desde tu Google Drive Para compartir un proyecto vinculado a un contenedor, comparte el elemento superior un archivo contenedor. Por ejemplo, si tienes una secuencia de comandos vinculada a un archivo una hoja de cálculo, puedes convertir a alguien en editor del guion convirtiéndolo en editor del en una hoja de cálculo. Los proyectos vinculados al contenedor heredan el acceso de visualizador y editor. del archivo contenedor.
Todas las secuencias de comandos vinculadas al contenedor usan el mismo propietario, visualizador y de acceso de editores definida para el archivo contenedor. El propietario del contenedor toma la propiedad de un proyecto de secuencia de comandos nuevo, independientemente de quién lo haya creado.
Recursos para la colaboración y el proyecto
Los recursos son entidades que están asociadas con tu proyecto, pero que existen con independencia de su código. Esta sección explica cómo colaborar en un proyecto afecta a sus recursos, en particular: el proyecto de Cloud Platform, los activadores bibliotecas y propiedades del usuario.
Colaboración y proyectos de Google Cloud
Cada proyecto de Apps Script tiene asociado Proyecto de Google Cloud. Los proyectos de Google Cloud tienen su propio conjunto de propietarios, editores y otros roles, que puede ser diferente del conjunto de usuarios que pueden acceder a la secuencia en un proyecto final.
Si tu proyecto de secuencia de comandos debe publicarse como un complemento, debe usar un proyecto estándar de Google Cloud. Cuando colaboras en una aplicación que usa un proyecto estándar de Google Cloud, recomendar Configura los propietarios y roles de Google Cloud para asegurarse de que todos los colaboradores tengan los niveles de acceso adecuados. Esto ayuda situaciones en las que pierdas acceso a la configuración de Cloud del proyecto sus propietarios ya no pertenecen a tu organización. Esto es especialmente importante para los complementos.
Colaboración y activadores
Cuando colaboras en un proyecto, cualquier activadores instalables que crees no se comparten 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 secuencia de comandos para crear activadores de forma programática en el entorno de ejecución. Para obtener más información, consulta Administra activadores de manera programática.
Colaboración y bibliotecas
Las bibliotecas incluidas en tu 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á 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
Colaboración y propiedades del usuario
Propiedades del usuario son únicas para el usuario que las creó. Esto significa que el los colaboradores del proyecto no podrán ver tus propiedades del usuario ni acceder a ellas, y no puede ver los suyos ni acceder a ellos. Usa Propiedades de las secuencias de comandos si quieres compartir propiedades específicas del proyecto con los colaboradores. Para más información, consulta la Guía de propiedades.