Trang này được dịch bởi Cloud Translation API.

Tạo tiện ích bổ sung cho Google Workspace bằng Node.js

Tạo tiện ích bổ sung của Google Workspace trong Cloud Functions bằng môi trường thời gian chạy Node.js.

Mục tiêu

Thiết lập môi trường.
Tạo và triển khai một Chức năng trên đám mây.
Tạo và triển khai tiện ích bổ sung.
Cài đặt tiện ích bổ sung.

Điều kiện tiên quyết

Một dự án trên Google Cloud.
Hãy nhớ bật tính năng thanh toán cho dự án trên Cloud. Tìm hiểu cách xác minh trạng thái thanh toán của dự án.
Cloud SDK được định cấu hình với dự án Cloud.

Thiết lập môi trường

Mở dự án trên Google Cloud trong Google Cloud Console

Trong Google Cloud Console, hãy chuyển đến trang Chọn một dự án.
Chọn một dự án trên Đám mây
Chọn dự án Google Cloud mà bạn muốn sử dụng. Hoặc nhấp vào Tạo dự án rồi làm theo hướng dẫn trên màn hình. Nếu tạo dự án trên Google Cloud, bạn có thể cần phải bật tính năng thanh toán cho dự án đó.

Định cấu hình màn hình xin phép bằng OAuth

Tiện ích bổ sung của Google Workspace yêu cầu cấu hình màn hình yêu cầu đồng ý. Việc định cấu hình màn hình xin phép bằng OAuth của tiện ích bổ sung sẽ xác định nội dung mà Google hiển thị cho người dùng.

Trong Google Cloud Console, hãy chuyển đến Trình đơn > > Tạo thương hiệu.
Chuyển đến phần Thương hiệu
Nếu đã định cấu hình , bạn có thể định cấu hình các chế độ cài đặt sau đây cho Màn hình đồng ý OAuth trong phần Gắn thương hiệu, Đối tượng và Quyền truy cập dữ liệu. Nếu bạn thấy thông báo chưa được định cấu hình, hãy nhấp vào Bắt đầu:

Trong phần Thông tin ứng dụng, trong mục Tên ứng dụng, hãy nhập tên cho ứng dụng.
Trong phần Email hỗ trợ người dùng, hãy chọn địa chỉ email hỗ trợ mà người dùng có thể liên hệ với bạn nếu họ có câu hỏi về sự đồng ý của họ.
Nhấp vào Tiếp theo.
Trong phần Đối tượng người xem, hãy chọn Nội bộ.
Nhấp vào Tiếp theo.
Trong phần Thông tin liên hệ, hãy nhập Địa chỉ email để bạn có thể nhận thông báo về mọi thay đổi đối với dự án của mình.
Nhấp vào Tiếp theo.
Trong phần Hoàn tất, hãy xem lại Chính sách dữ liệu người dùng của Dịch vụ API của Google. Nếu bạn đồng ý, hãy chọn Tôi đồng ý với Chính sách dữ liệu người dùng của Dịch vụ API của Google.
Nhấp vào Tiếp tục.
Nhấp vào Tạo.

Hiện tại, bạn có thể bỏ qua bước thêm phạm vi. Sau này, khi tạo một ứng dụng để sử dụng bên ngoài tổ chức Google Workspace, bạn phải thay đổi Loại người dùng thành Bên ngoài. Sau đó, thêm các phạm vi uỷ quyền mà ứng dụng của bạn yêu cầu. Để tìm hiểu thêm, hãy xem hướng dẫn đầy đủ về cách Định cấu hình sự đồng ý OAuth.

Tạo và triển khai một Chức năng trên đám mây

Trong một thiết bị đầu cuối cục bộ, hãy bật API tiện ích bổ sung Google Workspace, Cloud Build và Cloud Functions:
```
gcloud services enable cloudfunctions cloudbuild.googleapis.com gsuiteaddons.googleapis.com
```

Trong một thư mục trống, hãy tạo tệp function.js bằng mã mẫu sau:

/**
 * Cloud Function that loads the homepage for a
 * Google Workspace add-on.
 *
 * @param {Object} req Request sent from Google
 * @param {Object} res Response to send back
 */
exports.loadHomePage = function addonsHomePage (req, res) {
  res.send(createAction());
};

/** Creates a card with two widgets. */
function createAction() {
  return {
    "action": {
      "navigations": [
        {
          "pushCard": {
            "header": {
              "title": "Cats!"
            },
            "sections": [
              {
                "widgets": [
                  {
                    "textParagraph": {
                      "text": "Your random cat:"
                    }
                  },
                  {
                    "image": {
                      "imageUrl": "https://cataas.com/cat"
                     }
                  }
                ]
              }
            ]
          }
        }
      ]
    }
  };
}

Triển khai hàm:
```
gcloud functions deploy loadHomePage --runtime nodejs12 --trigger-http
```
Nếu được nhắc, hãy chỉ định rằng bạn không cho phép các lệnh gọi chưa xác thực của hàm. Có thể mất vài phút để triển khai hàm.

Tạo quá trình triển khai tiện ích bổ sung

Tìm email tài khoản dịch vụ của tiện ích bổ sung:
```
gcloud workspace-add-ons get-authorization
```

Cấp cho tài khoản dịch vụ vai trò cloudfunctions.invoker:

gcloud functions add-iam-policy-binding loadHomePage \
    --role roles/cloudfunctions.invoker \
    --member serviceAccount:SERVICE_ACCOUNT_EMAIL

Lấy URL của hàm đã triển khai. Để lấy URL, hãy chạy lệnh sau và tìm trường url trong phần httpsTrigger:
```
gcloud functions describe loadHomePage
```

Tạo tệp deployment.json bằng mã mẫu sau. Thay thế URL bằng URL của hàm đã triển khai ở bước trước.

{
  "oauthScopes": ["https://www.googleapis.com/auth/gmail.addons.execute"],
  "addOns": {
    "common": {
      "name": "My HTTP Add-on",
      "logoUrl": "https://raw.githubusercontent.com/webdog/octicons-png/main/black/beaker.png",
      "homepageTrigger": {
        "runFunction": "URL"
      }
    },
    "gmail": {},
    "drive": {},
    "calendar": {},
    "docs": {},
    "sheets": {},
    "slides": {}
  }
}

Tạo quá trình triển khai:

gcloud workspace-add-ons deployments create quickstart \
    --deployment-file=deployment.json

Cài đặt tiện ích bổ sung

Cài đặt bản triển khai ở chế độ phát triển:

gcloud workspace-add-ons deployments install quickstart

Mở hoặc tải lại Gmail để xem tiện ích bổ sung. Trong thanh công cụ ở bên phải, hãy tìm biểu tượng cốc đo.
Nhấp vào biểu tượng để mở tiện ích bổ sung. Nếu được nhắc, hãy cho phép tiện ích bổ sung.

Không bắt buộc: Dọn dẹp

Để tránh bị tính phí cho tài khoản của bạn, hãy xoá các tài nguyên mà bạn đã tạo:

Gỡ cài đặt tiện ích bổ sung khỏi Tài khoản Google của bạn:
```
gcloud workspace-add-ons deployments uninstall quickstart
```
Để tránh bị tính phí cho các tài nguyên dùng trong hướng dẫn nhanh này, hãy xoá dự án trên Cloud:
```
gcloud projects delete PROJECT_ID
```
Thay thế PROJECT_ID bằng mã của dự án trên Google Cloud mà bạn đã sử dụng cho phần hướng dẫn nhanh. Bạn có thể tìm thấy mã dự án trên Google Cloud trong trang Trang tổng quan.

Các bước tiếp theo

Để thêm chức năng vào tiện ích bổ sung của Google Workspace, hãy tham khảo các hướng dẫn sau: