Ce guide explique comment obtenir des informations sur les différents artefacts de réunion générés par une conférence à l'aide de l'API REST Google Meet.
Un artefact est un fichier ou des données générés par Google Meet en réponse à une conférence. Cela inclut les vidéos et autres artefacts, comme les transcriptions.
Pour produire des artefacts, les participants doivent les générer dans Meet avant la fin de la conférence. Les transcriptions fonctionnent indépendamment des enregistrements. Vous n'avez pas besoin d'enregistrer la réunion pour générer une transcription. Pour en savoir plus, consultez Enregistrer une visioconférence et Utiliser les transcriptions avec Google Meet.
Si vous êtes le propriétaire ou un participant d'un espace de réunion, vous pouvez appeler les méthodes get()
et list()
sur les ressources recordings
, transcripts
et transcripts.entries
pour récupérer des artefacts.
L'authentification et l'autorisation avec des identifiants utilisateur permettent aux applications Google Meet d'accéder aux données utilisateur et d'effectuer des opérations pour le compte de l'utilisateur authentifié. L'authentification avec la délégation au niveau du domaine vous permet d'autoriser le compte de service d'une application à accéder aux données de vos utilisateurs sans que chacun d'entre eux ait à donner son consentement.
Rétention des artefacts
Une fois une visioconférence terminée, Meet enregistre les enregistrements et les transcriptions dans le Google Drive de l'organisateur de la réunion. Par défaut, les artefacts Meet sont conservés conformément aux règles de Drive.
Les entrées de transcription fournies par l'API REST Meet sont supprimées 30 jours après la fin de la conférence.
Vous pouvez également gérer la conservation des artefacts Meet séparément à l'aide de règles de conservation spécifiques à Meet dans Google Vault. Pour en savoir plus, consultez Conserver des données Google Meet avec Vault.
Enregistrements
Les sections suivantes expliquent comment obtenir des informations sur les enregistrements dans un enregistrement de conférence.
Meet a accès à l'ID de l'enregistrement une fois le fichier d'enregistrement généré. Il est possible qu'un utilisateur supprime le fichier d'enregistrement de Google Drive, mais que le nom unique soit toujours renvoyé dans Meet.
La ressource recordings
inclut les objets DriveDestination
et State
.
L'objet DriveDestination
contient l'emplacement d'exportation dans Drive où l'enregistrement est enregistré en tant que fichier MP4. Pour télécharger l'enregistrement ou le lire dans un navigateur, utilisez la valeur du champ exportUri
de l'objet. Si vous connaissez l'API Google Drive, la valeur du champ file
correspond à id
dans la ressource files
. Pour en savoir plus, consultez Télécharger et exporter des fichiers.
L'objet State
contient l'état de la session d'enregistrement. Cela vous permet de savoir si l'enregistrement a commencé, s'il s'est terminé, mais que le fichier d'enregistrement n'est pas prêt, ou si le fichier d'enregistrement a été généré et est prêt à être téléchargé.
Obtenir des informations sur un enregistrement
Pour obtenir des détails sur un enregistrement spécifique, utilisez la méthode get()
sur la ressource recordings
avec le paramètre de chemin d'accès name
. Si vous ne connaissez pas le nom de l'enregistrement, vous pouvez lister tous les noms d'enregistrement à l'aide de la méthode list()
.
La méthode renvoie une instance d'une ressource recordings
.
L'exemple de code suivant montre comment récupérer un enregistrement spécifique :
Java
Node.js
Python
Remplacez le nom de l'enregistrement par le nom de l'ID d'enregistrement spécifique dans un enregistrement de conférence.
Lister tous les enregistrements
Pour lister les détails de tous les enregistrements d'un enregistrement de conférence, utilisez la méthode list()
sur la ressource recordings
avec le paramètre de chemin d'accès parent
. Format : conferenceRecords/{conferenceRecord}
.
La méthode renvoie une liste d'enregistrements de conférences, classés par ordre croissant de startTime
, sous la forme d'une instance de ressource recordings
. Pour ajuster la taille de la page, consultez Personnaliser la pagination .
L'exemple de code suivant montre comment lister tous les enregistrements d'un enregistrement de conférence :
Java
Node.js
Python
Remplacez la valeur parente par le nom de l'enregistrement de la conférence.
Transcriptions
Les sections suivantes expliquent comment obtenir des informations sur les transcriptions de conférences dans un enregistrement de conférence.
Meet a accès à l'ID de la transcription une fois les données de transcription générées. Il est possible qu'un utilisateur supprime le fichier de transcription de Drive, mais que le nom unique soit toujours renvoyé dans Meet.
La ressource transcripts
inclut les objets DocsDestination
et State
.
L'objet DocsDestination
contient l'emplacement d'exportation dans Drive où le fichier de transcription Google Docs est enregistré. Pour récupérer le contenu ou parcourir la transcription dans un navigateur, utilisez la valeur du champ exportUri
de l'objet. Si vous connaissez l'API Google Docs, la valeur du champ document
correspond à documentId
dans la ressource documents
.
L'objet State
contient l'état de la session de transcription. Cela vous permet de savoir si la session de transcription a commencé, si elle s'est terminée mais que le fichier de transcription n'est pas prêt, ou si le fichier de transcription a été généré et est prêt à être téléchargé.
Obtenir des informations sur une transcription
Pour obtenir des détails sur une transcription spécifique, utilisez la méthode get()
sur la ressource transcripts
avec le paramètre de chemin d'accès name
. Si vous ne connaissez pas le nom de la transcription, vous pouvez lister tous les noms de transcriptions à l'aide de la méthode list()
.
La méthode renvoie une instance d'une ressource transcripts
.
L'exemple de code suivant montre comment récupérer une transcription spécifique :
Java
Node.js
Python
Remplacez le nom de la transcription par le nom de l'ID de transcription spécifique dans un enregistrement de conférence.
Lister toutes les transcriptions
Pour lister les détails de toutes les transcriptions d'un enregistrement de conférence, utilisez la méthode list()
sur la ressource transcripts
avec le paramètre de chemin d'accès parent
. Format : conferenceRecords/{conferenceRecord}
.
La méthode renvoie une liste des transcriptions de la conférence, classées par ordre croissant de startTime
, sous la forme d'une instance de ressource transcripts
. Pour ajuster la taille de la page, consultez Personnaliser la pagination .
L'exemple de code suivant montre comment lister toutes les transcriptions d'un enregistrement de conférence :
Java
Node.js
Python
Remplacez la valeur parente par le nom de l'enregistrement de la conférence.
Entrées de transcription
Les sections suivantes expliquent comment obtenir la parole de chaque participant sous forme d'entrées de transcription lors d'une session de transcription de conférence.
L'entrée de transcription contient le texte transcrit de la voix du participant, jusqu'à un maximum de 10 000 mots. Le texte prononcé languageCode
(par exemple, en-US
) est également inclus en syntaxe IETF BCP 47.
Chaque entrée de transcription est associée à un nom participant
dans la conférence. Pour récupérer les informations d'un participant, consultez Obtenir des informations sur un participant.
Les données de transcription sont disponibles pendant 30 jours après la fin de la conférence.
Notez que les entrées de transcription renvoyées par l'API REST Meet ne correspondent pas forcément à la transcription figurant dans le fichier de transcription Docs. Cela se produit lorsque le fichier de transcription est modifié après sa génération.
Obtenir des informations sur une entrée de transcription
Pour obtenir des détails sur une entrée de transcription spécifique, utilisez la méthode get()
sur la ressource transcripts.entries
avec le paramètre de chemin d'accès name
. Si vous ne connaissez pas le nom de l'entrée de transcription, vous pouvez lister tous les noms de transcriptions à l'aide de la méthode list()
.
La méthode renvoie une instance d'une ressource transcripts.entries
.
L'exemple de code suivant montre comment récupérer une entrée de transcription spécifique :
Java
Node.js
Python
Remplacez le nom de l'entrée de transcription par l'ID de l'entrée de transcription spécifique dans une transcription.
Lister toutes les entrées de transcription
Pour lister les détails de toutes les entrées de transcription dans une transcription, utilisez la méthode list()
sur la ressource transcripts.entries
avec le paramètre de chemin d'accès parent
. Format : conferenceRecords/{conferenceRecord}/transcripts/{transcript}
.
La méthode renvoie une liste d'entrées de transcription structurées par transcription de conférence, triées par startTime
par ordre croissant, sous la forme d'une instance de ressource transcripts.entries
. Pour ajuster la taille de la page, consultez Personnaliser la pagination .
L'exemple de code suivant montre comment lister toutes les entrées de transcription dans une transcription :
Java
Node.js
Python
Remplacez la valeur parente par le nom de l'enregistrement de la conférence et le nom de la transcription.
Personnaliser la pagination
Transmettez les paramètres de requête suivants pour personnaliser la pagination des enregistrements, des transcriptions et des entrées de transcription :
pageSize
: nombre maximal d'éléments à renvoyer. Le service peut renvoyer une valeur inférieure à celle-ci. Si aucune valeur n'est spécifiée, 10 éléments au maximum sont renvoyés. La valeur maximale est 100. Les valeurs supérieures à 100 sont automatiquement ramenées à 100.pageToken
: jeton de page reçu d'un appel de liste précédent. Fournissez ce jeton pour récupérer la page suivante.
Articles associés
- Enregistrer une visioconférence
- Utiliser les transcriptions avec Google Meet
- Conserver les données Google Meet avec Vault
- Personnaliser les fonctionnalités Meet en tant qu'administrateur