Участник — это человек, присоединившийся к вызову или использующий режим 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
Питон
Замените имя участника именем конкретного участника, которого нужно найти.
Получение сведений об участниках с помощью People API
Чтобы получить сведения об участнике, используйте метод people.get
в People API .
- Извлеките идентификатор человека из имени ресурса участника, используя конечный компонент пути. Например, если имя ресурса участника —
conferenceRecords/abc-123/participants/12345
идентификатор People API —12345
. - Включите источники
READ_SOURCE_TYPE_PROFILE
,READ_SOURCE_TYPE_CONTACT
иREAD_SOURCE_TYPE_OTHER_CONTACT
. Это гарантирует, что в ответ будут включены как внутренние пользователи организации Google Workspace, так и внешние контакты.
В следующем примере выполняется поиск как в профилях организации, так и в контактах человека:
КУЛЬ
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