Pelajari cara mendesain, membuat, dan memublikasikan add-on Google Workspace:
- Tentukan aplikasi Google Workspace tempat Anda ingin add-on tersedia bagi pengguna.
- Siapkan project add-on Anda dan pilih pemilik dan kolaborator.
- Rancang dan konfigurasi tampilan dan perilaku add-on Anda.
- Buat add-on.
- Verifikasi cakupan OAuth add-on Anda.
- Uji add-on dalam satu atau beberapa aplikasi Google Workspace.
- Publikasikan add-on.
Buat add-on dengan Apps Script atau HTTP. Untuk membandingkan keduanya, tonton video "Apps Script vs. endpoint HTTP: Mana yang harus Anda pilih? 🤔".
Memilih aplikasi host Google Workspace
Anda dapat mengonfigurasi add-on Google Workspace agar muncul di aplikasi host Google Workspace berikut:
- Gmail
- Google Kalender
- Google Chat
- Google Dokumen
- Google Drive
- Google Meet
- Google Spreadsheet
- Google Slide
Untuk membuat aplikasi Google Workspace, lihat Memperluas UI Google Workspace.
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 Anda membangun add-on dalam bahasa selain Apps Script, Anda hanya perlu membuat project Google Cloud.
Untuk membuat add-on, Anda harus mengonfigurasi project skrip dan project 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 serta setelan terkait, sementara kolaborator dapat membantu coding dan pengujian.
Project Apps Script
Sebelum membuat add-on, tinjau kuota dan batasan Apps Script untuk menyelaraskan desain project Anda dengan panduan ini. Apps Script paling cocok untuk pengembangan ringan add-on pribadi atau internal dengan basis pengguna kecil. Jika add-on Anda memerlukan dukungan untuk banyak pengguna, latensi rendah, atau kontrol penuh atas infrastruktur Anda, pertimbangkan runtime yang berbeda.
Buat file project Apps Script add-on Anda di drive bersama agar tidak ada satu akun pun yang memiliki kepemilikan tunggal. Menempatkan file skrip add-on di drive bersama memastikan bahwa semua kolaborator memiliki akses ke project skrip.
Saat Anda memublikasikan add-on, satu akun pengguna adalah penayang. Akun penayangan harus memiliki akses edit ke project skrip, tetapi tidak harus menjadi pemiliknya.
Untuk membuat project Apps Script, lihat Project skrip.
Project Google Cloud
Tambahkan kolaborator ke project Cloud add-on. Tindakan ini memastikan tim Anda selalu dapat mengakses setelan Cloud add-on.
Untuk membuat project Google Cloud, lihat Membuat project Google Cloud.
Mendesain dan mengonfigurasi tampilan dan perilaku add-on
Tentukan tampilan dan perilaku add-on sebelum Anda membangunnya. Pertimbangkan kasus penggunaan yang diselesaikan oleh add-on. Mulailah dengan desain dasar untuk mulai bekerja terlebih dahulu, lalu tambahkan penyempurnaan.
Lihat panduan gaya add-on Google Workspace untuk mengetahui panduan cara mendesain pengalaman pengguna add-on Anda.
Mengonfigurasi manifes add-on
Terapkan desain di manifes add-on. Konfigurasi tampilan dan perilaku add-on dalam manifes, termasuk aplikasi host Google Workspace yang diperluas oleh add-on.
Untuk mengetahui detailnya, lihat Manifes untuk add-on Google Workspace.
Saat Anda menambahkan kode dan fitur, perbarui manifes sesuai kebutuhan untuk menentukan tampilan dan perilaku add-on yang diperlukan.
Mengonfigurasi tampilan dan perilaku aplikasi Google Chat
Jika Anda mendesain add-on yang memperluas Google Chat, gunakan Google Chat API untuk mengonfigurasi tampilan dan perilaku aplikasi Chat. Untuk mengetahui langkah-langkahnya, lihat Menggunakan Google Chat API.
Membangun add-on
Terapkan antarmuka berbasis kartu untuk add-on. Gunakan Layanan kartu atau jika Anda menggunakan bahasa kode lain, kembalikan JSON yang diformat agar antarmuka dirender sebagai kartu.
Terapkan fungsi pemicu yang ditentukan dalam manifes add-on. Jika add-on Anda terhubung ke layanan pihak ketiga menggunakan OAuth, konfigurasi OAuth untuk layanan tersebut.
Membuat kartu
Tentukan antarmuka pengguna add-on dengan membuat objek
Card dan menambahkan
widget. Fungsi pemicu yang ditentukan dalam
manifes Anda harus menampilkan satu objek
Card atau array objek
Card yang merepresentasikan 'halaman' yang berbeda dari antarmuka add-on. Add-on
juga dapat membuat dan menampilkan kartu baru sebagai respons terhadap tindakan pengguna.
Di Apps Script, buat kartu menggunakan class
CardBuilder. Setiap
kartu memerlukan CardHeader
dan satu atau beberapa
CardSections. Isi
setiap bagian kartu dengan masing-masing widget yang membentuk antarmuka.
Widget
interaksi biasanya
ditautkan ke tindakan untuk menentukan
perilaku interaksinya.
Setelah Anda menambahkan semua bagian dan widget ke kartu melalui
CardBuilder, panggil
CardBuilder.build
untuk membuat objek Card yang sesuai.
Gunakan layanan Apps Script bawaan](/apps-script/guides/services/), seperti
CalendarApp, untuk mengambil
informasi yang akan ditampilkan di kartu add-on. Menggunakan data dari layanan non-Google.
Jika add-on Anda memerlukan akses ke API non-Google yang memerlukan OAuth, konfigurasikan dan hubungkan ke layanan tersebut—lihat panduan Menghubungkan ke Layanan Non-Google.
Urutan konstruksi
Saat Anda membuat kartu, buat dari atas ke bawah. Gunakan urutan pembuatan ini:
- Buat widget.
- Tambahkan widget ke bagian kartu.
- Ulangi hingga bagian kartu memiliki semua widgetnya.
- Tambahkan bagian kartu ke kartu.
Hal ini karena saat menambahkan widget ke kartu atau bagian kartu, Anda sebenarnya menambahkan salinan widget tersebut. Setiap perubahan yang Anda lakukan pada objek widget setelah menambahkannya tidak akan ditampilkan di kartu akhir.
Tindakan universal
Gunakan tindakan universal untuk menyediakan fungsi yang tidak bergantung pada konteks. Tindakan universal adalah item menu yang tersedia di UI add-on, terlepas dari kartu. Semua tindakan universal yang ditentukan muncul di menu kartu add-on.
Lihat Tindakan universal untuk mengetahui detail selengkapnya.
Memverifikasi cakupan OAuth add-on
Cakupan menentukan tindakan yang dapat dilakukan add-on atas nama pengguna. Add-on hanya boleh memiliki cakupan yang diperlukan agar dapat berfungsi.
Dalam project add-on, tetapkan cakupan add-on untuk memastikan add-on menggunakan set cakupan yang paling tidak permisif yang memungkinkan. Tentukan cakupan dalam manifes add-on.
Lihat Cakupan untuk mengetahui 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, gunakan add-on di akun Anda untuk menguji tampilan dan perilakunya di aplikasi host yang diperluasnya. Verifikasi bahwa add-on berperilaku seperti yang diharapkan untuk konteks dan tindakan pengguna.
Untuk mulai menguji add-on, lihat panduan berikut:
- Menguji dan men-debug add-on Google Workspace Apps Script
- Menguji dan men-debug add-on Google Workspace HTTP
- Menguji fitur interaktif untuk aplikasi Google Chat
Memublikasikan add-on
Dengan memublikasikan add-on, add-on Anda akan tersedia bagi orang lain. Sebelum memublikasikan, tinjau ringkasan publikasi. Publikasi adalah proses kompleks yang memerlukan persiapan.
Add-on Google Workspace dipublikasikan ke Google Workspace Marketplace. Add-on yang tersedia secara publik memerlukan peninjauan aplikasi sebelum dipublikasikan.
Lihat Mempublikasikan add-on Google Workspace untuk mengetahui detail selengkapnya.