Apps Script cung cấp một số tính năng giúp bạn và các nhà phát triển khác cùng tạo và duy trì các tập lệnh, tiện ích bổ sung cũng như ứng dụng web.
Kiến thức cơ bản về cộng tác
Để cộng tác trên một dự án, bạn và cộng tác viên đều phải có quyền chỉnh sửa tệp dự án Apps Script (và vùng chứa của tệp đó, nếu đó là tập lệnh ràng buộc). Việc này cho phép mọi người trong nhóm của bạn xem và thực hiện thay đổi đối với mã Apps Script. Người chỉnh sửa cũng có thể tạo phiên bản mã mới, phát hành tiện ích bổ sung và triển khai tập lệnh dưới dạng ứng dụng web hoặc dưới dạng tệp thực thi cho API Apps Script.
Bạn có thể giúp nhóm của mình bằng cách lên kế hoạch trước về cách xử lý việc chỉnh sửa, xem xét, tạo phiên bản và triển khai cũng như xuất bản dự án, tiện ích bổ sung hoặc ứng dụng web (nếu có). Dự án độc lập thường là loại dự án dễ cộng tác nhất vì chúng xuất hiện trực tiếp trong Google Drive và là loại dự án nên dùng để phát triển tiện ích bổ sung và ứng dụng web.
Một vấn đề thường gặp trong quá trình cộng tác xảy ra khi một chủ sở hữu dự án tập lệnh rời khỏi nhóm mà không chuyển quyền sở hữu dự án cho người khác trong nhóm. Vấn đề này có thể khiến bạn không thể duy trì hoặc cập nhật dự án. Việc đưa dự án tập lệnh của bạn vào bộ nhớ dùng chung sẽ giúp ngăn chặn sự cố này, vì các tệp trong bộ nhớ dùng chung không có chủ sở hữu cụ thể.
Cộng tác bằng công cụ dòng lệnh clasp
clasp cho phép bạn đồng bộ hoá các dự án giữa script.google.com và hệ thống tệp trên máy. Nhờ đó, bạn có thể đơn giản hoá và tự động hoá quá trình phát triển mã nếu bạn và cộng tác viên của mình đang sử dụng phần mềm quản lý kiểm soát nguồn như git.
Để biết thêm thông tin chi tiết, hãy tham khảo bài viết Giao diện dòng lệnh sử dụng hướng dẫn clasp.
Cộng tác với bộ nhớ dùng chung
Bộ nhớ dùng chung (trước đây gọi là "Drive nhóm") cung cấp một không gian dùng chung trong Google Drive để các nhóm người dùng Drive có thể cộng tác hiệu quả hơn. Các tệp nằm trong bộ nhớ dùng chung là thuộc quyền sở hữu của toàn bộ nhóm chứ không phải các cá nhân. Điều này có nghĩa là khi một cộng tác viên rời khỏi nhóm, họ sẽ không nắm quyền sở hữu và quyền kiểm soát tệp cùng với mình.
Bộ nhớ dùng chung cũng cho phép bạn di chuyển tệp trên nhiều miền — bộ nhớ dùng chung trong một miền có thể có cộng tác viên từ miền khác, những người này có thể di chuyển tệp từ miền đó vào bộ nhớ dùng chung. Điều này có thể rất có giá trị đối với các nhà phát triển Apps Script, vì nó cung cấp phương tiện để một nhóm phát triển tiện ích bổ sung, ứng dụng web hoặc mã khác cho khách hàng trong các miền khác nhau.
Khi bạn sử dụng bộ nhớ dùng chung để cộng tác trên các dự án Apps Script, hãy lưu ý những điều sau:
- Những cộng tác viên có quyền chỉnh sửa đối với bộ nhớ dùng chung có thể tạo hoặc di chuyển các tệp mới vào bộ nhớ dùng chung đó. Là người chỉnh sửa tập lệnh, họ có thể xem và chỉnh sửa dự án tập lệnh, chạy mã tập lệnh, tạo phiên bản tập lệnh mới, phát hành tiện ích bổ sung.
- Để triển khai tập lệnh dưới dạng ứng dụng web hoặc tệp thực thi cho Apps Script API, tài khoản tạo hoạt động triển khai phải thuộc cùng miền với bộ nhớ dùng chung chứa tập lệnh.
- Bộ nhớ dùng chung cho phép bạn chia sẻ các tệp cụ thể trong bộ nhớ dùng chung với những người khác bên ngoài nhóm, đồng thời cập nhật quyền chỉnh sửa và xem của họ đối với các tệp đó giống như mọi tệp khác trên Drive. Tuy nhiên, nếu người dùng thuộc nhóm sở hữu bộ nhớ dùng chung, thì bạn không thể giảm quyền truy cập của họ vào các tệp cụ thể. Ví dụ: nếu người dùng có quyền chỉnh sửa đối với bộ nhớ dùng chung, bạn không thể thay đổi quyền đó thành quyền chỉ có thể xem đối với một tệp cụ thể trong bộ nhớ dùng chung đó.
- Những cộng tác viên có toàn quyền truy cập vào bộ nhớ dùng chung cũng có thể xoá các tệp và dự án Apps Script, cũng như di chuyển tệp ra khỏi bộ nhớ dùng chung.
- Tất cả tập lệnh ràng buộc vùng chứa đều sử dụng cùng một danh sách truy cập trình xem và danh sách người chỉnh sửa đã xác định cho tệp vùng chứa. Ví dụ: nếu có quyền chỉnh sửa một tệp Google Trang tính, bạn cũng có quyền chỉnh sửa mọi mã dự án Apps Script đính kèm. Việc đặt một tệp vùng chứa như vậy vào bộ nhớ dùng chung sẽ cấp cho các cộng tác viên của bộ nhớ dùng chung đó quyền truy cập giống như với mã tập lệnh mà họ có đối với chính vùng chứa đó.
- Khi một dự án tập lệnh nằm trong bộ nhớ dùng chung, quyền truy cập vào dự án Cloud Platform (GCP) của dự án đó có thể bị hạn chế. Xem phần hướng dẫn về Các dự án và bộ nhớ dùng chung GCP để biết thông tin chi tiết.
- Các ứng dụng web được triển khai trên một miền sẽ ngừng hoạt động nếu quyền sở hữu của các ứng dụng đó thay đổi thành một bộ nhớ dùng chung hoặc tài khoản trong một miền khác. Bạn có thể khắc phục vấn đề này bằng cách di chuyển tập lệnh trở lại miền ban đầu.
- Tương tự, các dự án tập lệnh được triển khai dưới dạng API Apps Script có thể thực thi sẽ ngừng hoạt động khi được API gọi nếu bạn di chuyển các dự án đó qua bộ nhớ dùng chung từ miền này sang miền khác. Bạn có thể khắc phục vấn đề này bằng cách di chuyển tập lệnh trở lại miền gốc.
Cộng tác bằng thư mục dùng chung
Nếu không thể cộng tác bằng bộ nhớ dùng chung, bạn có thể sử dụng thư mục dùng chung. Khi bạn tạo hoặc di chuyển một dự án Apps Script sang một thư mục Google Drive mà người khác có thể truy cập, họ sẽ kế thừa chính quyền truy cập vào dự án Apps Script mà họ có cho thư mục đó. Ví dụ:
- Nếu người nào đó có quyền chỉnh sửa thư mục, họ có thể chỉnh sửa hoặc xoá dự án Apps Script và chạy tập lệnh đó.
- Nếu người dùng chỉ có quyền xem thư mục, họ có thể xem dự án Apps Script và chạy tập lệnh.
Cộng tác bằng tính năng chia sẻ dự án
Bạn có thể cộng tác trên một dự án bằng cách chia sẻ trực tiếp dự án đó với tất cả các cộng tác viên. Bạn có thể trực tiếp chia sẻ các dự án tập lệnh nằm trong các thư mục Google Drive thông thường hoặc trong bộ nhớ dùng chung. Nếu sử dụng phương thức này, bạn nên lập kế hoạch cẩn thận về những người sở hữu và duy trì tập lệnh theo thời gian.
Các dự án độc lập sẽ xuất hiện trong Google Drive dưới dạng một tệp và bạn có thể chia sẻ các dự án đó như mọi tệp khác. Để biết thêm thông tin, hãy xem phần Chia sẻ tệp và thư mục.
Dự án bị ràng buộc bởi vùng chứa không hiển thị trong Google Drive của bạn. Để chia sẻ dự án ràng buộc với vùng chứa, hãy chia sẻ tệp vùng chứa gốc. Ví dụ: nếu bạn có một tập lệnh liên kết với một bảng tính Google Trang tính, bạn có thể chỉ định người nào đó làm người chỉnh sửa tập lệnh bằng cách chỉ định họ làm người chỉnh sửa bảng tính. Các dự án ràng buộc vùng chứa sẽ kế thừa các chế độ cài đặt quyền truy cập của người xem và người chỉnh sửa của tệp vùng chứa.
Tất cả các tập lệnh ràng buộc vùng chứa đều sử dụng cùng một danh sách quyền truy cập của chủ sở hữu, người xem và quyền chỉnh sửa đã xác định cho tệp vùng chứa. Chủ sở hữu vùng chứa nắm quyền sở hữu một dự án tập lệnh mới bất kể ai là người tạo dự án đó.
Tài nguyên cho dự án và hoạt động cộng tác
Tài nguyên là các thực thể được liên kết với dự án nhưng tồn tại độc lập với mã của dự án. Phần này giải thích mức độ ảnh hưởng của việc cộng tác trong một dự án đến các tài nguyên của dự án đó, cụ thể là: dự án Cloud Platform, điều kiện kích hoạt, thư viện và thuộc tính người dùng.
Dự án cộng tác và Google Cloud
Mỗi dự án Apps Script đều có một dự án Google Cloud liên kết. Các dự án trên Google Cloud có nhóm chủ sở hữu, người chỉnh sửa và các vai trò khác riêng, có thể khác với nhóm người dùng có thể truy cập vào dự án tập lệnh.
Nếu dự án tập lệnh của bạn được phát hành dưới dạng tiện ích bổ sung, thì dự án đó phải sử dụng dự án Google Cloud chuẩn. Khi cộng tác trên một ứng dụng sử dụng dự án Google Cloud tiêu chuẩn, bạn nên định cấu hình chủ sở hữu và vai trò trên Google Cloud để đảm bảo tất cả cộng tác viên đều có cấp truy cập phù hợp. Điều này giúp ngăn chặn trường hợp bạn mất quyền truy cập vào phần cài đặt đám mây của dự án vì chủ sở hữu của dự án không còn ở cùng tổ chức của bạn. Điều này đặc biệt quan trọng đối với tiện ích bổ sung.
Hoạt động cộng tác và sự kiện kích hoạt
Khi bạn cộng tác trên một dự án, mọi điều kiện kích hoạt có thể cài đặt mà bạn tạo sẽ không được chia sẻ với những người có quyền truy cập vào dự án của bạn. Nếu cần thiết lập điều kiện kích hoạt nhất quán cho tất cả các cộng tác viên, bạn có thể sử dụng dịch vụ Tập lệnh để tạo điều kiện kích hoạt theo phương thức lập trình, trong thời gian chạy. Để biết thêm thông tin, hãy xem bài viết Quản lý điều kiện kích hoạt theo cách có lập trình.
Cộng tác và thư viện
Cộng tác viên của dự án có thể sử dụng các thư viện có trong dự án của bạn. Tuy nhiên, nếu không có quyền truy cập tối thiểu ở cấp độ đọc vào một thư viện đi kèm, chúng không thể sử dụng các thư viện đó – trong trường hợp này, tập lệnh sẽ báo lỗi. Để biết thêm thông tin về thư viện, hãy xem phần Quản lý thư viện.
Cộng tác và thuộc tính người dùng
Thuộc tính người dùng là duy nhất đối với người dùng đã tạo thuộc tính đó. Điều này có nghĩa là cộng tác viên dự án không thể xem hoặc truy cập vào thuộc tính người dùng của bạn và bạn cũng không thể xem hoặc truy cập vào thuộc tính của họ. Sử dụng thuộc tính tập lệnh nếu bạn muốn chia sẻ các thuộc tính cụ thể của dự án với cộng tác viên. Để biết thêm thông tin, vui lòng xem Hướng dẫn về thuộc tính.