Ce document 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 enregistrements vidéo et d'autres artefacts, comme les transcriptions.
Pour générer des artefacts, les participants doivent les configurer dans Meet avant la fin de la conférence. Pour en savoir plus, consultez Gérer les artefacts automatiques.
Les transcriptions fonctionnent indépendamment des enregistrements. Vous n'avez pas besoin d'enregistrer la réunion pour générer une transcription. Lorsque tous les participants quittent la réunion, la transcription s'arrête automatiquement. Pour en savoir plus, consultez Enregistrer une visioconférence et Utiliser les transcriptions avec Google Meet.
Récupérer des artefacts
Si vous êtes propriétaire ou participant d'un espace de réunion, vous pouvez appeler les méthodes get et list sur les ressources recordings, transcripts, transcripts.entries et smart notes pour récupérer les artefacts. Pour en savoir plus, consultez les sections suivantes.
L'authentification et l'autorisation avec les identifiants utilisateur permettent aux applications 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 à celle du champ 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. Il a le format suivant : 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. Il a le format suivant : 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 d'entrées 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 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, utilisez la méthode list sur la ressource transcripts.entries avec le paramètre de chemin d'accès parent. Il a le format suivant : 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.
Notes intelligentes
Les sections suivantes expliquent comment obtenir des informations sur les notes intelligentes de réunion dans un enregistrement de réunion.
Meet a accès à l'ID de la note intelligente une fois que les données de la note intelligente sont générées. Il est possible qu'un utilisateur supprime le fichier de notes intelligentes de Drive, mais que le nom unique soit toujours renvoyé dans Meet.
La ressource smartNotes inclut l'objet State.
Cet objet contient l'état de la session de notes intelligentes. Cela vous permet de savoir si la session de notes intelligentes a commencé, si elle s'est terminée mais que le fichier de notes intelligentes n'est pas prêt, ou si le fichier de notes intelligentes a été généré et est prêt à être téléchargé.
La ressource smartNotes inclut également le type d'objet DocsDestination. Cet objet contient l'emplacement d'exportation dans Drive où le fichier de notes intelligentes Google Docs est enregistré. Pour récupérer le contenu ou parcourir les notes intelligentes 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.
Vous pouvez gérer les notes intelligentes à l'aide des méthodes get et list.
Obtenir des informations sur les notes intelligentes
Pour obtenir des détails sur un fichier de notes intelligentes spécifique, utilisez la méthode get sur la ressource smartNotes avec le paramètre de chemin d'accès name. Si vous ne connaissez pas le nom de la note intelligente, vous pouvez lister tous les fichiers de notes intelligentes à l'aide de la méthode list.
La méthode renvoie une instance d'une ressource smartNotes.
Lister toutes les notes intelligentes
Pour lister les détails de tous les fichiers de notes intelligentes d'un enregistrement de conférence, utilisez la méthode list sur la ressource smartNotes avec le paramètre de chemin d'accès parent. Il a le format suivant : conferenceRecords/{conferenceRecord}.
La méthode renvoie une liste de fichiers de notes intelligentes de conférence, triés par startTime dans l'ordre croissant, sous la forme d'une instance de ressource smartNotes. Pour ajuster la taille de la page, consultez Personnaliser la pagination .
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 de 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.