Um participante é uma pessoa que entrou em 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
do mesmo par de participante-dispositivo, cada um deles receberá IDs de sessão exclusivos.
Esta página descreve como receber informações sobre todos os participantes que compareceram ou estão em uma conferência ou sobre apenas um 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:Uma pessoa que participa de um computador pessoal, um dispositivo móvel ou pelo 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 que está ligando de um telefone em que a identidade é desconhecida porque ele não fez login com uma Conta do Google.
Pesquisar todos os participantes
Para conferir detalhes sobre todos os participantes em um registro de conferência, use o método
list()
no recurso
conferenceRecords.participants
com o parâmetro de caminho parent
.
É possível usar os campos earliestStartTime
ou latestEndTime
para filtrar os usuários que entraram antes ou saíram depois de um determinado período. Ambos os campos usam o formato
Carimbo de data/hora
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 conferir os participantes ativos em uma conferência, use latestEndTime IS
NULL
.
O método retorna uma lista de participantes da conferência, ordenada por horário de entrada em
ordem decrescente, como uma instância de um recurso conferenceRecords.participants
.
O exemplo de código abaixo mostra como listar todos os participantes em um registro de conferência:
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 método
get()
no recurso
conferenceRecords.participants
com o parâmetro de caminho name
. Para extrair 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 de 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 conferir detalhes sobre todas as sessões de um participante em um registro de
conferência, use o método
list()
no recurso
conferenceRecords.participants.participantSessions
com o parâmetro de caminho parent
.
É possível usar os campos startTime
ou endTime
para filtrar usuários que entraram antes ou saíram depois de um determinado período. Ambos os campos usam o formato
Carimbo de data/hora
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:
startTime < 2023-10-01T15:01:23Z
endTime < 2023-10-01T15:01:23Z
O método retorna uma lista de sessões de participantes, ordenadas por horário de participação em
ordem decrescente, como uma instância de um
recurso conferenceRecords.participants.participantSession
.
O exemplo de código abaixo 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 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 extrair 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 abaixo 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.
Extrair detalhes do participante com a API People
Para extrair 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
for
conferenceRecords/abc-123/participants/12345
, o ID da API People será12345
. - Inclua as fontes
READ_SOURCE_TYPE_PROFILE
,READ_SOURCE_TYPE_CONTACT
eREAD_SOURCE_TYPE_OTHER_CONTACT
. Isso garante que os usuários internos de uma organização do Google Workspace e os contatos externos sejam incluídos na resposta.
O exemplo a seguir pesquisa perfis de organização e contatos de uma 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