Memigrasikan aplikasi Google Chat Anda

Jika menggabungkan organisasi Google Workspace, Anda mungkin perlu memigrasikan aplikasi Chat agar dapat terus berfungsi.

Sebelum memigrasikan aplikasi Chat, hubungi administrator organisasi Anda untuk melihat apakah setelan administratif memengaruhinya. Mengubah setelan administratif dapat memulihkan fungsi penuh ke aplikasi Chat Anda dan membuat migrasi tidak diperlukan. Misalnya, administrator Google Workspace Anda mungkin harus menambahkan aplikasi Chat ke daftar yang diizinkan, atau mungkin harus mengizinkan pengguna menginstal aplikasi Chat. Untuk mengetahui informasi selengkapnya, lihat Menentukan apakah aplikasi Google Chat perlu dimigrasikan setelah menggabungkan organisasi Google Workspace.

Setelah Anda memutuskan bahwa Anda perlu memigrasikan aplikasi Chat, selesaikan proses tiga langkah berikut:

1. Siapkan lingkungan untuk aplikasi Chat dengan membuat project Google Cloud di organisasi yang digabungkan, mengaktifkan API, dan mungkin mengonfigurasi layar izin OAuth 2.0.
2. Deploy ulang aplikasi Chat dari project Cloud baru.
3. Tambahkan aplikasi Chat yang dibuat ulang ke ruang Chat atau percakapan, dan nonaktifkan aplikasi Chat asli.

Membuat project Cloud di organisasi yang digabungkan dan mengaktifkan API

Membuat project Cloud baru dan mengaktifkan API untuk aplikasi Chat di organisasi Google Workspace yang digabungkan akan memastikan bahwa pengguna dan grup yang Anda izinkan untuk mengakses aplikasi Chat dapat melakukannya tanpa error.

Membuat project Cloud

Konsol Google Cloudgcloud CLI

1. Di konsol Google Cloud, buka Menu > IAM & Admin > Create a Project.

   Buka Membuat Project

2. Di kolom Project Name, masukkan nama deskriptif untuk project Anda.

   Opsional: Untuk mengedit Project ID, klik Edit. Project ID tidak dapat diubah setelah project dibuat, jadi pilih ID yang sesuai dengan kebutuhan Anda sepanjang waktu project tersebut.

3. Di kolom Location, klik Browse untuk menampilkan lokasi potensial untuk project Anda. Kemudian, klik Select.
   Perhatian: Tidak dapat menemukan organisasi Google Workspace Anda?
   Artinya, Anda tidak login ke akun Google Workspace. Beberapa fitur yang dijelaskan dalam dokumentasi developer Google Workspace hanya tersedia untuk project yang terkait dengan organisasi.
4. Klik Buat. Konsol Google Cloud akan membuka halaman Dasbor dan project Anda akan dibuat dalam beberapa menit.

Di salah satu lingkungan pengembangan berikut, akses Google Cloud CLI (gcloud):

• Cloud Shell: Untuk menggunakan terminal online dengan gcloud CLI yang sudah disiapkan, aktifkan Cloud Shell.
  Aktifkan Cloud Shell
• Shell Lokal: Untuk menggunakan lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI.
  Untuk membuat project Cloud, gunakan perintah gcloud projects create:

  gcloud projects create PROJECT_ID

  Ganti PROJECT_ID dengan menetapkan ID untuk project yang ingin Anda buat.

Mengaktifkan API

Semua aplikasi Chat harus mengaktifkan Google Chat API. Bergantung pada cara aplikasi Chat dibuat, Anda mungkin perlu mengaktifkan API lain. Misalnya, jika Anda mem-build aplikasi Chat menggunakan Google Cloud Functions, aktifkan Cloud Build API, Cloud Functions API, Pub/Sub API, Cloud Logging API, Artifact Registry API, dan Cloud Run API. Sebagai praktik terbaik, untuk memastikan aplikasi yang dimigrasikan berfungsi, aktifkan API yang sama di project Cloud baru yang diaktifkan di project Cloud lama.

Untuk mengaktifkan API, lakukan hal berikut:

Konsol Google CloudGoogle Cloud CLI

1. Di konsol Google Cloud, buka Menu > Produk lainnya > Google Workspace > Pustaka Produk.

   Buka Library Produk

2. Klik API yang ingin diaktifkan.
3. Klik Aktifkan.
4. Untuk mengaktifkan lebih banyak API, ulangi langkah-langkah ini.

1. Instal atau buka Antarmuka Command Line (CLI) Google Cloud.

2. Jalankan perintah services enable, yang menentukan layanan API mana yang akan diaktifkan.

   gcloud services enable API_SERVICE_ID

Mengonfigurasi Chat API

Dalam project Cloud baru, Anda harus menggunakan Chat API untuk menentukan nama, deskripsi, dan ikon aplikasi Chat. Untuk mengonfigurasi detail ini, lihat Mengonfigurasi Chat API

Mengonfigurasi layar izin OAuth

Anda mungkin perlu mengonfigurasi layar izin OAuth untuk project Cloud Anda. Jika sebelumnya Anda menggunakan OAuth 2.0 untuk otorisasi, gunakan cakupan akses otorisasi yang sama.

1. Di konsol Google Cloud, buka Menu > > Branding.

   Buka Branding

2. Jika telah mengonfigurasi , Anda dapat mengonfigurasi setelan Layar Izin OAuth berikut di Branding, Audiens, dan Akses Data. Jika Anda melihat pesan yang bertuliskan not configured yet, klik Get Started:
1. Di bagian Informasi Aplikasi, di Nama aplikasi, masukkan Nama aplikasi.
2. Di Email dukungan pengguna, pilih alamat email dukungan yang dapat dihubungi pengguna jika mereka memiliki pertanyaan tentang izin mereka.
3. Klik Berikutnya.
4. Di bagian Audiens, pilih jenis pengguna untuk aplikasi Anda.
5. Klik Berikutnya.
6. Di bagian Informasi Kontak, masukkan Alamat email tempat Anda dapat menerima notifikasi tentang perubahan apa pun pada project Anda.
7. Klik Berikutnya.
8. Di bagian Selesai, tinjau Kebijakan Data Pengguna Layanan Google API dan jika Anda setuju, pilih Saya setuju dengan Layanan Google API: Kebijakan Data Pengguna.
9. Klik Lanjutkan.
10. Klik Buat.
11. Jika Anda memilih Eksternal untuk jenis pengguna, tambahkan pengguna pengujian:
    1. Klik Audiens.
    2. Di bagian Pengguna pengujian, klik Tambahkan pengguna.
    3. Masukkan alamat email Anda dan pengguna pengujian resmi lainnya, lalu klik Simpan.

3. Jika Anda membuat aplikasi untuk digunakan di luar organisasi Google Workspace, klik Akses Data > Tambahkan atau Hapus Cakupan. Sebaiknya terapkan praktik terbaik berikut saat memilih cakupan:

   • Pilih cakupan yang memberikan tingkat akses minimum yang diperlukan oleh aplikasi Anda. Untuk daftar cakupan yang tersedia, lihat Cakupan OAuth 2.0 untuk Google API.
   • Tinjau cakupan yang tercantum di setiap tiga bagian: cakupan tidak sensitif, cakupan sensitif, dan cakupan yang dibatasi. Untuk cakupan apa pun yang tercantum di bagian "Cakupan sensitif Anda" atau "Cakupan terbatas Anda", coba identifikasi cakupan alternatif yang tidak sensitif untuk menghindari peninjauan tambahan yang tidak perlu.
   • Beberapa cakupan memerlukan peninjauan tambahan oleh Google. Untuk aplikasi yang hanya digunakan secara internal oleh organisasi Google Workspace Anda, cakupan tidak tercantum di layar izin dan penggunaan cakupan yang dibatasi atau sensitif tidak memerlukan peninjauan lebih lanjut oleh Google. Untuk mengetahui informasi selengkapnya, lihat Kategori cakupan.
4. Setelah memilih cakupan yang diperlukan oleh aplikasi Anda, klik Simpan.

Untuk informasi selengkapnya tentang cara mengonfigurasi izin OAuth, lihat Memulai .

Men-deploy ulang aplikasi Chat ke project Cloud baru

Bergantung pada apakah aplikasi Chat Anda dibuat dengan Apps Script, AppSheet, atau jenis koneksi lain, seperti Python atau Java, men-deploy ulang aplikasi Chat sedikit berbeda. Dalam kedua kasus tersebut, Anda tidak perlu membuat ulang semua kode, tetapi Anda perlu melakukan beberapa perubahan.

Memigrasikan logika aplikasi Chat

Bergantung pada arsitektur aplikasi Chat, Anda mungkin perlu memigrasikan layanan lain ke project Cloud baru:

• Untuk aplikasi HTTP, Anda juga perlu memigrasikan logika aplikasi lainnya yang di-build menggunakan Cloud Functions, Cloud Run, atau App Engine.
• Untuk aplikasi Chat percakapan yang menggunakan bahasa alami, Anda juga perlu memigrasikan agen Dialogflow.
• Untuk aplikasi Chat yang dibuat di balik firewall, Anda juga perlu memigrasikan topik Pub/Sub.

Mengonfigurasi fitur interaktif di project Cloud baru

Untuk men-deploy ulang aplikasi Chat yang dibuat dengan bahasa seperti Python atau Java, konfigurasikan aplikasi Chat di project Cloud baru Anda.

Untuk mengonfigurasi fitur interaktif, lihat Menerima dan merespons interaksi pengguna.

Men-deploy ulang aplikasi Chat Apps Script

Untuk men-deploy ulang aplikasi Chat yang dibuat dengan Apps Script, ubah nomor project Cloud yang terkait dengan project Apps Script ke nomor project yang merupakan milik project Cloud baru Anda. Kemudian, salin ID deployment Apps Script dan tempelkan ke halaman konfigurasi aplikasi Chat di konsol Google Cloud.

Menyalin nomor project Cloud

1. Di konsol Google Cloud, buka Menu > IAM & Admin > Settings.

   Buka IAM & Admin Settings

2. Di kolom Project number, salin nilainya.

Menetapkan nomor project Google Cloud di project Apps Script

1. Buka Apps Script.

   Buka Apps Script

2. Di project Apps Script aplikasi Chat, klik Project Settings .

3. Pada Google Cloud Platform (GCP) Project, klik Change project.

4. Di GCP project number, tempel nomor project Google Cloud.

5. Klik Set project.

Menyalin ID deployment project Apps Script

1. Di kanan atas Apps Script, klik Deploy > Manage deployments.
2. Di bagian Deployment ID, klik Copy.
3. Klik Selesai.

Mengonfigurasi ulang dan men-deploy ulang aplikasi Chat

1. Di konsol Google Cloud, telusuri "Google Chat API", lalu klik Google Chat API, lalu klik Manage.

   Buka Chat API

2. Klik tab Configuration, lalu masukkan informasi yang diperlukan berikut:

   • Nama aplikasi: Nama yang digunakan orang saat berinteraksi dengan aplikasi Chat Anda.
   • URL Avatar: URL HTTPS yang mengarah ke gambar grafis persegi (misalnya, PNG atau JPEG), minimal 128x128, yang muncul sebagai avatar untuk aplikasi Chat Anda.
   • Deskripsi: Deskripsi tujuan aplikasi Chat yang dimaksud yang muncul di bawah nama aplikasi Chat Anda.

3. Untuk mengaktifkan fitur interaktif, klik tombol Aktifkan fitur interaktif yang memungkinkan pengguna berinteraksi dengan aplikasi Chat Anda:

4. Di bagian Connection settings, pilih Apps Script project.

5. Di kolom Deployment ID, tempel ID deployment yang sebelumnya Anda salin.

6. Untuk menyelesaikan konfigurasi lainnya, lihat tabel di Mengonfigurasi aplikasi Chat di project Cloud baru

7. Klik Simpan.

Men-deploy ulang aplikasi Chat AppSheet

Untuk men-deploy ulang aplikasi Chat yang dibuat dengan AppSheet di project Cloud baru, salin aplikasi ke project Cloud baru.

Memperbarui akun layanan

Jika aplikasi Chat Anda diautentikasi sebagai aplikasi dan menggunakan akun layanan untuk melakukan panggilan ke Google API, perbarui detail akun layanan aplikasi Chat. Untuk mengetahui informasi selengkapnya, lihat Mengautentikasi sebagai aplikasi Chat.

Membagikan aplikasi Chat

Sebelum aplikasi Chat tersedia bagi pengguna di organisasi baru, administrator Anda mungkin harus mengizinkan akses ke aplikasi Chat secara manual. Untuk informasi selengkapnya, lihat Cara administrator Google Workspace menginstal aplikasi Chat.

Beralih ke aplikasi Chat baru

Setelah aplikasi Chat dimigrasikan ke organisasi baru, sekarang saatnya memublikasikannya. Tambahkan ke ruang Chat atau pesan langsung, lalu hapus aplikasi Chat lama dari ruang atau pesan langsung tersebut sehingga orang hanya mengirim pesan ke aplikasi Chat yang dimigrasikan.

Praktik terbaik: Untuk membantu penerapan aplikasi Chat yang dimigrasikan, umumkan migrasi kepada pengguna dan dorong mereka untuk menginstal aplikasi Chat yang dimigrasikan di ruang dan percakapan Chat.

Menambahkan aplikasi Chat baru ke ruang Chat

1. Buka Chat.

   Buka Chat

2. Klik pesan langsung atau ruang.

3. Klik menu drop-down di samping nama ruang atau orang, lalu pilih Aplikasi & integrasi.

4. Klik Tambahkan aplikasi.

5. Masukkan nama aplikasi, pilih aplikasi dari daftar, lalu klik Tambahkan.

6. Ulangi langkah-langkah ini untuk setiap ruang atau pesan langsung yang ingin Anda tambahkan aplikasi Chat.

Menghapus aplikasi Chat lama dari ruang Chat

1. Buka Chat.

   Buka Chat

2. Klik pesan langsung atau ruang.

3. Klik menu drop-down di samping nama ruang atau orang, lalu pilih Aplikasi & integrasi.

4. Di samping aplikasi Chat lama yang belum dimigrasikan, klik Opsi lainnya , lalu klik Hapus dari ruang.

5. Ulangi langkah-langkah ini untuk setiap ruang atau pesan langsung tempat Anda ingin menghapus aplikasi Chat lama.

Menonaktifkan aplikasi Chat lama

Untuk mencegah pengguna menggunakan aplikasi Chat lama dan mendorong mereka menggunakan aplikasi Chat baru, nonaktifkan aplikasi Chat lama dan batalkan publikasinya dari Google Workspace Marketplace.

Topik terkait

• Memublikasikan aplikasi