Memigrasikan aplikasi Google Chat Anda

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

Sebelum memigrasikan aplikasi Chat, hubungi administrator organisasi Anda untuk mengetahui apakah setelan administratif memengaruhinya. Mengubah setelan administratif mungkin akan 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 berpotensi 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, 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 memastikan bahwa pengguna dan grup yang Anda izinkan mengakses aplikasi Chat dapat melakukannya tanpa error.

Membuat project Cloud

Konsol Google Cloud

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

   Buka Buat Project

2. Di kolom Nama Project, 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 Jelajahi untuk menampilkan potensi lokasi untuk project Anda. Kemudian, klik Pilih.
   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 pada 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 > APIs & Services > Library > Google Workspace.

   Buka Library API

2. Klik API yang ingin Anda aktifkan.
3. Klik Enable.
4. Untuk mengaktifkan lebih banyak API, 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 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 Anda. 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 API Google, buka Menu > Google Auth platform > Branding.

   Buka Branding

2. Jika sudah mengonfigurasi platform Google Auth, Anda dapat mengonfigurasi setelan Layar Izin OAuth berikut di Branding, Audiens, dan Akses Data. Jika Anda melihat pesan yang mengatakan Google Auth platform not configured yet, klik Get Started:
1. Di bagian App Information, di App name, masukkan App name.
2. Di User support email, pilih alamat email dukungan tempat pengguna dapat menghubungi Anda jika mereka memiliki pertanyaan tentang izin mereka.
3. Klik Next.
4. Di bagian Audience, pilih jenis pengguna untuk aplikasi Anda.
5. Klik Next.
6. Di bagian Contact Information, masukkan Email address tempat Anda dapat diberi tahu tentang perubahan apa pun pada project Anda.
7. Klik Next.
8. Di bagian Finish, tinjau Kebijakan Data Pengguna Layanan Google API dan jika Anda setuju, pilih I agree to the Google API Services: User Data Policy.
9. Klik Continue.
10. Klik Create.
11. Jika Anda memilih External untuk jenis pengguna, tambahkan pengguna pengujian:
    1. Klik Audience.
    2. Di bagian Test users, klik Add users.
    3. Masukkan alamat email Anda dan pengguna pengujian resmi lainnya, lalu klik Save.

3. Jika Anda membuat aplikasi untuk digunakan di luar organisasi Google Workspace, klik Data Access > Add or Remove Scopes. Sebaiknya ikuti praktik terbaik berikut saat memilih cakupan:

   • Pilih cakupan yang memberikan tingkat akses minimum yang diperlukan oleh aplikasi Anda. Untuk mengetahui daftar cakupan yang tersedia, lihat Cakupan OAuth 2.0 untuk Google API.
   • Tinjau cakupan yang tercantum di setiap dari tiga bagian: cakupan non-sensitif cakupan sensitif, dan cakupan terbatas. Untuk cakupan apa pun yang tercantum di bagian "Cakupan sensitif Anda" atau "Cakupan terbatas Anda", coba identifikasi cakupan non-sensitif alternatif 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 terbatas 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 Save.

Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi izin OAuth, lihat Memulai platform Google Auth.

Men-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 akan 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 fungsi Cloud Run, 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 termasuk dalam project Cloud baru Anda. Kemudian, salin ID deployment Apps Script Anda dan tempelkan ke halaman konfigurasi aplikasi Chat di Konsol API Google.

Menyalin nomor project Cloud Anda

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

   Buka Setelan IAM &Admin

2. Di kolom Project number, salin nilainya.

Menetapkan nomor project Google Cloud Anda di project Apps Script

1. Buka Apps Script.

   Buka Apps Script

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

3. Di bagian 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 Deployment ID, klik Copy.
3. Klik Done.

Mengonfigurasi ulang dan men-deploy ulang aplikasi Chat Anda

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

   Buka Chat API

2. Klik tab Configuration, dan masukkan informasi wajib 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 muncul di bawah nama aplikasi Chat Anda.

3. Untuk mengaktifkan fitur interaktif, klik tombol Enable interactive features 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 Save.

Men-deploy ulang aplikasi Chat AppSheet

Untuk men-deploy ulang aplikasi Chat yang dibuat dengan AppSheet di project Cloud baru Anda, 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 Melakukan autentikasi sebagai aplikasi Chat.

Membagikan aplikasi Chat Anda

Sebelum aplikasi Chat Anda tersedia untuk 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 di dokumentasi Google Workspace Marketplace.

Beralih ke aplikasi Chat baru

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

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

4. Klik Add apps.

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

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 Apps &integrations.

4. Di samping aplikasi Chat lama yang tidak dimigrasikan, klik More options , lalu klik Remove from space.

5. Ulangi langkah-langkah ini untuk setiap ruang atau pesan langsung yang ingin Anda hapus 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.