Este documento explica como receber 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 dado gerado pelo Google Meet em resposta a uma conferência. Isso inclui gravações de vídeo e outros artefatos, como transcrições.
Para produzir materiais, os participantes precisam configurá-los no Meet antes do fim da conferência. Para mais informações, consulte Gerenciar artefatos automáticos.
As transcrições funcionam de forma independente das gravações, e não é necessário gravar a reunião para gerar uma transcrição. Quando todos os participantes saem da reunião, a transcrição é interrompida automaticamente. Para mais informações, consulte Gravar uma videochamada e Usar transcrições com o Google Meet.
Recuperar artefatos
Se você for proprietário ou participante de um espaço para reuniões, poderá chamar os métodos get e list nos recursos recordings, transcripts, transcripts.entries e smart notes para recuperar artefatos. Para saber mais, consulte as seguintes seções.
A autenticação e a autorização com credenciais de usuário permitem que os apps do Meet acessem dados do usuário e realizem operações em nome do usuário autenticado. A autenticação com delegação em todo o domínio permite autorizar a conta de serviço de um aplicativo a acessar os dados dos usuários sem precisar pedir o consentimento de cada um.
Retenção de artefatos
Depois que uma conferência termina, o Meet salva as 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 obter 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 seja retornado no Meet.
O recurso
recordings
inclui os objetos
DriveDestination
e
State.
O objeto DriveDestination contém o local de exportação no Drive
em que a gravação é salva como um arquivo MP4. Para baixar a 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 campo
id no
recurso files. Para mais informações, consulte Fazer o download e exportar arquivos.
O objeto State contém o status da sessão de gravação. Assim, é possível
consultar se a gravação começou, se ela terminou, mas o arquivo
ainda não está pronto, ou se o arquivo foi gerado e está pronto para download.
Receber detalhes sobre uma gravação
Para ver 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,
liste todos os nomes de gravação 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 ID específico em um registro 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. O formato é
conferenceRecords/{conferenceRecord}.
O método retorna uma lista de gravações de conferências, ordenadas por startTime em ordem crescente, como uma instância de um recurso recordings. Para ajustar o tamanho da página, consulte Personalizar 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 "parent" pelo nome do registro da conferência.
Transcrições
As seções a seguir detalham como receber informações sobre transcrições de conferências em um registro de conferência.
O Meet tem acesso ao ID da transcrição assim que os dados dela são gerados. É possível que um usuário exclua o arquivo de transcrição do Drive, mas o nome exclusivo ainda seja retornado no Meet.
O recurso
transcripts
inclui os objetos
DocsDestination
e
State.
O objeto DocsDestination contém o local de exportação no Drive
onde o arquivo de transcrição do Google Docs é 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 ao
documentId
no recurso documents.
O objeto State contém o status da sessão de transcrição. Assim, você pode
consultar se a sessão de transcrição foi iniciada, se ela 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.
Receber detalhes sobre uma transcrição
Para ver 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, liste 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 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. O 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 "parent" 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 de transcrição contém o texto transcrito da voz do participante, até 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 participant na conferência. Para
recuperar 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 término 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 Google Docs. Isso acontece quando o arquivo de transcrição é modificado após a geração.
Receber detalhes sobre uma entrada de transcrição
Para ver 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 de transcrição, liste todos os nomes de entrada 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 de transcrição pelo ID específico em uma transcrição.
Listar todas as entradas de 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. O 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 paginação .
O exemplo de código a seguir mostra como listar todas as entradas de transcrição em uma transcrição:
Java
Node.js
Python
Substitua o valor "parent" pelo nome do registro da conferência e da transcrição.
Notas inteligentes
As seções a seguir detalham como receber informações sobre anotações inteligentes de conferências em um registro de conferência.
O Meet tem acesso ao ID da observação inteligente assim que os dados dela são gerados. É possível que um usuário exclua o arquivo de anotações inteligentes do Drive, mas o nome exclusivo ainda seja retornado no Meet.
O recurso smartNotes
inclui o objeto State.
Esse objeto contém o status da sessão de Minuta inteligente. Isso permite consultar se a sessão de Minuta inteligente foi iniciada, se ela terminou, mas o arquivo ainda não está pronto, ou se o arquivo foi gerado e está pronto para download.
O recurso smartNotes também inclui o tipo de objeto
DocsDestination. Esse objeto contém o local de exportação no Drive em que o arquivo de anotações inteligentes do Google Docs é salvo. Para buscar o conteúdo ou navegar pelas Minutas inteligentes em um navegador, use o valor do campo
exportUri do objeto. Se você conhece a API Google Docs, o valor do campo
document
corresponde ao
documentId
no recurso documents.
É possível gerenciar as notas inteligentes usando os métodos get e
list.
Receber detalhes sobre as notas inteligentes
Para ver detalhes sobre um arquivo de anotações inteligentes específico, use o método
get no recurso
smartNotes com
o parâmetro de caminho name. Se você não souber o nome das anotações inteligentes, liste
todos os arquivos de anotações inteligentes usando o método list.
O método retorna uma instância de um recurso smartNotes.
Listar todas as notas inteligentes
Para listar detalhes sobre todos os arquivos de anotações inteligentes em um registro de conferência, use o método
list no recurso
smartNotes com
o parâmetro de caminho parent. O formato é
conferenceRecords/{conferenceRecord}.
O método retorna uma lista de arquivos de anotações inteligentes de conferências, ordenados por
startTime em ordem crescente, como uma instância de um recurso smartNotes. Para ajustar o tamanho da página, consulte Personalizar paginação .
Personalizar 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 acima disso são automaticamente alterados para 100.pageToken: um token de página recebido de uma chamada de lista anterior. Informe esse token para recuperar a página seguinte.