Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Integrasi Gmail
Dengan konektor aksi Gmail, Anda dapat mengakses Gmail langsung di Amazon Quick melalui bahasa alami. Anda dapat membaca dan mengirim email, mengelola label dan draf, mengatur utas, dan mencari kontak tanpa meninggalkan Amazon Quick.
Amazon Quick mendukung beberapa metode otentikasi untuk Gmail. Pilih metode yang paling sesuai dengan persyaratan keamanan organisasi Anda.
-
Aplikasi OAuth default — Menggunakan aplikasi OAuth yang AWS dikelola. Tidak diperlukan kredensi tambahan. Anda mengautentikasi langsung dengan akun Google Anda.
-
Aplikasi OAuth khusus — Menggunakan klien OAuth yang dikelola pelanggan yang dibuat di Google Cloud Console. Opsi ini memberi organisasi Anda kontrol penuh atas konfigurasi OAuth.
Untuk informasi selengkapnya tentang metode otentikasi yang didukung Amazon Quick, lihatMetode autentikasi.
Sebelum Anda mulai
Pastikan Anda memiliki yang berikut ini sebelum Anda mengatur integrasi.
-
Akun Google dengan akses ke Gmail.
-
Untuk aplikasi Custom OAuth: Akses ke Google Cloud Console
di situs web Google dengan izin untuk membuat klien OAuth. -
Untuk persyaratan berlangganan Amazon Quick, lihatSiapkan integrasi di konsol.
Mengkonfigurasi Google Cloud
Jika Anda menggunakan otentikasi aplikasi OAuth Default, lewati bagian ini dan lihat. Menyiapkan konektor di Amazon Quick
Untuk autentikasi aplikasi OAuth Kustom, selesaikan langkah-langkah berikut di Google Cloud Console sebelum Anda mengonfigurasi Amazon Quick. Saat Anda mengaktifkan API di langkah 3, cari dan aktifkan API Gmail.
Buat klien OAuth di Google Cloud Console
Buat klien OAuth di Google Cloud Console untuk mendapatkan kredensi klien yang Anda butuhkan untuk Amazon Quick. Untuk informasi selengkapnya, lihat Menggunakan OAuth 2.0 untuk Mengakses Google API
-
Masuk ke Google Cloud Console
di situs web Google. -
Buat proyek baru atau pilih proyek yang sudah ada.
-
Di panel navigasi kiri, pilih API & Layanan, lalu pilih Perpustakaan. Cari API yang dibutuhkan integrasi Anda dan pilih Aktifkan.
-
Pilih layar persetujuan OAuth dan pilih Memulai.
-
Konfigurasikan layar persetujuan:
-
Masukkan Nama Aplikasi dan pilih email Dukungan pengguna.
-
Untuk Audiens, pilih Internal (khusus organisasi Anda) atau Eksternal (pengguna Google mana pun).
-
Tambahkan detail kontak pengembang dan pilih Buat.
-
-
Pilih Buat klien OAuth.
-
Konfigurasikan klien:
-
Untuk jenis Aplikasi, pilih Aplikasi Web.
-
Masukkan nama untuk klien Anda.
-
Di bawah URI pengalihan resmi, tambahkan URL callback Cepat Amazon:
https://{region}.quicksight.aws.amazon.com/sn/oauthcallback
-
-
Pilih Buat.
-
Catat nilai-nilai berikut. Anda membutuhkannya saat mengonfigurasi Amazon Quick.
-
ID Klien
-
Rahasia klien
-
Cakupan yang direkomendasikan
Cakupan berikut diminta saat Anda terhubung ke Gmail.
| Lingkup | Deskripsi |
|---|---|
https://www.googleapis.com/auth/gmail.modify |
Membaca, mengirim, dan mengelola email dan label. |
https://www.googleapis.com/auth/gmail.send |
Mengirim email atas nama pengguna. |
https://www.googleapis.com/auth/contacts.readonly |
Membaca informasi kontak. |
openid |
Mengautentikasi identitas pengguna. |
email |
Membaca alamat email pengguna. |
catatan
emailCakupan openid dan cakupan secara otomatis disertakan dalam alur persetujuan OAuth untuk otentikasi pengguna. Mereka tidak diperlukan untuk Service-to-Service OAuth.
Menyiapkan konektor di Amazon Quick
Connect dari tab Tersedia
Jika Anda ingin menggunakan otentikasi aplikasi OAuth Default, Anda dapat terhubung langsung dari tab Tersedia tanpa konfigurasi tambahan.
-
Di konsol Amazon Quick, pilih Konektor.
-
Pada tab Tersedia, cari Gmail dan pilih Connect.
-
Selesaikan alur masuk Google dan berikan izin yang diminta.
Untuk mengonfigurasi konektor dengan aplikasi Custom OAuth sebagai gantinya, gunakan tab Buat untuk tim Anda seperti yang dijelaskan di bawah ini.
Buat dari tab Buat untuk tim Anda
Setelah Anda menyelesaikan konfigurasi Google Cloud yang diperlukan, buat konektor di Amazon Quick.
-
Di konsol Amazon Quick, pilih Konektor.
-
Pilih tab Buat untuk tim Anda.
-
Temukan dan pilih Gmail.
catatan
Jika konektor Gmail sudah ada, dialog akan muncul dengan konektor yang ada. Untuk menggunakan konektor yang ada, pilihlah. Untuk membuat yang baru, pilih Tidak, buat yang baru.
-
Masukkan Nama untuk konektor Anda. Secara opsional, pilih + Tambahkan Deskripsi untuk menambahkan deskripsi.
-
Untuk jenis Koneksi, pilih Jaringan publik.
-
Untuk Konfigurasi OAuth, pilih salah satu metode otentikasi berikut dan konfigurasikan bidang yang diperlukan.
-
Untuk aplikasi OAuth Default:
Tidak diperlukan kredensi tambahan. Pilih Next untuk melanjutkan.
-
Untuk aplikasi Custom OAuth, konfigurasikan bidang berikut:
-
URL Dasar (Opsional) — URL dasar API Gmail. Misalnya:
https://gmail.googleapis.com -
ID Klien — ID klien dari klien Google Cloud OAuth Anda.
-
Rahasia klien — Rahasia klien dari klien Google Cloud OAuth Anda.
-
URL Token — Titik akhir token. Misalnya:
https://oauth2.googleapis.com/token -
URL otorisasi — Titik akhir otorisasi. Misalnya:
https://accounts.google.com/o/oauth2/v2/auth -
Redirect URL — Pre-filled dengan URL callback Amazon Quick.
-
-
-
Pilih Berikutnya.
-
Jika Anda memilih aplikasi OAuth Default atau aplikasi Custom OAuth, jendela otorisasi Google akan terbuka. Tinjau izin yang diminta dan pilih Izinkan.
-
Pada halaman Ulasan, tinjau tindakan yang tersedia untuk konektor. Pilih Berikutnya.
-
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.
-
Pilih Terbitkan.
Tindakan yang tersedia
Setelah Anda mengatur konektor, tindakan berikut tersedia.
| Kategori | Tindakan | Deskripsi |
|---|---|---|
| Pesan | Dapatkan Email | Mengambil email dari kotak surat. |
| Pesan | Dapatkan Pesan Dengan Thread Id | Mengambil pesan dengan ID utasnya. |
| Pesan | Dapatkan Pesan Dengan Id Pesan | Mengambil pesan dengan ID pesannya. |
| Pesan | Kirim Email | Mengirim pesan email baru. |
| Pesan | Kirim Balas Thread | Membalas thread email yang ada. |
| Pesan | Teruskan Pesan | Meneruskan email ke penerima lain. |
| Pesan | Dapatkan Lampiran | Mengambil lampiran email. |
| Pesan | Pesan Pembaruan Batch | Memodifikasi label pada beberapa pesan dalam satu operasi. |
| Utas | Daftar Thread | Daftar utas email di kotak pesan. |
| Utas | Perbarui Label Thread | Memodifikasi label pada utas. |
| Sampah | Hapus Email | Memindahkan email ke tempat sampah. |
| Sampah | Hapus Thread | Memindahkan utas ke tempat sampah. |
| Sampah | Pulihkan Pesan | Mengembalikan email dari tempat sampah. |
| Sampah | Kembalikan Thread | Mengembalikan utas dari tempat sampah. |
| Label | Daftar Label | Daftar semua label di kotak pesan. |
| Label | Dapatkan Label | Mengambil detail untuk label tertentu. |
| Label | Buat Label | Membuat label baru. |
| Label | Perbarui Label | Memperbarui properti label. |
| Label | Tag Email | Menambahkan label ke email. |
| Draf | Daftar Draf | Daftar draf email. |
| Draf | Dapatkan Draf | Mengambil draf tertentu. |
| Draf | Buat Draf | Membuat draf email baru. |
| Draf | Perbarui Draf | Memperbarui draf yang ada. |
| Draf | Kirim Draf | Mengirim draft yang ada. |
| Kontak | Cari Kontak | Mencari kontak berdasarkan nama atau email. |
| Kontak | Dapatkan Kontak | Mengambil informasi kontak. |
| Riwayat | Daftar Sejarah | Daftar riwayat perubahan kotak pesan. |
| Pengaturan | Dapatkan Profil | Mengambil profil Gmail pengguna yang diautentikasi. |
| Pengaturan | Dapatkan Kirim Sebagai Alias | Mengambil konfigurasi alias kirim sebagai tertentu. |
| Pengaturan | Daftar Kirim Sebagai Alias | Daftar semua alias kirim sebagai untuk akun. |
catatan
Tindakan yang dapat Anda gunakan bergantung pada data yang dapat diakses oleh pengguna yang diautentikasi.
Kelola dan pecahkan masalah
Untuk mengedit, membagikan, atau menghapus konektor Anda, lihatMengelola integrasi yang ada.
Masalah otentikasi Google yang umum
-
Sign-in gagal (Aplikasi OAuth default atau aplikasi Custom OAuth) — Verifikasi bahwa akun Google Anda aktif dan Anda dapat langsung masuk ke situs web Google.
Untuk aplikasi Custom OAuth, konfirmasikan bahwa URI pengalihan di klien Google Cloud OAuth Anda cocok dengan URL callback Amazon Quick. -
Aplikasi diblokir oleh administrator — Jika administrator Google Workspace membatasi akses aplikasi pihak ketiga, Anda mungkin akan melihat kesalahan saat mencoba masuk. Hubungi administrator Google Workspace Anda untuk mengizinkan aplikasi Amazon Quick.
-
Kredensi klien tidak valid (aplikasi OAuth khusus) — Verifikasi bahwa ID Klien dan rahasia Klien cocok dengan nilai di klien Google Cloud OAuth Anda.
-
Popup otentikasi gagal — Verifikasi bahwa browser Anda mengizinkan popup dari domain konsol Amazon Quick. Coba gunakan browser lain atau bersihkan cache browser Anda.
-
Izin dicabut - Jika sebelumnya Anda mencabut akses Cepat Amazon dari setelan izin Akun Google, Anda perlu mengautentikasi ulang dengan mengedit konektor dan masuk lagi.
-
Pembatasan tarif API Google — Google mungkin membatasi permintaan selama periode penggunaan tinggi. Jika tindakan gagal, coba lagi setelah beberapa menit.
Gmail-specific masalah
-
Gmail API tidak diaktifkan — Verifikasi bahwa API Gmail diaktifkan di project Google Cloud Anda di bawah API & Services, Library.
