Halaman ini diterjemahkan oleh Cloud Translation API.

Mem-build add-on Google Workspace dengan Node.js
Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

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

Project Google Cloud.
Pastikan Anda mengaktifkan penagihan untuk project Cloud Anda. Pelajari cara memverifikasi status penagihan project Anda.
Cloud SDK dikonfigurasi dengan project Cloud.

Menyiapkan lingkungan Anda

Buka project Cloud Anda di konsol Google Cloud

Di konsol Google Cloud, buka halaman Select a project.
Memilih project Cloud
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.

Di konsol Google Cloud, buka Menu > > Branding.
Buka Branding
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:

Di bagian Informasi Aplikasi, di Nama aplikasi, masukkan nama untuk aplikasi.
Di Email dukungan pengguna, pilih alamat email dukungan yang dapat dihubungi pengguna jika mereka memiliki pertanyaan tentang izin mereka.
Klik Berikutnya.
Di bagian Audiens, pilih Internal.
Klik Berikutnya.
Di bagian Informasi Kontak, masukkan Alamat email tempat Anda dapat menerima notifikasi tentang perubahan apa pun pada project Anda.
Klik Berikutnya.
Di bagian Selesai, tinjau Kebijakan Data Pengguna Layanan Google API dan jika Anda setuju, pilih Saya setuju dengan Layanan Google API: Kebijakan Data Pengguna.
Klik Lanjutkan.
Klik Buat.

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

Dari konsol Google Cloud, klik Aktifkan Cloud Shell .

Aktifkan Cloud Shell

Terminal Cloud Shell akan terbuka dan meluncurkan sesi di panel bawah konsol Google Cloud.
Klik Authorize untuk menyediakan dan terhubung ke Cloud Shell.

Di Terminal Cloud Shell, aktifkan Cloud Functions API, Cloud Build API, API add-on Google Workspace, dan Compute Engine API:

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

Luncurkan Cloud Shell Editor dengan mengklik Open Editor di toolbar jendela Cloud Shell.

Editor kode bawaan ini memberikan kemudahan untuk melihat dan mengedit file di lingkungan yang sama dengan tempat project dibuat dan di-deploy.

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"
                     }
                  }
                ]
              }
            ]
          }
        }
      ]
    }
  };
}

Dalam direktori yang sama, buat file package.json dengan kode contoh berikut:

{
  "dependencies": {
    "@google-cloud/functions-framework": "^3.0.0"
  }
}

Kembali ke Terminal Cloud Shell dengan mengklik Buka Terminal.

Tambahkan peran Cloud Build Service Account (roles/cloudbuild.builds.builder) ke akun layanan default Compute Engine.

Pertama, siapkan izin akun layanan:

export PROJECT_ID=$(gcloud config get project)
export SERVICE_ACCOUNT_NAME=$(gcloud compute project-info describe \
  --format="value(defaultServiceAccount)")

Selanjutnya, berikan izin akun layanan yang tidak ada:

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:$SERVICE_ACCOUNT_NAME" \
  --role="roles/cloudbuild.builds.builder"

Jalankan perintah berikut untuk men-deploy fungsi:
```
gcloud functions deploy loadHomePage --runtime nodejs22 --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

Temukan email akun layanan untuk add-on:

gcloud workspace-add-ons get-authorization

Berikan peran cloudfunctions.invoker kepada akun layanan. Ganti SERVICE_ACCOUNT_EMAIL dengan kolom serviceAccountEmail dari langkah sebelumnya.

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

Dapatkan URL fungsi yang di-deploy. Untuk mendapatkan URL, jalankan perintah berikut dan cari kolom url di bagian httpsTrigger:
```
gcloud functions describe loadHomePage
```
Kembali ke Cloud Shell Editor dengan mengklik Open Editor.

Di direktori yang sama dengan package.json, 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": {},
    "httpOptions": {
      "granularOauthPermissionSupport": "OPT_IN"
    }
  }
}

Kembali ke Terminal Cloud Shell untuk membuat deployment:

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

Menginstal add-on

Instal deployment dalam mode pengembangan:

gcloud workspace-add-ons deployments install quickstart

Buka atau muat ulang Gmail untuk melihat add-on. Di toolbar di sebelah kanan, cari ikon gelas ukur.
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:

Uninstal add-on dari Akun Google Anda:

gcloud workspace-add-ons deployments uninstall quickstart

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.

Untuk menambahkan lebih banyak fitur ke add-on Google Workspace, lihat hal berikut: