Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Integrasi Smartsheet
Gunakan konektor tindakan Smartsheet untuk mengelola lembar, baris, laporan, dan pencarian di seluruh ruang kerja Smartsheet Anda secara langsung di Amazon Quick melalui bahasa alami. Integrasi ini menggunakan Smartsheet API. Untuk informasi selengkapnya, lihat [pengenalan Smartsheet API](https://developers.smartsheet.com/api/smartsheet/introduction) di dokumentasi Smartsheet.
Menyiapkan integrasi ini melibatkan dua langkah. Pertama, Anda mengonfigurasi kredensional di Smartsheet untuk metode otentikasi yang Anda pilih. Kemudian, Anda membuat integrasi di Amazon Quick dan menghubungkannya ke akun Smartsheet Anda. Untuk informasi tentang metode otentikasi yang didukung Amazon Quick, lihat[Metode autentikasi](quick-action-auth.md).
## Prasyarat
Sebelum Anda mengatur integrasi, pastikan Anda memenuhi persyaratan berikut:
+ Akun Smartsheet dengan paket Bisnis atau Perusahaan. Akun gratis tidak dapat menghasilkan token akses API atau mendaftarkan aplikasi OAuth. Untuk informasi selengkapnya, lihat [harga Smartsheet](https://www.smartsheet.com/pricing) di situs web Smartsheet.
+ Akses ke [Alat Pengembang Smartsheet](https://developers.smartsheet.com/) diaktifkan untuk akun Anda. Untuk mendaftar, buka halaman [Pendaftaran Alat Pengembang](https://developers.smartsheet.com/register).
+ Untuk persyaratan berlangganan, lihat[Siapkan integrasi di konsol](integration-console-setup-process.md).
## Konfigurasikan Alat Pengembang Smartsheet
Sebelum Anda mengonfigurasi Amazon Quick, atur kredensional di Smartsheet. Langkah-langkah yang Anda selesaikan bergantung pada metode otentikasi yang Anda rencanakan untuk digunakan. Amazon Quick mendukung dua metode otentikasi untuk Smartsheet. Untuk informasi lebih lanjut tentang metode ini, lihat[Metode autentikasi](quick-action-auth.md).
+ **Otentikasi pengguna (OAuth)** - Setiap pengguna masuk dengan akun Smartsheet mereka sendiri. Tindakan dijalankan dengan izin pengguna tersebut. Metode ini menggunakan[Aplikasi OAuth khusus](quick-action-auth.md#quick-custom-user-auth). Lengkapi [Daftar Alat Pengembang dan buat profil pengembang](#smartsheet-register-developer-tools) dan [Daftarkan aplikasi OAuth](#smartsheet-register-oauth-app) bagian di bawah ini.
+ **Otentikasi layanan (kunci API)** — Semua tindakan dijalankan menggunakan satu token API. Metode ini menggunakan[Otentikasi kunci API](quick-action-auth.md#quick-actions-api-key-auth). Lengkapi [Hasilkan token akses API (hanya otentikasi layanan)](#smartsheet-api-token-setup) bagian di bawah ini.
Untuk informasi selengkapnya tentang Smartsheet OAuth, lihat [OAuth](https://developers.smartsheet.com/api/smartsheet/guides/advanced-topics/oauth) di dokumentasi Smartsheet API.
### Daftar Alat Pengembang dan buat profil pengembang
1. Buka halaman [Pendaftaran Alat Pengembang](https://developers.smartsheet.com/register) dan daftarkan akun Smartsheet yang ingin Anda gunakan dengan aplikasi Anda. Untuk informasi selengkapnya, lihat [Mendaftar Alat Pengembang](https://developers.smartsheet.com/api/smartsheet/guides/advanced-topics/oauth#register-for-developer-tools) di dokumentasi API Smartsheet.
1. **Setelah Smartsheet mengaktifkan Alat Pengembang, masuk ke aplikasi Smartsheet dan pilih ikon **Akun** Anda di sudut kiri bawah, lalu pilih Alat Pengembang.**
1. Pilih **Buat Profil Pengembang** dan masukkan nama profil. Untuk informasi selengkapnya, lihat [Membuat profil pengembang Anda](https://developers.smartsheet.com/api/smartsheet/guides/advanced-topics/oauth#create-your-developer-profile) di dokumentasi Smartsheet API.
**Tip**
Smartsheet merekomendasikan penggunaan akun layanan khusus untuk aplikasi OAuth daripada akun pribadi.
### Daftarkan aplikasi OAuth
1. Di Alat Pengembang Smartsheet, pilih **Buat Aplikasi Baru**.
1. Lengkapi formulir:
+ **Nama aplikasi** — Nama untuk mengidentifikasi aplikasi Anda kepada pengguna.
+ **Deskripsi aplikasi** — Deskripsi singkat tentang integrasi.
+ **URL Aplikasi** — URL yang meluncurkan aplikasi Anda, atau halaman landing.
+ **App contact/support** - Support informasi kontak.
+ **URL pengalihan aplikasi** - `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`
Ganti {{{region}}} dengan AWS Wilayah Anda (misalnya,`us-east-1`).
1. Pilih **Simpan**. Smartsheet menghasilkan **ID klien Aplikasi** dan **rahasia Aplikasi**.
1. Salin nilai **Client ID** dan **Client Secret**. Anda memerlukan ini saat mengonfigurasi integrasi di Amazon Quick.
Untuk informasi selengkapnya, lihat [Mendaftarkan aplikasi](https://developers.smartsheet.com/api/smartsheet/guides/advanced-topics/oauth#register-an-app) di dokumentasi Smartsheet API.
### Hasilkan token akses API (hanya otentikasi layanan)
Jika Anda berencana untuk menggunakan otentikasi layanan alih-alih OAuth, buat token akses API. Anda harus memiliki rencana Bisnis atau Perusahaan untuk menghasilkan token. Untuk informasi selengkapnya, lihat [Menghasilkan token akses API](https://help.smartsheet.com/articles/2482389-generate-API-key) di Pusat Bantuan Smartsheet.
1. Di aplikasi Smartsheet, pilih **Akun** Anda (gambar profil) di bagian bawah bilah navigasi kiri, lalu pilih **Pengaturan Pribadi**.
1. Pilih tab **Akses API** dan pilih **Hasilkan token akses baru**.
1. Beri nama token dan pilih **OK**. Salin nilai token segera — ini adalah satu-satunya saat itu terlihat.
**penting**
Simpan token akses Anda dengan aman. Siapa pun yang memiliki token dapat mengakses semua data Smartsheet yang dapat diakses oleh pemilik token. Jangan komit token ke sistem kontrol versi. Untuk praktik terbaik dalam menyimpan token, lihat [Autentikasi](https://developers.smartsheet.com/api/smartsheet/guides/basics/authentication) dalam dokumentasi API Smartsheet.
## Cakupan akses OAuth
Saat Anda mengonfigurasi autentikasi pengguna (OAuth), integrasi meminta cakupan akses berikut dari Smartsheet. Cakupan ini menentukan apa yang dapat dilakukan integrasi atas nama pengguna yang diautentikasi. Jika Anda menggunakan otentikasi layanan (kunci API) sebagai gantinya, integrasi menggunakan izin penuh dari pemilik token dan cakupan tidak berlaku. Untuk informasi selengkapnya, lihat [Akses cakupan](https://developers.smartsheet.com/api/smartsheet/guides/advanced-topics/oauth#access-scopes) dalam dokumentasi Smartsheet API.
**Cakupan akses Smartsheet OAuth**
| Lingkup | Deskripsi |
| --- | --- |
| READ\_SHEETS | Baca semua data lembar, termasuk lampiran, diskusi, dan data sel. |
| WRITE\_SHEETS | Menyisipkan dan memodifikasi data lembar, termasuk lampiran, diskusi, dan data sel. |
**catatan**
Cakupan akses tidak mengesampingkan izin berbagi yang ada. Misalnya, memiliki `WRITE_SHEETS` cakupan tidak memungkinkan integrasi untuk memperbarui lembar di mana pengguna hanya memiliki akses tingkat pemirsa. Untuk informasi selengkapnya, lihat [Tingkat akses sumber daya](https://developers.smartsheet.com/api/smartsheet/guides/basics/resource-access-levels) dalam dokumentasi Smartsheet API.
## Siapkan integrasi di Amazon Quick
Setelah Anda menyelesaikan konfigurasi Alat Pengembang Smartsheet, buat integrasi di Amazon Quick.
1. Di konsol Amazon Quick, pilih **Konektor**.
1. Pilih tab **Buat untuk tim Anda**.
1. Temukan dan pilih **Smartsheet**.
1. Masukkan detail integrasi:
+ **Nama — Nama** deskriptif untuk integrasi Smartsheet Anda.
+ **Deskripsi** (Opsional) — Tujuan integrasi.
1. Pilih jenis koneksi Anda dan isi pengaturan koneksi. Untuk informasi selengkapnya tentang metode otentikasi ini, lihat[Metode autentikasi](quick-action-auth.md).
1. Untuk **autentikasi Pengguna (OAuth)**, gunakan ID Klien dan Rahasia Klien dari pendaftaran aplikasi Alat Pengembang Smartsheet Anda. Konfigurasi bidang berikut:
+ **URL dasar** — `https://api.smartsheet.com/2.0`
+ **ID Klien — ID** klien aplikasi dari pendaftaran aplikasi Smartsheet Developer Tools Anda.
+ **Rahasia Klien** — Rahasia aplikasi dari pendaftaran aplikasi Smartsheet Developer Tools Anda.
+ **URL Token** — `https://api.smartsheet.com/2.0/token`
+ **URL Auth** — `https://app.smartsheet.com/b/authorize`
+ **URL pengalihan** - `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`
1. Untuk **otentikasi Layanan (kunci API)**, gunakan token akses API dari Pengaturan Pribadi Smartsheet Anda. Konfigurasi bidang berikut:
+ **Kunci API** — Token akses API Smartsheet yang dihasilkan dari Pengaturan Pribadi Anda.
+ **URL dasar** — `https://api.smartsheet.com/2.0`
+ **Email** — Alamat email yang terkait dengan akun Smartsheet yang menghasilkan token.
1. Pilih **Buat dan lanjutkan**.
1. Pilih pengguna untuk berbagi integrasi dengan.
1. Pilih **Berikutnya**.
Untuk otentikasi pengguna, buka **Konektor > nama konektor** Smartsheet Anda, dan pilih **Masuk** untuk menyelesaikan alur otorisasi OAuth. Di jendela persetujuan Smartsheet, pilih **Izinkan** untuk memberikan akses.
**penting**
Dengan otentikasi layanan, semua tindakan berjalan menggunakan izin pemilik token API. Setiap pengguna Amazon Quick dengan akses ke integrasi ini dapat melakukan tindakan pada semua sumber daya Smartsheet yang dapat diakses oleh pemilik token. Cakupan izin token dengan tepat untuk persyaratan keamanan organisasi Anda.
**catatan**
Jika Anda menggunakan Smartsheet Gov, Smartsheet Regions Europe, atau Smartsheet Regions Australia, gunakan URL dasar yang sesuai untuk lingkungan Anda:
**URL dasar regional Smartsheet**
| Lingkungan | URL dasar |
| --- | --- |
| Smartsheet | https://api.smartsheet.com/2.0 |
| Smartsheet Gubernur | https://api.smartsheetgov.com/2.0 |
| Wilayah Smartsheet Eropa | https://api.smartsheet.eu/2.0 |
| Wilayah Smartsheet Australia | https://api.smartsheet.au/2.0 |
Untuk informasi selengkapnya, lihat [URL dasar](https://developers.smartsheet.com/api/smartsheet/guides/basics/base-url) dalam dokumentasi Smartsheet API.
## Tindakan yang tersedia
Setelah Anda mengatur integrasi, tindakan berikut tersedia.
**Tindakan yang tersedia Smartsheet**
| Kategori | Tindakan | Deskripsi |
| --- | --- | --- |
| Pencarian | Daftar Pencarian | Mencari semua lembar yang dapat diakses pengguna untuk teks tertentu. |
| Lembar | Lembar Daftar | Daftar semua lembar yang dapat diakses oleh pengguna yang diautentikasi. |
| Lembar | Dapatkan Lembar | Mendapat lembar dan datanya berdasarkan ID lembar. |
| Laporan | Daftar Laporan | Daftar semua laporan yang dapat diakses oleh pengguna. |
| Laporan | Lihat Laporan | Mendapat rincian laporan berdasarkan ID laporan. |
## Kelola dan pecahkan masalah
Untuk mengedit, membagikan, atau menghapus integrasi Anda, lihat[Mengelola integrasi yang ada](integration-workflows.md#managing-existing-integrations).
### Masalah otentikasi
+ **Otorisasi OAuth gagal** — Verifikasi bahwa ID Klien dan Rahasia Klien cocok dengan nilai dalam pendaftaran aplikasi Alat Pengembang Smartsheet Anda. Konfirmasikan URL pengalihan di Smartsheet cocok dengan URL dalam konfigurasi Amazon Quick Anda dengan tepat. Untuk daftar jenis kesalahan OAuth, lihat jenis kesalahan [OAuth dalam dokumentasi API Smartsheet](https://developers.smartsheet.com/api/smartsheet/guides/advanced-topics/oauth#oauth-error-types).
+ **Alat Pengembang tidak tersedia** — Verifikasi bahwa Alat Pengembang diaktifkan untuk akun Smartsheet Anda. Akun gratis tidak mendukung Alat Pengembang. Jika permintaan Anda ditolak, hubungi Manajer Sukses Pelanggan Smartsheet Anda.
+ **Otentikasi kunci API gagal** — Verifikasi bahwa token akses belum dicabut. Anda dapat mengelola token dari **Pengaturan Pribadi** > **Akses API** di aplikasi Smartsheet. Untuk informasi selengkapnya, lihat [Menghasilkan token akses API](https://help.smartsheet.com/articles/2482389-generate-API-key) di Pusat Bantuan Smartsheet.
+ **Token akses kedaluwarsa** — Token akses OAuth kedaluwarsa setelah sekitar 7 hari. Amazon Quick menangani penyegaran token secara otomatis. Jika Anda mengalami kesalahan token persisten, keluar dan masuk lagi dari pengaturan integrasi. Untuk informasi selengkapnya, lihat [Melakukan panggilan API](https://developers.smartsheet.com/api/smartsheet/guides/advanced-topics/oauth#make-api-calls) di dokumentasi Smartsheet API.
### Pesan kesalahan umum
+ **Tindakan mengembalikan kesalahan izin** — Verifikasi bahwa pengguna yang diautentikasi memiliki izin berbagi yang diperlukan pada lembar target. Cakupan OAuth tidak mengesampingkan kontrol akses tingkat berbagi. Untuk informasi selengkapnya, lihat [Tingkat akses sumber daya](https://developers.smartsheet.com/api/smartsheet/guides/basics/resource-access-levels) dalam dokumentasi Smartsheet API.
+ **Lembar tidak ditemukan** - Verifikasi ID lembar sudah benar dan bahwa pengguna yang diautentikasi memiliki setidaknya akses penampil ke lembar.
+ **Kesalahan batas tingkat API** — API Smartsheet memberlakukan batas tarif. Untuk informasi selengkapnya, lihat [Batasan](https://developers.smartsheet.com/api/smartsheet/guides/basics/limitations) dalam dokumentasi API Smartsheet.