Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menghubungkan ke Rapat Zoom
Zoom Meetings adalah platform konferensi video berbasis cloud yang dapat digunakan untuk rapat konferensi video, konferensi audio, webinar, rekaman rapat, dan obrolan langsung.
**Topics**
+ [AWS Glue dukungan untuk Zoom Meetings](zoom-meetings-support.md)
+ [Kebijakan yang berisi operasi API untuk membuat dan menggunakan koneksi](zoom-meetings-configuring-iam-permissions.md)
+ [Mengkonfigurasi Rapat Zoom](zoom-meetings-configuring.md)
+ [Mengonfigurasi aplikasi klien Zoom Meetings](zoom-meetings-configuring-client-app.md)
+ [Mengkonfigurasi koneksi Zoom Meetings](zoom-meetings-configuring-connections.md)
+ [Membaca dari entitas Zoom Meetings](zoom-meetings-reading-from-entities.md)
+ [Opsi koneksi Zoom Rapat](zoom-meetings-connection-options.md)
+ [Batasan Rapat Zoom](zoom-meetings-limitations.md)
# AWS Glue dukungan untuk Zoom Meetings
AWS Glue mendukung Rapat Zoom sebagai berikut:
**Didukung sebagai sumber?**
Ya. Anda dapat menggunakan pekerjaan AWS Glue ETL untuk menanyakan data dari Rapat Zoom.
**Didukung sebagai target?**
Tidak.
**Versi API Zoom Meetings yang didukung**
Versi API Zoom Meetings berikut didukung:
+ v2
# Kebijakan yang berisi operasi API untuk membuat dan menggunakan koneksi
Kebijakan contoh berikut menjelaskan izin AWS IAM yang diperlukan untuk membuat dan menggunakan koneksi. Jika Anda membuat peran baru, buat kebijakan yang berisi hal-hal berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"glue:ListConnectionTypes",
"glue:DescribeConnectionType",
"glue:RefreshOAuth2Tokens",
"glue:ListEntities",
"glue:DescribeEntity"
],
"Resource": "*"
}
]
}
```
------
Jika Anda tidak ingin menggunakan metode di atas, gunakan kebijakan IAM terkelola berikut ini:
+ [AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Memberikan akses ke sumber daya yang diperlukan berbagai AWS Glue proses untuk dijalankan atas nama Anda. Sumber daya ini termasuk AWS Glue, Amazon S3, IAM, CloudWatch Log, dan Amazon. EC2 Jika Anda mengikuti konvensi penamaan untuk sumber daya yang ditentukan dalam kebijakan ini, AWS Glue proses memiliki izin yang diperlukan. Kebijakan ini biasanya dilampirkan pada peran yang ditentukan saat menentukan crawler, tugas, dan titik akhir pengembangan.
+ [AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Memberikan akses penuh ke AWS Glue sumber daya saat identitas yang dilampirkan kebijakan menggunakan Konsol AWS Manajemen. Jika Anda mengikuti konvensi penamaan untuk sumber daya yang ditentukan dalam kebijakan ini, maka pengguna memiliki kemampuan konsol penuh. Kebijakan ini biasanya dilampirkan ke pengguna AWS Glue konsol.
# Mengkonfigurasi Rapat Zoom
Sebelum Anda dapat menggunakan AWS Glue untuk mentransfer data dari Rapat Zoom, Anda harus memenuhi persyaratan ini:
## Persyaratan minimum
Berikut ini adalah persyaratan minimum:
+ Anda memiliki akun Zoom Meetings.
+ Akun Zoom Anda diaktifkan untuk akses API.
+ Anda telah membuat OAuth2 aplikasi di akun Zoom Meetings Anda. Integrasi ini menyediakan kredensi yang AWS Glue digunakan untuk mengakses data Anda dengan aman saat melakukan panggilan yang diautentikasi ke akun Anda. Untuk informasi selengkapnya, lihat [Mengonfigurasi aplikasi klien Zoom Meetings](zoom-meetings-configuring-client-app.md).
Jika memenuhi persyaratan ini, Anda siap untuk terhubung AWS Glue ke akun Rapat Zoom Anda. Untuk koneksi biasa, Anda tidak perlu melakukan hal lain di Zoom Meetings.
# Mengonfigurasi aplikasi klien Zoom Meetings
1. Masuk ke Marketplace Aplikasi Zoom.
1. Pilih **Kembangkan** > **Bangun Aplikasi**.
1. Pilih **Aplikasi Umum** untuk aplikasi berbasis OAuth 2.0.
1. Pada halaman **Info Dasar**, tambahkan atau perbarui informasi tentang aplikasi seperti nama aplikasi, cara aplikasi dikelola, kredensi aplikasi, dan OAuth informasi.
1. Di bagian **Pilih cara aplikasi dikelola**, konfirmasikan bagaimana Anda ingin aplikasi dikelola:
1. **Admin-managed**: Admin akun menambah dan mengelola aplikasi
1. **Dikelola pengguna**: Pengguna individu menambahkan dan mengelola aplikasi. Aplikasi ini hanya memiliki akses ke data resmi pengguna.
1. **Kredensial Aplikasi**: Alur build secara otomatis menghasilkan kredensi aplikasi (ID klien dan rahasia klien) untuk aplikasi Anda.
1. Di bagian OAuth Informasi, siapkan OAuth untuk aplikasi Anda.
1. **OAuth URL pengalihan** (wajib): Masukkan URL pengalihan atau titik akhir untuk disiapkan OAuth antara aplikasi dan Zoom.
1. **Gunakan URL Mode Ketat** (opsional)
1. **Pemeriksaan subdomain** (opsional)
1. **OAuth allow lists** (required): Tambahkan keunikan apa pun URLs yang harus diizinkan Zoom sebagai pengalihan yang valid untuk alur Anda OAuth .
1. Pada halaman **Scopes**, pilih metode Zoom API yang diizinkan untuk dipanggil oleh aplikasi Anda. Cakupan menentukan informasi dan kemampuan mana yang tersedia untuk pengguna Anda. Pilih cakupan granular berikut:
+ pengguna:baca:list\$1users:admin
+ zoom\$1rooms:baca:list\$1rooms:admin
+ kelompok:baca:list\$1members:admin
+ grup: baca: administrator: admin
+ kelompok:baca: list\$1groups:admin
+ laporan:baca:admin
+ peran: baca: list\$1roles, peran: baca: list\$1roles:admin
Setelah cakupan ditambahkan pilih **Lanjutkan** dan aplikasi siap digunakan.
Untuk informasi selengkapnya tentang penyiapan OAuth 2.0, lihat [Integrasi (OAuth aplikasi)](https://developers.zoom.us/docs/integrations/).
# Mengkonfigurasi koneksi Zoom Meetings
Zoom Meetings mendukung jenis hibah AUTHORIZATION\$1CODE untuk. OAuth2 Jenis hibah menentukan cara AWS Glue berkomunikasi dengan Rapat Zoom untuk meminta akses ke data Anda.
+ Jenis hibah ini dianggap “berkaki tiga” OAuth karena bergantung pada pengalihan pengguna ke server otorisasi pihak ketiga untuk mengautentikasi pengguna. Ini digunakan saat membuat koneksi melalui AWS Glue konsol. Pengguna yang membuat koneksi perlu memberikan informasi OAuth terkait seperti Client ID dan Client Secret untuk aplikasi klien Zoom Meetings mereka. AWS Glue Konsol akan mengarahkan pengguna ke Zoom di mana pengguna harus masuk dan mengizinkan AWS Glue izin yang diminta untuk mengakses instance Zoom Meetings mereka.
+ Pengguna masih dapat memilih untuk membuat aplikasi mereka sendiri yang terhubung di Zoom Meetings dan memberikan ID klien dan rahasia klien mereka sendiri saat membuat koneksi melalui AWS Glue konsol. Dalam skenario ini, mereka masih akan diarahkan ke Zoom Meetings untuk masuk dan memberi wewenang AWS Glue untuk mengakses sumber daya mereka.
+ Jenis hibah ini menghasilkan token penyegaran dan token akses. Token akses berumur pendek, dan dapat disegarkan secara otomatis tanpa interaksi pengguna menggunakan token penyegaran.
+ Untuk dokumentasi Rapat Zoom publik tentang cara membuat aplikasi yang terhubung untuk OAuth alur Kode Otorisasi, lihat [Menggunakan OAuth 2.0](https://developers.zoom.us/docs/api/using-zoom-apis/#using-oauth-20).
Untuk mengonfigurasi koneksi Zoom Meetings:
1. Di AWS Secrets Manager, buat rahasia dengan detail berikut:
1. Untuk aplikasi terhubung yang dikelola pelanggan, Rahasia harus berisi aplikasi yang terhubung Rahasia Konsumen dengan kunci `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` sebagai.
1. Catatan: Anda harus membuat rahasia untuk koneksi Anda di AWS Glue.
1. Di AWS Glue Glue Studio, buat koneksi di bawah **Koneksi Data** dengan mengikuti langkah-langkah di bawah ini:
1. Saat memilih **jenis Koneksi**, pilih Zoom Meetings.
1. Sediakan lingkungan Zoom Meetings yang ingin Anda sambungkan.
1. Pilih peran AWS IAM yang AWS Glue dapat mengasumsikan dan memiliki izin untuk tindakan berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:DescribeSecret",
"secretsmanager:GetSecretValue",
"secretsmanager:PutSecretValue",
"ec2:CreateNetworkInterface",
"ec2:DescribeNetworkInterfaces",
"ec2:DeleteNetworkInterface"
],
"Resource": "*"
}
]
}
```
------
1. Pilih `secretName` yang ingin Anda gunakan untuk koneksi ini AWS Glue untuk memasukkan token.
1. Pilih opsi jaringan jika Anda ingin menggunakan jaringan Anda.
1. Berikan peran IAM yang terkait dengan izin AWS Glue pekerjaan Anda untuk membaca`secretName`.
# Membaca dari entitas Zoom Meetings
**Prasyarat**
Objek Zoom Meetings yang ingin Anda baca. Anda akan membutuhkan nama objek seperti `Group` atau`Zoom Rooms`.
**Entitas yang didukung untuk sumber**:
| Entitas | Dapat disaring | Mendukung batas | Mendukung Pesanan oleh | Mendukung Pilih\$1 | Mendukung partisi |
| --- | --- | --- | --- | --- | --- |
| Ruang Zoom | Tidak | Ya | Tidak | Ya | Tidak |
| Kelompok | Tidak | Tidak | Tidak | Ya | Tidak |
| Anggota Grup | Ya | Ya | Tidak | Ya | Tidak |
| Admin Grup | Tidak | Ya | Tidak | Ya | Tidak |
| Laporan (harian) | Ya | Tidak | Tidak | Ya | Tidak |
| Peran | Tidak | Tidak | Tidak | Ya | Tidak |
| Pengguna | Ya | Ya | Tidak | Ya | Tidak |
**Contoh:**
```
zoom_read = glueContext.create_dynamic_frame.from_options(
connection_type="zoom",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "organization",
"API_VERSION": "v2"
}
)
```
**Entitas Zoom Rapat dan detail bidang**:
Zoom Meetings secara dinamis memuat bidang yang tersedia di bawah entitas yang dipilih. Tergantung pada tipe data bidang, ini mendukung operator filter berikut.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/zoom-meetings-reading-from-entities.html)
## Mempartisi kueri
Zoom Meetings tidak mendukung partisi berbasis filter atau partisi berbasis rekaman.
# Opsi koneksi Zoom Rapat
Berikut ini adalah opsi koneksi untuk Zoom Meetings:
+ `ENTITY_NAME`(String) - (Diperlukan) Digunakan untuk Baca. Nama entitas Zoom Meetings. Misalnya, `group`.
+ `API_VERSION`(String) - (Diperlukan) Digunakan untuk Baca. Zoom Meetings Rest versi API yang ingin Anda gunakan. Nilainya adalah`v2`, karena Zoom Meetings saat ini hanya mendukung versi v2.
+ `SELECTED_FIELDS`(Daftar) - Default: kosong (SELECT \$1). Digunakan untuk Baca. Daftar kolom yang dipisahkan koma yang ingin Anda pilih untuk entitas yang dipilih.
+ `FILTER_PREDICATE`(String) - Default: kosong. Digunakan untuk Baca. Itu harus dalam format Spark SQL.
+ `QUERY`(String) - Default: kosong. Digunakan untuk Baca. Kueri SQL Spark penuh.
# Batasan Rapat Zoom
Berikut ini adalah batasan atau catatan untuk Zoom Meetings:
+ Zoom Meetings tidak mendukung orderby.
+ Zoom Meetings tidak mendukung partisi berbasis filter karena tidak ada bidang yang dapat memenuhi kriteria yang diperlukan.
+ Zoom Meetings tidak mendukung partisi berbasis rekaman karena batas pagination dan pagination berbasis offset tidak didukung.