Apps Script menyediakan beberapa fitur yang membantu Anda dan developer lain membuat dan mengelola skrip, add-on, serta aplikasi web secara bersamaan.
Dasar-dasar kolaborasi
Untuk berkolaborasi pada project, Anda dan kolaborator harus memiliki akses editor ke file project Apps Script (dan penampungnya, jika berupa skrip terikat). Dengan begitu, semua orang di tim Anda dapat melihat dan mengubah kode Apps Script. Editor juga dapat membuat versi kode baru, memublikasikan add-on, dan men-deploy skrip sebagai aplikasi web atau sebagai file yang dapat dieksekusi untuk Apps Script API.
Anda dapat membantu tim dengan merencanakan terlebih dahulu cara Anda menangani pengeditan, peninjauan, pembuatan versi, dan (jika berlaku) deployment serta publikasi project, add-on, atau aplikasi web. Project mandiri biasanya adalah cara yang paling mudah untuk berkolaborasi karena muncul langsung di Google Drive dan merupakan jenis project yang direkomendasikan untuk pengembangan add-on dan aplikasi web.
Masalah umum dalam kolaborasi terjadi saat pemilik project skrip meninggalkan tim tanpa mentransfer kepemilikan project kepada orang lain dalam tim. Hal ini dapat menyebabkan Anda tidak dapat mempertahankan atau memperbarui project. Menempatkan project skrip di drive bersama dapat mencegah masalah ini, karena file di drive bersama tidak memiliki pemilik khusus.
Berkolaborasi dengan alat command line clasp
clasp memungkinkan Anda menyinkronkan project antara script.google.com dan sistem
file lokal. Hal ini memungkinkan Anda menyederhanakan dan mengotomatiskan pengembangan kode jika Anda
dan kolaborator menggunakan software pengelolaan kontrol sumber seperti
git.
Untuk detail selengkapnya, lihat Antarmuka Command Line
menggunakan panduan clasp.
Berkolaborasi dengan drive bersama
Drive bersama (sebelumnya dikenal sebagai "Drive Tim") menyediakan ruang bersama di Google Drive tempat grup pengguna Drive dapat berkolaborasi dengan lebih efektif. File yang ditempatkan di drive bersama adalah milik grup secara keseluruhan, bukan perorangan. Artinya, saat kolaborator keluar dari grup, mereka tidak mengambil kepemilikan dan kontrol file dengan mereka.
Drive bersama juga memungkinkan Anda memindahkan file di seluruh domain — drive bersama di satu domain dapat memiliki kolaborator dari domain lain yang dapat memindahkan file dari domain tersebut ke drive bersama. Hal ini dapat sangat bermanfaat bagi developer Apps Script karena menyediakan sarana bagi tim untuk mengembangkan add-on, aplikasi web, atau kode lain untuk pelanggan di domain yang berbeda.
Saat Anda menggunakan drive bersama untuk berkolaborasi dalam project Apps Script, perhatikan hal-hal berikut:
- Kolaborator yang memiliki akses editor ke drive bersama dapat membuat atau memindahkan file baru ke drive bersama. Sebagai editor skrip, mereka dapat melihat dan mengedit project skrip, menjalankan kode skrip, membuat versi skrip baru, dan memublikasikan add-on.
- Untuk men-deploy skrip sebagai aplikasi web atau file yang dapat dieksekusi untuk Apps Script API, akun yang membuat deployment harus berada di domain yang sama dengan drive bersama tempat skrip berada.
- Drive bersama memungkinkan Anda berbagi file tertentu dalam drive bersama kepada orang lain di luar grup, dan memperbarui izin edit dan lihat di file tersebut seperti file Drive lainnya. Namun, jika pengguna adalah bagian dari tim tempat drive bersama berada, Anda tidak dapat mengurangi akses mereka untuk file tertentu. Misalnya, jika pengguna memiliki akses edit ke drive bersama, Anda tidak dapat mengubahnya menjadi akses hanya lihat untuk file tertentu dalam drive bersama.
- Kolaborator yang memiliki akses penuh ke drive bersama juga dapat menghapus file dan project Apps Script, serta memindahkan file keluar dari drive bersama.
- Semua skrip yang dibatasi penampung menggunakan daftar akses pelihat dan editor yang sama yang ditentukan untuk file penampung. Misalnya, jika memiliki akses edit ke Spreadsheet Google, Anda juga memiliki akses edit ke kode project Apps Script yang dilampirkan. Menempatkan file penampung tersebut ke dalam drive bersama akan memberikan akses yang sama kepada kolaborator drive bersama ke kode skrip seperti yang mereka miliki untuk penampung itu sendiri.
- Jika project skrip berada di drive bersama, akses ke project Cloud Platform (GCP)-nya mungkin dibatasi. Lihat bagian panduan project GCP dan drive bersama untuk mengetahui detailnya.
- Aplikasi web yang di-deploy di satu domain akan berhenti berfungsi jika kepemilikannya berubah menjadi drive bersama atau akun di domain yang berbeda. Hal ini dapat diperbaiki dengan memindahkan skrip kembali ke domain aslinya.
- Demikian pula, project skrip yang di-deploy sebagai Apps Script API yang dapat dieksekusi tidak akan berfungsi saat dipanggil oleh API jika dipindahkan melalui drive bersama dari satu domain ke domain lainnya. Hal ini dapat diperbaiki dengan memindahkan skrip kembali ke domain aslinya.
Berkolaborasi dengan folder bersama
Jika tidak dapat berkolaborasi dengan drive bersama, Anda dapat menggunakan folder bersama. Saat Anda membuat atau memindahkan project Apps Script ke folder Google Drive yang dapat diakses orang lain, mereka akan mewarisi akses yang sama ke project Apps Script yang mereka miliki untuk folder tersebut. Contoh:
- Jika seseorang memiliki akses edit ke folder, dia dapat mengedit atau menghapus project Apps Script dan menjalankan skrip.
- Jika seseorang hanya memiliki akses lihat ke folder, dia dapat melihat project Apps Script dan menjalankan skrip.
Berkolaborasi dengan berbagi project
Anda dapat berkolaborasi pada suatu project dengan membagikan project tersebut secara langsung kepada semua kolaborator. Anda dapat langsung membagikan project skrip yang berada di folder Google Drive reguler atau di drive bersama. Jika menggunakan metode ini, sebaiknya Anda merencanakan dengan cermat siapa yang memiliki dan mengelola skrip dari waktu ke waktu.
Project mandiri akan muncul di Google Drive sebagai file dan dapat Anda bagikan seperti file lainnya. Untuk mengetahui informasi selengkapnya, lihat Berbagi file dan folder.
Project yang terikat pada container tidak terlihat dari Google Drive Anda. Untuk membagikan project yang terikat dengan container, bagikan file penampung induk. Misalnya, jika Anda memiliki skrip yang terikat dengan spreadsheet Google Spreadsheet, Anda dapat menjadikan seseorang sebagai editor skrip dengan menjadikan orang tersebut editor spreadsheet. Project yang terikat container mewarisi setelan akses editor dan pelihat dari file container-nya.
Semua skrip yang terikat penampung menggunakan daftar akses pemilik, pelihat, dan editor yang sama yang ditentukan untuk file penampung. Pemilik penampung mengambil alih kepemilikan project skrip baru, terlepas dari siapa yang membuatnya.
Kolaborasi dan sumber daya proyek
Resource adalah entity yang terkait dengan project Anda, tetapi ada secara terpisah dari kodenya. Bagian ini menjelaskan bagaimana kolaborasi pada project memengaruhi resource-nya, khususnya: project Cloud Platform, pemicu, library, dan properti pengguna.
Kolaborasi dan project Google Cloud
Setiap project Apps Script memiliki project Google Cloud terkait. Project Google Cloud memiliki kumpulan pemilik, editor, dan peran lainnya sendiri, yang mungkin berbeda dengan kumpulan pengguna yang dapat mengakses project skrip.
Jika project skrip Anda dimaksudkan untuk dipublikasikan sebagai add-on, project tersebut harus menggunakan project Google Cloud standar. Saat Anda berkolaborasi pada aplikasi yang menggunakan project Google Cloud standar, sebaiknya Anda mengonfigurasi pemilik dan peran Google Cloud untuk memastikan semua kolaborator memiliki tingkat akses yang tepat. Tindakan ini akan membantu mencegah situasi saat Anda kehilangan akses ke setelan Cloud project karena pemiliknya tidak lagi berada di organisasi Anda. Hal ini sangat penting untuk add-on.
Kolaborasi dan pemicu
Saat Anda berkolaborasi pada suatu project, setiap pemicu yang dapat diinstal yang Anda buat tidak dibagikan kepada orang yang memiliki akses ke project Anda. Jika harus memiliki penyiapan pemicu yang konsisten untuk semua kolaborator, Anda dapat menggunakan layanan Skrip untuk membuat pemicu secara terprogram, selama waktu proses. Untuk mengetahui informasi selengkapnya, lihat Mengelola Pemicu Secara Terprogram.
Kolaborasi dan perpustakaan
Library yang disertakan dalam project Anda tersedia bagi para kolaborator project. Namun, jika klien tidak memiliki setidaknya akses level baca ke library yang disertakan, library tidak dapat menggunakan library tersebut — skrip akan menampilkan error dalam kasus ini. Untuk informasi selengkapnya tentang library, lihat Mengelola Library.
Kolaborasi dan properti pengguna
Properti pengguna bersifat unik bagi pengguna yang membuatnya. Ini berarti bahwa kolaborator project tidak dapat melihat atau mengakses properti pengguna Anda dan Anda tidak dapat melihat atau mengakses properti mereka. Gunakan properti skrip jika Anda ingin membagikan properti khusus project kepada kolaborator. Untuk mengetahui informasi selengkapnya, lihat Panduan Properti.