Mengupgrade add-on Gmail dan Kalender lama

Catatan: Anda tidak dapat langsung mengupgrade Add-on Editor ke Add-on Google Workspace saat ini. Untuk informasi selengkapnya, lihat Dapatkah saya mengupgrade Add-on Editor.

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.

Catatan: Jika Anda tidak mengupgrade add-on Gmail dan add-on konferensi Kalender, add-on tersebut akan otomatis diupgrade ke Add-on Google Workspace dengan halaman beranda umum. Anda tidak perlu mengubah listingan atau kode developer dan add-on akan hanya tersedia dalam versi aslinya aplikasi host. Di Google Workspace Marketplace, diupgrade secara otomatis add-on tercantum dalam bagian "berfungsi dengan Gmail" atau "berfungsi dengan Kalender" dengan listingan, jumlah instal, dan pengguna yang dipertahankan.

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.

1. Membuka add-on Gmail atau add-on konferensi Kalender yang sudah ada Apps Script proyek.
2. Di sebelah kiri, klik Overview .
3. Di sebelah kanan, klik Buat salinan .
4. Di sebelah kiri, klik Project Settings > Ubah project.
5. Klik GCP Project Number.
6. Masukkan nomor project yang terkait dengan project Apps Script add-on yang sudah ada dan dipublikasikan.
7. Klik Set project.

Peringatan: Jangan mengupgrade project Apps Script add-on publik secara langsung. Anda perlu untuk membuat salinan agar versi yang diupgrade tetap terpisah dari versi publik saat sedang dibuat dan diuji.

Langkah 2: Integrasikan Add-on Google Workspace

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

1. 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.
2. Dalam project Apps Script add-on yang disalin, buat halaman beranda Anda kartu dengan homepageTrigger fungsi-fungsi lainnya. Pastikan untuk menyertakan fungsi atau logika pendukung yang diperlukan untuk mengontrol antarmuka beranda yang baru Anda.

3. Pertimbangkan untuk menambahkan kartu kontekstual yang dipicu oleh tindakan pengguna, seperti membuka Rangkaian pesan Gmail atau Acara kalender.

   Perhatian: Add-on yang diupgrade menerima nilai ID yang berbeda untuk pesan Gmail daripada yang diterima add-on Gmail. Perubahan ini hanya memengaruhi add-on yang diupgrade yang menggunakan messageId sebagai kunci dalam penyimpanan permanen apa pun. Jika diperlukan, Anda masih dapat mendapatkan nilai ID lama dengan Gmail API. Fitur Gmail API Metode messages().get() menerima nilai ID baru dan lama, tetapi hanya menampilkan nilai ID lama.

4. 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:

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

2. 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.

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 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

1. Buka Google Workspace Marketplace SDK.

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

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

4. 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.

   Perhatian: Mengupgrade add-on Anda ke Add-on Google Workspace dengan cara ini adalah satu kali proses yang tidak dapat diurungkan.

5. 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.

6. 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.