Mem-build add-on Google Workspace dengan Node.js

Membuat add-on Google Workspace di Cloud Functions menggunakan runtime Node.js.

Tujuan

  • Siapkan lingkungan Anda.
  • Membuat dan men-deploy Cloud Function.
  • Buat dan deploy add-on.
  • Instal add-on.

Prasyarat

Menyiapkan lingkungan Anda

Buka project Cloud Anda di konsol Google Cloud

  1. Di konsol Google Cloud, buka halaman Select a project.

    Memilih project Cloud

  2. Pilih project Google Cloud yang ingin Anda gunakan. Atau, klik Buat project dan ikuti petunjuk di layar. Jika membuat project Google Cloud, Anda mungkin perlu mengaktifkan penagihan untuk project tersebut.

Mengonfigurasi layar izin OAuth

Add-on Google Workspace memerlukan konfigurasi layar izin. Mengonfigurasi layar izin OAuth add-on akan menentukan apa yang ditampilkan Google kepada pengguna.

  1. Di konsol Google Cloud, buka Menu > > Branding.

    Buka Branding

  2. Jika telah mengonfigurasi , Anda dapat mengonfigurasi setelan Layar Izin OAuth berikut di Branding, Audiens, dan Akses Data. Jika Anda melihat pesan yang bertuliskan not configured yet, klik Get Started:
    1. Di bagian Informasi Aplikasi, di Nama aplikasi, masukkan nama untuk aplikasi.
    2. Di Email dukungan pengguna, pilih alamat email dukungan yang dapat dihubungi pengguna jika mereka memiliki pertanyaan tentang izin mereka.
    3. Klik Berikutnya.
    4. Di bagian Audiens, pilih Internal.
    5. Klik Berikutnya.
    6. Di bagian Informasi Kontak, masukkan Alamat email tempat Anda dapat menerima notifikasi tentang perubahan apa pun pada project Anda.
    7. Klik Berikutnya.
    8. Di bagian Selesai, tinjau Kebijakan Data Pengguna Layanan Google API dan jika Anda setuju, pilih Saya setuju dengan Layanan Google API: Kebijakan Data Pengguna.
    9. Klik Lanjutkan.
    10. Klik Buat.
  3. Untuk saat ini, Anda dapat melewati penambahan cakupan. Di masa mendatang, saat membuat aplikasi untuk digunakan di luar organisasi Google Workspace, Anda harus mengubah Jenis pengguna menjadi Eksternal. Kemudian, tambahkan cakupan otorisasi yang diperlukan aplikasi Anda. Untuk mempelajari lebih lanjut, lihat panduan lengkap Mengonfigurasi izin OAuth.

Membuat dan men-deploy Cloud Function

  1. Di terminal lokal, aktifkan Cloud Functions, Cloud Build, dan API add-on Google Workspace:

    gcloud services enable cloudfunctions cloudbuild.googleapis.com gsuiteaddons.googleapis.com

  2. Di direktori kosong, buat file function.js dengan kode contoh berikut:

    /**
 * 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. Deploy fungsi tersebut:

    gcloud functions deploy loadHomePage --runtime nodejs12 --trigger-http

    Jika diminta, tentukan bahwa Anda tidak mengizinkan pemanggilan fungsi yang tidak diautentikasi. Mungkin perlu waktu beberapa menit hingga fungsi di-deploy.

Membuat deployment add-on

  1. Temukan email akun layanan untuk add-on:

    gcloud workspace-add-ons get-authorization

  2. Berikan peran cloudfunctions.invoker ke akun layanan:

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

  3. Dapatkan URL fungsi yang di-deploy. Untuk mendapatkan URL, jalankan perintah berikut dan cari kolom url di bagian httpsTrigger:

    gcloud functions describe loadHomePage

  4. Buat file deployment.json dengan kode contoh berikut. Ganti URL dengan URL fungsi yang di-deploy dari langkah sebelumnya.

    {
  "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": {}
  }
}

  5. Buat deployment:

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

Menginstal add-on

  1. Instal deployment dalam mode pengembangan:

    gcloud workspace-add-ons deployments install quickstart

  2. Buka atau muat ulang Gmail untuk melihat add-on. Di panel alat di sebelah kanan, cari ikon gelas ukur.

  3. Klik ikon untuk membuka add-on. Jika diminta, izinkan add-on.

Opsional: Pembersihan

Agar tidak menimbulkan tagihan ke akun Anda, hapus resource yang Anda buat:

  1. Uninstal add-on dari Akun Google Anda:

    gcloud workspace-add-ons deployments uninstall quickstart

  2. Agar tidak menimbulkan biaya untuk resource yang digunakan dalam panduan memulai ini, hapus project Cloud:

    gcloud projects delete PROJECT_ID

    Ganti PROJECT_ID dengan ID project Cloud yang Anda gunakan untuk memulai. Anda dapat menemukan project ID Cloud di konsol Google Cloud pada halaman Dasbor.

Langkah berikutnya

Untuk menambahkan lebih banyak fungsi ke add-on Google Workspace, lihat panduan berikut: