Jika menggabungkan organisasi Google Workspace, Anda mungkin perlu memigrasikan aplikasi Chat agar aplikasi tetap berfungsi.
Sebelum memigrasikan aplikasi Chat, hubungi administrator organisasi Anda untuk mengetahui apakah setelan administratif memengaruhinya. Mengubah setelan administratif dapat memulihkan fungsi penuh ke aplikasi Chat Anda dan membuat migrasi tidak diperlukan. Misalnya, administrator Google Workspace 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 menentukan bahwa Anda perlu memigrasikan aplikasi Chat, selesaikan proses tiga langkah berikut:
- Siapkan lingkungan untuk aplikasi Chat Anda dengan membuat project Google Cloud di organisasi gabungan, mengaktifkan API, dan mungkin mengonfigurasi layar izin OAuth 2.0.
- Deploy ulang aplikasi Chat Anda dari project Cloud yang baru.
- Tambahkan aplikasi Chat yang dibuat ulang ke ruang Chat atau percakapan, dan nonaktifkan aplikasi Chat yang 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 gabungan akan memastikan pengguna dan grup yang Anda izinkan mengakses aplikasi Chat dapat melakukannya tanpa error.
Membuat project Cloud
Konsol Google Cloud
- Di konsol Google Cloud, buka Menu > IAM & Admin > Create a Project.
-
Di kolom Project Name, masukkan nama deskriptif untuk project Anda.
Opsional: Untuk mengedit ID Project, klik Edit. Project ID tidak dapat diubah setelah project dibuat. Jadi, pilih ID yang sesuai dengan kebutuhan Anda sepanjang waktu project tersebut.
- Di kolom Location, klik Browse untuk menampilkan lokasi potensial project. Kemudian, klik Select.
- Klik Create. Konsol Google Cloud akan membuka halaman Dashboard 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.
Mengaktifkan Cloud Shell -
Local Shell: Untuk menggunakan lingkungan pengembangan lokal,
instal dan
initialize
gcloud CLI.
Untuk membuat project Cloud, gunakan perintah `gcloud projects create`:
Ganti PROJECT_ID dengan menetapkan ID project yang ingin Anda buat.gcloud projects create PROJECT_ID
Mengaktifkan API
Semua aplikasi Chat harus mengaktifkan Google Chat API. Bergantung pada cara aplikasi Chat di-build, Anda mungkin perlu mengaktifkan API lainnya. Misalnya, jika Anda membangun 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 bahwa 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
- Di konsol Google Cloud, buka Menu > More products > Google Workspace > Product Library.
- Klik API yang ingin Anda aktifkan.
- Klik Enable.
- Untuk mengaktifkan API lainnya, ulangi langkah-langkah ini.
Google Cloud CLI
- Instal atau buka Antarmuka Command Line (CLI) Google Cloud.
-
Jalankan perintah
services enable, yang menentukan layanan API yang akan diaktifkan.gcloud services enable API_SERVICE_ID
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 otorisasi yang sama.
- Di konsol Google Cloud, buka Menu > APIs & Services > OAuth consent screen.
- Pilih jenis pengguna untuk aplikasi Anda, lalu klik Buat.
- Lengkapi formulir pendaftaran aplikasi, lalu klik Simpan dan Lanjutkan.
Jika Anda membuat aplikasi untuk digunakan di luar organisasi Google Workspace, klik Tambahkan atau Hapus Cakupan. Kami merekomendasikan praktik terbaik berikut saat memilih cakupan:
- Pilih cakupan yang menyediakan 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 masing-masing bagian: cakupan tidak sensitif, cakupan sensitif, dan cakupan yang dibatasi. Untuk setiap cakupan yang tercantum di bagian "Cakupan sensitif Anda" atau "Cakupan yang dibatasi", coba identifikasi alternatif cakupan 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 informasi selengkapnya, lihat Kategori cakupan.
- Setelah memilih cakupan yang dibutuhkan oleh aplikasi Anda, klik Simpan dan Lanjutkan.
- Jika memilih Eksternal untuk jenis pengguna, tambahkan pengguna pengujian:
- Di bagian Pengguna uji coba, klik Tambahkan pengguna.
- Masukkan alamat email Anda dan pengguna pengujian yang diotorisasi lainnya, lalu klik Simpan dan Lanjutkan.
- Tinjau ringkasan pendaftaran aplikasi Anda. Untuk melakukan perubahan, klik Edit. Jika pendaftaran aplikasi terlihat baik-baik saja, klik Back to Dashboard.
Deploy ulang aplikasi Chat Anda ke project Cloud yang baru
Bergantung pada apakah aplikasi Chat Anda dibuat dengan Apps Script, AppSheet, atau jenis koneksi lainnya, seperti Python atau Java, cara men-deploy ulang aplikasi Chat sedikit berbeda. Dalam kedua kasus tersebut, Anda tidak perlu membuat ulang semua kode, tetapi Anda perlu membuat beberapa perubahan.
Memigrasikan logika aplikasi Chat
Bergantung pada arsitektur aplikasi Chat, Anda mungkin perlu memigrasikan layanan lain ke project Cloud yang 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 dibangun di belakang firewall, Anda juga perlu memigrasikan topik Pub/Sub.
Mengonfigurasi aplikasi Chat di project Cloud baru
Untuk men-deploy ulang aplikasi Chat yang di-build dengan bahasa seperti Python atau Java, konfigurasikan aplikasi Chat di project Cloud baru Anda.
Di konsol Google Cloud, telusuri "Google Chat API" dan klik Google Chat API, lalu klik Manage.
Klik tab Configuration, dan masukkan informasi yang diperlukan berikut:
- Nama aplikasi: Nama yang digunakan orang saat berinteraksi dengan aplikasi Chat Anda.
- Avatar URL: URL HTTPS yang mengarah ke gambar grafis persegi (misalnya, PNG atau JPEG), berukuran minimal 128x128, yang muncul sebagai avatar untuk aplikasi Chat Anda.
- Deskripsi: Deskripsi tujuan yang dimaksudkan aplikasi Chat yang muncul di bawah nama aplikasi Chat Anda.
Untuk mengaktifkan fitur interaktif, klik tombol Aktifkan fitur interaktif yang memungkinkan pengguna berinteraksi dengan aplikasi Chat Anda, dan gunakan tabel berikut untuk menyelesaikan konfigurasi:
Kolom Deskripsi Fungsi Kumpulan kolom yang menentukan cara aplikasi Chat berinteraksi dengan pengguna: - Menerima pesan 1:1: Pengguna dapat menemukan dan mengirim pesan ke aplikasi Chat langsung di Google Chat.
- Bergabung ke ruang dan percakapan grup: Pengguna dapat menambahkan aplikasi Chat ke ruang dan percakapan grup.
Setelan koneksi Endpoint untuk aplikasi Chat, yang merupakan salah satu dari hal berikut: - URL aplikasi: Endpoint HTTPS yang menghosting implementasi aplikasi Chat.
- Project Apps Script: ID deployment untuk project Apps Script yang menerapkan aplikasi Chat.
- Nama topik Cloud Pub/Sub: Topik Pub/Sub yang berlangganan aplikasi Chat sebagai endpoint.
- Dialogflow: Mendaftarkan aplikasi Chat dengan integrasi Dialogflow. Untuk mengetahui informasi selengkapnya, lihat Membangun aplikasi Google Chat Dialogflow yang memahami bahasa alami.
Perintah garis miring Perintah yang dapat ditampilkan kepada pengguna dalam Google Chat. Memungkinkan pengguna melihat tindakan inti untuk aplikasi Chat Anda dalam Google Chat, dan memilih tindakan tertentu yang ingin mereka gunakan. Untuk mengetahui informasi selengkapnya, lihat Merespons perintah garis miring sebagai aplikasi Chat. Pratinjau link Pola URL yang dikenali aplikasi Chat dan memberikan konten tambahan saat pengguna mengirim link. Untuk informasi lebih lanjut, lihat Pratinjau link. Visibilitas Maksimal 5 individu atau satu atau beberapa Google Grup yang dapat melihat dan menginstal aplikasi Chat Anda. Gunakan kolom ini untuk menguji aplikasi Chat Anda, atau untuk berbagi aplikasi Chat dengan tim Anda. Untuk informasi selengkapnya, lihat Setelan visibilitas dan publikasi untuk aplikasi Chat. Untuk mencatat error ke Cloud Logging setiap kali aplikasi Chat menampilkan error, centang kotak Log errors to Logging. Untuk mengetahui informasi selengkapnya, lihat Membuat kueri log error untuk aplikasi Chat.
Klik Save. Saat menyimpan konfigurasi aplikasi Chat, aplikasi Chat Anda akan tersedia untuk pengguna yang ditentukan di organisasi Google Workspace Anda.
Men-deploy ulang aplikasi Chat Apps Script
Untuk men-deploy ulang aplikasi Chat Anda yang di-build dengan Apps Script, ubah nomor project Cloud yang terkait dengan project Apps Script ke nomor project yang menjadi bagian dari project Cloud baru Anda. Selanjutnya, salin ID deployment Apps Script Anda dan tempelkan ke halaman konfigurasi aplikasi Chat di Konsol Google Cloud.
Salin nomor project Cloud Anda
- Di konsol Google Cloud, buka Menu > IAM & Admin > Settings.
- Di kolom Project number, salin nilainya.
Menetapkan nomor project Google Cloud di project Apps Script
Buka Apps Script.
Di project Apps Script aplikasi Chat, klik Project Settings .
Pada Google Cloud Platform (GCP) Project, klik Change project.
Di GCP project number, tempel nomor project Google Cloud.
Klik Set project.
Menyalin ID deployment project Apps Script Anda
- Di kanan atas Apps Script, klik Deploy > Manage deployment.
- Di bagian ID Deployment, klik Salin.
- Klik Done.
Mengonfigurasi ulang dan men-deploy ulang aplikasi Chat Anda
Di konsol Google Cloud, telusuri "Google Chat API" dan klik Google Chat API, lalu klik Manage.
Klik tab Configuration, dan masukkan informasi yang diperlukan berikut:
- Nama aplikasi: Nama yang digunakan orang saat berinteraksi dengan aplikasi Chat Anda.
- Avatar URL: URL HTTPS yang mengarah ke gambar grafis persegi (misalnya, PNG atau JPEG), berukuran minimal 128x128, yang muncul sebagai avatar untuk aplikasi Chat Anda.
- Deskripsi: Deskripsi tujuan yang dimaksudkan aplikasi Chat yang muncul di bawah nama aplikasi Chat Anda.
Untuk mengaktifkan fitur interaktif, klik tombol Aktifkan fitur interaktif yang memungkinkan pengguna berinteraksi dengan aplikasi Chat Anda:
Di bagian Connection settings, pilih Apps Script project.
Di kolom Deployment ID, tempel ID deployment yang sebelumnya Anda salin.
Untuk menyelesaikan konfigurasi lainnya, lihat tabel di Mengonfigurasi aplikasi Chat di project Cloud baru
Klik Save.
Men-deploy ulang aplikasi Chat AppSheet
Untuk men-deploy ulang aplikasi Chat Anda 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.
Bagikan aplikasi Chat Anda
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, saatnya untuk memublikasikannya. Tambahkan ke ruang Chat atau pesan langsung, lalu hapus aplikasi Chat lama dari ruang tersebut agar pengguna hanya mengirim pesan ke aplikasi Chat yang dimigrasikan.
Menambahkan aplikasi Chat baru ke ruang Chat
Buka Chat.
Klik ruang atau pesan langsung.
Klik drop-down di samping nama ruang atau orang, lalu pilih Apps & integration.
Klik Tambahkan aplikasi.
Masukkan nama aplikasi, pilih aplikasi dari daftar, lalu klik Add.
Ulangi langkah-langkah ini untuk setiap ruang atau pesan langsung tempat Anda ingin menambahkan aplikasi Chat.
Menghapus aplikasi Chat lama dari ruang Chat
Buka Chat.
Klik ruang atau pesan langsung.
Klik drop-down di samping nama ruang atau orang, lalu pilih Apps & integration.
Di samping aplikasi Chat lama yang belum dimigrasikan, klik More options , lalu klik Remove from space.
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 agar menggunakan aplikasi Chat baru, nonaktifkan aplikasi Chat lama dan batalkan publikasinya dari Google Workspace Marketplace.