Bắt đầu nhanh: Tạo một tiện ích bổ sung bằng ngôn ngữ lập trình bất kỳ

Tạo một Tiện ích bổ sung của Google Workspace trong Chức năng đám mây mà không cần sử dụng Tập lệnh ứng dụng.

Mục tiêu

  • Tạo một chức năng đám mây.
  • Gọi Google để gọi tiện ích bổ sung.
  • Tạo lượt triển khai tiện ích bổ sung.
  • Cài đặt tiện ích bổ sung.

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

Tạo một chức năng đám mây

  1. Trong thiết bị đầu cuối cục bộ, hãy bật Chức năng đám mây, Bản dựng đám mây và API tiện ích bổ sung:

    gcloud services enable cloudfunctions cloudbuild.googleapis.com gsuiteaddons.googleapis.com
    
  2. Trong một thư mục trống, hãy tạo tệp function.js có mã mẫu sau:

    /**
     * Google 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"
                         }
                      }
                    ]
                  }
                ]
              }
            }
          ]
        }
      };
    }
    
  3. Triển khai hàm:

    gcloud functions deploy loadHomePage --runtime nodejs12 --trigger-http
    
  4. Xác minh rằng hàm đã được triển khai:

    gcloud functions call loadHomePage
    

Gọi Google để gọi tiện ích bổ sung

  1. Tìm email tài khoản dịch vụ cho tiện ích bổ sung:

    gcloud workspace-add-ons get-authorization
    
  2. 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
    

Tạo cấu hình triển khai tiện ích bổ sung

  1. Lấy URL của hàm đã triển khai:

    gcloud functions describe loadHomePage
    
  2. 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": {}
      }
    }
    
  3. Tạo tùy chọn triển khai:

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

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

  1. Cài đặt quá trình triển khai ở chế độ phát triển:

    gcloud workspace-add-ons deployments install quickstart
    
  2. Mở hoặc tải lại Gmail để xem tiện ích bổ sung. Trên thanh công cụ ở bên phải, hãy tìm biểu tượng cốc.

  3. Nhấp vào biểu tượng để mở tiện ích bổ sung.

Dọn dẹp

  1. 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
    
  2. Để tránh phát sinh phí cho các tài nguyên được sử dụng trong bước khởi động nhanh này, hãy xoá dự án:

    gcloud projects delete PROJECT_ID
    

    Thay thế PROJECT_ID bằng mã nhận dạng của dự án mà bạn sử dụng để bắt đầu nhanh. Bạn có thể tìm thấy mã dự án trong Cloud Console trên Trang tổng quan.