Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Integrasi Google Chat
<a name="google-chat-integration"></a>

Dengan konektor tindakan Google Chat, Anda dapat mengirim pesan, mengelola spasi, dan berinteraksi dengan utas obrolan dari akun Google Workspace langsung di Amazon Quick melalui bahasa alami.

Google Chat menggunakan otentikasi aplikasi OAuth Kustom. Untuk informasi selengkapnya tentang metode otentikasi yang didukung Amazon Quick, lihat[Metode autentikasi](quick-action-auth.md).

## Sebelum Anda mulai
<a name="google-chat-prerequisites"></a>

Pastikan Anda memiliki yang berikut ini sebelum Anda mengatur integrasi.
+ Akun Google Workspace aktif dengan akses ke ruang Google Chat yang ingin Anda gunakan.
+ Klien OAuth 2.0 yang terdaftar di konsol Google Cloud untuk project Google Workspace Anda, dengan Google Chat API diaktifkan.
+ Untuk persyaratan berlangganan Amazon Quick, lihat[Siapkan integrasi di konsol](integration-console-setup-process.md).

## Mengkonfigurasi Google Cloud
<a name="google-chat-source-setup"></a>

Untuk autentikasi aplikasi OAuth Kustom, buat klien OAuth 2.0 di [konsol Google Cloud](https://console.cloud.google.com/), aktifkan Google Chat API untuk project Anda, konfigurasikan layar persetujuan OAuth dengan cakupan Obrolan yang Anda perlukan (misalnya,,`chat.messages`)`chat.spaces`, dan tambahkan URL panggilan balik Cepat Amazon sebagai URI pengalihan resmi. `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback` Ganti {{{region}}} dengan AWS Wilayah Anda (misalnya,`us-east-1`). Untuk petunjuk langkah demi langkah, lihat [Google Chat API](https://developers.google.com/workspace/chat) di dokumentasi developer Google Workspace. Rekam ID Klien dan Rahasia Klien — Anda memerlukannya saat mengonfigurasi Amazon Quick.

## Menyiapkan konektor di Amazon Quick
<a name="google-chat-quicksuite-setup"></a>

1. Di konsol Amazon Quick, pilih **Konektor**.

1. Pilih tab **Buat untuk tim Anda**.

1. Temukan dan pilih **Google Chat**.

1. Masukkan **Nama** untuk konektor Anda. Secara opsional, pilih **\+ Tambahkan Deskripsi** untuk menambahkan deskripsi.

1. Untuk **jenis Koneksi**, pilih **Jaringan publik**.

1. Untuk **Konfigurasi OAuth**, pilih **aplikasi OAuth Kustom** dan konfigurasikan bidang berikut:
   + **URL Dasar — URL dasar** MCP Google Chat.
   + **ID Klien — ID** klien OAuth dari klien Google Cloud OAuth 2.0 Anda.
   + **Klien OAuth Publik** (Opsional) - Pilih opsi ini jika klien Google Cloud OAuth 2.0 Anda dikonfigurasi sebagai klien publik (tidak ada rahasia klien).
   + **Rahasia klien** - Rahasia klien dari klien Google Cloud OAuth 2.0 Anda.
   + **URL Token** — Titik akhir token Google OAuth.
   + **URL Otorisasi** — Titik akhir otorisasi Google OAuth.
   + **Redirect URL** — Pre-filled dengan URL callback Amazon Quick.

1. Pilih **Berikutnya**.

1. Jendela masuk Google terbuka. Tinjau izin yang diminta dan pilih **Izinkan**.

1. Pada halaman **Ulasan**, tinjau tindakan yang tersedia untuk konektor. Pilih **Berikutnya**.

1. Pada halaman **Publikasikan**, pilih siapa yang dapat mengakses konektor. Anda dapat mengaktifkan akses untuk semua orang di organisasi Anda atau mencari tim atau grup tertentu.

1. Pilih **Terbitkan**.

## Tindakan yang tersedia
<a name="google-chat-actions"></a>

Setelah Anda mengatur konektor, tindakan yang diekspos oleh Google Chat tersedia. Untuk melihat rangkaian tindakan saat ini untuk konektor Anda, buka tampilan **Tindakan yang tersedia** konektor di konsol Amazon Quick.

## Mengelola dan memecahkan masalah
<a name="google-chat-troubleshooting"></a>

Untuk mengedit, membagikan, atau menghapus konektor Anda, lihat[Mengelola integrasi yang ada](integration-workflows.md#managing-existing-integrations).

### Masalah otentikasi
<a name="google-chat-troubleshooting-auth"></a>
+ **Sign-in gagal** — Pastikan akun Google Workspace Anda aktif dan Anda dapat langsung masuk ke Google Chat. Konfirmasikan bahwa URI pengalihan resmi di klien Google Cloud OAuth 2.0 Anda cocok dengan URL callback Amazon Quick.
+ **Kredensi klien tidak valid** — Verifikasi bahwa ID Klien dan Rahasia Klien cocok dengan nilai di klien Google Cloud OAuth 2.0 Anda.
+ **Izin tidak memadai** — Verifikasi bahwa API Obrolan diaktifkan dan layar persetujuan OAuth Anda menyertakan cakupan yang diperlukan untuk operasi yang ingin Anda gunakan.