Apps Script menyediakan beberapa fitur yang membantu Anda dan developer lain membuat dan mengelola skrip, add-on, dan aplikasi web bersama-sama.
Dasar-dasar kolaborasi
Untuk berkolaborasi dalam project, Anda dan kolaborator harus memiliki akses editor ke file project Apps Script (dan penampung, jika merupakan 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.
Anda dapat membantu tim dengan merencanakan terlebih dahulu cara menangani pengeditan, peninjauan, pembuatan versi, dan (jika berlaku) deployment serta publikasi project, add-on, atau aplikasi web. Project mandiri biasanya paling mudah dilakukan kolaborasi, 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 mengelola atau mengupdate project. Menempatkan project skrip di drive bersama akan mencegah masalah ini, karena file di drive bersama tidak memiliki pemilik tertentu.
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 mengetahui detail selengkapnya, lihat Panduan Antarmuka Command Line
menggunakan 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 dimiliki oleh grup secara keseluruhan, bukan oleh individu. Artinya, saat collaborator keluar dari grup, mereka tidak akan mengambil kepemilikan dan kontrol file.
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 berharga bagi developer Apps Script, karena menyediakan cara 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 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, 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 merupakan 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 lihat-saja untuk file tertentu dalam drive bersama.
- 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 penampil dan editor yang sama yang ditentukan untuk file penampung. Misalnya, jika Anda memiliki akses edit ke Google Spreadsheet, Anda juga memiliki akses edit ke kode project Apps Script apa pun yang disertakan. Dengan menempatkan file penampung tersebut ke drive bersama, kolaborator drive bersama akan memiliki akses yang sama 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 dapat 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 atau akun bersama di domain lain. Hal ini dapat diperbaiki dengan memindahkan skrip kembali ke domain aslinya.
- Demikian pula, project skrip yang di-deploy sebagai file yang dapat dieksekusi Apps Script API akan berhenti berfungsi saat dipanggil oleh API jika dipindahkan melalui drive bersama dari satu domain ke domain lain. 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 dalam project dengan membagikan project secara langsung kepada semua kolaborator. Anda dapat langsung membagikan project skrip yang berada di folder Google Drive biasa atau di drive bersama. Jika Anda menggunakan metode ini, sebaiknya Anda merencanakan dengan cermat siapa yang memiliki dan mengelola skrip dari waktu ke waktu.
Project mandiri muncul di Google Drive sebagai file dan Anda dapat membagikannya seperti file lainnya. Untuk informasi selengkapnya, lihat Berbagi file dan folder.
Project yang terikat penampung tidak terlihat dari Google Drive Anda. Untuk membagikan project yang terikat penampung, bagikan file penampung induk. Misalnya, jika Anda memiliki skrip yang terikat ke spreadsheet Google Spreadsheet, Anda dapat menjadikan seseorang sebagai editor skrip dengan menjadikannya editor spreadsheet. Project yang terikat penampung mewarisi setelan akses viewer dan editor file penampungnya.
Semua skrip yang terikat penampung menggunakan daftar akses pemilik, penampil, dan editor yang sama yang ditentukan untuk file penampung. Pemilik penampung akan mengambil kepemilikan project skrip baru, terlepas dari siapa yang membuatnya.
Kolaborasi dan referensi project
Resource adalah entitas yang terkait dengan project Anda, tetapi ada secara terpisah dari kodenya. Bagian ini menjelaskan pengaruh kolaborasi pada project terhadap resource-nya, terutama: project Cloud Platform, pemicu, library, dan properti pengguna.
Kolaborasi dan project Google Cloud
Setiap project Apps Script memiliki project Google Cloud yang terkait. Project Google Cloud memiliki kumpulan pemilik, editor, dan peran lainnya, yang dapat berbeda dari 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 konfigurasi pemilik dan peran Google Cloud untuk memastikan semua kolaborator Anda memiliki tingkat akses yang sesuai. Hal ini 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 dalam project, semua pemicu yang dapat diinstal yang Anda buat tidak akan dibagikan kepada orang yang memiliki akses ke project Anda. Jika perlu memiliki penyiapan pemicu yang konsisten untuk semua kolaborator, Anda dapat menggunakan Layanan skrip untuk membuat pemicu secara terprogram, pada waktu proses. Untuk informasi selengkapnya, lihat Mengelola Pemicu Secara Terprogram.
Kolaborasi dan library
Library yang disertakan dalam project Anda tersedia untuk kolaborator project. Namun, jika tidak memiliki setidaknya akses tingkat baca ke library yang disertakan, library tersebut tidak dapat digunakan — dalam hal ini, skrip akan menampilkan error. Untuk informasi selengkapnya tentang library, lihat Mengelola Library.
Kolaborasi dan properti pengguna
Properti pengguna bersifat unik untuk pengguna yang membuatnya. Artinya, collaborator 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.