Um participante é uma pessoa associada a um
chamada ou que use o modo Companion
, assistir como espectador ou
um dispositivo da sala conectado a uma chamada. Há um
conferenceRecords.participants
recurso para cada pessoa.
Uma sessão de participante é uma
um ID de sessão exclusivo criado para cada par de participante e dispositivo que entra em uma chamada.
Há um
conferenceRecords.participants.participantSessions
recurso para cada sessão. Se o participante entrar na mesma chamada várias vezes
do mesmo par de participante e dispositivo, eles recebem IDs de sessão exclusivos.
Esta página descreve como conseguir informações sobre todos os participantes que participaram ou estão em uma conferência, ou apenas sobre apenas um participante, junto com as informações da sessão.
Participantes
As seções a seguir detalham como conseguir informações sobre os participantes.
A
conferenceRecords.participants
inclui o campo user
. Um user
só pode ser um dos seguintes:
objetos:
Uma
signedinUser
é:Uma pessoa que participa usando um computador pessoal, um dispositivo móvel ou no modo companion.
Uma conta de robô usada por dispositivos de salas de conferências.
Um
anonymousUser
é um usuário não identificado que não fez login em uma Conta do Google.Uma
phoneUser
é um usuário que liga para a reunião de um telefone em que a identidade do usuário é desconhecida porque não fizeram login com uma Conta do Google.
Pesquisar todos os participantes
Para obter detalhes sobre todos os participantes em um registro de videoconferência, use o
list()
na classe
conferenceRecords.participants
recurso com o parâmetro de caminho parent
.
É possível usar os campos earliestStartTime
ou latestEndTime
para filtrar
usuários que entraram antes ou saíram depois de um determinado período. Ambos os campos usam o
Carimbo de data/hora
formato em 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:
earliestStartTime < 2023-10-01T15:01:23Z
latestEndTime < 2023-10-01T15:01:23Z
Para reunir participantes ativos em uma videoconferência, use latestEndTime IS
NULL
.
O método retorna uma lista de participantes da conferência, ordenada por horário de entrada
ordem decrescente, como uma instância de um recurso conferenceRecords.participants
.
O exemplo de código a seguir mostra como listar todos os participantes de uma conferência registrar:
Java
Node.js
Python
Substitua o valor pai pelo nome do registro da conferência.
Pesquisar um participante específico
Para pesquisar um participante específico, use o
get()
na classe
conferenceRecords.participants
recurso 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
conferenceRecords.participants
.
O exemplo de código abaixo mostra como recuperar um participante específico:
Java
Node.js
Python
Substitua o nome do participante pelo nome do participante específico a ser encontrado.
Sessões com participantes
As seções a seguir detalham como receber informações sobre as sessões dos participantes.
Pesquisar todas as sessões dos participantes
Para obter detalhes sobre todas as sessões de um participante em uma conferência
gravar, use o
list()
na classe
conferenceRecords.participants.participantSessions
recurso com o parâmetro de caminho parent
.
É possível usar os campos startTime
ou endTime
para filtrar os usuários que participaram
antes ou depois de um determinado período. Ambos os campos usam o
Carimbo de data/hora
em RFC
3.339 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, ordenada por horário de entrada
ordem decrescente, como uma instância de um
conferenceRecords.participants.participantSession
.
O exemplo de código a seguir mostra como listar todas as sessões dos participantes em uma registro da 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
get()
na classe
conferenceRecords.participants.participantSessions
recurso 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
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 a ser encontrado.
Recuperar detalhes dos participantes com a API People
Para recuperar detalhes sobre um participante, use o
Método people.get
na
API People.
- Extraia o ID da pessoa do nome do recurso do participante usando o
componente final do caminho. Por exemplo, se o nome do recurso do participante
é
conferenceRecords/abc-123/participants/12345
, que é o ID da A API People é12345
. - Inclui as origens
READ_SOURCE_TYPE_PROFILE
,READ_SOURCE_TYPE_CONTACT
, eREAD_SOURCE_TYPE_OTHER_CONTACT
. Isso garante que os usuários internos uma organização do Google Workspace e os contatos externos estão incluídos a resposta.
O exemplo a seguir pesquisa perfis e contatos da organização em busca de um pessoa:
cURL
curl \
'https://people.googleapis.com/v1/people/PERSON_ID?personFields=names%2CemailAddresses&sources=READ_SOURCE_TYPE_OTHER_CONTACT&sources=READ_SOURCE_TYPE_PROFILE&sources=READ_SOURCE_TYPE_CONTACT' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--header 'Accept: application/json' \
--compressed