Các dự án Google Cloud

Mọi dự án Google 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 một dự án mặc định do Apps Script tự động tạo hoặc một dự án tiêu chuẩn do bạn tự tạo. Nói chung, các dự án mặc định phù hợp với các tập lệnh 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 lại để sử dụng 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 quá trình phát triển. Việc chuyển đổi sau này có thể gây ra các vấn đề phức tạp, chẳng hạn như yêu cầu người dùng cấp lại quyền.

Dự án mặc định trên Cloud

Khi bạn tạo một dự án Apps Script, dự án này sẽ tạo một dự án trên đám mây 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 trên đám mây 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 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 trên đám mây tiêu chuẩn. Ví dụ: để xem nhật ký Google Cloud trong bảng điều khiển Cloud, 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, 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 dự án mặc định trên Cloud

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 bạn tạo dự án tập lệnh trước ngày 8 tháng 4 năm 2019, thì bạn có thể sử dụng một dự án mặc định mà bạn có thể truy cập trong bảng điều khiển 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 số dự án.

Xoá dự án mặc định trên Cloud

Nếu là quản trị viên, bạn có thể xoá các dự án mặc định trên Cloud giống như cách xoá các dự án tiêu chuẩn trên Cloud. Xem bài viết Xem hoặc chỉnh sửa dự án mặc định trên Cloud.

Người dùng không phải là quản trị viê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 sang một dự án tiêu chuẩn, thì Apps Script sẽ xoá dự án mặc định được đính kèm với tập lệnh cùng với các chế độ cài đặt và thông tin của dự án đó.

Dự án tiêu chuẩn trên Cloud

Dự án mặc định trên Cloud 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 để 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ụ phổ biến. Chỉ thực hiện các tác vụ này với các dự án tiêu chuẩn.

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

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

Thuộc tính của dự án tiêu chuẩn trên đám mây

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

  • Truy cập vào tất cả các chế độ cài đặt Google Cloud cho dự án trực tiếp từ bảng điều khiển Cloud. Điều 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 chi tiết khác.
  • Khi bạn xoá một dự án tập lệnh hoặc chuyển dự án đó để sử dụng một dự án tiêu chuẩn khác, dự án tiêu chuẩn ban đầu vẫn tồn tại và có thể được 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 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 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ể dùng chung các dự án trên Cloud 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 API Apps Scriptscripts.run, 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 một dự án tiêu chuẩn, tên dự án trên đám mây 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 trên đám mây cho phù hợp.

Truy cập vào một dự án tiêu chuẩn trên đám mây

Cách truy cập vào dự án tiêu chuẩn được liên kết với dự án tập lệnh:

  1. Mở dự án Apps Script.
  2. Ở bên trái, hãy nhấp vào biểu tượng Project Settings .
  3. Trong phần Google Cloud Project (Dự án Google Cloud), hãy nhấp vào số dự án.

Tìm một dự án tiêu chuẩn trực tiếp trên trang bảng điều khiển Cloud Manage Resources (Quản lý tài nguyên).

Kích hoạt một API trong một dự án trên đám mây tiêu chuẩn

Để cấp cho một ứng dụng Apps Script quyền truy cập vào một API khác của Google, hãy kích hoạt API đó trong dự án tương ứng trên Cloud:

  1. Mở dự án trên đám mây.
  2. Nhấp vào biểu tượng Trình đơn > API và Dịch vụ.
  3. Nhấp vào mục Bật API và dịch vụ.
  4. 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 Enter.
  5. Nhấp vào API trong kết quả tìm kiếm, sau đó nhấp vào Bật.

Bạn có thể được nhắc chấp nhận Điều khoản dịch vụ cho Google APIs hoặc Google Cloud. Hãy 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ó 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ã và số của một dự án trên đám mây tiêu chuẩn

Tất cả các dự án trên Cloud đều có tên, mã và số. Bạn có thể cần các mã nhận dạng này để định cấu hình dịch vụ hoặc hoàn tất các tác vụ khác.

Cách xác định mã và số của dự án tiêu chuẩn:

  1. Mở dự án trên đám mây.
  2. Ở trên cùng bên phải, hãy nhấp vào biểu tượng Tuỳ chọn khác > Project settings (Cài đặt dự án).
  3. Xem Project name (Tên dự án), Project ID (Mã dự án) và Project number (Số dự án) trong bảng điều khiển Settings (Cài đặt) kết quả. Project number (Số dự án) bao gồm các chữ số, trong khi Project ID (Mã dự án) là chữ và số. Chỉnh sửa Project name (Tên dự án) hiển thị cho người dùng trong lời nhắc uỷ quyền.

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

Nếu đang sử dụng Cloud Logging hoặc Error Reporting cho dự án tập lệnh, bạn có thể xem các nhật ký và báo cáo đó trong bảng điều khiển Cloud bằng cách làm như sau:

  1. Mở dự án trên đám mây.
  2. Nhấp vào biểu tượng Trình đơn .
  3. Trong phần Operations (Hoạt động), hãy 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, trong phần Operations (Hoạt động), hãy nhấp vào Error Reporting (Báo cáo lỗi). Nếu bạn được nhắc thiết lập tính năng báo cáo lỗi, thì điều này có nghĩa là dự án tập lệnh của bạn chưa ghi lại bất kỳ 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ụ đó. Các chế độ cài đặt màn hình xin phép bằng OAuth xác định 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 mặc định trên Cloud tự động tạo một màn hình xin phép từ thông tin chi tiết của dự án Apps Script; bạn không thể điều chỉnh các chế độ cài đặt đó. Các dự án tiêu chuẩn trên Cloud cho phép bạn tuỳ chỉnh thông tin này. Cách định cấu hình màn hình xin phép của tập lệnh:

  1. Mở dự án trên đám mây.
  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 Configure consent screen (Định cấu hình màn hình xin phép).
  4. Điền vào từng phần của màn hình xin phép.
  5. Để ghi lại các thay đổi ở mỗi giai đoạn, hãy nhấp vào Save and continue (Lưu và tiếp tục).

Tạo thông tin xác thực 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, hãy 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). Chỉ thực hiện việc này với các dự án tiêu chuẩn.

Cách tạo mã ứng dụng và khoá bí mật của ứng dụng cho dự án tập lệnh:

  1. Mở dự án trên đám mây.
  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 Create credentials (Tạo thông tin xác thực) > OAuth client ID (Mã ứng dụng OAuth).
  4. Trong phần Application type (Loại ứng dụng), hãy chọn loại ứng dụng của bạn rồi điền vào biểu mẫu. Khi hoàn tất, hãy nhấp vào Create (Tạo).
  5. Trong hộp thoại, hãy nhấp vào Download JSON (Tải tệp JSON xuống). Sử 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 đám mây

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 để đả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 các chế độ cài đặt Google Cloud của dự án tập lệnh.

Cách 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 (yêu cầu quyền chỉnh sửa):

  1. Xác định người cộng tác. Bạn nên sử dụng một Nhóm Google. Chỉ định các miền để đưa tất cả người dùng trong miền đó vào.
  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 & admin > IAM.
  4. Ở trên cùng, hãy nhấp vào Add (Thêm).
  5. Làm theo hướng dẫn trên màn hình để thêm thành viên mới và vai trò của họ. Thêm email riêng lẻ, Nhóm Google hoặc miền.
  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 duy nhất

Nhiều dự án Apps Script có thể dùng chung cùng một dự án tiêu chuẩn trên đám mây. Để 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 đó. Bạn không thể thực hiện việc này với các dự án mặc định.

Nếu bạn muốn xuất bản dự án tập lệnh của mình trên 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ể dùng chung các dự án trên Cloud.

Sử dụng một dự án trên đám mây tiêu chuẩn khác

Chuyển một dự án tập lệnh để sử dụng một dự án trên đám mây tiêu chuẩn khác. Nếu tập lệnh của bạn yêu cầu định cấu hình dự án trên đám mây theo cách thủ công, hãy chuyển từ dự án mặc định sang dự án tiêu chuẩn. Để tìm hiểu thêm, hãy tham khảo bài viết về các dự án tiêu chuẩn trên Cloud.

Ảnh hưởng của việc chuyển sang một dự án trên đám mây tiêu 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 tiêu chuẩn khác, thì việc 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 trên đám mây mới. Bạn sẽ mất mọi dữ liệu được liên kết với các dịch vụ nâng cao trong dự án trên đám mây trước đó. Để tìm hiểu cách bật API trong dự án trên đám mây, 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, bạn phải bật API Drive trong các dự án tiêu chuẩn trên Cloud.

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

    Bật API Drive

  • Tất cả người dùng đã uỷ quyền cho tập lệnh trước đó 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 trước đó 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 ứ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 một trang thông tin ứng dụng 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 trên đám mây tiêu chuẩn khác

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

  1. Nếu bạn không có dự án trên đám mây 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 tên dự án dễ nhớ để tìm dự án đó trên trang Google Cloud console Manage Resources (Quản lý tài nguyên). 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 bạn muốn sử dụng một dự án hiện có, hãy mở trang bảng điều khiển Cloud Manage Resources (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ò 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ó quyền tương đương cho dự án. Bạn không thể sử dụng một dự án do Apps Script tự động tạo.
  3. Xác định Project number (Số dự án) của dự án trên đám mây.
  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 biểu tượng Project Settings (Cài đặt dự án).
  6. Trong phần Google Cloud Project (Dự án Google Cloud), hãy nhấp vào Change project (Thay đổi dự án).
  7. Nhập số dự án mới rồi nhấp vào Set project (Đặt dự án).

Dự án trên Cloud và bộ nhớ dùng chung

Bộ nhớ 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 (trước đây là Ổ đĩa nhóm) cung cấp các 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 các dự án Apps Script và tài liệu trên Drive. Bộ nhớ dùng chung rất hữu ích khi 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 chúng đặt ra một số hạn chế đối với những gì bạn có thể làm với các dự án cũ mặc định trên Cloud.

Danh sách sau đây mô tả cách các dự án trên Cloud 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 một dự án tiêu chuẩn, 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 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 hạn chế sau đây sẽ áp dụng khi dự án tập lệnh nằm trong một bộ nhớ 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 Cloud. Hạn chế này ngăn bạn thực hiện các 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 một bộ nhớ dùng chung, Google sẽ hạn chế quyền truy cập vào dự án mặc định trên Cloud. 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 di chuyển. 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 lệnh đó vào một bộ nhớ dùng chung, thì bạn vẫn có thể truy cập vào dự án trên đám mây của tập lệnh đó. Những người cộng tác của bạn trong bộ nhớ dùng chung có thể không truy cập được.
    4. Một tập lệnh sẽ giữ lại tên dự án trên đám mây mà tập lệnh đó có trước khi được di chuyển vào một 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 uỷ quyền cho tập lệnh vẫn thấy tên cũ trên các hộp thoại uỷ quyền.

Để tránh những hạn chế này đố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 các dự án Apps Script trên Cloud

Nếu có quyền resourcemanager.projects.list cho thư mục dự án Apps Script của tổ chức, bạn có thể xem tất cả các dự án Apps Script tiêu chuẩn và mặc định trên Cloud trong thư mục đó.

  1. Mở trang bảng điều khiển Cloud Manage Resources (Quản lý tài nguyên).
  2. Bên cạnh thư mục Apps Script, hãy sao chép mã nhận dạng.
  3. Nhấp vào Filter (Bộ lọc) > Parent ID (Mã nhận dạng mẹ) và dán mã nhận dạng thư mục Apps Script.

Xoá dự án Apps Script trên Cloud

Bạn phải là quản trị viên thì mới có thể xoá các dự án mặc định.

Cách xoá một dự án Apps Script khỏi bảng điều khiển Cloud của Google:

  1. Mở dự án trên đám mây.
  2. Ở trên cùng bên phải, hãy nhấp vào biểu tượng Tuỳ chọn khác > Project settings (Cài đặt dự án).
  3. Nhấp vào Shut down / delete (Tắt/xoá).
  4. Làm theo hướng dẫn trên màn hình để tắt dự án.

Để xoá một dự án Apps Script bằng gcloud, hãy sử 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á các dự án trên Cloud, hãy xem bài viết Tắt (xoá) dự án.