Mengupgrade add-on yang dipublikasikan

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

Jika sudah membuat dan memublikasikan add-on untuk memperluas Gmail atau Kalender, Anda dapat mengupgradenya ke Google Workspace Add-on. Petunjuk di halaman ini menjelaskan cara menambahkan fungsi Google Workspace ke add-on Gmail atau Kalender yang ada, lalu memublikasikan add-on yang diupgrade tersebut agar dapat ditemukan dan diinstal.

Anda dapat mentransfer fungsi baru ke add-on awal untuk mempertahankan Google Workspace listingan, penginstalan, dan pengguna Marketplace Anda. Dengan melakukan upgrade, Anda juga dapat memanfaatkan Google Workspace fitur Add-on baru seperti halaman beranda.

Langkah 1: Buat salinan project Apps Script add-on

Add-on yang diupgrade menggunakan project Google Cloud yang sama dengan add-on yang dipublikasikan, tetapi penting untuk membuat dan menggunakan salinan project Apps Script yang mendasarinya sehingga pengguna yang ada tidak terpengaruh saat Anda menguji versi yang diupgrade. Upgrade salinan project skrip asli juga berarti Anda selalu dapat mengakses kode asli, dan dapat men-deploy ulang nanti jika diperlukan.

  1. Buka add-on Gmail yang ada atau project Apps Script add-on konferensi.
  2. Di sebelah kiri, klik Ringkasan .
  3. Di sebelah kanan, klik Buat salinan .
  4. Di sebelah kiri, klik Setelan Project > Ubah project.
  5. Klik Nomor Project GCP.
  6. Masukkan nomor project yang sama yang terkait dengan project Apps Script add-on yang sudah ada dan dipublikasikan.
  7. Klik Tetapkan project.

Langkah 2: Integrasikan Google Workspace fitur Add-on

Anda harus mendesain dan mengimplementasikan Google Workspace fitur Add-on apa pun yang ingin ditambahkan ke add-on.

  1. Rencanakan konten yang akan ditampilkan di kartu halaman beranda add-on dan apakah konten tersebut harus muncul di Gmail, Kalender, Drive, atau kombinasi dari ketiga host tersebut. Jika Anda menginginkan halaman beranda di lebih dari satu host, tentukan apakah halaman beranda tersebut mungkin sama dengan yang ada di halaman beranda, atau apakah Anda ingin kartu halaman beranda kustom untuk setiap host.
  2. Pada project Apps Script add-on yang telah disalin, buat kartu halaman beranda dengan fungsi homepageTrigger. Pastikan untuk menyertakan fungsi pendukung atau logika yang diperlukan untuk mengontrol antarmuka halaman beranda baru Anda.
  3. Pertimbangkan untuk menambahkan kartu kontekstual yang dipicu oleh tindakan pengguna, seperti membuka rangkaian pesan Gmail atau acara Kalender.

  4. Perbarui akses ke objek peristiwa di add-on (dalam fungsi callback widget atau dalam fungsi pemicu kontekstual) untuk menggunakan struktur objek peristiwa yang diperbarui. Struktur baru masih berisi kolom objek acara 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

Cara penyimpanan informasi konfigurasi di struktur manifes Google Workspace Add-on telah berubah secara signifikan dari struktur add-on Gmail dan penggunaan add-on konferensi Kalender. Saat mengupgrade add-on, Anda harus memperbarui kolom manifes project Apps Script add-on sesuai dengan tabel di bawah. Anda harus memperbarui semua sub-properti yang relevan ke properti addOns yang baru.

Pastikan juga memperbarui kolom oauthScopes manifes sesuai kebutuhan untuk mencerminkan izin yang diperlukan add-on yang diperbarui.

Untuk mempelajari Google Workspace Manifes add-on lebih lanjut, 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 kolom addOns.common.universalActions[].label yang sesuai.
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 diupgrade

Untuk menguji add-on yang diupgrade sebelum memublikasikannya, lihat Pengujian Google Workspace Add-on.

Langkah 5: Minta peninjauan add-on yang telah diupgrade

Semua Google Workspace Add-on, baik add-on yang diupgrade maupun yang dibuat dari awal, harus disetujui sebelum dapat dicantumkan di Google Workspace Marketplace.

Ikuti langkah-langkah berikut untuk mengirimkan add-on agar ditinjau:

  1. Pastikan add-on Anda memenuhi semua persyaratan publikasi add-on.

  2. Buat deployment berversi Google Workspace add-on (di project Apps Script baru) menggunakan versi kode yang ingin dipublikasikan. Jangan mencoba memublikasikan aplikasi menggunakan deployment head.

  3. Jika menambahkan cakupan baru saat mengupgrade add-on, Anda harus meminta verifikasi OAuth. Misalnya, jika add-on Gmail menggunakan cakupan Drive atau Kalender baru di versi Google Workspace Add-on, Anda harus mengirimkan cakupan baru tersebut untuk verifikasi. Verifikasi sering memerlukan waktu beberapa hari hingga selesai, jadi mulailah prosesnya sedini mungkin. Pastikan add-on Anda telah diverifikasi sebelum melanjutkan ke Langkah 6.

Langkah 6: Sediakan add-on yang diupgrade

  1. Buka Google Workspace Marketplace SDK.

  2. Di sebelah kiri, klik Configuration. Panel ini berisi formulir tempat Anda memberikan informasi tentang add-on.

  3. Update deskripsi singkat, deskripsi mendetail, dan screenshot listingan Anda untuk mencerminkan fungsi baru Google Workspace Add-on.

  4. Di bagian Extensions, klik tombol Upgrade to Google Workspace Add-on. Di kotak teks yang muncul, masukkan ID deployment baru yang Anda buat untuk Google Workspace Add-on pada langkah sebelumnya. Jika ID deployment Anda valid, daftar host yang didukung akan muncul.

  5. Jika Anda menambahkan cakupan baru ke Google Workspace Add-on, 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 add-on Anda.

  6. Verifikasi bahwa informasi yang Anda masukkan dalam formulir sudah benar. Selanjutnya, klik Simpan perubahan.

Jika Anda memiliki pertanyaan atau mengalami masalah selama Google Workspace proses upgrade Add-on ini, hubungi kami.

FAQ

Berikut pertanyaan umum (FAQ) terkait upgrade add-on:

Dapatkah saya mengupgrade Add-on Editor?

Sebagian besar Add-on Editor dapat dipindahkan ke Google Workspace Add-on. Namun, add-on dapat diupgrade ke Google Workspace Add-on semudah add-on untuk Gmail dan Kalender.

Jika ingin memigrasikan Add-on Editor ke Google Workspace Add-on, Anda harus menulis ulang UI add-on dari HTML ke Antarmuka berbasis kartu, dan memperbarui penanganan JavaScript ke Layanan Kartu.

Beberapa layanan di Add-on Editor yang ada mungkin tidak tersedia di Layanan Kartu. Misalnya, jika Add-on Editor Anda menyertakan alat pilih file, tidak ada padanan yang tersedia dari Layanan Kartu untuk Google Workspace Add-on.

Dapatkah saya mem-build Google Workspace Add-on terpisah dan mempertahankan add-on yang sudah ada?

Anda dapat mem-build Google Workspace Add-on tambahan dengan nama merek yang berbeda, tetapi kami tidak mengizinkan add-on konferensi Gmail atau Kalender terpisah dengan nama merek yang sama dengan Google Workspace Add-on Anda. Jika Anda memiliki pertanyaan atau ingin meminta pengecualian, hubungi kami.

Apakah pengguna saya perlu mengotorisasi ulang add-on setelah diupgrade?

Selama Google Workspace Add-on Anda menggunakan project Cloud Platform (GCP) pokok yang sama, dengan client ID OAuth terkait, pengguna Anda tidak perlu mengotorisasi ulang izin yang sebelumnya mereka otorisasi untuk add-on asli Anda. Namun, jika Anda menambahkan cakupan baru selama proses upgrade, pengguna harus mengizinkan cakupan baru tersebut saat pertama kali menggunakan versi add-on Google Workspace.

Dapatkah saya mengupgrade ekstensi Chrome ke Google Workspace Add-on dan mentransfer pengguna?

Tidak. Anda tidak dapat mentransfer ulasan, instal, dan listingan ekstensi Chrome. Anda harus membuat Google Workspace Add-on dan pengguna langsung ekstensi Chrome baru ke Google Workspace Marketplace.

Dapatkah saya menggabungkan beberapa add-on dengan Google Workspace Add-on?

Lihat Membuat daftar integrasi aplikasi bersama.