Các dự án Google Cloud

Mọi dự án Apps Script đều sử dụng Google Cloud để quản lý hoạt động uỷ quyền, 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 được liên kết. Dự án tập lệnh của bạn có thể sử dụng dự ánmặc định mà Apps Script tự động tạo hoặc dự ánchuẩn mà bạn tự tạo. Nhìn chung, các dự án mặc định phù hợp với các tập lệnh đơn giản hoặc hằng ngày, nhưng bạn nên sử dụng một dự án tiêu chuẩn cho mọi ứng dụng phức tạp, có chất lượng thương mại hoặc bạn dự định xuất bản.

Bạn có thể chuyển từ dự án mặc định sang dự án tiêu chuẩn bất cứ lúc nào, nhưng không thể chuyển về dự án mặc định. Tốt nhất là bạn nên chọn dự án trên Đám mây mà tập lệnh của bạn sử dụng ngay từ đầu trong quá trình phát triển. Việc chuyển đổi sau này có thể gây ra những phức tạp, 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 Cloud mặc định 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. Apps Script 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, thì Apps Script sẽ 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 Google Cloud Console. Trong những trường hợp này, tập lệnh của bạn phải sử dụng một dự án Cloud tiêu chuẩn. Ví dụ: để xem nhật ký Google Cloud trong Google Cloud Console, tập lệnh của bạn phải sử dụng một dự án tiêu chuẩn.

Theo mặc định, các dự án trên Cloud có một chính sách Quản lý danh tính và quyền truy cập (IAM) với một mục nhập, đó là 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ụ Google là appsdev-apps-dev-script-auth@system.gserviceaccount.com.

Xem hoặc cập nhật dự án mặc định trên đám mây

Hầu hết người dùng đều không thể trực tiếp xác định vị trí, 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 trước ngày 8 tháng 4 năm 2019, bạn có thể sử dụng một dự án mặc định mà bạn có thể truy cập trong Google Cloud Console. Để truy cập vào dự án mặc định, hãy chuyển đến phần cài đặt dự án tập lệnh rồi nhấp vào số dự án.

Xoá các 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 Google Cloud giống như cách bạn xoá các dự án tiêu chuẩn trên Google Cloud. Xem phần Xem hoặc chỉnh sửa dự án mặc định trên Cloud.

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 theo cách thủ công. Tuy nhiên, nếu bạn xoá dự án tập lệnh hoặc chuyển dự án đó sang sử dụng một dự án tiêu chuẩn, thì Apps Script sẽ xoá dự án mặc định được đính kèm vào tập lệnh cùng với mọi chế độ cài đặt hoặc thông tin mà dự án đó chứa.

Dự án trên đám mây tiêu chuẩn

Dự án trên Google Cloud mặc định là lựa chọn tốt nhất cho hầu hết các dự án 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 dự án tập lệnh của mình sang sử dụng một dự án tiêu chuẩn.

Các phần sau đây mô tả thời điểm Apps Script yêu cầu một dự án tiêu chuẩn, các thuộc tính của dự án đó và các tác vụ thường dùng với dự án đó. Bạn chỉ có thể thực hiện các thao tác bên dưới với dự án tiêu chuẩn.

Khi Apps Script yêu cầu dự án Cloud tiêu chuẩn

Bạn phải sử dụng dự án tiêu chuẩn trong các trường hợp sau:

Các thuộc tính chuẩn của dự án trên đám mây

Dự án tiêu chuẩn có các thuộc tính sau:

  • Bạn có thể truy cập trực tiếp vào tất cả các chế độ cài đặt Google Cloud cho dự án từ Bảng điều khiển Google Cloud. Thao tác này cho phép bạn kích hoạt API, điều chỉnh thông tin xác thực uỷ quyền và định cấu hình các thông tin khác.
  • Khi bạn xoá một dự án tập lệnh hoặc chuyển dự án đó sang sử dụng một dự án chuẩn khác, dự án chuẩn ban đầu vẫn sẽ tồn tại và có thể được sử dụng lại.
  • Khi 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 kích hoạt API tương ứng theo cách thủ công trong dự án tiêu chuẩn.
  • Nhiều dự án tập lệnh và các ứng dụng khác có thể dùng chung cùng một dự án tiêu chuẩn. Nếu bạn dự định xuất bản một dự án tập lệnh lên Google Workspace Marketplace dưới dạng một tiện ích bổ sung, thì dự án đó phải có dự án tiêu chuẩn riêng. Các ứng dụng đã xuất bản không thể chia sẻ 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 một dự án tập lệnh từ một ứng dụng khác bằng phương thức scripts.run của Apps Script API, thì dự án tập lệnh và ứng dụng gọi phải dùng chung cùng một dự án tiêu chuẩn.
  • Khi Apps Script yêu cầu người dùng uỷ quyền cho một tập lệnh sử dụng dự án tiêu chuẩn, tên dự án trên Cloud sẽ đượ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 Cloud phù hợp.

Truy cập vào một dự án Cloud tiêu chuẩn

Để truy cập vào dự án tiêu chuẩn được liên kết với dự án tập lệnh, hãy làm như sau:

  1. Mở dự án Apps Script.
  2. Ở bên trái, hãy nhấp vào Cài đặt dự án .
  3. Trong mục Dự án trê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 tiêu chuẩn ngay trên trang Quản lý tài nguyên của Google Cloud Console.

Kích hoạt một API trong dự án Cloud tiêu chuẩn

Thông thường, một ứng dụng Apps Script cần có quyền truy cập vào một API khác của Google. Để làm việc này, bạn phải kích hoạt API trong dự án Cloud tương ứng. Kích hoạt một API bằng cách làm như sau:

  1. Mở dự án trên Google Cloud.
  2. Nhấp vào Trình đơn > API và Dịch vụ.
  3. Nhấp vào Bật API và dịch vụ.
  4. Trong hộp tìm kiếm, hãy nhập API bạn muốn kích hoạt rồi nhấn phím Enter.
  5. Nhấp vào API trong kết quả tìm kiếm, sau đó 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 các API của Google hoặc Google Cloud. Xem kỹ Điều khoản dịch vụ trước khi chấp nhận.

Tuỳ thuộc vào ứng dụng, bạn cũng có thể cần định cấu hình API bằng cách chọn API đó trong trang tổng quan API và dịch vụ.

Xác định mã nhận dạng và số dự án trên Cloud tiêu 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ó những 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 tiêu chuẩn, hãy làm như sau:

  1. Mở dự án trên Google Cloud.
  2. Ở 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.
  3. Xem Tên dự án, Mã dự án và Số dự án trong bảng Cài đặt xuất hiện. Số dự án chỉ bao gồm các chữ số, trong khi Mã dự án là chữ và số. Bạn có thể chỉnh sửa Tên dự án. Tên này sẽ xuất hiện với người dùng trong lời nhắc uỷ quyền.

Xem nhật ký và báo cáo lỗi của Google Cloud trong bảng điều khiển Google Cloud

Nếu đang sử dụng tính năng ghi nhật ký trên Google Cloud hoặc tính năng báo cáo lỗi cho dự án tập lệnh, bạn có thể xem các nhật ký và báo cáo đó trong Google Cloud Console bằng cách làm như sau:

  1. Mở dự án trên Google Cloud.
  2. Nhấp vào biểu tượng Trình đơn .
  3. Di chuyển xuống phần Operations (Thao tác) rồi nhấp vào Logging > Logs explorer (Ghi nhật ký > Trình khám phá nhật ký).
  4. Để xem báo cáo lỗi, hãy di chuyển xuống phần Thao tác rồi nhấp vào Báo cáo lỗi. Nếu bạn được nhắc thiết lập báo cáo lỗi, thì tức là dự án tập lệnh của bạn chưa ghi lại bất kỳ trường hợp ngoại lệ nào.

Khi sử dụng các dịch vụ yêu cầu OAuth, Google sẽ nhắc người dùng uỷ quyền cho các dịch vụ đó. Chế độ cài đặt màn hình đồng ý OAuth cho phép bạn đặt một số thông tin mà Google trình bày cho người dùng, chẳng hạn như tên ứng dụng và URL Điều khoản dịch vụ.

Các dự án Cloud mặc định sẽ tự động tạo màn hình đồng ý từ thông tin chi tiết về dự án Apps Script; bạn không thể điều chỉnh những chế độ cài đặt đó. Các dự án Cloud tiêu chuẩn cho phép bạn tuỳ chỉnh thông tin này. Bạn có thể định cấu hình màn hình xin phép của tập lệnh bằng cách làm như sau:

  1. Mở dự án trên Google Cloud.
  2. Nhấp vào biểu tượng Trình đơn > API và Dịch vụ > Thông tin xác thực.
  3. Nhấp vào Định cấu hình màn hình đồng ý.
  4. Điền thông tin vào từng phần trong quy trình trên màn hình xin phép.
  5. Để ghi lại các thay đổi ở mỗi giai đoạn của quy trình công 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 xác thực OAuth (mã ứng dụng và khoá bí mật của ứng dụng). Bạn chỉ có thể thực hiện việc này với các dự án tiêu chuẩn.

Để tạo mã ứng dụng khách và khoá bí mật của ứng dụng khách cho dự án tập lệnh, hãy làm như sau:

  1. Mở dự án trên Google Cloud.
  2. Nhấp vào biểu tượng Trình đơn > API và Dịch vụ > Thông tin xác thực.
  3. Nhấp vào Tạo thông tin đăng nhập > Mã ứng dụng OAuth.
  4. Trong mục Loại ứng dụng, hãy chọn loại ứng dụng của bạn và điền vào biểu mẫu kết quả nếu cần. Khi hoàn tất, hãy nhấp vào Tạo.
  5. Trong hộp thoại xuất hiện, hãy nhấp vào Tải tệp JSON xuống. Bạn có thể 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 trên Đám mây tiêu chuẩn

Bạn có thể thêm chủ sở hữu bổ sung hoặc các vai trò khác vào một dự án tiêu chuẩn. Nếu bạn đang cộng tác trong một dự án, thì việc này sẽ giúp đảm bảo rằng luôn có người trong nhóm của bạ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 khác hoặc các vai trò khác vào một dự án tiêu chuẩn bằng cách thực hiện các bước sau. Bạn phải có quyền chỉnh sửa đối với dự án để thực hiện bất kỳ thay đổi nào trong số này:

  1. Xác định những người nên cộng tác với bạn. Bạn nên tạo hoặc sử dụng một Nhóm Google hiện có. Bạn cũng có thể chỉ định các miền trong danh sách cộng tác viên để thêm tất cả người dùng trong miền đó.
  2. Mở dự án trên Đám mây của tập lệnh.
  3. Nhấp vào biểu tượng Trình đơn > IAM và quản trị > IAM.
  4. Ở trên cùng, hãy nhấp vào Thêm.
  5. 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à vai trò của họ vào Dự án trên đám mây. Bạn có thể thêm từng email, nhóm trên Google Groups hoặc miền làm thành viên mới.
  6. Nhấp vào Lưu.

Nhóm nhiều tập lệnh bằng một dự án trên đám mây

Bạn có thể có nhiều dự án Apps Script dùng chung cùng một dự án Cloud tiêu chuẩn. Để thực hiện việc này, hãy tạo một dự án tiêu chuẩn rồi chuyển từng dự án tập lệnh để sử dụng dự án tiêu chuẩn đó. 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 một dự án tập lệnh để dự án đó sử dụng một dự án tiêu chuẩn khác trên Đám mây. Nếu tập lệnh của bạn yêu cầu định cấu hình dự án Cloud theo cách thủ công, thì bạn phải chuyển từ dự án mặc định sang dự án tiêu chuẩn. Để tìm hiểu 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 chuẩn trên Cloud.

Ảnh hưởng của việc chuyển sang một dự án Cloud tiêu chuẩn khác

Nếu bạn chuyển tập lệnh từ một dự án mặc định hoặc sang một dự án tiêu chuẩn khác, thì điều này sẽ có những ảnh hưởng sau:

  • Nếu đã kích hoạt các dịch vụ nâng cao cho tập lệnh, bạn phải bật các API tương ứng trong dự án mới trên Cloud. Bạn sẽ mất mọi dữ liệu liên kết với các dịch vụ nâng cao trong dự án trên Cloud trước đó. Để tìm hiểu cách bật API trong dự án trên Cloud, 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 tích hợp, thì bạn phải bật Drive API trong các dự án Cloud tiêu chuẩn.

    Trong dự án Cloud tiêu chuẩn, hãy bật Drive API:

    Bật Drive API

  • Tất cả người dùng đã uỷ quyền cho tập lệnh trước đây đều phải uỷ quyền lại. Trong hầu hết các trường hợp, tất cả người dùng đã uỷ quyền cho các ứng dụng được liên kết với dự án mới cũng phải uỷ 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 trên Cửa hàng Play 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 trên Cửa hàng Play mới, 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 trở lại dự án mặc định. Apps Script sẽ xoá các dự án mặc định sau khi bạn đặt tập lệnh để sử dụng một dự án tiêu chuẩn.

Chuyển sang một dự án Cloud tiêu chuẩn khác

Để chuyển dự án Cloud hiện có của một tập lệnh sang một dự án Cloud khác, hãy làm theo các bước sau:

  1. Nếu bạn không có dự án Cloud phù hợp, hãy tạo một dự án bằng cách làm theo hướng dẫn Tạo dự án. Đặt một tên dự án dễ nhớ để bạn có thể tìm thấy dự án đó trên trang Quản lý tài nguyên của Google Cloud Console. Apps Script sử dụng tên này khi yêu cầu người dùng uỷ quyền cho tập lệnh.
  2. Nếu muốn sử dụng một dự án hiện có, hãy mở trang Google Cloud Console Quản lý tài nguyên rồi tìm một dự án hiện có để sử dụng. Bạn phải có vai trò Project Browser và OAuth Config Editor hoặc các vai trò có quyền tương đương cho dự án. Bạn không thể sử dụng dự án do Apps Script tự động tạo.
  3. Xác định Số dự án của dự án trên Cloud.
  4. Mở tập lệnh mà bạn muốn thay thế dự án trên đám mây.
  5. Ở bên trái, hãy nhấp vào Cài đặt dự án .
  6. Trong mục Dự án trên Google Cloud Platform (GCP), hãy nhấp vào Thay đổi dự án.
  7. 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à Ổ đĩa nhóm) cung cấp không gian dùng chung để các nhóm người dùng Drive có thể cộng tác trên các dự án Apps Script và tài liệu trên Drive. Ổ đĩa dùng chung rất hữu ích khi bạn phát triển tập lệnh, tiện ích bổ sung và ứng dụng web với một nhóm, nhưng ổ đĩa dùng chung sẽ áp đặt một số hạn chế đối với những việc bạn có thể làm với các dự án mặc định cũ trên đám mây.

Danh sách hạn chế sau đây mô tả cách các dự án trên Cloud tương tác với ổ đĩa dùng chung:

  • Nếu dự án tập lệnh của bạn sử dụng một dự án tiêu chuẩn, thì sẽ không có các hạn chế bổ sung khi dự án tập lệnh nằm trong một 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, thì sẽ không có thêm hạn chế nào khi dự án tập lệnh nằm trong một 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 ngày 8 tháng 4 năm 2019, thì các quy định hạn chế sau đây sẽ áp dụng khi dự án tập lệnh nằm trên ổ dùng chung:
    1. 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 Bảng điều khiển Google Cloud. Quy định hạn chế này ngăn bạn thực hiện những hành động yêu cầu quyền truy cập trực tiếp vào dự án.
    2. 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 một dự án tiêu chuẩn.
    3. Khi bạn di chuyển một dự án Apps Script hiện có vào ổ dùng chung, Google sẽ hạn chế quyền truy cập vào dự án Cloud mặc định. Bạn vẫn có thể truy cập vào dự án mặc định nếu đã có quyền truy cập trước khi chuyển. Ví dụ: nếu tạo một tập lệnh trong thư mục Drive của tôi rồi di chuyển tập lệnh đó vào bộ nhớ dùng chung, bạn vẫn có thể truy cập vào dự án Đám mây của tập lệnh đó. Có thể cộng tác viên trong bộ nhớ dùng chung sẽ không thể làm được.
    4. Tập lệnh sẽ giữ lại tên dự án trên Cloud mà tập lệnh có trước khi được di chuyển sang một ổ đĩa 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 uỷ quyền cho tập lệnh vẫn thấy tên cũ trên hộp thoại uỷ quyền.

Để tránh các hạn chế nêu trên đối với các tập lệnh cũ, hãy chuyển sang một dự án tiêu chuẩn.

Lấy danh sách dự án Apps Script trên đám mây

Nếu 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 tiêu chuẩn và mặc định trong thư mục đó.

  1. Mở trang Quản lý tài nguyên của Google Cloud Console.
  2. Sao chép mã nhận dạng bên cạnh thư mục Apps Script.
  3. Nhấp vào Bộ lọc > Mã nhận dạng thư mục mẹ rồi dán mã nhận dạng thư mục Apps Script.

Xoá các dự án trên đám mây của Apps Script

Để xoá một dự án Apps Script Cloud, hãy làm theo các bước trong phần Lấy danh sách dự án Apps Script Cloud, chọn dự án bạn muốn xoá rồi nhấp vào Xoá.

Để xoá một dự án Apps Script bằng gcloud, hãy dùng các 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 Cloud, hãy xem phần Tắt (xoá) dự án.