Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Integrasi Airtable
Dengan konektor aksi Airtable, Anda dapat mengakses platform Airtable langsung di Amazon Quick melalui bahasa alami. Anda dapat membuat dan memperbarui catatan, mengelola basis dan tabel, memfilter tampilan, dan melakukan operasi data relasional tanpa meninggalkan Amazon Quick.
Amazon Quick mendukung beberapa metode otentikasi untuk Airtable. Pilih metode yang paling sesuai dengan persyaratan keamanan organisasi Anda.
+ Aplikasi **OAuth default — Menggunakan aplikasi** OAuth yang AWS dikelola. Tidak diperlukan kredensil tambahan. Pengguna mengautentikasi langsung dengan akun Airtable mereka.
+ Aplikasi **OAuth khusus - Menggunakan aplikasi** OAuth yang dikelola pelanggan yang terdaftar di Airtable. Opsi ini memberi organisasi Anda kontrol penuh atas konfigurasi OAuth.
+ **API Key** — Menggunakan token akses pribadi Airtable untuk otentikasi. Cocokkan untuk penggunaan individu atau pengujian.
Untuk informasi selengkapnya tentang metode otentikasi yang didukung Amazon Quick, lihat[Metode autentikasi](quick-action-auth.md).
## Sebelum Anda mulai
Pastikan Anda memiliki yang berikut ini sebelum Anda mengatur integrasi.
+ Akun Airtable aktif dengan akses ke pangkalan dan data yang ingin Anda gunakan.
+ Untuk **aplikasi OAuth Kustom**: Akses ke [Airtable Builder Hub](https://airtable.com/create/oauth) di situs web Airtable untuk mendaftarkan integrasi OAuth.
+ Untuk **Kunci API**: Token akses pribadi dari [Airtable Builder Hub](https://airtable.com/create/tokens) di situs web Airtable.
+ Untuk persyaratan berlangganan Amazon Quick, lihat[Siapkan integrasi di konsol](integration-console-setup-process.md).
## Mengkonfigurasi Airtable
Jika Anda menggunakan otentikasi **aplikasi OAuth Default**, lewati bagian ini dan lanjutkan ke. [Menyiapkan konektor di Amazon Quick](#airtable-quicksuite-setup)
Untuk aplikasi Custom OAuth atau otentikasi API Key, selesaikan langkah-langkah yang berlaku di Airtable sebelum mengonfigurasi Amazon Quick.
### Daftarkan integrasi OAuth (aplikasi OAuth khusus)
Buat integrasi OAuth di Airtable Builder Hub untuk mendapatkan kredensi klien yang Anda butuhkan untuk Amazon Quick.
1. Masuk ke [Airtable Builder Hub](https://airtable.com/create/oauth) di situs web Airtable dan pilih integrasi **OAuth**.
1. Pilih **Daftarkan integrasi OAuth baru**.
1. Masukkan **Nama** untuk integrasi Anda.
1. Untuk URL **pengalihan OAuth, masukkan URL** pengalihan dari Amazon Quick: `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`
1. Pilih **Registrasi integrasi**.
1. Setelah pendaftaran, buat rahasia klien dengan memilih **Regenerasi rahasia klien**.
1. Catat nilai-nilai berikut. Anda membutuhkannya saat mengonfigurasi Amazon Quick.
+ **ID Klien**
+ **Rahasia klien**
1. Di bawah **Cakupan**, pilih izin yang diperlukan integrasi Anda. Untuk daftar lengkap cakupan yang direkomendasikan, lihat[Cakupan yang direkomendasikan](#airtable-oauth-scopes).
### Buat token akses pribadi (API Key)
Buat token akses pribadi di Airtable Builder Hub untuk autentikasi API Key.
1. Masuk ke [Airtable Builder Hub](https://airtable.com/create/tokens) di situs web Airtable dan pilih Token **akses pribadi**.
1. Pilih **Buat token**.
1. Konfigurasikan nama token, cakupan, dan akses dasar sesuai kebutuhan untuk kasus penggunaan Anda.
1. Salin dan simpan token yang dihasilkan dengan aman. Anda membutuhkannya saat mengonfigurasi Amazon Quick.
### Cakupan yang direkomendasikan
Saat Anda mendaftarkan integrasi OAuth atau membuat token akses pribadi, konfigurasikan cakupan berikut berdasarkan tindakan yang ingin Anda gunakan.
**Cakupan yang direkomendasikan Airtable**
| Lingkup | Deskripsi |
| --- | --- |
| data.records:read | Baca data dalam catatan. |
| data.records:write | Membuat, mengedit, dan menghapus catatan. |
| data.recordComments:read | Baca komentar dalam catatan. |
| data.recordComments:write | Buat, edit, dan hapus catatan komentar. |
| schema.bases:read | Baca struktur basis, termasuk nama tabel dan jenis bidang. |
| schema.bases:write | Edit struktur basis, termasuk nama tabel dan jenis bidang. |
| user.email:read | Baca alamat email pengguna yang diautentikasi. |
## 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.
1. Di konsol Amazon Quick, pilih **Konektor**.
1. Pada tab **Tersedia**, cari **Airtable** dan pilih **Connect**.
1. Selesaikan aliran masuk Airtable dan berikan izin yang diminta.
Untuk mengonfigurasi konektor dengan aplikasi OAuth Kustom atau Kunci API, gunakan tab **Buat untuk tim Anda** seperti yang dijelaskan di bawah ini.
### Buat dari tab Buat untuk tim Anda
Setelah Anda menyelesaikan konfigurasi Airtable yang diperlukan, buat konektor di Amazon Quick.
1. Di konsol Amazon Quick, pilih **Konektor**.
1. Pilih tab **Buat untuk tim Anda**.
1. Temukan dan pilih **Airtable**.
**catatan**
Jika konektor Airtable sudah ada, dialog akan muncul dengan konektor yang ada. Untuk menggunakan konektor yang ada, pilihlah. Untuk membuat yang baru, pilih **Tidak, buat yang baru**.
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 salah satu metode otentikasi berikut dan konfigurasikan bidang yang diperlukan.
1. Untuk aplikasi **OAuth Default**:
Tidak diperlukan kredensil tambahan. Pilih **Next** untuk melanjutkan.
1. Untuk **aplikasi Custom OAuth**, konfigurasikan bidang berikut:
+ **URL Dasar** (Opsional) - URL dasar API Airtable. Contoh: `https://api.airtable.com`
+ **ID Klien — ID** klien dari integrasi OAuth Airtable Anda.
+ **Rahasia klien — Rahasia** klien dari integrasi Airtable OAuth Anda.
+ **URL Token** — Titik akhir token. Contoh: `https://airtable.com/oauth2/v1/token`
+ **URL Otorisasi** — Titik akhir otorisasi. Contoh: `https://airtable.com/oauth2/v1/authorize`
+ **Redirect URL** — Pre-filled dengan URL callback Amazon Quick.
1. Untuk **API Key**, konfigurasikan bidang berikut:
+ **URL Dasar** (Opsional) - URL dasar API Airtable. Contoh: `https://api.airtable.com`
+ **Kunci API** — Token akses pribadi Airtable Anda.
+ **Email** (Opsional) — Alamat email yang terkait dengan akun Airtable Anda.
1. Pilih **Berikutnya**.
1. Jika Anda memilih aplikasi **OAuth Default atau aplikasi** **Custom OAuth, jendela otorisasi** Airtable akan terbuka. Tinjau izin yang diminta, pilih basis dan ruang kerja untuk memberikan akses, dan pilih **Berikan** akses.
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
Setelah Anda mengatur konektor, tindakan berikut tersedia.
**Tindakan yang tersedia Airtable**
| Kategori | Tindakan | Deskripsi |
| --- | --- | --- |
| Catatan | Daftar Catatan | Daftar catatan dalam tabel dengan pemfilteran dan penyortiran opsional. |
| Catatan | Dapatkan Rekam | Mengambil catatan tertentu berdasarkan ID. |
| Catatan | Batch Buat Rekaman | Membuat satu atau lebih catatan baru dalam tabel. |
| Catatan | Perbarui Rekaman | Memperbarui bidang pada catatan yang ada. |
| Catatan | Catatan Pembaruan Batch | Memperbarui beberapa catatan dalam satu operasi menggunakan PATCH. |
| Catatan | Batch Put Record | Upserts beberapa catatan dalam satu operasi menggunakan PUT. |
| Komentar | Daftar Komentar | Daftar komentar pada catatan. |
| Komentar | Buat Komentar | Menambahkan komentar ke catatan. |
| Komentar | Perbarui Komentar | Mengedit komentar yang ada pada catatan. |
| Skema | Daftar Basis | Daftar semua basis yang dapat diakses oleh pengguna yang diautentikasi. |
| Skema | Dapatkan Skema Dasar | Mengambil skema basis, termasuk tabel dan definisi bidang. |
| Skema | Buat Tabel | Membuat tabel baru di basis. |
| Skema | Perbarui Tabel | Memperbarui properti tabel seperti nama atau deskripsi. |
| Skema | Buat Bidang | Menambahkan bidang baru ke tabel. |
| Skema | Bidang Perbarui | Memperbarui properti bidang seperti nama atau jenis. |
| Lampiran | Buat Lampiran | Mengunggah lampiran ke rekaman. |
| Pengguna | Dapatkan Info Pengguna | Mengambil informasi tentang pengguna yang diautentikasi. |
**catatan**
Tindakan yang dapat Anda gunakan bergantung pada basis dan ruang kerja yang dapat diakses oleh pengguna yang diautentikasi.
## Mengelola dan memecahkan masalah
Untuk mengedit, membagikan, atau menghapus konektor Anda, lihat[Mengelola integrasi yang ada](integration-workflows.md#managing-existing-integrations).
### Masalah otentikasi
+ **Sign-in gagal (Aplikasi OAuth default atau aplikasi Custom OAuth)** — Verifikasi bahwa akun Airtable Anda aktif dan Anda dapat masuk ke [airtable.com di situs web Airtable](https://airtable.com) secara langsung. Untuk aplikasi Custom OAuth, konfirmasikan bahwa URL pengalihan dalam integrasi OAuth Airtable Anda cocok dengan URL callback Amazon Quick.
+ **Kredensi klien tidak valid (aplikasi OAuth Kustom)** — Verifikasi bahwa ID Klien dan rahasia Klien cocok dengan nilai dalam integrasi OAuth Airtable Anda. Jika Anda membuat ulang rahasia klien, perbarui nilainya di Amazon Quick.
+ **Kunci API ditolak** — Verifikasi bahwa token akses pribadi Anda aktif dan memiliki cakupan yang diperlukan. Token dapat dicabut atau kedaluwarsa di Airtable Builder Hub.
+ **Izin tidak memadai** — Verifikasi bahwa cakupan yang dikonfigurasi untuk metode autentikasi Anda menyertakan izin yang diperlukan untuk tindakan yang ingin Anda gunakan. Lihat [Cakupan yang direkomendasikan](#airtable-oauth-scopes).