Apps Script برخی از ویژگی‌هایی را ارائه می‌کند که به شما و سایر توسعه‌دهندگان کمک می‌کند تا اسکریپت‌ها، افزونه‌ها و برنامه‌های وب را با هم بسازید و نگهداری کنید.
اصول همکاری
برای همکاری در یک پروژه، همه شما و همکارانتان باید به فایل پروژه Apps Script (و محفظه آن، اگر یک اسکریپت محدود است) دسترسی ویرایشگر داشته باشید. این به همه اعضای تیم شما امکان می‌دهد کد Apps Script را ببینند و تغییراتی در آن ایجاد کنند. ویراستارها همچنین می‌توانند نسخه‌های کد جدید ایجاد کنند، افزونه‌ها را منتشر کنند، و اسکریپت‌ها را به‌عنوان برنامه‌های وب یا به‌عنوان فایل‌های اجرایی برای Apps Script API اجرا کنند.
می‌توانید با برنامه‌ریزی از قبل برای نحوه مدیریت ویرایش، بازبینی، نسخه‌سازی و (در صورت وجود) استقرار و انتشار پروژه، افزونه یا برنامه وب به تیم خود کمک کنید. پروژه‌های مستقل معمولاً ساده‌ترین راه برای همکاری هستند، زیرا مستقیماً در Google Drive ظاهر می‌شوند و نوع پروژه پیشنهادی برای توسعه برنامه‌های افزودنی و وب هستند.
یک مشکل رایج در همکاری زمانی رخ می دهد که صاحب پروژه اسکریپت تیم را بدون انتقال مالکیت پروژه به شخص دیگری در تیم ترک می کند. این باعث می شود که نتوانید پروژه را حفظ یا به روز کنید. قرار دادن پروژه اسکریپت خود در درایو مشترک از این مشکل جلوگیری می کند، زیرا فایل های موجود در درایو مشترک صاحبان خاصی ندارند.
با ابزار خط فرمان clasp همکاری کنید
clasp به شما امکان می دهد پروژه ها را بین script.google.com و سیستم فایل محلی خود همگام سازی کنید. اگر شما و همکارانتان از نرم افزار مدیریت کنترل منبع مانند git استفاده می کنید، این به شما امکان می دهد توسعه کد خود را ساده و خودکار کنید.
برای جزئیات بیشتر، به رابط خط فرمان با استفاده از راهنمای clasp مراجعه کنید.
با درایوهای مشترک همکاری کنید
درایوهای مشترک (که قبلاً به عنوان «درایوهای گروه» شناخته می‌شد) فضای مشترکی را در Google Drive فراهم می‌کنند که گروه‌هایی از کاربران Drive می‌توانند به طور مؤثرتری با یکدیگر همکاری کنند. فایل‌هایی که در یک درایو مشترک قرار می‌گیرند، به‌جای افراد، متعلق به کل گروه هستند. این بدان معناست که وقتی یک همکار گروه را ترک می‌کند، مالکیت و کنترل فایل را با او نمی‌گیرد.
درایوهای مشترک همچنین به شما امکان می‌دهند فایل‌ها را در دامنه‌ها جابه‌جا کنید - یک درایو مشترک در یک دامنه می‌تواند مشارکت‌کنندگانی از دامنه دیگری داشته باشد که می‌توانند فایل‌ها را از آن دامنه به درایو مشترک منتقل کنند. این می تواند برای توسعه دهندگان Apps Script بسیار ارزشمند باشد، زیرا ابزاری را برای یک تیم برای توسعه افزونه ها، برنامه های وب یا کدهای دیگر برای مشتریان در دامنه های مختلف فراهم می کند.
هنگامی که از درایوهای مشترک برای همکاری در پروژه های Apps Script استفاده می کنید، موارد زیر را در نظر داشته باشید:
- همکاران با دسترسی ویرایشگر به درایو مشترک می‌توانند فایل‌های جدیدی را به درایو مشترک ایجاد یا منتقل کنند. به عنوان ویرایشگر اسکریپت، آنها می توانند پروژه های اسکریپت را مشاهده و ویرایش کنند، کد اسکریپت را اجرا کنند، نسخه های جدید اسکریپت ایجاد کنند، افزونه ها را منتشر کنند.
- برای استقرار اسکریپت‌ها به‌عنوان برنامه‌های وب یا فایل‌های اجرایی برای Apps Script API ، حسابی که استقرار را ایجاد می‌کند باید به همان دامنه درایو مشترکی که اسکریپت در آن قرار دارد تعلق داشته باشد.
- درایوهای مشترک به شما امکان می‌دهند فایل‌های خاصی را در درایو مشترک با دیگران خارج از گروه به اشتراک بگذارید و مجوزهای ویرایش و مشاهده آنها را در آن فایل‌ها مانند سایر فایل‌های Drive به‌روزرسانی کنید. با این حال، اگر کاربر بخشی از تیمی باشد که درایو مشترک به آن تعلق دارد، نمی‌توانید دسترسی او را برای فایل‌های خاص کاهش دهید. برای مثال، اگر کاربری به یک درایو مشترک دسترسی ویرایش داشته باشد، نمی‌توانید آن را به دسترسی فقط مشاهده برای یک فایل خاص در درایو مشترک تغییر دهید.
- مشارکت‌کنندگانی که دسترسی کامل به درایو مشترک دارند همچنین می‌توانند فایل‌ها و پروژه‌های Apps Script را حذف کنند و فایل‌ها را به خارج از درایو مشترک منتقل کنند.
- همه اسکریپت های محدود به کانتینر از لیست های دسترسی نمایشگر و ویرایشگر یکسانی استفاده می کنند که برای فایل کانتینر تعریف شده است. برای مثال، اگر به یک برگه Google دسترسی ویرایش دارید، به هر کد پروژه Apps Script متصل به آن نیز دسترسی ویرایش دارید. قرار دادن چنین فایل کانتینری در یک درایو مشترک به همکاران درایو مشترک همان دسترسی را به کد اسکریپت می دهد که برای خود ظرف دارند.
- وقتی یک پروژه اسکریپت در یک درایو مشترک قرار دارد، ممکن است دسترسی به پروژه Cloud Platform (GCP) آن محدود شود. برای جزئیات بیشتر به بخش راهنمای پروژه‌های GCP و درایوهای مشترک مراجعه کنید.
- برنامه های وب مستقر شده در یک دامنه در صورتی که مالکیت آنها به یک درایو مشترک یا حساب در دامنه دیگری تغییر کند، دیگر کار نمی کنند. این را می توان با انتقال اسکریپت به دامنه اصلی خود اصلاح کرد.
- به طور مشابه، پروژه‌های اسکریپت که به‌عنوان یک فایل اجرایی Apps Script API مستقر می‌شوند، در صورت انتقال از طریق درایو مشترک از یک دامنه به دامنه دیگر، وقتی توسط API فراخوانی می‌شوند، دیگر کار نمی‌کنند. این را می توان با انتقال اسکریپت به دامنه اصلی خود اصلاح کرد.
با یک پوشه مشترک همکاری کنید
اگر نمی توانید با یک درایو مشترک همکاری کنید، می توانید به جای آن از یک پوشه مشترک استفاده کنید. وقتی یک پروژه Apps Script را ایجاد می‌کنید یا به پوشه Google Drive منتقل می‌کنید که افراد دیگر می‌توانند به آن دسترسی داشته باشند، همان دسترسی را به پروژه Apps Script که برای پوشه دارند به ارث می‌برند. مثلا:
- اگر شخصی به پوشه دسترسی ویرایش داشته باشد، می تواند پروژه Apps Script را ویرایش یا حذف کند و اسکریپت را اجرا کند.
- اگر شخصی فقط به پوشه دسترسی داشته باشد، می تواند پروژه Apps Script را مشاهده کند و اسکریپت را اجرا کند.
با به اشتراک گذاری پروژه همکاری کنید
شما می توانید با به اشتراک گذاری مستقیم پروژه با همه همکاران، در یک پروژه همکاری کنید. می‌توانید مستقیماً پروژه‌های اسکریپتی را که در پوشه‌های Google Drive معمولی یا در درایوهای مشترک قرار دارند به اشتراک بگذارید. اگر از این روش استفاده می‌کنید، توصیه می‌شود به دقت برنامه‌ریزی کنید که چه کسی مالک و نگه‌دارنده اسکریپت در طول زمان است.
پروژه های مستقل در Google Drive شما به عنوان یک فایل نمایش داده می شوند و می توانید آنها را مانند هر فایل دیگری به اشتراک بگذارید. برای اطلاعات بیشتر، به اشتراک گذاری فایل ها و پوشه ها مراجعه کنید.
پروژه‌های محدود به کانتینر از Google Drive شما قابل مشاهده نیستند. برای به اشتراک گذاشتن یک پروژه محدود به کانتینر، فایل کانتینر والد را به اشتراک بگذارید. برای مثال، اگر یک اسکریپت متصل به صفحه‌گسترده Google Sheets دارید، می‌توانید شخصی را با تبدیل کردن او به ویرایشگر صفحه‌گسترده، ویرایشگر اسکریپت کنید. پروژه های محدود به کانتینر تنظیمات دسترسی بیننده و ویرایشگر فایل کانتینری خود را به ارث می برند.
همه اسکریپت‌های محدود به کانتینر از فهرست دسترسی مالک، بیننده و ویرایشگر یکسانی استفاده می‌کنند که برای فایل کانتینر تعریف شده است . مالک کانتینر مالکیت پروژه اسکریپت جدید را بدون توجه به اینکه چه کسی آن را ایجاد کرده است، در اختیار می‌گیرد.
همکاری و منابع پروژه
منابع موجودیت هایی هستند که با پروژه شما مرتبط هستند اما مستقل از کد آن وجود دارند. این بخش توضیح می‌دهد که چگونه همکاری در یک پروژه بر منابع آن تأثیر می‌گذارد، به ویژه: پروژه پلتفرم ابری، راه‌اندازها، کتابخانه‌ها و ویژگی‌های کاربر.
پروژه های همکاری و Google Cloud
هر پروژه Apps Script یک پروژه Google Cloud مرتبط دارد. پروژه‌های Google Cloud دارای مجموعه‌ای از مالکان، ویرایشگرها و نقش‌های دیگر هستند که می‌تواند با مجموعه کاربرانی که می‌توانند به پروژه اسکریپت دسترسی داشته باشند متفاوت باشد.
اگر قرار است پروژه اسکریپت شما به عنوان یک افزونه منتشر شود، باید از پروژه استاندارد Google Cloud استفاده کند. وقتی روی برنامه‌ای همکاری می‌کنید که از پروژه استاندارد Google Cloud استفاده می‌کند، توصیه می‌کنیم مالکان و نقش‌های Google Cloud را پیکربندی کنید تا اطمینان حاصل کنید که همه همکاران شما سطوح مناسبی از دسترسی را دارند. این به جلوگیری از موقعیت‌هایی کمک می‌کند که دسترسی به تنظیمات Cloud پروژه را از دست بدهید زیرا صاحبان آن دیگر در سازمان شما نیستند. این به ویژه برای افزونه ها مهم است.
همکاری و محرک ها
هنگامی که در پروژه ای با هم همکاری می کنید، هرگونه محرک قابل نصبی که ایجاد می کنید با کسانی که به پروژه شما دسترسی دارند به اشتراک گذاشته نمی شود. اگر نیاز دارید که راه‌اندازی ثابتی برای همه همکاران داشته باشید، می‌توانید از سرویس اسکریپت برای ایجاد محرک‌ها به صورت برنامه‌نویسی در زمان اجرا استفاده کنید. برای اطلاعات بیشتر، به مدیریت محرک ها به صورت برنامه ای مراجعه کنید.
همکاری و کتابخانه ها
کتابخانه های موجود در پروژه شما در دسترس همکاران پروژه است. با این حال، اگر حداقل دسترسی سطح خواندن به یک کتابخانه گنجانده شده نداشته باشند، نمی توانند از آن کتابخانه ها استفاده کنند - اسکریپت در این مورد یک خطا ایجاد می کند. برای اطلاعات بیشتر درباره کتابخانه ها، به مدیریت کتابخانه ها مراجعه کنید.
همکاری و ویژگی های کاربر
ویژگی های کاربر منحصر به فردی است که آنها را ایجاد کرده است. این بدان معنی است که همکاران پروژه نمی توانند ویژگی های کاربر شما را ببینند یا به آنها دسترسی داشته باشند و شما نمی توانید ویژگی های آنها را ببینید یا به آنها دسترسی پیدا کنید. اگر می‌خواهید ویژگی‌های خاص پروژه را با همکاران به اشتراک بگذارید، از ویژگی‌های اسکریپت استفاده کنید. برای اطلاعات بیشتر، به راهنمای Properties مراجعه کنید.