Premiers pas avec l'API Meet Media

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

Exigences techniques

Les contraintes suivantes sont appliquées lorsque vous utilisez l'API Meet Media :

Pour obtenir les meilleurs résultats et bénéficier d'une assistance optimale :

  • Les clients doivent utiliser la libwebrtc bibliothèque, et la version ne doit pas être antérieure de plus de 12 mois à la dernière version STABLE de 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 recevront 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 de OAuth 2.0 pour l'authentification et l' autorisation.

Accès approprié

Champs d'application de l'API Meet Media

Les champs d'application d'autorisation sont les autorisations que vous demandez aux utilisateurs d'autoriser pour que votre application puisse accéder au contenu de la réunion. Lorsqu'un utilisateur installe votre application, il est invité à valider ces champs d'application. 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 champs d'application 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 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 la vidéo en temps réel dans les 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 limités :

En plus des champs d'application de l'API Meet Media, vous devez également demander le champ d'application général de lecture des réunions avec votre OAuth. Ce champ d'application est nécessaire 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 du champ d'application Description Utilisation
https://www.googleapis.com/auth/meetings.space.read Permet aux applications de lire les métadonnées de n'importe quel espace de réunion auquel l'utilisateur a accès. Sensible

Si votre application nécessite d'accéder à d'autres API Google, vous pouvez également ajouter ces champs d'application. Pour en savoir plus sur les champs d'application des API Google, consultez la page 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 champs d'application.

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

Conditions requises pour les utilisateurs finaux

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

Versions pour appli mobile

Les utilisateurs mobiles doivent passer aux versions suivantes :

Plate-forme Application Version
Android Application Meet 309
iOS Application Meet 308
Android Application Gmail 2025.05.30
iOS Application Gmail 6.0.250518

Plates-formes non compatibles

Nous ne sommes pas compatibles avec les clients matériels tiers qui exécutent Meet. Par exemple, si vos utilisateurs finaux utilisent un appareil de salle de conférence matériel Cisco qui exécute Meet, votre instance de l'API Meet Media 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 pour lesquels l'âge de consentement n'est pas atteint dans le pays concerné (généralement moins de 18 ans) ou pour lesquels l'âge de consentement n'était pas atteint 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 mineurs.

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