Jika Anda telah membuat dan memublikasikan add-on untuk memperluas Gmail atau Kalender, Anda dapat mengupgradenya ke Add-on Google Workspace. Petunjuk di halaman ini menjelaskan cara untuk menambahkan fungsi Google Workspace ke add-on Gmail atau Kalender yang ada dan lalu publikasikan add-on yang telah ditingkatkan versinya agar dapat ditemukan dan diinstal.
Anda dapat mentransfer fungsi baru ke fungsi asli add-on untuk mempertahankan listingan, penginstalan, dan pengguna Google Workspace Marketplace Anda. Dengan melakukan upgrade, Anda juga dapat memanfaatkan fitur Add-on Google Workspace yang baru seperti halaman beranda.
Langkah 1: Buat salinan project Apps Script add-on Anda
Add-on yang telah diupgrade menggunakan project Google Cloud yang sama dengan yang Anda publikasikan tetapi Anda juga harus membuat dan menggunakan salinan aplikasi bawaan, Project skrip agar pengguna yang ada tidak terpengaruh saat Anda menguji dengan versi yang telah ditingkatkan. Mengupgrade salinan project skrip asli juga berarti Anda selalu dapat mengakses kode asli, dan dapat men-deploy-nya kembali nanti jika diperlukan.
- Membuka add-on Gmail atau add-on konferensi Kalender yang sudah ada Apps Script proyek.
- Di sebelah kiri, klik Overview .
- Di sebelah kanan, klik Buat salinan .
- Di sebelah kiri, klik Project Settings > Ubah project.
- Klik GCP Project Number.
- Masukkan nomor project yang terkait dengan project Apps Script add-on yang sudah ada dan dipublikasikan.
- Klik Set project.
Langkah 2: Integrasikan Add-on Google Workspace
Anda harus mendesain dan menerapkan fitur Add-on Google Workspace yang ingin ditambahkan ke add-on Anda.
- Rencanakan konten yang akan ditampilkan di add-on Anda kartu halaman beranda dan apakah mereka akan muncul di Gmail, Kalender, Drive, atau kombinasi dari ketiganya {i>host<i}. Jika Anda menginginkan halaman beranda ada di lebih dari satu host, tentukan apakah dapat berupa halaman beranda yang sama, atau jika Anda ingin kartu halaman beranda kustom untuk setiap host.
- Dalam project Apps Script add-on yang disalin, buat halaman beranda Anda
kartu dengan
homepageTriggerfungsi-fungsi lainnya. Pastikan untuk menyertakan fungsi atau logika pendukung yang diperlukan untuk mengontrol antarmuka beranda yang baru Anda. Pertimbangkan untuk menambahkan kartu kontekstual yang dipicu oleh tindakan pengguna, seperti membuka Rangkaian pesan Gmail atau Acara kalender.
Memperbarui akses ke objek peristiwa di add-on Anda (di fungsi callback widget atau dalam pemicu kontekstual ) untuk menggunakan struktur objek peristiwa. Struktur baru masih berisi kolom objek peristiwa yang sama dengan yang digunakan oleh add-on konferensi Gmail dan Kalender, tetapi kolom asli tersebut tidak digunakan lagi dan pada akhirnya akan dihapus.
Langkah 3: Perbarui manifes add-on Anda
Cara di mana informasi konfigurasi disimpan di
struktur manifes dari
Add-on Google Workspace telah banyak berubah dari struktur add-on Gmail
dan add-on konferensi Kalender yang digunakan. Saat mengupgrade add-on, Anda harus mengupdate kolom manifes project Apps Script add-on sesuai dengan
pada tabel di bawah ini. Anda harus memperbarui semua sub-properti yang relevan ke
Properti addOns.
Pastikan juga untuk memperbarui
Kolom oauthScopes sebagai
yang diperlukan untuk mencerminkan izin yang dibutuhkan oleh add-on yang diperbarui.
Untuk mempelajari lebih lanjut manifes Add-on Google Workspace, lihat Manifes.
Add-on Gmail
| Kolom manifes asli | Tindakan diperlukan |
|---|---|
gmail.composeTrigger |
Pindahkan ke addOns.gmail.composeTrigger. |
gmail.contextualTriggers[] |
Pindahkan daftar ke addOns.gmail.contextualTriggers[]. |
gmail.logoUrl |
Pindahkan ke addOns.common.logoUrl. |
gmail.name |
Pindahkan ke addOns.common.name. |
gmail.openLinkUrlPrefixes[] |
Pindahkan daftar ke addOns.common.openLinkUrlPrefixes[].
|
gmail.primaryColor |
Pindahkan ke addOns.common.layoutProperties.primaryColor. |
gmail.secondaryColor |
Pindahkan ke addOns.common.layoutProperties.secondaryColor.
|
gmail.universalActions[] |
Pindahkan daftar ke addOns.common.universalActions[]. |
gmail.universalActions[].text |
Pindahkan setiap kolom gmail.universalActions[].text ke
addOns.common.universalActions[].label yang sesuai
kolom tersebut. |
gmail.useLocalFromApp |
Pindahkan ke addOns.common.useLocaleFromApp. |
Add-on konferensi Kalender
| Kolom manifes asli | Tindakan diperlukan |
|---|---|
calendar.createSettingsUrlFunction |
Pindahkan ke addOns.calendar.createSettingsUrlFunction. |
calendar.conferenceSolution[] |
Pindahkan ke addOns.calendar.conferenceSolution[]. |
calendar.logoUrl |
Pindahkan ke addOns.common.logoUrl. |
calendar.name |
Pindahkan ke addOns.common.name. |
Langkah 4: Uji add-on yang telah diupgrade
Untuk menguji add-on yang telah diupgrade sebelum memublikasikannya, lihat Menguji Add-on Google Workspace.
Langkah 5: Minta peninjauan untuk add-on yang diupgrade
Semua Add-on Google Workspace, baik add-on yang diupgrade atau yang dibuat dari awal, harus disetujui sebelum dapat tercantum di Google Workspace Marketplace.
Ikuti langkah-langkah berikut untuk mengirimkan add-on agar ditinjau:
Pastikan add-on Anda memenuhi semua persyaratan publikasi add-on.
Membuat deployment berversi Add-on Google Workspace (di project Apps Script baru) menggunakan versi kode yang ingin Anda publikasikan. Jangan mencoba mempublikasikan menggunakan head deployment.
Jika menambahkan cakupan baru saat mengupgrade add-on, Anda harus meminta verifikasi OAuth. Misalnya, jika add-on Gmail Anda menggunakan cakupan Drive atau Kalender baru di Versi Add-on Google Workspace, Anda harus mengirimkan cakupan baru tersebut untuk verifikasi. Verifikasi sering kali membutuhkan waktu beberapa hari, jadi mulailah prosesnya sebagai sedini mungkin. Pastikan add-on Anda diverifikasi sebelum melanjutkan ke Langkah 6.
Langkah 6: Buat add-on yang diupgrade tersedia
Buka Google Workspace Marketplace SDK.
Di sebelah kiri, klik Configuration. Panel ini berisi formulir tempat Anda memberikan informasi tentang add-on Anda.
Perbarui deskripsi singkat, deskripsi mendetail, dan screenshot listingan baru untuk mencerminkan fungsi baru Add-on Google Workspace.
Di bagian Ekstensi, klik Upgrade ke Tombol Add-on Google Workspace. Di kotak teks yang muncul, masukkan ID deployment baru yang Anda buat untuk Add-on Google Workspace pada langkah sebelumnya. Jika ID deployment Anda valid, daftar {i>host<i} yang didukung akan muncul.
Jika Anda menambahkan cakupan baru ke Add-on Google Workspace, pastikan Anda menambahkannya ke Bagian Cakupan OAuth 2.0 di halaman Konfigurasi. Cakupan yang tercantum di bagian tersebut harus sama persis dengan cakupan yang tercantum dalam manifes.
Pastikan informasi yang Anda masukkan dalam formulir sudah benar. Lalu: lalu klik Save changes.
Jika Anda memiliki pertanyaan atau mengalami masalah selama upgrade Add-on Google Workspace ini ini, hubungi kami.
FAQ
Berikut adalah pertanyaan umum (FAQ) terkait upgrade add-on:
Bisakah saya mengupgrade Add-on Editor?
Sebagian besar Add-on Editor dapat dipindahkan ke Add-on Google Workspace. Namun demikian, mereka tidak dapat diupgrade ke Add-on Google Workspace semudah add-on untuk Gmail dan Kalender.
Jika ingin memigrasikan Add-on Editor ke Add-on Google Workspace, Anda harus menulis ulang UI add-on dari HTML menjadi berbasis kartu , dan memperbarui JavaScript Anda ke Layanan Kartu.
Beberapa layanan di Add-on Editor yang sudah ada mungkin tidak tersedia di Layanan Kartu. Misalnya, jika Add-on Editor Anda menyertakan pemilih file, ada tidak setara dengan yang tersedia dari Layanan Kartu untuk Add-on Google Workspace.
Dapatkah saya membuat Add-on Google Workspace terpisah dan mempertahankan add-on yang sudah ada?
Anda dapat membuat Add-on Google Workspace tambahan dengan nama merek yang berbeda, namun kami tidak mengizinkan add-on konferensi Gmail atau Kalender terpisah berdasarkan nama merek yang sama dengan Add-on Google Workspace Anda. Jika Anda memiliki pertanyaan atau ingin meminta pengecualian, hubungi kami.
Apakah pengguna saya perlu mengizinkan ulang add-on setelah diupgrade?
Selama Add-on Google Workspace Anda menggunakan arsitektur dasar yang sama Project Cloud Platform (GCP), dengan client ID OAuth terkait, pengguna Anda tidak perlu mengizinkan ulang izin akses yang sebelumnya telah diberikan untuk {i>add-on<i} asli Anda. Namun, jika Anda menambahkan cakupan baru selama proses upgrade, pengguna harus mengizinkan cakupan baru saat pertama kali menggunakan Google Workspace versi add-on Anda.
Dapatkah saya mengupgrade ekstensi Chrome ke Add-on Google Workspace dan mentransfer pengguna?
Tidak. Anda tidak dapat mentransfer pengguna, penginstalan, dan listingan ekstensi Chrome untuk tinjauan sejawat (peer review). Anda harus membuat Add-on Google Workspace baru dan mengarahkan pengguna Chrome ekstensi ke Google Workspace Marketplace.
Dapatkah saya menggabungkan beberapa add-on dengan Add-on Google Workspace?
Lihat Membuat daftar integrasi aplikasi bersama-sama.