Mọi dự án Apps Script sử dụng Google Cloud để quản lý việc uỷ quyền, các dịch vụ nâng cao và thông tin chi tiết khác. Để định cấu hình và quản lý các chế độ cài đặt này, mỗi dự án Apps Script đều có một dự án Google Cloud liên kết. Dự án tập lệnh của bạn có thể sử dụng dự án mặc định mà Apps Script tự động tạo ra, hoặc dự án tiêu chuẩn mà bạn tạo chính bạn. Nhìn chung, các dự án mặc định phù hợp với nhu cầu sử dụng hằng ngày hoặc đơn giản mà bạn nên sử dụng dự án chuẩn cho mọi ứng dụng phức tạp, có chất lượng thương mại hoặc chất lượng mà bạn dự định xuất bản.
Bạn có thể chuyển từ dự án mặc định sang dự án chuẩn bất cứ lúc nào, nhưng bạn không thể chuyển về sử dụng dự án mặc định. Tốt nhất để chọn dự án Đám mây mà tập lệnh của bạn sử dụng ban đầu trong quá trình phát triển. Việc chuyển đổi sau có thể gây ra nhiều rắc rối, chẳng hạn như yêu cầu người dùng uỷ quyền lại.
Dự án mặc định trên đám mây
Khi bạn tạo một dự án Apps Script, Apps Script sẽ tạo một dự án mặc định Dự án trên đám mây hoạt động ở chế độ nền.
- Đối với hầu hết các tập lệnh, bạn không bao giờ cần xem hoặc điều chỉnh dự án mặc định này. Chiến dịch Quảng cáo ứng dụng Tập lệnh xử lý các hoạt động tương tác cần thiết với Google Cloud. Ví dụ: nếu bạn kích hoạt một dịch vụ nâng cao trong trình chỉnh sửa Apps Script, Apps Script kích hoạt dịch vụ nâng cao trong dự án Cloud mặc định khi bạn lưu dự án tập lệnh.
- Đối với một số tập lệnh, bạn cần tương tác với bảng điều khiển Google Cloud. Trong các trong trường hợp khác, tập lệnh của bạn phải sử dụng dự án Cloud tiêu chuẩn. Cho Ví dụ: để xem nhật ký của Google Cloud trong bảng điều khiển Google Cloud, tập lệnh của bạn phải sử dụng một dự án chuẩn.
Theo mặc định, các dự án trên Google Cloud có giải pháp Quản lý danh tính và quyền truy cập
(IAM) có một mục nhập, một tài khoản dịch vụ của Google đóng vai trò là chủ sở hữu của
dự án mặc định. Tài khoản dịch vụ của Google là
appsdev-apps-dev-script-auth@system.gserviceaccount.com
.
Xem hoặc cập nhật các dự án mặc định trên đám mây
Hầu hết người dùng không thể trực tiếp tìm, xem hoặc chỉnh sửa các dự án mặc định trong bảng điều khiển Google Cloud. Nếu bạn là Quản trị viên, hãy tham khảo bài viết Xem các dự án mặc định trên Google Cloud.
Nếu tạo dự án tập lệnh của mình trước ngày 8 tháng 4 năm 2019, bạn có thể sử dụng dự án mặc định mà bạn có thể truy cập trong bảng điều khiển Google Cloud. Để truy cập vào dự án mặc định, hãy chuyển đến phần cài đặt của dự án tập lệnh rồi nhấp vào dự án đó số.
Xoá dự án mặc định trên đám mây
Nếu là quản trị viên, bạn có thể xoá các dự án mặc định trên Cloud theo cách bạn làm dự án Cloud chuẩn. Xem phần Xoá dự án trên đám mây Apps Script.
Nếu không phải là quản trị viên, bạn không thể xoá các dự án mặc định. Tuy nhiên, Apps Script sẽ xoá các dự án mặc định trong các trường hợp sau:
- Nếu bạn xóa dự án tập lệnh hoặc chuyển dự án tập lệnh đó để sử dụng dự án chuẩn, Ứng dụng Tập lệnh sẽ xoá dự án mặc định được đính kèm vào tập lệnh cùng với bất kỳ dự án nào hoặc thông tin trong đó.
- Nếu một tập lệnh không chạy trong 180 ngày trở lên, Apps Script xoá dự án mặc định được liên kết. Nếu tập lệnh chạy sau Apps Script sẽ xoá dự án mặc định của nó, Apps Script sẽ tạo một dự án cho tập lệnh.
Dự án Cloud chuẩn
Các dự án mặc định trên đám mây là lựa chọn phù hợp nhất cho hầu hết các dự án có tập lệnh, trừ phi bạn cần định cấu hình dự án theo cách thủ công. Trong những trường hợp này, bạn phải chuyển đổi dự án tập lệnh của bạn để sử dụng dự án chuẩn.
Các phần sau đây mô tả khi nào Apps Script yêu cầu một dự án chuẩn, thuộc tính của các dự án đó và các tác vụ phổ biến được thực hiện với các dự án đó. Bạn chỉ có thể thực hiện các tác vụ dưới đây với các dự án chuẩn.
Khi Apps Script yêu cầu các dự án Cloud tiêu chuẩn
Bạn phải sử dụng dự án chuẩn trong các trường hợp sau:
- Cách xuất bản dự án tập lệnh dưới dạng tiện ích bổ sung trong Google Workspace Marketplace.
- Để xác minh ứng dụng OAuth của dự án tập lệnh.
- Khi bạn có một ứng dụng cần thực thi các hàm trong
dự án tập lệnh bằng cách sử dụng
Phương thức
scripts.run
của API Apps Script. - Để xem các dự án tập lệnh của bạn nhật ký Google Cloud trong Bảng điều khiển Google Cloud. Bảng điều khiển Google Cloud cung cấp nhiều công cụ hơn để lọc và nhật ký, và có thể hữu ích hơn chế độ xem đơn giản do trang tổng quan Apps Script.
- Để xem báo cáo lỗi của dự án tập lệnh bằng cách sử dụng Báo cáo lỗi.
- Cách tạo hộp thoại mở tệp.
- Khi bạn cần kiểm soát thủ công Cài đặt Google Cloud.
Thuộc tính dự án Cloud chuẩn
Dự án chuẩn có các thuộc tính sau:
- Bạn có thể truy cập ngay vào tất cả chế độ cài đặt của Google Cloud cho dự án từ bảng điều khiển Google Cloud. Điều này cho phép bạn kích hoạt API, điều chỉnh việc uỷ quyền thông tin xác thực và định cấu hình các chi tiết khác.
- Khi bạn xoá một dự án tập lệnh hoặc chuyển dự án đó sang sử dụng dự án chuẩn khác, dự án chuẩn ban đầu vẫn giữ nguyên và có thể sử dụng lại.
- Khi bạn kích hoạt một dịch vụ nâng cao trong một dự án tập lệnh, bạn phải tự kích hoạt API tương ứng trong dự án chuẩn.
- Nhiều dự án tập lệnh và các ứng dụng khác có thể dùng chung một dự án dự án chuẩn. Nếu bạn định xuất bản một dự án tập lệnh vào Google Workspace Marketplace dưới dạng tiện ích bổ sung, lớp đó phải có dự án chuẩn riêng. Không thể chia sẻ các ứng dụng đã xuất bản Dự án trên đám mây với các ứng dụng khác.
- Nếu bạn muốn thực thi các hàm trong dự án tập lệnh của một ứng dụng khác bằng cách sử dụng
phương thức
scripts.run
của API Apps Script, dự án tập lệnh và ứng dụng gọi phải có cùng tiêu chuẩn dự án. - Khi Apps Script yêu cầu người dùng cấp quyền cho một tập lệnh sử dụng thì tên dự án trên đám mây được dùng để xác định tập lệnh (không phải tên dự án tập lệnh). Vì lý do này, hãy nhớ đặt Tên dự án trên đám mây.
Truy cập vào một dự án chuẩn trên Google Cloud
Để truy cập vào dự án chuẩn được liên kết với tập lệnh của bạn dự án, hãy làm như sau:
- Mở dự án Apps Script.
- Ở bên trái, hãy nhấp vào biểu tượng Cài đặt dự án .
- Trong mục Dự án Google Cloud Platform (GCP), hãy nhấp vào số dự án.
Bạn cũng có thể tìm thấy một dự án thông thường ngay trên trang Quản lý tài nguyên trên bảng điều khiển Google Cloud.
Kích hoạt API trong dự án Google Cloud chuẩn
Thông thường, ứng dụng Apps Script cần quyền truy cập vào một API khác của Google. Để thực hiện việc này, bạn phải kích hoạt API này trong dự án Google Cloud tương ứng. Kích hoạt API bằng cách thực hiện như sau:
- Mở dự án trên Google Cloud.
- Nhấp vào biểu tượng Trình đơn > API và Các dịch vụ.
- Nhấp vào Bật API và dịch vụ.
- Trong hộp tìm kiếm, hãy nhập API mà bạn muốn kích hoạt rồi nhấn phím Enter.
- Nhấp vào API trong kết quả tìm kiếm rồi nhấp vào Bật để kích hoạt API cho dự án Cloud này.
Bạn có thể được nhắc chấp nhận Điều khoản dịch vụ của API của Google hoặc Google Cloud. Xem xét Điều khoản dịch vụ một cách cẩn thận trước khi chấp nhận.
Tuỳ thuộc vào ứng dụng, có thể bạn cũng cần phải định cấu hình API bằng cách chọn nó trong API & Trang tổng quan các dịch vụ.
Xác định mã nhận dạng và số lượng dự án Cloud chuẩn
Tất cả dự án trên Cloud đều có tên dự án, mã dự án và số dự án. Đôi khi, bạn phải có các giá trị nhận dạng này để định cấu hình dịch vụ hoặc hoàn tất các nhiệm vụ khác.
Để xác định mã và số dự án chuẩn, hãy làm như sau:
- Mở dự án trên Google Cloud.
- Ở trên cùng bên phải, hãy nhấp vào biểu tượng Tuỳ chọn khác > Cài đặt dự án.
- Xem Tên dự án, Mã dự án và Số dự án trong bảng điều khiển Cài đặt. Số dự án chỉ bao gồm chữ số, trong khi Mã dự án là chữ và số. Bạn có thể chỉnh sửa Project name (Tên dự án) hiển thị với người dùng khi có lời nhắc uỷ quyền.
Xem nhật ký của Google Cloud và báo cáo lỗi trong bảng điều khiển Google Cloud
Nếu bạn đang dùng tính năng ghi nhật ký Google Cloud hoặc báo cáo lỗi cho dự án tập lệnh của mình, bạn có thể xem các nhật ký và báo cáo đó trong bảng điều khiển Google Cloud bằng cách làm như sau:
- Mở dự án trên Google Cloud.
- Nhấp vào biểu tượng Trình đơn .
- Di chuyển xuống phần Hoạt động rồi nhấp vào Ghi nhật ký > Trình khám phá nhật ký.
- Để xem báo cáo lỗi, hãy di chuyển xuống phần Hoạt động rồi nhấp vào Error Reporting (Báo cáo lỗi). Nếu bạn được nhắc khi thiết lập báo cáo lỗi, điều này có nghĩa là dự án tập lệnh của bạn vẫn đã ghi lại bất kỳ ngoại lệ nào.
Hoàn tất màn hình xin phép bằng OAuth
Khi sử dụng những dịch vụ yêu cầu OAuth, Google sẽ nhắc người dùng cho phép những dịch vụ đó luôn miễn phí. Chế độ cài đặt màn hình xin phép bằng OAuth cho phép bạn đặt một số thông tin mà Google hiển thị với người dùng, chẳng hạn như tên ứng dụng và URL của Điều khoản dịch vụ.
Các dự án Cloud mặc định sẽ tự động tạo màn hình xin phép trên Thông tin chi tiết về dự án Apps Script; bạn không thể điều chỉnh các chế độ cài đặt đó. Các dự án Cloud chuẩn cho phép bạn tuỳ chỉnh thông tin này. Bạn có thể định cấu hình trạng thái đồng ý của tập lệnh màn hình bằng cách làm như sau:
- Mở dự án trên Google Cloud.
- Nhấp vào biểu tượng Trình đơn > API và Dịch vụ > Thông tin đăng nhập.
- Nhấp vào Định cấu hình màn hình đồng ý.
- Điền vào từng mục trong quy trình trên màn hình đồng ý.
- Để ghi lại các thay đổi của bạn ở mỗi giai đoạn của quy trình làm việc, hãy nhấp vào Lưu và tiếp tục.
Tạo thông tin đăng nhập OAuth
Apps Script thường thiết lập OAuth cho các dịch vụ mà tập lệnh của bạn sử dụng. Đối với một số ứng dụng, bạn phải tạo thêm Thông tin đăng nhập OAuth (mã ứng dụng khách và mật khẩu ứng dụng khách). Bạn chỉ có thể thực hiện việc này bằng dự án chuẩn.
Để tạo mã ứng dụng khách và mật khẩu ứng dụng khách cho dự án tập lệnh của bạn, hãy làm như sau sau:
- Mở dự án trên Google Cloud.
- Nhấp vào biểu tượng Trình đơn > API và Dịch vụ > Thông tin đăng nhập.
- Nhấp vào Tạo thông tin xác thực > Mã ứng dụng OAuth.
- Trong Application type (Loại ứng dụng), hãy chọn loại ứng dụng rồi chọn điền vào biểu mẫu kết quả nếu cần. Sau khi hoàn tất, hãy nhấp vào Tạo.
- Trong hộp thoại xuất hiện, hãy nhấp vào Tải JSON xuống. Bạn có thể hãy dùng tệp này để định cấu hình OAuth.
Thêm chủ sở hữu khác vào một dự án tiêu chuẩn trên Google Cloud
Bạn có thể thêm chủ sở hữu khác hoặc các vai trò khác vào dự án chuẩn. Nếu bạn đang cộng tác trong một dự án, việc này giúp đảm bảo rằng ai đó luôn có quyền truy cập vào chế độ cài đặt Google Cloud của dự án tập lệnh.
Bạn có thể thêm chủ sở hữu bổ sung hoặc các vai trò khác vào dự án chuẩn bằng cách thực hiện đang theo dõi. Bạn phải có quyền chỉnh sửa đối với dự án để thực hiện bất kỳ những thay đổi sau:
- Xác định ai là cộng tác viên của bạn. Bạn nên tạo hoặc sử dụng một Nhóm Google hiện có. Bạn có thể đồng thời chỉ định miền trong danh sách cộng tác viên để bao gồm tất cả người dùng trong đó miền.
- Mở dự án Cloud của tập lệnh.
- Nhấp vào biểu tượng Trình đơn > IAM và quản trị viên > IAM.
- Ở phía trên cùng, hãy nhấp vào Thêm.
- Làm theo hướng dẫn trên màn hình để thêm một hoặc nhiều thành viên mới và đối với dự án Cloud. Bạn có thể thêm từng email, Google Groups hoặc miền với tư cách thành viên mới.
- Nhấp vào Lưu.
Nhóm nhiều tập lệnh bằng một dự án Cloud duy nhất
Bạn có thể có nhiều dự án Apps Script có cùng một tiêu chuẩn Dự án trên đám mây. Để làm điều này, hãy tạo một dự án chuẩn rồi chuyển đổi từng dự án tập lệnh để sử dụng. Bạn không thể thực hiện việc này với các dự án mặc định.
Sử dụng một dự án Cloud chuẩn khác
Bạn có thể chuyển đổi một dự án tập lệnh để dự án đó sử dụng một tiêu chuẩn khác Dự án trên đám mây. Nếu tập lệnh của bạn yêu cầu cấu hình thủ công của phần trên đám mây, bạn phải chuyển từ dự án mặc định sang dự án chuẩn dự án. Để tìm hiểu thông tin thêm về thời điểm bạn cần sử dụng dự án chuẩn, hãy tham khảo dự án Cloud chuẩn.
Ảnh hưởng của việc chuyển sang dự án Google Cloud chuẩn khác
Nếu bạn chuyển tập lệnh của mình từ một dự án mặc định hoặc sang một dự án chuẩn khác dự án của bạn, thì tập lệnh này có các tác động sau:
- Nếu đã kích hoạt các dịch vụ nâng cao cho tập lệnh của mình, bạn phải bật các API tương ứng ở dự án Cloud mới. Bạn mất bất kỳ dữ liệu nào liên kết với trong dự án Cloud trước đó. Để tìm hiểu cách bật API trong dự án Google Cloud của bạn, hãy tham khảo bài viết Bật API Google Workspace.
- Nếu tập lệnh của bạn sử dụng dịch vụ Google Drive được tích hợp sẵn, bạn phải bật
API Drive trong các dự án Cloud tiêu chuẩn.
Trong dự án Cloud chuẩn của bạn, hãy bật API Drive:
- Tất cả người dùng đã từng cho phép tập lệnh phải ủy quyền lại. Ngang bằng trong hầu hết các trường hợp, tất cả người dùng đã từng cho phép ứng dụng được liên kết với dự án mới cũng phải ủy quyền lại.
- Nếu tập lệnh của bạn được liên kết với một trang thông tin ứng dụng trên Google Workspace Marketplace thì trang thông tin ứng dụng, người dùng và bài đánh giá của bạn sẽ không được chuyển sang dự án mới. Bạn phải tạo một trang thông tin ứng dụng trong dự án mới và người dùng phải cài đặt lại ứng dụng của bạn. Để biết thông tin về cách tạo trang thông tin ứng dụng, hãy tham khảo bài viết Xuất bản ứng dụng.
- Bạn không thể chuyển tập lệnh về dự án mặc định. Xoá Apps Script dự án mặc định sau khi bạn đặt tập lệnh để sử dụng dự án chuẩn.
Chuyển sang một dự án Cloud chuẩn khác
Cách chuyển dự án hiện có của một tập lệnh trên Google Cloud sang một dự án khác Một dự án trên đám mây, hãy làm theo các bước sau:
- Nếu bạn không có dự án nào phù hợp trên Google Cloud, hãy tạo bằng cách làm theo liên kết Tạo dự án . Đặt một tên dễ nhớ cho dự án để bạn có thể hãy tìm tệp đó trên trang Quản lý tài nguyên trên Google Cloud Console. Apps Script sử dụng tên này khi yêu cầu người dùng cho phép tập lệnh.
- Nếu bạn muốn sử dụng một dự án hiện có, hãy mở trang Quản lý tài nguyên trên bảng điều khiển Google Cloud và xác định vị trí một dự án hiện có để sử dụng. Bạn phải có Vai trò Trình duyệt dự án và Trình chỉnh sửa cấu hình OAuth hoặc các vai trò có vai trò tương đương quyền, đối với dự án. Bạn không thể sử dụng dự án do Apps tạo tự động Tập lệnh.
- Xác định Số dự án của dự án Google Cloud.
- Mở tập lệnh có dự án trên Google Cloud mà bạn muốn thay thế.
- Ở bên trái, hãy nhấp vào Cài đặt dự án .
- Trong mục Dự án Google Cloud Platform (GCP), hãy nhấp vào Thay đổi dự án.
- Nhập số dự án mới rồi nhấp vào Đặt dự án.
Dự án trên đám mây và bộ nhớ dùng chung
Bộ nhớ dùng chung (trước đây là Drive nhóm) cung cấp không gian dùng chung nơi các nhóm người dùng Drive có thể cộng tác trên Apps Script dự án và tài liệu trên Drive. Bộ nhớ dùng chung rất hữu ích trong quá trình phát triển tập lệnh, tiện ích bổ sung và ứng dụng web với nhóm, nhưng chúng đặt ra một số hạn chế về những việc bạn có thể làm với các dự án mặc định cũ trên Google Cloud.
Danh sách các quy định hạn chế sau đây mô tả cách các dự án trên đám mây tương tác với bộ nhớ dùng chung:
- Nếu dự án tập lệnh của bạn sử dụng dự án chuẩn, sẽ không có các hạn chế khác khi dự án tập lệnh nằm trong bộ nhớ dùng chung.
- Nếu dự án tập lệnh của bạn sử dụng một dự án mặc định được tạo vào hoặc sau ngày 8 tháng 4 năm 2019, không có hạn chế bổ sung nào khi tập lệnh dự án nằm trong bộ nhớ dùng chung.
- Nếu dự án tập lệnh của bạn sử dụng một dự án mặc định được tạo trước đó
Vào ngày 8 tháng 4 năm 2019, các hạn chế sau đây được áp dụng trong khi tập lệnh
dự án nằm trên bộ nhớ dùng chung:
- Bạn không thể truy cập vào dự án mặc định bằng giao diện người dùng Apps Script hoặc không bảng điều khiển Google Cloud. Quy định hạn chế này khiến bạn không thể dùng những hành động yêu cầu quyền truy cập trực tiếp vào dự án.
- Bạn không thể kích hoạt các dịch vụ nâng cao. Để kích hoạt các dịch vụ nâng cao, hãy chuyển sang thẻ dự án.
- Khi bạn di chuyển dự án Apps Script hiện có vào bộ nhớ dùng chung, Google sẽ hạn chế quyền truy cập vào dự án mặc định trên Google Cloud. Bạn vẫn có thể truy cập vào dự án mặc định nếu bạn đã có quyền truy cập trước khi di chuyển. Cho ví dụ: nếu bạn đã tạo một tập lệnh trong thư mục Drive của tôi rồi di chuyển tệp đó vào bộ nhớ dùng chung, bạn vẫn có thể truy cập vào tập lệnh Dự án trên đám mây. Cộng tác viên của bạn trong bộ nhớ dùng chung có thể không thể.
- Một tập lệnh giữ lại tên dự án trên đám mây trước khi được đã chuyển đến bộ nhớ dùng chung. Ngay cả khi bạn thay đổi tên dự án trên bộ nhớ dùng chung, những người dùng ủy quyền tập lệnh vẫn thấy tên cũ khi ủy quyền .
Để tránh các hạn chế ở trên đối với các tập lệnh cũ hơn, chuyển sang dự án chuẩn.
Nhận danh sách các dự án Apps Script Cloud
Nếu bạn có quyền resourcemanager.projects.list
đối với
thư mục dự án Apps Script của tổ chức, bạn có thể xem tất cả
dự án Apps Script Cloud mặc định trong thư mục.
- Mở trang Quản lý tài nguyên trên bảng điều khiển Google Cloud.
- Bên cạnh thư mục Apps Script, hãy sao chép mã nhận dạng.
- Nhấp vào Bộ lọc > Mã nhận dạng cha mẹ rồi dán mã thư mục Apps Script.
Xoá dự án trên Apps Script Cloud
Để xoá dự án Apps Script trên đám mây, hãy làm theo các bước trong phần Tải danh sách dự án Apps Script Cloud, chọn dự án mà bạn muốn xoá rồi nhấp vào Xoá.
Để xoá dự án Apps Script bằng gcloud
, hãy dùng lệnh sau
.
gcloud projects list --filter='parent.id=APPS_SCRIPT_FOLDER_ID'
gcloud projects delete PROJECT_ID
Để biết thêm thông tin về cách xoá dự án trên Google Cloud, hãy xem phần Tắt máy (xoá) dự án.