Neste guia, explicamos 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 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 de forma independente das gravações, e não é necessário gravar a reunião para gerar uma transcrição. Para mais informações, consulte Gravar uma video chamada e Usar transcrições com o Google Meet.
Se você é proprietário ou participante de um espaço de reunião, pode chamar os métodos get()
e list()
nos recursos recordings
, transcripts
e transcripts.entries
para recuperar artefatos.
A autenticação e a autorização com credenciais de usuário permitem 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 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 deles.
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 id
no recurso files
. Para
mais informações, consulte
Fazer download e exportar arquivos.
O objeto State
contém o status da sessão de gravação. Assim, você pode
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çõ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 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
. 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 dos 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 ao documentId
no recurso documents
.
O objeto State
contém o status da sessão de transcrição. Assim, é possível
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
. 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 de 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 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
. 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 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.
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 subsequente.
Temas relacionados
- Gravar uma videochamada
- Usar transcrições com o Google Meet
- Reter dados do Google Meet com o Vault
- Personalizar recursos do Meet como administrador