Google Apps Script cung cấp các tính năng giúp các nhóm cùng nhau xây dựng và duy trì tập lệnh, tiện ích bổ sung Google Workspace và ứng dụng web. Hướng dẫn này đề cập đến hoạt động cộng tác tích cực trên một dự án của nhiều nhà phát triển; nếu bạn muốn chia sẻ mã để người khác đưa vào dự án của riêng họ, hãy xem hướng dẫn về Thư viện.
Thông tin cơ bản về việc cộng tác
Để cộng tác trong một dự án, bạn và cộng tác viên của bạn đều phải có quyền chỉnh sửa đối với tệp dự án Apps Script (và vùng chứa của tệp đó, nếu đó là một tập lệnh liên kết). Nhờ đó, mọi người trong nhóm của bạn đều có thể xem và thay đổi mã Apps Script. Người chỉnh sửa cũng có thể tạo phiên bản mã mới, 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 Apps Script API.
Lập kế hoạch trước về cách bạn xử lý việc chỉnh sửa, xem xét, quản lý phiên bản và (nếu có thể) triển khai cũng như xuất bản dự án, tiện ích bổ sung hoặc ứng dụng web của mình. Dự án độc lập thường là 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 được đề xuất để phát triển tiện ích bổ sung và ứng dụng web.
Một vấn đề thường gặp trong hoạt động cộng tác là khi 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 một người khác trong nhóm. Điều này có thể khiến bạn không thể duy trì hoặc cập nhật dự án. Việc đặt dự án tập lệnh của bạn trong bộ nhớ dùng chung sẽ ngăn chặn vấn đề này, vì các tệp trong bộ nhớ dùng chung không có chủ sở hữu cụ thể.
Luôn chia sẻ quyền sở hữu dự án tập lệnh. Nếu có người rời khỏi tổ chức của bạn và tài khoản của họ bị xoá, thì bạn sẽ mất quyền truy cập vào các tập lệnh mà không có chủ sở hữu nào khác. Chia sẻ kịch bản của bạn trong Drive hoặc di chuyển kịch bản đó vào bộ nhớ dùng chung.
Cộng tác với 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 thiết bị. Điều này giúp bạn đơ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 đ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 Giao diện dòng lệnh bằng hướng dẫn clasp.
Cộng tác bằng bộ nhớ dùng chung
Ổ đĩa dùng chung chỉ dành cho khách hàng sử dụng Google Workspace Business và Google Workspace Enterprise.
Bộ nhớ dùng chung là một không gian dùng chung trên Drive, nơi các nhóm người dùng Drive có thể cộng tác hiệu quả hơn. Các tệp được đặt trong bộ nhớ dùng chung thuộc sở hữu của nhóm nói chung, chứ không phải của từng cá nhân. Điều này có nghĩa là khi rời khỏi nhóm, cộng tác viên sẽ không mang theo quyền sở hữu và kiểm soát tệp.
Bộ nhớ dùng chung cũng cho phép bạn di chuyển tệp giữa các miền – 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. Những cộng tác viên này có thể di chuyển tệp từ miền đó vào bộ nhớ dùng chung. Điều này giúp một nhóm có thể phát triển các tiện ích bổ sung, ứng dụng web hoặc mã khác cho khách hàng ở nhiều miền.
Khi bạn sử dụng bộ nhớ dùng chung để cộng tác trên các dự án Apps Script:
- Những người cộng tác 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 và 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 bản triển khai phải thuộc cùng một miền với bộ nhớ dùng chung mà tập lệnh nằm trong đó.
- 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 những tệp đó như mọi tệp khác trên Drive. Tuy nhiên, nếu một người dùng là thành viên của nhóm có bộ nhớ dùng chung, thì bạn không thể giảm quyền truy cập của họ đối với các tệp cụ thể. Ví dụ: nếu người dùng có quyền chỉnh sửa đối với một bộ nhớ dùng chung, thì 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 khỏi bộ nhớ dùng chung.
- Tất cả tập lệnh liên kết với vùng chứa đều sử dụng cùng một danh sách quyền truy cập của 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 một Google Trang tính, bạn cũng có quyền chỉnh sửa mọi mã dự án Apps Script được đính kèm vào trang tính đó. Việc đặt tệp vùng chứa như vậy vào bộ nhớ dùng chung sẽ cấp cho cộng tác viên của bộ nhớ dùng chung đó quyền truy cập vào mã tập lệnh giống như quyền truy cập vào 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 trên Google Cloud có thể bị hạn chế. Hãy xem phần hướng dẫn Dự án Google Cloud và bộ nhớ dùng chung để biết thông tin chi tiết.
- Ứng dụng web được triển khai trong một miền sẽ ngừng hoạt động nếu quyền sở hữu của ứng dụng đó thay đổi thành bộ nhớ dùng chung hoặc tài khoản trong một miền khác. Hãy 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 tệp thực thi API Apps Script sẽ 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. Hãy 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.
Cộng tác bằng thư mục dùng chung
Hãy thận trọng nếu bạn tạo hoặc di chuyển một dự án Apps Script sang thư mục dùng chung. Đảm bảo rằng bạn chỉ chia sẻ thư mục với những người đáng tin cậy.
Nếu không thể cộng tác với bộ nhớ dùng chung, hãy 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 trên Drive mà người khác có thể truy cập, họ sẽ có cùng quyền truy cập vào dự án Apps Script như quyền truy cập vào thư mục đó. Ví dụ:
- Nếu có quyền chỉnh sửa thư mục, người dùng có thể chỉnh sửa hoặc xoá dự án Apps Script và chạy tập lệnh.
- Nếu chỉ có quyền xem thư mục, thì người khác 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
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ả cộng tác viên. Chia sẻ trực tiếp các dự án tập lệnh nằm trong thư mục thông thường trên Drive hoặc trong bộ nhớ dùng chung. Lập kế hoạch cẩn thận về người sở hữu và duy trì tập lệnh theo thời gian.
Dự án độc lập xuất hiện dưới dạng tệp trong Drive; hãy chia sẻ dự án giống như bất kỳ tệp nào khác. Để biết thêm thông tin, hãy xem bài viết Chia sẻ tệp và thư mục.
Các dự án liên kết với vùng chứa không xuất hiện trong Drive. Để chia sẻ một dự án liên kết với vùng chứa, hãy chia sẻ tệp vùng chứa mẹ. Ví dụ: nếu bạn có một tập lệnh được liên kết với một bảng tính Google Trang tính, hãy cấp cho người dùng quyền chỉnh sửa tập lệnh bằng cách cấp cho họ quyền chỉnh sửa bảng tính. Các dự án liên kết với vùng chứa sẽ kế thừa 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 liên kết với vùng chứa đều sử dụng cùng một danh sách truy cập của chủ sở hữu, người xem và 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ẽ sở hữu một dự án tập lệnh mới, bất kể ai đã tạo dự án đó.
Tài nguyên cộng tác và dự án
Tài nguyên là những 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 dự án. Phần này giải thích cách việc cộng tác trên một dự án ảnh hưởng đến các tài nguyên của dự án đó, cụ thể là dự án trên đám mây của Google Cloud, các điều kiện kích hoạt, thư viện và thuộc tính người dùng.
Hoạt động cộng tác và dự án trên Google Cloud
Mỗi dự án Apps Script đều có một dự án Google Cloud được liên kết. Các dự án trên Google Cloud có một nhóm chủ sở hữu, người chỉnh sửa và các vai trò khác riêng. Nhóm này 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.
Cộng tác và điều kiện kích hoạt
Khi bạn cộng tác trong một dự án, mọi trình 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 một trình kích hoạt nhất quán cho tất cả cộng tác viên, hãy sử dụng Dịch vụ tập lệnh để tạo trình kích hoạt theo phương thức lập trình, tại thời gian chạy. Để biết thêm thông tin, hãy xem phần Quản lý các điều kiện kích hoạt theo phương thức lập trình.
cộng tác viên.
Cộng tác và thư viện
Các cộng tác viên dự án có thể sử dụng những 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 được đưa vào, thì họ không thể sử dụng những 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 bài viết 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à riêng biệt đối với người dùng đã tạo các 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 người dùng 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, hãy xem Hướng dẫn về tài sản.