Участник — это человек, присоединившийся к вызову или использующий режим Companion , наблюдающий за происходящим в качестве зрителя, или устройство в комнате, подключенное к вызову. Для каждого человека имеется один ресурс conferenceRecords.participants
.
Сеанс участника — это уникальный идентификатор сеанса, созданный для каждой пары участник-устройство, которая присоединяется к вызову. Для каждого сеанса существует один ресурс conferenceRecords.participants.participantSessions
. Если участник присоединяется к одному и тому же вызову несколько раз с одной и той же пары участник-устройство, каждому из них присваиваются уникальные идентификаторы сеанса.
На этой странице описано, как получить информацию обо всех участниках, которые присутствовали или находятся в конференции , или только об одном участнике, а также информацию об их сеансе.
Участники
В следующих разделах подробно описано, как получить информацию об участниках.
Ресурс conferenceRecords.participants
включает поле user
. user
может быть только одним из следующих объектов:
signedinUser
— это либо:Человек, присоединяющийся с персонального компьютера, мобильного устройства или через режим Companion.
Учетная запись робота, используемая устройствами конференц-зала.
anonymousUser
— это неопознанный пользователь, не вошедший в учетную запись Google.phoneUser
— это пользователь, звонящий с телефона, личность которого неизвестна, поскольку он не вошел в систему с помощью учетной записи Google.
Поиск всех участников
Чтобы получить подробную информацию обо всех участниках записи конференции, используйте метод list()
ресурса conferenceRecords.participants
с параметром parent
пути.
Вы можете использовать поля earliestStartTime
или latestEndTime
для фильтрации пользователей, которые присоединились до или ушли после определенного времени. В обоих полях используется формат отметки времени в формате RFC 3339 UTC «Zulu» с наносекундным разрешением и до девяти дробных цифр: {year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
. Например:
-
earliestStartTime < 2023-10-01T15:01:23Z
-
latestEndTime < 2023-10-01T15:01:23Z
Чтобы получить активных участников в существующей конференции, используйте latestEndTime IS NULL
.
Метод возвращает список участников конференции, упорядоченный по времени присоединения в порядке убывания, как экземпляр ресурса conferenceRecords.participants
.
В следующем примере кода показано, как составить список всех участников в записи конференции:
Джава
Node.js
Питон
Замените родительское значение именем записи конференции.
Поиск конкретного участника
Для поиска конкретного участника используйте метод get()
ресурса conferenceRecords.participants
с параметром пути name
. Чтобы получить имя участника, используйте метод conferenceRecords.participants.list
.
Метод возвращает имя участника как экземпляр ресурса conferenceRecords.participants
.
В следующем примере кода показано, как получить конкретного участника:
Джава
Node.js
Питон
Замените имя участника именем конкретного участника, которого нужно найти.
Сессии участников
В следующих разделах подробно описано, как получить информацию о сеансах участников.
Поиск всех сеансов участников
Чтобы получить подробную информацию обо всех сеансах участника в записи конференции, используйте метод list()
ресурса conferenceRecords.participants.participantSessions
с параметром parent
пути.
Вы можете использовать поля startTime
или endTime
для фильтрации пользователей, которые присоединились до или ушли после определенного времени. В обоих полях используется формат отметки времени в формате RFC 3339 UTC «Zulu» с наносекундным разрешением и до девяти дробных цифр: {year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
. Например:
-
startTime < 2023-10-01T15:01:23Z
-
endTime < 2023-10-01T15:01:23Z
Метод возвращает список сеансов участников, упорядоченных по времени присоединения в порядке убывания, как экземпляр ресурса conferenceRecords.participants.participantSession
.
В следующем примере кода показано, как составить список всех сеансов участников в записи конференции:
Джава
Node.js
Питон
Замените родительское значение именем записи конференции и именем участника.
Поиск конкретного участника сеанса
Для поиска конкретного сеанса участника используйте метод get()
ресурса conferenceRecords.participants.participantSessions
с параметром пути name
. Чтобы получить имя участника, используйте метод list()
.
Метод возвращает имя участника как экземпляр ресурса conferenceRecords.participants.participantSessions
.
В следующем примере кода показано, как получить сеанс конкретного участника:
Джава
Node.js
Питон
Замените имя участника именем конкретного участника, которого нужно найти.