Um participante é uma pessoa que participa de uma
chamada ou que usa o modo
Companion, assistindo como espectador ou
um dispositivo de sala conectado a uma chamada. Há um recurso
conferenceRecords.participants
para cada pessoa.
Uma sessão de participante é um
ID de sessão exclusivo criado para cada par de participante-dispositivo que entra em uma chamada.
Há um recurso
conferenceRecords.participants.participantSessions
para cada sessão. Se o participante entrar na mesma chamada várias vezes
usando o mesmo par de dispositivo e participante, cada um deles vai receber IDs de sessão exclusivos.
Nesta página, descrevemos como consultar todos os participantes que participaram ou estão em uma conferência ou apenas um único participante, além das informações da sessão.
Participantes
As seções a seguir detalham como receber informações sobre os participantes.
O recurso conferenceRecords.participants
inclui o campo user
. Um user
pode ser apenas um dos seguintes
objetos:
Um
signedinUser
pode ser:Um indivíduo que participa usando um computador pessoal, um dispositivo móvel ou no modo companion.
Uma conta de robô usada por dispositivos de sala de conferências.
Um
anonymousUser
é um usuário não identificado que não fez login em uma Conta do Google.Um
phoneUser
é um usuário ligando para a reunião usando um smartphone em que a identidade é desconhecida porque não fez login com uma Conta do Google.
Pesquisar todos os participantes
Para acessar detalhes sobre todos os participantes em um registro de videoconferência, use o método
list()
no recurso
conferenceRecords.participants
com o parâmetro de caminho parent
.
Use os campos earliestStartTime
ou latestEndTime
para filtrar por
usuários que entraram antes ou saíram depois de um determinado período. Ambos os campos usam o formato Timestamp no formato UTC "Zulu" RFC 3339, com resolução de nanossegundos e até nove dígitos fracionários: {year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
. Exemplo:
earliestStartTime < 2023-10-01T15:01:23Z
latestEndTime < 2023-10-01T15:01:23Z
Para ter participantes ativos em uma videoconferência, use latestEndTime IS
NULL
.
O método retorna uma lista de participantes da videoconferência, ordenados por horário de entrada em
ordem decrescente, como uma instância de um recurso conferenceRecords.participants
.
O exemplo de código a seguir mostra como listar todos os participantes em uma gravação de conferência:
Java
Node.js
Python
Substitua o valor pai pelo nome do registro da videoconferência.
Pesquisar um participante específico
Para pesquisar um participante específico, use o método
get()
no recurso
conferenceRecords.participants
com o parâmetro de caminho name
. Para recuperar o nome do
participante, use o método conferenceRecords.participants.list
.
O método retorna um nome de participante como uma instância de um
recurso conferenceRecords.participants
.
O exemplo de código a seguir mostra como recuperar um participante específico:
Java
Node.js
Python
Substitua o nome do participante pelo nome do participante específico que você quer encontrar.
Sessões dos participantes
As seções a seguir detalham como acessar informações sobre as sessões dos participantes.
Pesquisar todas as sessões dos participantes
Para conferir detalhes sobre todas as sessões de um participante em um registro
de videoconferência, use o método
list()
no recurso
conferenceRecords.participants.participantSessions
com o parâmetro de caminho parent
.
Você pode usar os campos startTime
ou endTime
para filtrar por usuários que entraram antes ou saíram depois de um determinado período. Ambos os campos usam o formato Timestamp no formato RFC 3339 UTC, "Zulu", com resolução de nanossegundos e até nove dígitos fracionários: {year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
. Exemplo:
startTime < 2023-10-01T15:01:23Z
endTime < 2023-10-01T15:01:23Z
O método retorna uma lista de sessões dos participantes, ordenadas pelo horário de entrada em
ordem decrescente, como uma instância de um
recurso conferenceRecords.participants.participantSession
.
O exemplo de código a seguir mostra como listar todas as sessões de participantes em um registro de conferência:
Java
Node.js
Python
Substitua o valor pai pelo nome do registro da conferência e pelo nome do participante.
Pesquisar uma sessão de participante específica
Para pesquisar uma sessão de participante específica, use o método
get()
no recurso
conferenceRecords.participants.participantSessions
com o parâmetro de caminho name
. Para recuperar o nome do
participante, use o método list()
.
O método retorna um nome de participante como uma instância de um
recurso conferenceRecords.participants.participantSessions
.
O exemplo de código a seguir mostra como recuperar uma sessão de participante específica:
Java
Node.js
Python
Substitua o nome do participante pelo nome do participante específico que você quer encontrar.