Premiers pas avec l'API Meet Media

Pour utiliser l'API Google Meet Media et ses habilitations OAuth 2.0 associées, votre application doit respecter les exigences suivantes.

Exigences techniques

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

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

  • Les clients doivent utiliser la bibliothèque libwebrtc, et 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 aux abandons de 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é

Découvrir les niveaux d'accès de l'API Media

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 de champ d'application Description Utilisation
https://www.googleapis.com/auth/meetings.conference.media.readonly Enregistrer la vidéo et l'audio en temps réel dans les appels vidéo Google Meet. Limité
https://www.googleapis.com/auth/meetings.conference.media.audio.readonly Capturer l'audio en temps réel dans les appels vidéo Google Meet. Limité
https://www.googleapis.com/auth/meetings.conference.media.video.readonly Enregistrer 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 niveaux d'accès de l'API Meet Media sont restreints :

En plus des habilitations de l'API Meet Media, vous devez également demander l'habilitation générale de lecture des réunions avec votre OAuth. Ce champ d'application est requis pour accéder aux métadonnées de la réunion, telles que les informations sur les participants et les entrées multimédias, et pour négocier une connexion réussie.

Code de champ d'application Description Utilisation
https://www.googleapis.com/auth/meetings.space.read Autorise les applications à lire les métadonnées de tous les espaces de réunion auxquels l'utilisateur a accès. Sensible

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 niveaux d'accès aux 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.

Conditions requises pour les utilisateurs finaux

Pour que la conférence soit éligible, les participants Meet doivent également répondre à certaines exigences minimales pour pouvoir utiliser l'API Meet Media.

Versions d'application mobile

Pour les utilisateurs mobiles, ils doivent passer à ces versions :

Plate-forme Application Version
Android Application Meet 309
iOS Application Meet 308
Android Application Gmail 30/05/2025
iOS Application Gmail 6.0.250518

Plates-formes non compatibles

Nous ne prenons pas en charge les clients matériels tiers qui exécutent Meet. Par exemple, si vos utilisateurs finaux utilisent un appareil Cisco pour salle de conférence exécutant Meet, votre instance Meet Media API ne peut pas rejoindre l'appel.

Limites d'âge

L'API Meet Media ne peut pas collecter de contenus multimédias à partir de comptes enregistrés pour des mineurs.

Il s'agit généralement de comptes dont les utilisateurs n'ont pas encore atteint l'âge minimal requis dans leur pays (généralement moins de 18 ans) ou qui n'avaient pas encore atteint l'âge minimal requis lorsque le compte a été créé par un parent dans l'application Google Family Link.

Notez que certaines régions (comme l'UE) imposent des restrictions supplémentaires sur les types de comptes considérés comme appartenant à des mineurs.

Si vous pensez que le compte d'un de vos utilisateurs est limité, vous pouvez valider son âge pour vérifier si son compte a été validé. En savoir plus sur la validation de votre âge