Mengupgrade add-on yang dipublikasikan

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

Anda dapat mentransfer fungsi baru ini ke add-on asli untuk mempertahankan pengguna, penginstalan, dan listingan 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 add-on yang Anda publikasikan, tetapi penting untuk membuat dan menggunakan salinan project Apps Script pokok agar pengguna yang ada tidak terpengaruh saat Anda menguji versi yang sudah diupgrade. Dengan mengupgrade salinan project skrip asli, Anda juga dapat mengakses kode asli kapan saja dan dapat men-deploy ulang kode tersebut nanti jika perlu.

  1. Buka add-on Gmail atau project add-on konferensi Kalender Apps Script yang sudah ada.
  2. Di sebelah kiri, klik Overview .
  3. Di sebelah kanan, klik Buat salinan .
  4. Di sebelah kiri, klik Setelan Project > Ubah project.
  5. Klik GCP Project Number.
  6. Masukkan nomor project yang sama dengan yang terkait dengan project Apps Script add-on yang dipublikasikan dan sudah ada.
  7. 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.

  1. Rencanakan konten yang akan ditampilkan di kartu halaman beranda add-on dan apakah konten tersebut akan muncul di Gmail, Kalender, Drive, atau kombinasi dari ketiga host tersebut. Jika Anda ingin halaman beranda berada di lebih dari satu host, tentukan apakah halaman beranda dapat berupa halaman beranda yang sama atau kartu halaman beranda khusus untuk setiap host.
  2. Dalam salinan project Apps Script add-on Anda, buat kartu halaman beranda dengan fungsi homepageTrigger. Pastikan untuk menyertakan fungsi atau logika pendukung 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 semua akses objek peristiwa di add-on Anda (dalam fungsi callback widget atau dalam fungsi pemicu kontekstual) untuk menggunakan struktur objek peristiwa yang telah diperbarui. Struktur baru ini 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 informasi konfigurasi disimpan dalam struktur manifes Add-on Google Workspace telah berubah drastis 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 baru.

Pastikan Anda juga memperbarui kolom oauthScopes manifes jika diperlukan untuk mencerminkan izin yang diperlukan add-on terbaru.

Untuk mempelajari manifes Add-on Google Workspace lebih lanjut, lihat Manifes.

Add-on Gmail

Bidang 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

Bidang 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 memublikasikan, lihat Menguji Add-on Google Workspace.

Langkah 5: Minta peninjauan add-on yang telah diupgrade

Semua Add-on Google Workspace, 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 Anda agar ditinjau:

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

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

  3. 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 diverifikasi. Verifikasi sering kali membutuhkan waktu beberapa hari, jadi mulailah prosesnya seawal mungkin. Pastikan add-on Anda diverifikasi sebelum melanjutkan ke Langkah 6.

Langkah 6: Buat add-on yang telah diupgrade tersedia

  1. Buka Google Workspace Marketplace SDK.

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

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

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

  5. Jika 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 add-on Anda.

  6. Pastikan informasi yang Anda masukkan dalam formulir sudah benar. Selanjutnya, klik Save changes.

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

FAQ

Berikut adalah pertanyaan umum mengenai upgrade add-on:

Dapatkah saya mengupgrade Add-on Editor?

Sebagian besar Add-on Editor dapat dipindahkan ke Add-on Google Workspace. Namun, add-on tersebut 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 ke antarmuka berbasis Kartu, dan memperbarui penanganan JavaScript Anda ke Layanan Kartu.

Beberapa layanan di Add-on Editor yang ada mungkin tidak tersedia di Layanan Kartu. Misalnya, jika Add-on Editor Anda menyertakan pemilih file, tidak ada versi setara yang tersedia dari Add-on Card Service untuk 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, tetapi kami tidak mengizinkan add-on konferensi Gmail atau Kalender terpisah dengan nama merek yang sama dengan Add-on Google Workspace Anda. Jika Anda memiliki pertanyaan atau ingin meminta pengecualian, hubungi kami.

Apakah pengguna saya perlu melakukan otorisasi ulang add-on setelah diupgrade?

Asalkan Add-on Google Workspace Anda menggunakan project Cloud Platform (GCP) dasar yang sama, dengan client ID OAuth terkait, pengguna tidak perlu memberikan otorisasi ulang izin yang sebelumnya telah mereka beri 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 Google Workspace add-on.

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

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

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

Lihat Mencantumkan integrasi aplikasi bersama-sama.