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