Berkolaborasi dengan developer lain

Apps Script menyediakan beberapa fitur yang membantu Anda dan developer lain membuat dan memelihara skrip, {i>add-on<i}, dan aplikasi web bersama-sama.

Dasar-dasar kolaborasi

Untuk berkolaborasi pada suatu proyek, Anda dan kolaborator Anda harus memiliki akses editor ke file project Apps Script (dan penampungnya, jika berupa skrip terikat). Hal ini memungkinkan semua orang di tim Anda melihat dan membuat perubahan pada kode Apps Script. Editor juga bisa membuat kode baru memublikasikan add-on, dan menerapkan skrip sebagai aplikasi web atau sebagai file yang dapat dieksekusi untuk Apps Script API.

Anda dapat membantu tim dengan merencanakan terlebih dahulu bagaimana Anda menangani pengeditan, meninjau, membuat versi, dan (jika ada) deployment dan publikasi project, add-on, atau aplikasi web. Project mandiri biasanya adalah yang paling mudah untuk berkolaborasi, karena file tersebut muncul langsung di Google Drive dan merupakan jenis project yang direkomendasikan untuk add-on dan pengembangan aplikasi web.

Masalah umum dalam kolaborasi terjadi ketika pemilik proyek skrip meninggalkan tim tanpa mengalihkan kepemilikan proyek kepada orang lain dalam tim. Hal ini dapat menyebabkan Anda tidak dapat mempertahankan atau memperbarui project. Menempatkan project skrip di drive bersama 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 file lokal Anda sistem file. Hal ini memungkinkan Anda menyederhanakan dan mengotomatiskan pengembangan kode jika Anda dan kolaborator Anda menggunakan {i>software<i} manajemen 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") memberikan ruang bersama di Google Drive tempat grup Drive pengguna dapat berkolaborasi dengan lebih efektif. File yang ditempatkan di drive bersama adalah milik oleh grup sebagai keseluruhan, bukan individu. Ini berarti bahwa ketika kolaborator keluar dari grup dan mereka tidak membawa kepemilikan dan kontrol file 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. Ini bisa sangat bermanfaat untuk Apps Script karena menyediakan sarana bagi tim untuk mengembangkan {i>add-on<i}, aplikasi web, atau kode lain untuk pelanggan di domain yang berbeda.

Jika Anda menggunakan drive bersama untuk berkolaborasi pada project Apps Script, pertahankan berikut ini:

  1. 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 membuat skrip proyek, menjalankan kode skrip, membuat versi skrip baru, memublikasikan add-on.
  2. Untuk men-deploy skrip sebagai aplikasi web atau file yang dapat dieksekusi untuk Apps Script API: akun yang membuat deployment harus berasal dari domain yang sama dengan {i>drive<i} bersama tempat skrip berada.
  3. Drive bersama memungkinkan Anda berbagi file tertentu dalam drive bersama ke orang lain di luar grup, dan memperbarui izin akses edit dan lihat mereka di file-file tersebut seperti file Drive lainnya. Namun, jika pengguna bagian dari tempat drive bersama berada, Anda tidak dapat mengurangi akses mereka . Misalnya, jika pengguna memiliki akses edit ke drive bersama, Anda tidak dapat mengubahnya menjadi akses hanya lihat untuk file tertentu dalam drive bersama.
  4. Kolaborator dengan akses penuh ke drive bersama juga dapat menghapus file dan project Apps Script, lalu memindahkan file dari drive bersama.
  5. Semua skrip terikat container 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. Menempatkan file penampung ke drive bersama akan memberikan kolaborator drive bersama akses yang sama ke kode skrip seperti yang mereka miliki untuk penampung itu sendiri.
  6. Jika project skrip berada di drive bersama, akses ke project Project Cloud Platform (GCP) mungkin dibatasi. Lihat Project GCP dan drive bersama bagian panduan untuk detailnya.
  7. Aplikasi web yang ditempatkan di satu domain berhenti berfungsi jika kepemilikan mereka berubah menjadi akun atau drive bersama di domain yang berbeda. Hal ini dapat diperbaiki dengan memindahkan skrip kembali ke domain aslinya.
  8. Demikian pula, proyek 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 lain. Ini dapat diperbaiki dengan memindahkan skrip kembali ke domain asli.

Berkolaborasi dengan folder bersama

Jika tidak dapat berkolaborasi dengan drive bersama, Anda dapat menggunakan folder bersama, sebagai gantinya. Saat Anda membuat atau memindahkan project Apps Script ke Folder Google Drive yang dapat diakses orang lain, mereka mewarisi akses yang sama ke project Apps Script yang mereka miliki untuk folder tersebut. Contoh:

  • Jika seseorang memiliki akses edit ke folder tersebut, dia dapat mengedit atau menghapus Apps Script dan jalankan skrip.
  • Jika seseorang hanya memiliki akses lihat ke folder, dia dapat melihat Apps Script dan jalankan skrip.

Berkolaborasi dengan berbagi project

Anda dapat berkolaborasi pada suatu proyek dengan langsung berbagi proyek dengan semua para kolaborator. Anda dapat langsung membagikan project skrip yang berada di Folder Google Drive atau di drive bersama. Jika Anda menggunakan metode ini, Anda sebaiknya 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 selengkapnya informasi, lihat Membagikan file dan folder.

Project yang terikat container tidak terlihat dari Google Drive. Untuk membagikan project yang terikat container, bagikan project induk penampung file. Misalnya, jika Anda memiliki skrip yang terikat dengan skrip Google Spreadsheet, {i>spreadsheet<i}, Anda dapat menjadikan seseorang editor skrip dengan menjadikannya editor pada {i>spreadsheet<i}. Project yang terikat container mewarisi akses pelihat dan editor setelan file container-nya.

Semua skrip terkait penampung menggunakan pemilik, pelihat, dan daftar akses editor yang ditentukan untuk file container. Pemilik penampung mengambil kepemilikan proyek skrip baru, terlepas dari siapa yang membuatnya.

Kolaborasi dan sumber daya proyek

Resource adalah entitas yang terkait dengan project Anda, tetapi ada secara terpisah dari kodenya. Bagian ini menjelaskan bagaimana berkolaborasi dalam suatu proyek memengaruhi resource-nya, khususnya: project Cloud Platform, pemicu, {i>library<i}, dan properti pengguna.

Kolaborasi dan project Google Cloud

Setiap project Apps Script memiliki Project Google Cloud Anda. Project Google Cloud memiliki kumpulan pemilik, editor, dan peran lainnya sendiri, yang bisa berbeda dari kumpulan pengguna yang dapat mengakses skrip proyek.

Jika proyek skrip Anda dimaksudkan untuk diterbitkan sebagai add-on, fitur ini harus menggunakan project Google Cloud standar. Saat Anda berkolaborasi pada aplikasi yang menggunakan project Google Cloud standar, kami merekomendasikan agar Anda mengonfigurasi pemilik dan peran Google Cloud untuk memastikan semua kolaborator Anda memiliki tingkat akses yang sesuai. Hal ini membantu mencegah situasi ketika Anda kehilangan akses ke setelan Cloud project karena pemiliknya tidak lagi bergabung dengan organisasi Anda. Hal ini sangat penting untuk add-on.

Kolaborasi dan pemicu

Ketika Anda berkolaborasi dalam suatu proyek, setiap pemicu yang dapat diinstal yang Anda buat tidak dibagikan kepada mereka yang memiliki akses ke project Anda. Jika Anda perlu memiliki konfigurasi 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 perpustakaan

Library yang disertakan dalam project Anda tersedia bagi para kolaborator project. Namun, jika mereka tidak memiliki setidaknya akses tingkat baca ke library yang disertakan mereka 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 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 milik mereka. Gunakan properti skrip jika Anda ingin membagikan properti khusus project kepada kolaborator. Sebagai informasi selengkapnya, lihat Panduan properti.