Este guia explica como conferir detalhes sobre os diferentes artefatos de reunião gerados por uma conferência usando a API REST do Google Meet.
Um artefato é um arquivo ou dados gerados pelo Google Meet em resposta a uma conferência. Isso inclui vídeos e outros artefatos, como transcrições.
Para produzir artefatos, os participantes precisam gerá-los no Meet antes do fim da conferência. As transcrições funcionam independentemente das gravações, e você não precisa gravar a reunião para gerar uma transcrição. Para mais informações, consulte Gravar uma videochamada e Usar as transcrições com o Google Meet.
Se você for proprietário ou participante do espaço de reunião, poderá chamar os métodos get()
e
list()
nos recursos recordings
, transcripts
e
transcripts.entries
para recuperar artefatos.
A autenticação e autorização com credenciais de usuário permite que os apps do Google Meet acessem dados do usuário e realizem operações em nome do usuário autenticado. A autenticação com a delegação em todo o domínio permite autorizar a conta de serviço de um aplicativo a acessar os dados dos seus usuários sem precisar de consentimento.
Retenção de artefatos
Depois que uma conferência termina, o Meet salva gravações e transcrições no Google Drive do organizador da reunião. Por padrão, os artefatos do Meet são retidos de acordo com as regras do Drive.
As entradas de transcrição fornecidas pela API REST do Meet são excluídas 30 dias após o fim da conferência.
Você também pode gerenciar a retenção de artefatos do Meet separadamente usando regras de retenção específicas do Meet no Google Vault. Para mais informações, consulte Reter dados do Google Meet com o Vault.
Gravações
As seções a seguir detalham como receber informações sobre gravações em um registro de conferência.
O Meet tem acesso ao ID da gravação depois que o arquivo é gerado. É possível que um usuário exclua o arquivo de gravação do Google Drive, mas o nome exclusivo ainda é retornado no Meet.
O recurso recordings
inclui os objetos
DriveDestination
e
State
.
O objeto DriveDestination
contém o local de exportação no Drive,
onde a gravação é salva como um arquivo MP4. Para fazer o download da gravação ou
reproduzi-la em um navegador, use o valor do campo exportUri
do objeto. Se você
conhece a API Google Drive, o valor do campo file
corresponde ao id
no recurso files
. Para mais
informações, consulte Fazer o download e exportar
arquivos.
O objeto State
armazena o status da sessão de gravação. Isso permite
consultar se a gravação foi iniciada, se a gravação foi encerrada, mas o arquivo
não está pronto ou se o arquivo de gravação foi gerado e está pronto para download.
Receber detalhes sobre uma gravação
Para conferir detalhes sobre uma gravação específica, use o método
get()
no recurso recordings
com o parâmetro de caminho name
. Se você não souber o nome da gravação,
listar todos os nomes de gravações usando o método list()
.
O método retorna uma instância de um recurso recordings
.
O exemplo de código a seguir mostra como recuperar uma gravação específica:
Java
Node.js
Python
Substitua o nome da gravação pelo nome do ID específico em uma gravação de conferência.
Listar todas as gravações
Para listar detalhes sobre todas as gravações em um registro de conferência, use o método
list()
no recurso recordings
com o parâmetro de caminho parent
. Formato:
conferenceRecords/{conferenceRecord}
.
O método retorna uma lista de gravações de conferência, ordenadas por startTime
em
ordem crescente, como uma instância de um recurso recordings
. Para ajustar o tamanho da página, consulte Personalizar a paginação .
O exemplo de código a seguir mostra como listar todas as gravações em um registro de conferência:
Java
Node.js
Python
Substitua o valor pai pelo nome do registro da conferência.
Transcrições
As seções a seguir detalham como receber informações sobre as transcrições de conferência em um registro de conferência.
O Meet tem acesso ao ID da transcrição quando os dados da transcrição são gerados. É possível que um usuário exclua o arquivo de transcrição do Drive, mas o nome exclusivo ainda é retornado no Meet.
O recurso transcripts
inclui os objetos
DocsDestination
e
State
.
O objeto DocsDestination
contém o local de exportação no Drive
em que o arquivo de transcrição do Documentos Google é salvo. Para buscar o conteúdo ou
navegar pela transcrição em um navegador, use o valor do campo exportUri
do objeto. Se
você conhece a API Google Docs, o valor do campo document
corresponde a
documentId
no recurso
documents
.
O objeto State
armazena o status da sessão de transcrição. Isso permite
consultar se a sessão de transcrição foi iniciada, se a sessão de transcrição foi encerrada, mas o arquivo de transcrição não está pronto ou se o arquivo de transcrição foi gerado e
está pronto para download.
Conferir detalhes de uma transcrição
Para conferir detalhes sobre uma transcrição específica, use o método
get()
no recurso
transcripts
com o parâmetro de caminho name
. Se você não souber o nome da transcrição,
é possível listar todos os nomes de transcrição usando o método
list()
.
O método retorna uma instância de um recurso transcripts
.
O exemplo de código a seguir mostra como recuperar uma transcrição específica:
Java
Node.js
Python
Substitua o nome da transcrição pelo nome do ID específico em um registro de conferência.
Listar todas as transcrições
Para listar detalhes sobre todas as transcrições em um registro de conferência, use o método
list()
no recurso
transcripts
com o parâmetro de caminho parent
. Formato:
conferenceRecords/{conferenceRecord}
.
O método retorna uma lista de transcrições de conferências, ordenadas por startTime
em
ordem crescente, como uma instância de um recurso transcripts
. Para ajustar o tamanho da
página, consulte Personalizar paginação .
O exemplo de código a seguir mostra como listar todas as transcrições em um registro de conferência:
Java
Node.js
Python
Substitua o valor pai pelo nome do registro da conferência.
Entradas de transcrição
As seções a seguir detalham como receber a fala de cada participante como entradas de transcrição durante uma sessão de transcrição de conferência.
A entrada da transcrição contém o texto transcrito da voz do participante, com um máximo de
10.000 palavras. O texto falado languageCode
(por exemplo, en-US
)
também é incluído como sintaxe IETF BCP 47.
Cada entrada de transcrição está conectada a um nome de participant
na conferência. Para
recuperar os detalhes do participante, consulte Receber detalhes sobre um
participante.
Os dados de entrada da transcrição ficam disponíveis por 30 dias após o fim da conferência.
As entradas de transcrição retornadas pela API REST do Meet podem não corresponder à transcrição encontrada no arquivo de transcrição do Documentos. Isso ocorre quando o arquivo de transcrição é modificado após a geração.
Conferir detalhes sobre uma entrada de transcrição
Para conferir detalhes sobre uma entrada de transcrição específica, use o método
get()
no recurso
transcripts.entries
com o parâmetro de caminho name
. Se você não souber o nome da entrada da transcrição, listar todos os nomes de transcrição usando o método list()
.
O método retorna uma instância de um recurso transcripts.entries
.
O exemplo de código a seguir mostra como recuperar uma entrada de transcrição específica:
Java
Node.js
Python
Substitua o nome da entrada da transcrição pelo nome do ID da entrada da transcrição específica em uma transcrição.
Listar todas as entradas da transcrição
Para listar detalhes sobre todas as entradas de transcrição em uma transcrição, use o método
list()
no recurso
transcripts.entries
com o parâmetro de caminho parent
. Formato:
conferenceRecords/{conferenceRecord}/transcripts/{transcript}
.
O método retorna uma lista de entradas de transcrição estruturadas por transcrição
de conferência, ordenadas por startTime
em ordem crescente, como uma instância de um
recurso transcripts.entries
. Para ajustar o tamanho da página, consulte Personalizar
a paginação .
O exemplo de código abaixo mostra como listar todas as entradas de transcrição em uma transcrição:
Java
Node.js
Python
Substitua o valor pai pelo nome do registro de conferência e da transcrição.
Personalizar a paginação
Transmita os seguintes parâmetros de consulta para personalizar a paginação de gravações, transcrições e entradas de transcrição:
pageSize
: o número máximo de itens a serem retornados. O serviço pode retornar menos que esse valor. Se não for especificado, no máximo 10 itens serão retornados. O valor máximo é 100. Valores maiores que 100 são automaticamente alterados para 100.pageToken
: um token de página recebido de uma chamada de lista anterior. Informe este token para recuperar a página seguinte.
Temas relacionados
- Gravar uma videochamada
- Usar transcrições com o Google Meet
- Reter dados do Google Meet com o Vault
- Personalizar os recursos do Meet como administrador