Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Connexion à Zoom Meetings
Zoom Meetings est une plateforme de visioconférence cloud qui peut être utilisée pour les réunions par visioconférence, les audioconférences, les webinaires, les enregistrements de réunions et le chat en direct.
**Topics**
+ [AWS Glue support pour Zoom Meetings](zoom-meetings-support.md)
+ [Politiques contenant les opérations API pour la création et l’utilisation des connexions](zoom-meetings-configuring-iam-permissions.md)
+ [Configuration de Zoom Meetings](zoom-meetings-configuring.md)
+ [Configuration de l’application client Zoom Meetings](zoom-meetings-configuring-client-app.md)
+ [Configuration des connexions Zoom Meetings](zoom-meetings-configuring-connections.md)
+ [Lecture depuis les entités de Zoom Meetings](zoom-meetings-reading-from-entities.md)
+ [Options de connexion Zoom Meetings](zoom-meetings-connection-options.md)
+ [Restrictions de Zoom Meetings](zoom-meetings-limitations.md)
# AWS Glue support pour Zoom Meetings
AWS Glue prend en charge Zoom Meetings comme suit :
**Prise en charge en tant que source ?**
Oui. Vous pouvez utiliser les tâches AWS Glue ETL pour interroger les données de Zoom Meetings.
**Prise en charge en tant que cible ?**
Non.
**Versions d’API Zoom Meetings prises en charge**
Les versions d’API Zoom Meetings suivantes sont prises en charge :
+ v2
# Politiques contenant les opérations API pour la création et l’utilisation des connexions
L'exemple de politique suivant décrit les autorisations AWS IAM requises pour créer et utiliser des connexions. Si vous créez un rôle, créez une politique contenant les éléments suivants :
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"glue:ListConnectionTypes",
"glue:DescribeConnectionType",
"glue:RefreshOAuth2Tokens",
"glue:ListEntities",
"glue:DescribeEntity"
],
"Resource": "*"
}
]
}
```
------
Si vous ne voulez pas utiliser la méthode ci-dessus, vous pouvez également utiliser les politiques IAM gérées suivantes :
+ [AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Accorde l'accès aux ressources dont AWS Glue les différents processus ont besoin pour s'exécuter en votre nom. Ces ressources incluent AWS Glue Amazon S3, IAM, CloudWatch Logs et Amazon EC2. Si vous suivez la convention de dénomination des ressources spécifiée dans cette politique, AWS Glue les processus disposent des autorisations requises. Cette politique est généralement attachée aux rôles spécifiés lorsque vous définissez les crawlers, les tâches et les points de terminaison de développement.
+ [AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Accorde un accès complet aux AWS Glue ressources lorsqu'une identité à laquelle la politique est attachée utilise la console AWS de gestion. Si vous suivez la convention de dénomination pour les ressources spécifiées dans la politique, les utilisateurs bénéficient des capacités totales de la console. Cette politique s'applique généralement aux utilisateurs de la AWS Glue console.
# Configuration de Zoom Meetings
Avant de pouvoir AWS Glue transférer des données depuis Zoom Meetings, vous devez satisfaire aux exigences suivantes :
## Configuration requise
Les exigences minimales sont les suivantes :
+ Vous disposez d’un compte Zoom Meetings.
+ Votre compte Zoom est activé pour accéder à l’API.
+ Vous avez créé une OAuth2 application dans votre compte Zoom Meetings. Cette intégration fournit les informations d'identification qui AWS Glue permettent d'accéder à vos données en toute sécurité lorsqu'elle passe des appels authentifiés vers votre compte. Pour de plus amples informations, veuillez consulter [Configuration de l’application client Zoom Meetings](zoom-meetings-configuring-client-app.md).
Si vous répondez à ces exigences, vous êtes prêt à vous connecter AWS Glue à votre compte Zoom Meetings. Pour les connexions classiques, vous n’avez rien d’autre à faire dans Zoom Meetings.
# Configuration de l’application client Zoom Meetings
1. Connectez-vous à la marketplace de l’application Zoom.
1. Choisissez **Développer** > **Créer l’application**.
1. Choisissez **General App** pour une application basée sur la OAuth version 2.0.
1. Sur la page **Informations de base**, ajoutez ou mettez à jour des informations sur l'application, telles que le nom de l'application, son mode de gestion, ses informations d'identification et autres OAuth informations.
1. Dans la section **Sélectionner le mode de gestion de l’application**, confirmez la manière dont vous souhaitez que votre application soit gérée :
1. **Gestion par l’administrateur** : les administrateurs de compte ajoutent et gèrent l’application.
1. **Gestion par l’utilisateur** : des utilisateurs individuels ajoutent et gèrent l’application. L’application n’a accès qu’aux données autorisées de l’utilisateur.
1. **Identifiants de l’application** : le flux de création génère automatiquement les informations d’identification (ID client et secret client) pour votre application.
1. Dans la section OAuth Informations, configurez OAuth votre application.
1. **OAuth URL de redirection** (obligatoire) : entrez l'URL de redirection ou le point de terminaison à configurer OAuth entre votre application et Zoom.
1. **Utiliser l’URL en mode strict** (facultatif)
1. **Vérification du sous-domaine** (facultatif)
1. **OAuth listes d'**autorisation (obligatoire) : ajoutez toute adresse unique URLs que Zoom doit autoriser comme redirections valides pour vos OAuth flux.
1. Sur la page **Portées**, sélectionnez les méthodes de l’API Zoom que votre application est autorisée à appeler. Les portées définissent les informations et les fonctionnalités mises à la disposition de votre utilisateur. Sélectionnez les portées granulaires suivantes :
+ user:read:list\$1users:admin
+ zoom\$1rooms:read:list\$1rooms:admin
+ group:read:list\$1members:admin
+ group:read:administrator:admin
+ group:read:list\$1groups:admin
+ report:read:admin
+ role:read:list\$1roles, role:read:list\$1roles:admin
Une fois les portées ajoutées, choisissez **Continuer** et l’application sera alors prête à être utilisée.
Pour plus d'informations sur la configuration OAuth 2.0, voir [Intégrations (OAuth applications).](https://developers.zoom.us/docs/integrations/)
# Configuration des connexions Zoom Meetings
Zoom Meetings prend en charge le type de subvention AUTHORIZATION\$1CODE pour. OAuth2 Le type de subvention détermine le mode AWS Glue de communication avec Zoom Meetings pour demander l'accès à vos données.
+ Ce type de subvention est considéré comme « à trois étapes » OAuth car il repose sur la redirection des utilisateurs vers un serveur d'autorisation tiers pour authentifier l'utilisateur. Il est utilisé lors de la création de connexions via la AWS Glue console. L'utilisateur qui crée une connexion doit fournir des informations OAuth connexes telles que l'ID client et le secret du client pour son application client Zoom Meetings. La AWS Glue console redirige l'utilisateur vers Zoom où il doit se connecter et autoriser AWS Glue les autorisations demandées pour accéder à son instance Zoom Meetings.
+ Les utilisateurs peuvent toujours choisir de créer leur propre application connectée dans Zoom Meetings et de fournir leur propre identifiant client et leur secret client lors de la création de connexions via la AWS Glue console. Dans ce scénario, ils seront toujours redirigés vers Zoom Meetings pour se connecter et autoriser AWS Glue l'accès à leurs ressources.
+ Ce type d’autorisation donne lieu à un jeton d’actualisation et à un jeton d’accès. Le jeton d’accès est de courte durée et peut être actualisé automatiquement sans interaction de l’utilisateur à l’aide du jeton d’actualisation.
+ Pour consulter la documentation publique de Zoom Meetings sur la création d'une application connectée pour le OAuth flux de code d'autorisation, voir [Utilisation de la OAuth version 2.0](https://developers.zoom.us/docs/api/using-zoom-apis/#using-oauth-20).
Pour configurer une connexion Zoom Meetings :
1. Dans AWS Secrets Manager, créez un secret avec les informations suivantes :
1. Pour l’application connectée gérée par le client, le secret doit contenir le secret du consommateur de l’application connectée avec `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` comme clé.
1. Remarque : vous devez créer un secret pour vos connexions dans AWS Glue.
1. Dans AWS Glue Glue Studio, créez une connexion sous **Data Connections** en suivant les étapes ci-dessous :
1. Lorsque vous sélectionnez un **type de connexion**, sélectionnez Zoom Meetings.
1. Indiquez l’environnement Zoom Meetings auquel vous souhaitez vous connecter.
1. Sélectionnez le rôle AWS IAM qui AWS Glue peut assumer et dispose des autorisations nécessaires pour les actions suivantes :
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:DescribeSecret",
"secretsmanager:GetSecretValue",
"secretsmanager:PutSecretValue",
"ec2:CreateNetworkInterface",
"ec2:DescribeNetworkInterfaces",
"ec2:DeleteNetworkInterface"
],
"Resource": "*"
}
]
}
```
------
1. Sélectionnez celui `secretName` que vous souhaitez utiliser pour cette connexion AWS Glue afin d'y placer les jetons.
1. Sélectionnez les options réseau si vous souhaitez utiliser votre réseau.
1. Accordez au rôle IAM associé à votre AWS Glue travail l'autorisation de lire`secretName`.
# Lecture depuis les entités de Zoom Meetings
**Prérequis**
Un objet Zoom Meetings à partir duquel vous souhaitez lire. Vous aurez besoin du nom de l’objet, comme `Group` ou `Zoom Rooms`.
**Entités prises en charge pour la source** :
| Entité | Peut être filtré | Limit prise en charge | Order by prise en charge | Select prise en charge\$1 | Partitionnement pris en charge |
| --- | --- | --- | --- | --- | --- |
| Zoom Rooms | Non | Oui | Non | Oui | Non |
| Groupe | Non | Non | Non | Oui | Non |
| Group Member | Oui | Oui | Non | Oui | Non |
| Group Admin | Non | Oui | Non | Oui | Non |
| Report (daily) | Oui | Non | Non | Oui | Non |
| Roles | Non | Non | Non | Oui | Non |
| Utilisateurs | Oui | Oui | Non | Oui | Non |
**Exemple :**
```
zoom_read = glueContext.create_dynamic_frame.from_options(
connection_type="zoom",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "organization",
"API_VERSION": "v2"
}
)
```
**Détails des entités et des champs Zoom Meetings** :
Zoom Meetings charge dynamiquement les champs disponibles sous l’entité sélectionnée. Les opérateurs de filtrage suivants sont pris en charge en fonction du type de données du champ.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/glue/latest/dg/zoom-meetings-reading-from-entities.html)
## Requêtes de partitionnement
Zoom Meetings ne prend pas en charge le partitionnement basé sur des filtres ni le partitionnement basé sur des enregistrements.
# Options de connexion Zoom Meetings
Les options de connexion pour Zoom Meetings sont les suivantes :
+ `ENTITY_NAME`(Chaîne) - (Obligatoire) Utilisé pour la lecture. Le nom de l’entité Zoom Meetings. Par exemple, `group`.
+ `API_VERSION`(Chaîne) - (Obligatoire) Utilisé pour la lecture. Version d’API Rest de Zoom Meetings que vous souhaitez utiliser. La valeur sera `v2`, car Zoom Meetings ne prend actuellement en charge que la version 2.
+ `SELECTED_FIELDS`(Liste) - Par défaut : vide (SELECT \$1). Utilisé pour la lecture. Liste de colonnes séparées par des virgules que vous souhaitez sélectionner pour l’entité sélectionnée.
+ `FILTER_PREDICATE`(Chaîne) - Par défaut : vide. Utilisé pour la lecture. Doit être au format SQL Spark.
+ `QUERY`(Chaîne) - Par défaut : vide. Utilisé pour la lecture. Requête Spark SQL complète.
# Restrictions de Zoom Meetings
Les restrictions ou remarques suivantes concernent Zoom Meetings :
+ Zoom Meetings ne prend pas en charge la commande Order by.
+ Zoom Meetings ne prend pas en charge le partitionnement basé sur des filtres, car aucun champ ne peut répondre aux critères requis.
+ Zoom Meetings ne prend pas en charge le partitionnement basé sur les enregistrements, car la limite de pagination et la pagination basée sur le décalage ne sont pas prises en charge.