Premiers pas avec l'API Meet Media

Version Preview pour les développeurs : disponible dans le cadre du programme Preview développeur Google Workspace, qui permet d'accéder de manière anticipée à certaines fonctionnalités.

Pour utiliser l'API Meet Media et accéder aux contenus multimédias en temps réel d'une conférence, le projet Google Cloud, le principal OAuth et tous les participants à la conférence doivent être inscrits au programme Preview développeur.

Pour utiliser l'API Google Meet Media et ses champs d'application OAuth associés, votre application doit respecter les exigences suivantes.

Exigences techniques

Les contraintes suivantes s'appliquent lorsque vous utilisez l'API Meet Media :

• Les clients doivent être compatibles avec tous les codecs suivants :

  • AV1
  • VP9
  • VP8

• Les clients doivent utiliser des implémentations de codec conformes aux exigences de l'API Meet Media concernant les codecs, y compris :

  • libvpx (Google) pour décoder VP8 ou VP9
  • dav1d (VideoLAN) pour décoder AV1

• Les clients doivent être compatibles avec les extensions d'en-tête WebRTC suivantes :

  • Heure d'envoi absolue
  • Contrôle de la congestion à l'échelle du transport
  • Heure de capture absolue
  • Descripteur de dépendance
  • Indication du niveau audio (urn:ietf:params:rtp-hdrext:ssrc-audio-level)

• Les clients doivent envoyer régulièrement une suite complète de métriques. Pour en savoir plus, consultez la page Métriques client.

Pour obtenir les meilleurs résultats et une assistance optimale :

• Les clients doivent utiliser la bibliothèque libwebrtc. La version ne doit pas être antérieure de plus de 12 mois à la dernière version de STABLE Chromium. Les navigateurs Chromium utilisent libwebrtc pour implémenter les API JavaScript WebRTC.

• Les clients doivent maintenir une bande passante minimale de 4 Mbit/s.

Activer l'API REST Meet

Avant d'utiliser les API Google, vous devez les activer dans un projet Google Cloud. Vous pouvez activer une ou plusieurs API dans un même projet Google Cloud.

• Dans la console Google Cloud, activez l'API REST Google Meet.

  Activer l'API

Règlement relatif à l'abandon des codecs

• Google se réserve le droit d'arrêter d'utiliser un codec à tout moment.

• Lorsqu'un nouveau codec est introduit, les développeurs reçoivent un préavis de 12 mois avant que les clients ne soient tenus de le prendre en charge.

Authentification et autorisation

Les clients de l'API Google Meet Media se connectent à une conférence au nom d'un utilisateur spécifique, à l'aide d'OAuth 2.0 pour l'authentification et l'autorisation.

Accès approprié

Important : consultez les Règles relatives aux données utilisateur et aux développeurs pour les API Workspace pour en savoir plus sur l'accès approprié à l'API Google Meet Media.

Respecter les champs d'application de l'API Meet

Les niveaux d'autorisation sont les autorisations que vous demandez aux utilisateurs d'accorder à votre application pour accéder au contenu des réunions. Lorsqu'un utilisateur installe votre application, il est invité à valider ces niveaux d'accès. En règle générale, vous devez choisir le champ d'application le plus précis possible et éviter de demander des champs d'application dont votre application n'a pas besoin. Les utilisateurs accordent plus facilement l'accès à des niveaux d'accès limités et clairement décrits.

L'API Meet Media est compatible avec le champ d'application OAuth 2.0 suivant :

Code du champ d'application	Description	Utilisation
https://www.googleapis.com/auth/meetings.conference.media.readonly	Enregistrez des vidéos et de l'audio en temps réel lors d'appels vidéo Google Meet.	Limité
https://www.googleapis.com/auth/meetings.conference.media.audio.readonly	Enregistrez de l'audio en temps réel lors d'appels vidéo Google Meet.	Limité
https://www.googleapis.com/auth/meetings.conference.media.video.readonly	Enregistrez des vidéos en temps réel lors d'appels vidéo Google Meet.	Limité

En raison de la nature sensible des conférences, tous les champs d'application de l'API Meet Media sont restreints :

• Restreint : ces niveaux d'accès offrent un large accès aux données utilisateur Google et nécessitent de passer par une procédure de validation des niveaux d'accès restreints. Pour en savoir plus sur cette exigence, consultez les Règles relatives aux données utilisateur dans les services d'API Google et les Exigences supplémentaires pour les champs d'application d'API spécifiques. Si vous stockez (ou transmettez) des données à portée restreinte sur des serveurs, vous devez passer par une évaluation de sécurité.

Si votre application nécessite d'accéder à d'autres API Google, vous pouvez également ajouter ces niveaux d'accès. Pour en savoir plus sur les champs d'application des API Google, consultez Utiliser OAuth 2.0 pour accéder aux API Google.

Pour définir les informations affichées aux utilisateurs et aux évaluateurs d'applications, consultez Configurer l'écran de consentement OAuth et choisir des habilitations.

Pour en savoir plus sur les champs d'application OAuth 2.0 spécifiques, consultez Champs d'application OAuth 2.0 pour les API Google.

Articles associés

• Découvrir les concepts de l'API Meet

• En savoir plus sur l'authentification et l'autorisation

• Méthodes d'authentification chez Google