Memigrasikan aplikasi Google Chat Anda

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

Sebelum memigrasikan aplikasi Chat, hubungi administrator organisasi Anda untuk memeriksa apakah setelan administratif memengaruhi aplikasi tersebut. Mengubah setelan administratif dapat memulihkan fungsi penuh aplikasi Chat Anda dan membuat migrasi tidak diperlukan. Misalnya, administrator Google Workspace Anda mungkin harus menambahkan aplikasi Chat Anda 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 menentukan bahwa Anda perlu memigrasikan aplikasi Chat, selesaikan proses tiga langkah berikut:

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

Buat project Cloud di organisasi yang digabungkan dan aktifkan API

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

Buat project Cloud

Konsol Google Cloud

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 Lokasi, klik Jelajah untuk menampilkan potensi lokasi 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.

gcloud CLI

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 Anda dibuat, Anda mungkin perlu mengaktifkan API lain. Misalnya, jika Anda membuat 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 Cloud

1. Di konsol Google Cloud, buka Menu > More products > Google Workspace > Product Library.

   Buka Library Produk

2. Klik API yang ingin Anda aktifkan.
3. Klik Enable.
4. Untuk mengaktifkan API lainnya, ulangi langkah-langkah ini.

Google Cloud CLI

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

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

   gcloud services enable API_SERVICE_ID

Mengonfigurasi Chat API

Di 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 sudah mengonfigurasi , Anda dapat mengonfigurasi setelan Layar Izin OAuth berikut di Branding, Audiens, dan Akses Data. Jika Anda melihat pesan yang menyatakan belum dikonfigurasi, klik Mulai:
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 Kebijakan Data Pengguna Layanan Google API.
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 uji resmi lainnya, lalu klik Simpan.

3. Jika Anda membuat aplikasi untuk digunakan di luar organisasi Google Workspace Anda, klik Akses Data > Tambahkan atau Hapus Cakupan. Sebaiknya lakukan 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 dari tiga bagian: cakupan tidak sensitif, cakupan sensitif, dan cakupan terbatas. 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 sensitif atau terbatas 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 mengetahui informasi selengkapnya tentang cara mengonfigurasi izin OAuth, lihat Mulai menggunakan .

Deploy ulang aplikasi Chat Anda ke project Cloud baru

Bergantung pada apakah aplikasi Chat Anda dibuat dengan Apps Script, AppSheet, atau jenis koneksi lain, seperti Python atau Java, cara men-deploy ulang aplikasi Chat Anda 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, Anda mungkin perlu memigrasikan layanan lain ke project Cloud baru:

• Untuk aplikasi HTTP, Anda juga perlu memigrasikan logika aplikasi lainnya yang dibuat 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 belakang 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, konfigurasi 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 dimiliki oleh project Cloud baru Anda. Kemudian, salin ID deployment Apps Script Anda dan tempelkan ke halaman konfigurasi aplikasi Chat di konsol Google Cloud.

Menyalin nomor project Cloud Anda

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

   Buka Setelan IAM & Admin

2. Di kolom Project number, salin nilai.

Menetapkan nomor project Google Cloud di project Apps Script Anda

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, tempelkan nomor project Google Cloud.

5. Klik Set project.

Menyalin ID deployment project Apps Script Anda

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

Mengonfigurasi ulang dan men-deploy ulang aplikasi Chat Anda

1. Di Konsol Google Cloud, cari "Google Chat API", lalu klik Google Chat API, lalu klik Manage.

   Buka Chat API

2. Klik tab Konfigurasi, 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 penggunaan aplikasi Chat 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, tempelkan 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 melakukan autentikasi 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 Anda

Sebelum aplikasi Chat Anda tersedia bagi pengguna di organisasi baru, administrator Anda mungkin harus mengizinkan akses ke aplikasi Chat secara manual. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi akses untuk organisasi Google Workspace dalam dokumentasi Google Workspace Marketplace.

Beralih ke aplikasi Chat baru

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

Praktik terbaik: Untuk membantu adopsi aplikasi Chat yang dimigrasikan, umumkan migrasi kepada pengguna Anda 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 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 tambahi aplikasi Chat.

Menghapus aplikasi Chat lama dari ruang Chat

1. Buka Chat.

   Buka Chat

2. Klik pesan langsung atau ruang.

3. Klik 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.