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 d'autres artefacts, comme les transcriptions.
Pour générer 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 propriétaire ou participant à 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 à l'aide d'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.
Conservation des artefacts
À la fin d'une conférence, Meet enregistre les enregistrements et les transcriptions dans 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 d'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 à la fois 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 est généré et 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 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 afficher 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 parent
. Format : conferenceRecords/{conferenceRecord}
.
La méthode renvoie une liste d'enregistrements de conférence, classés par startTime
par ordre croissant, en tant qu'instance d'une 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'une 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érence dans un enregistrement de conférence.
Meet a accès à l'ID de la transcription une fois que les données de la transcription sont 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 à la fois 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 extraire 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. Vous pouvez ainsi 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 est généré et 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 name
. Si vous ne connaissez pas le nom de la transcription, vous pouvez lister tous les noms de transcription à 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 afficher 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 parent
. Format : conferenceRecords/{conferenceRecord}
.
La méthode renvoie une liste de transcriptions de conférence, triées par startTime
par ordre croissant, en tant qu'instance d'une 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.
Captures de la 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.
La transcription contient le texte transcrit de la voix du participant, jusqu'à 10 000 mots maximum. Le texte parlé languageCode
(par exemple, en-US
) est également inclus en tant que syntaxe IETF BCP 47.
Chaque entrée de la transcription est associée à un nom participant
dans la conférence. Pour récupérer les informations sur un participant, consultez Obtenir des informations sur un participant.
Les données de saisie de la transcription sont disponibles pendant 30 jours après la fin de la conférence.
Notez que les entrées de la transcription renvoyées par l'API REST Meet peuvent ne pas correspondre à la transcription trouvée 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 name
. Si vous ne connaissez pas le nom de l'entrée de la transcription, vous pouvez lister tous les noms de transcription à 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 la transcription par le nom de l'ID d'entrée de la transcription spécifique dans une transcription.
Répertorier toutes les entrées de la transcription
Pour afficher les détails de toutes les entrées de transcription d'une transcription, utilisez la méthode list()
sur la ressource transcripts.entries
avec le paramètre de chemin 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
dans l'ordre croissant, en tant qu'instance d'une 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 un nombre inférieur à cette valeur. 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 remplacées par 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 des données Google Meet avec Vault
- Personnaliser les fonctionnalités Meet en tant qu'administrateur