Google Apps Script menyediakan fitur yang membantu tim membuat dan memelihara skrip, add-on Google Workspace, dan aplikasi web bersama-sama. Panduan ini membahas kolaborasi aktif pada project oleh beberapa developer; jika Anda ingin membagikan kode agar disertakan oleh orang lain dalam project mereka sendiri, lihat panduan Library.
Dasar-dasar kolaborasi
Untuk berkolaborasi dalam project, Anda dan kolaborator harus memiliki akses editor ke file project Apps Script (dan penampungnya, jika berupa skrip terikat). Tindakan ini memungkinkan semua orang di tim Anda melihat dan membuat perubahan pada 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.
Rencanakan sebelumnya cara Anda menangani pengeditan, peninjauan, pembuatan versi, dan (jika berlaku) deployment serta publikasi project, add-on, atau aplikasi web Anda. Project mandiri biasanya 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 keluar dari tim tanpa mentransfer kepemilikan project kepada orang lain di tim. Hal ini dapat membuat Anda tidak dapat mempertahankan atau memperbarui project. Menempatkan project skrip di drive bersama akan mencegah masalah ini, karena file di drive bersama tidak memiliki pemilik tertentu.
Selalu bagikan kepemilikan project skrip. Jika seseorang keluar dari organisasi Anda dan akunnya dihapus, akses ke skrip tanpa pemilik lain akan hilang. Bagikan skrip Anda di Drive atau pindahkan ke drive bersama.
Berkolaborasi dengan alat command line clasp
clasp memungkinkan Anda menyinkronkan project antara script.google.com dan sistem file lokal Anda. Dengan begitu, Anda dapat menyederhanakan
dan mengotomatiskan pengembangan kode jika Anda dan kolaborator menggunakan
software pengelolaan kontrol sumber seperti git.
Untuk mengetahui detail selengkapnya, lihat Antarmuka Command Line menggunakan panduan clasp.
Berkolaborasi dengan drive bersama
Drive bersama hanya tersedia untuk pelanggan Google Workspace Business dan Google Workspace Enterprise.
Drive bersama menyediakan ruang bersama di Drive tempat grup pengguna Drive dapat berkolaborasi secara lebih efektif. File yang ditempatkan di drive bersama dimiliki oleh grup secara keseluruhan, bukan oleh individu. Artinya, saat kolaborator keluar dari grup, dia tidak akan membawa kepemilikan dan kontrol file bersamanya.
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 memberikan cara bagi tim untuk mengembangkan add-on, aplikasi web, atau kode lain untuk pelanggan di berbagai domain.
Saat Anda menggunakan drive bersama untuk berkolaborasi dalam project Apps Script:
- Kolaborator dengan 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 membagikan file tertentu dalam drive bersama kepada orang lain di luar grup, dan memperbarui izin edit dan lihat mereka pada file tersebut seperti file Drive lainnya. Namun, jika pengguna adalah bagian dari tim yang memiliki drive bersama, Anda tidak dapat mengurangi aksesnya 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 tersebut.
- Kolaborator dengan akses penuh ke drive bersama juga dapat menghapus file dan project Apps Script, serta memindahkan file dari drive bersama.
- Semua skrip terikat penampung menggunakan daftar akses pelihat dan editor yang sama yang ditentukan untuk file penampung. Misalnya, jika Anda memiliki akses edit ke Spreadsheet Google, Anda juga memiliki akses edit ke kode project Apps Script yang dilampirkan ke spreadsheet tersebut. Menempatkan file penampung tersebut ke dalam drive bersama akan memberi kolaborator drive bersama akses yang sama ke kode skrip seperti yang mereka miliki untuk penampung itu sendiri.
- Jika project skrip berada di drive bersama, akses ke project Google Cloud-nya mungkin dibatasi. Lihat bagian panduan Project Google Cloud dan drive bersama untuk mengetahui detailnya.
- Aplikasi web yang di-deploy di satu domain akan berhenti berfungsi jika kepemilikannya berubah menjadi akun atau drive bersama di domain lain. Perbaiki hal ini dengan memindahkan skrip kembali ke domain aslinya.
- Demikian pula, project skrip yang di-deploy sebagai file yang dapat dieksekusi Apps Script API berhenti berfungsi saat dipanggil oleh API jika dipindahkan melalui drive bersama dari satu domain ke domain lain. Perbaiki hal ini dengan memindahkan skrip kembali ke domain aslinya.
Berkolaborasi dengan folder bersama
Berhati-hatilah jika Anda membuat atau memindahkan project Apps Script ke folder bersama. Pastikan folder hanya dibagikan kepada orang tepercaya.
Jika Anda tidak dapat berkolaborasi dengan drive bersama, gunakan folder bersama. Saat Anda membuat atau memindahkan project Apps Script ke folder Drive yang dapat diakses orang lain, mereka akan mewarisi akses yang sama ke project Apps Script seperti 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
Berkolaborasi dalam proyek dengan membagikan proyek secara langsung kepada semua kolaborator. Membagikan langsung project skrip yang berada di folder Drive biasa atau di drive bersama. Rencanakan dengan cermat siapa yang memiliki dan memelihara skrip dari waktu ke waktu.
Project mandiri muncul di Drive sebagai file; bagikan seperti file lainnya. Untuk mengetahui informasi selengkapnya, lihat Berbagi file dan folder.
Project yang terikat dengan penampung tidak terlihat di Drive. Untuk membagikan project terikat container, bagikan file container induk. Misalnya, jika Anda memiliki skrip yang terikat ke spreadsheet Google Spreadsheet, jadikan seseorang sebagai editor skrip dengan menjadikannya sebagai editor spreadsheet. Project terikat penampung mewarisi setelan akses pelihat dan editor file penampungnya.
Semua skrip terikat penampung menggunakan daftar akses pemilik, pelihat, dan editor yang sama yang ditentukan untuk file penampung. Pemilik penampung mengambil kepemilikan project skrip baru, terlepas dari siapa yang membuatnya.
Kolaborasi dan sumber daya project
Resource adalah entitas yang terkait dengan project Anda, tetapi ada secara terpisah dari kodenya. Bagian ini menjelaskan pengaruh kolaborasi dalam project terhadap resource-nya, khususnya: project Google Cloud, pemicu, library, dan properti pengguna.
Kolaborasi dan project Google Cloud
Setiap project Apps Script memiliki project Google Cloud terkait. Project Google Cloud memiliki serangkaian pemilik, editor, dan peran lainnya sendiri, yang dapat berbeda dari serangkaian pengguna yang dapat mengakses project skrip.
Kolaborasi dan pemicu
Saat Anda berkolaborasi dalam project, setiap pemicu yang dapat diinstal yang Anda buat tidak dibagikan kepada orang yang memiliki akses ke project Anda. Jika Anda perlu menyiapkan pemicu yang konsisten untuk semua kolaborator, gunakan layanan Skrip untuk membuat pemicu secara terprogram, saat runtime. Untuk mengetahui informasi selengkapnya, lihat Mengelola Pemicu Secara Terprogram.
kolaborator.
Kolaborasi dan library
Library yang disertakan dalam project Anda tersedia untuk kolaborator project. Namun, jika mereka tidak memiliki akses tingkat baca minimal ke library yang disertakan, mereka tidak dapat menggunakan library tersebut. Skrip akan menampilkan error dalam kasus ini. Untuk mengetahui informasi selengkapnya tentang pustaka, lihat Mengelola Pustaka.
Kolaborasi dan properti pengguna
Properti pengguna bersifat unik untuk pengguna yang membuatnya. Artinya, kolaborator project tidak dapat melihat atau mengakses properti pengguna Anda dan Anda tidak dapat melihat atau mengakses properti pengguna mereka. Gunakan properti skrip jika Anda ingin membagikan properti khusus project kepada kolaborator. Untuk mengetahui informasi selengkapnya, lihat Panduan properti.