Berkolaborasi dengan developer lain

Apps Script menyediakan beberapa fitur yang dapat membantu Anda dan developer lain membuat dan mengelola skrip, add-on, dan aplikasi web secara bersamaan.

Dasar-dasar kolaborasi

Agar dapat berkolaborasi dalam suatu project, Anda dan kolaborator harus memiliki akses editor ke file project Apps Script (dan penampungnya, jika berupa skrip terikat). Dengan demikian, semua orang di tim Anda dapat 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 cara menangani pengeditan, peninjauan, pembuatan versi, dan (jika berlaku) deployment dan publikasi project, add-on, atau aplikasi web. Project mandiri biasanya merupakan project yang paling mudah untuk berkolaborasi, karena project ini muncul langsung di Google Drive dan merupakan jenis project yang direkomendasikan untuk pengembangan aplikasi web dan add-on.

Masalah umum dalam kolaborasi terjadi ketika pemilik project skrip meninggalkan tim tanpa mentransfer kepemilikan project kepada orang lain dalam tim. Hal ini bisa membuat Anda tidak dapat mempertahankan atau memperbarui proyek. Menempatkan project skrip di drive bersama akan mencegah masalah ini, karena file di drive bersama tidak memiliki pemilik yang spesifik.

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 secara lebih efektif. File yang ditempatkan di drive bersama dimiliki oleh grup secara keseluruhan, bukan individu. Artinya, saat kolaborator keluar dari grup, dia tidak mengambil kepemilikan dan kontrol file dengan kolaborator tersebut.

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 memberikan sarana bagi tim untuk mengembangkan add-on, aplikasi web, atau kode lainnya bagi pelanggan di domain yang berbeda.

Saat Anda menggunakan drive bersama untuk berkolaborasi dalam project Apps Script, perhatikan hal berikut:

  1. 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.
  2. Untuk men-deploy skrip sebagai aplikasi web atau yang dapat dieksekusi untuk Apps Script API, akun yang membuat deployment harus berada di domain yang sama dengan drive bersama tempat skrip berada.
  3. Drive bersama memungkinkan Anda membagikan file tertentu dalam drive bersama kepada orang lain di luar grup, serta memperbarui izin edit dan lihat mereka di file tersebut seperti file Drive lainnya. Namun, jika pengguna adalah bagian dari tim yang memiliki drive bersama, Anda tidak dapat mengurangi akses mereka ke 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.
  4. Kolaborator dengan akses penuh ke drive bersama juga dapat menghapus file dan project Apps Script, serta memindahkan file dari drive bersama.
  5. Semua skrip yang terikat container menggunakan daftar akses penampil 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. Meletakkan file penampung tersebut ke dalam drive bersama akan memberikan akses yang sama ke kode skrip kepada kolaborator drive bersama seperti yang mereka miliki untuk penampung itu sendiri.
  6. 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.
  7. Aplikasi web yang di-deploy di satu domain berhenti berfungsi jika kepemilikannya berubah pada drive atau akun bersama di domain yang berbeda. Hal ini dapat diperbaiki dengan memindahkan skrip kembali ke domain aslinya.
  8. Demikian pula, project skrip yang di-deploy sebagai Apps Script API yang dapat dieksekusi berhenti 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, mereka 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 langsung membagikan project tersebut kepada semua kolaborator. Anda dapat langsung berbagi 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 muncul di Google Drive sebagai file dan Anda dapat membagikannya seperti file lainnya. Untuk mengetahui informasi selengkapnya, lihat Berbagi file dan folder.

Project yang terikat dengan container 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 container mewarisi setelan akses pelihat dan editor file container-nya.

Semua skrip yang terikat pada container menggunakan daftar akses pemilik, pelihat, dan editor yang sama yang telah ditentukan untuk file penampung. Pemilik container 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 tidak ada di kodenya. Bagian ini menjelaskan pengaruh kolaborasi pada suatu project terhadap resource-nya, khususnya: project Cloud Platform, pemicu, library, dan properti penggunanya.

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 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 konfigurasikan pemilik dan peran Google Cloud untuk memastikan semua kolaborator memiliki tingkat akses yang tepat. Hal ini membantu mencegah situasi saat Anda kehilangan akses ke setelan Cloud project karena pemiliknya tidak lagi bekerja di organisasi Anda. Hal ini sangat penting untuk add-on.

Kolaborasi dan pemicu

Saat Anda berkolaborasi dalam suatu 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, mereka tidak dapat menggunakan library tersebut. Dalam kasus 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. 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 berbagi properti khusus project dengan kolaborator. Untuk mengetahui informasi selengkapnya, lihat Panduan properti.