Mem-build Add-on Google Workspace

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Saat Anda ingin mem-build Google Workspace Add-on baru, ikuti prosedur umum berikut:

  1. Siapkan project add-on Anda dan pilih pemilik serta kolaborator.
  2. Desain tampilan dan perilaku add-on.
  3. Konfigurasikan manifes project add-on atau resource deployment.
  4. Tulis kode untuk menentukan tampilan dan perilaku add-on.
  5. Verifikasi cakupan OAuth add-on Anda.
  6. Uji add-on dalam aplikasi host yang diperluasnya.
  7. Publikasikan add-on.

Siapkan project add-on Anda dan pilih pemilik serta kolaborator

Jika Anda membuat add-on di Apps Script, Anda akan membuat project Apps Script dan project Google Cloud. Jika membuat add-on dalam bahasa selain Apps Script, Anda hanya perlu membuat project Google Cloud.

Sebelum memulai pengembangan add-on, pilih satu akun pengguna untuk memiliki project dan tentukan akun lain yang menjadi kolaborator. Pemilik project membuat dan mengelola file project dan setelan terkait, sementara kolaborator dapat membantu melakukan coding dan pengujian.

Project Apps Script

Anda dapat mem-build file project Apps Script add-on di drive bersama sehingga tidak ada satu akun yang memiliki kepemilikan tunggal. Menempatkan file skrip add-on di drive bersama memungkinkan Anda memastikan dengan mudah bahwa beberapa kolaborator selalu memiliki akses ke project skrip.

Saat Anda memublikasikan add-on, satu akun pengguna akan bertindak sebagai penayang. Akun publikasi harus memiliki akses edit ke project skrip, tetapi tidak harus merupakan pemilik file tersebut.

Project Google Cloud

Sebaiknya tambahkan kolaborator ke project Cloud add-on. Hal ini membantu memastikan seseorang di tim Anda dapat mengakses setelan Cloud add-on kapan saja.

Mendesain tampilan dan perilaku add-on

Tentukan tampilan add-on dan perilakunya sebelum Anda mulai mem-build-nya. Pertimbangkan kasus penggunaan yang harus disediakan oleh add-on. Mulailah dengan desain sederhana untuk mulai bekerja terlebih dahulu, lalu tambahkan peningkatan lainnya.

Lihat Google Workspace Panduan gaya add-on untuk panduan tentang cara mendesain pengalaman pengguna add-on.

Mengonfigurasi manifes project add-on

Dalam project Apps Script, manifes project adalah file JSON khusus. Bagian ini menentukan berbagai detail tentang project, seperti dependensi library-nya. Untuk Google Workspace Add-on, manifes juga memberikan informasi dasar yang diperlukan aplikasi host untuk menampilkan add-on dengan benar.

Lihat Manifes untuk mengetahui detail tentang cara mengonfigurasi manifes add-on di Apps Script.

Saat Anda menambahkan kode dan fitur ke add-on, edit manifes sesuai kebutuhan untuk menghasilkan tampilan dan perilaku add-on yang diperlukan.

Membuat kode add-on

Anda harus mengimplementasikan antarmuka berbasis kartu untuk add-on tersebut. Gunakan Layanan kartu Apps Script atau jika Anda menulis dalam bahasa kode lain, tampilkan JSON yang diformat dengan benar untuk antarmuka yang akan dirender sebagai kartu.

Anda juga harus mengimplementasikan fungsi pemicu apa pun yang ditentukan dalam manifes add-on. Jika add-on Anda terhubung ke layanan non-Google pihak ketiga menggunakan OAuth, Anda juga harus mengonfigurasi OAuth untuk layanan tersebut.

Membuat kartu

Anda menentukan antarmuka pengguna add-on dengan membuat objek Card dan mengisinya dengan widget. Fungsi pemicu yang ditentukan dalam manifes Anda harus menampilkan satu objek Card atau array objek Card yang mewakili 'halaman' antarmuka add-on yang berbeda. Add-on juga dapat membuat dan menampilkan kartu baru sebagai respons terhadap tindakan pengguna.

Di Apps Script, Anda membuat kartu menggunakan class CardBuilder. Setiap kartu memerlukan CardHeader dan satu atau beberapa CardSections. Anda harus mengisi setiap bagian kartu dengan widget individual yang membentuk antarmuka add-on. Widget interaksi, biasanya ditautkan ke tindakan untuk menentukan perilaku interaksinya.

Setelah menambahkan semua bagian dan widget ke kartu Anda melalui CardBuilder, Anda harus memanggil CardBuilder.build() untuk membuat objek Card yang sesuai.

Anda dapat menggunakan layanan Apps Script bawaan lainnya, seperti CalendarApp untuk mengambil informasi yang akan ditampilkan dalam kartu add-on yang Anda buat. Anda dapat menggunakan data yang diambil dari layanan non-Google.

Jika Google Workspace Add-on Anda memerlukan akses ke API non-Google yang memerlukan OAuth, Anda harus mengonfigurasi dan terhubung ke layanan tersebut—lihat Panduan Menghubungkan ke Non-Layanan Google untuk detail selengkapnya.

Pesanan konstruksi

Saat membuat kartu, Anda harus mem-build dari atas. Artinya, Anda harus menggunakan urutan konstruksi ini:

  1. Build widget.
  2. Tambahkan widget ke bagian kartu.
  3. Ulangi hingga bagian kartu memiliki semua widget.
  4. Tambahkan bagian kartu ke kartu.

Wajib diisi karena saat menambahkan widget ke kartu atau bagian kartu, Anda sebenarnya menambahkan salinan widget tersebut. Setiap perubahan yang Anda buat pada objek widget setelah menambahkannya tidak akan tercermin dalam kartu akhir.

Tindakan universal

Anda dapat menggunakan tindakan universal untuk menyediakan fungsi yang tidak bergantung pada konteks. Tindakan universal adalah item menu yang tersedia di UI add-on, apa pun kartu yang saat ini ditampilkan. Semua tindakan universal yang ditentukan selalu muncul dalam menu kartu add-on.

Lihat Tindakan universal untuk detail selengkapnya.

Memverifikasi cakupan OAuth add-on

Cakupan menentukan tindakan yang diizinkan oleh add-on atas nama pengguna. Praktik terbaiknya adalah add-on hanya memiliki cakupan untuk tindakan yang harus dimilikinya secara urut dan tidak lebih.

Dalam project add-on, tetapkan cakupan add-on secara eksplisit untuk memastikan add-on menggunakan kumpulan cakupan yang paling longgar. Anda menentukan cakupan yang digunakan add-on dalam manifes add-on.

Lihat Cakupan untuk detail selengkapnya.

Menguji add-on

Anda dapat menguji add-on yang tidak dipublikasikan dengan menginstal add-on yang tidak dipublikasikan terlebih dahulu. Setelah diinstal dan diberi otorisasi, Anda dapat menggunakan add-on di akun Anda serta menguji tampilan dan perilakunya di aplikasi host yang diperluasnya. Anda harus memverifikasi bahwa add-on berperilaku seperti yang diharapkan untuk konteks dan tindakan pengguna.

Lihat Menguji Google Workspace Add-on untuk detail selengkapnya.

Memublikasikan add-on

Memublikasikan add-on akan membuatnya tersedia untuk orang lain, baik secara publik maupun hanya pengguna di domain Anda. Sebelum memulai proses publikasi, pastikan untuk meninjau ringkasan publikasi. Publikasi adalah proses kompleks yang memerlukan persiapan dan waktu untuk diselesaikan.

Google Workspace Add-on dipublikasikan ke Google Workspace Marketplace. Add-on yang tersedia untuk publik harus menyelesaikan peninjauan aplikasi sebelum dipublikasikan.

Lihat Publikasi Google Workspace Add-on untuk detail selengkapnya.

Google Workspace Contoh add-on

Google Workspace Sidebar add-on

Untuk membantu Anda memahami cara Google Workspace Add-on dibuat, add-on Google Workspace "Cats" panduan memulai menunjukkan cara membuat add-on Google Workspace sederhana, termasuk halaman beranda, navigasi kartu, dan layanan pihak ketiga. Setelah menyelesaikan panduan memulai, Anda dapat menginstal add-on dan bereksperimen dengan kode tersebut.