Uczestnik to osoba, która dołączyła do rozmowy lub korzysta z trybu towarzyszącego, ogląda jako widz lub jest użytkownikiem urządzenia w sali konferencyjnej połączonej z rozmową. Każda osoba ma do dyspozycji jeden zasób:
conferenceRecords.participants
Sesja uczestnika to unikalny identyfikator sesji utworzony dla każdej pary uczestnik–urządzenie, która dołącza do rozmowy.
W przypadku każdej sesji jest jeden zasób conferenceRecords.participants.participantSessions
. Jeśli uczestnik dołącza do tego samego połączenia kilka razy z tego samego urządzenia, każdemu z tych połączeń przypisany jest unikalny identyfikator sesji.
Na tej stronie znajdziesz informacje o tym, jak uzyskać informacje o wszystkich uczestnikach, którzy uczestniczyli w konferencji lub są w niej, a także o pojedynczym uczestniku wraz z informacjami o sesji.
Uczestnicy
W poniższych sekcjach znajdziesz szczegółowe informacje o tym, jak uzyskać informacje o uczestnikach.
Zasób conferenceRecords.participants
zawiera pole user
. user
może być tylko jednym z tych obiektów:
signedinUser
może być:Osoba dołączająca z komputera osobistego, urządzenia mobilnego lub w trybie Companion.
Konto robota używane przez urządzenia w salach konferencyjnych.
anonymousUser
to niezidentyfikowany użytkownik, który nie jest zalogowany na konto Google.phoneUser
to użytkownik dzwoniący z telefonu, którego tożsamość jest nieznana, ponieważ nie jest zalogowany na konto Google.
Wyszukaj wszystkich uczestników
Aby uzyskać szczegółowe informacje o wszystkich uczestnikach w rekordzie konferencji, użyj metody list()
w zasobach conferenceRecords.participants
z parametrem ścieżki parent
.
Za pomocą pól earliestStartTime
lub latestEndTime
możesz filtrować użytkowników, którzy dołączyli przed określonym czasem lub opuścili po nim. Oba pola używają formatu sygnatury czasowej w formacie RFC 3339
UTC „Zulu”, z dokładnością do nanosekund i maksymalnie 9 cyfr po przecinku:
{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
. Na przykład:
earliestStartTime < 2023-10-01T15:01:23Z
latestEndTime < 2023-10-01T15:01:23Z
Aby uzyskać listę aktywnych uczestników w istniejącej konferencji, użyj polecenia latestEndTime IS
NULL
.
Metoda zwraca listę uczestników konferencji uporządkowaną według czasu dołączenia w kolejności malejącej jako instancja zasobu conferenceRecords.participants
.
Poniższy przykładowy kod pokazuje, jak wyświetlić wszystkich uczestników w rekordzie konferencji:
Java
Node.js
Python
Zastąp wartość nadrzędną nazwą rekordu konferencji.
Wyszukiwanie konkretnego uczestnika
Aby wyszukać konkretnego uczestnika, użyj metody get()
w zasobie conferenceRecords.participants
z parametrem ścieżki name
. Aby pobrać nazwę uczestnika, użyj metody conferenceRecords.participants.list
.
Metoda zwraca nazwę uczestnika jako instancję zasobu conferenceRecords.participants
.
Poniższy przykładowy kod pokazuje, jak pobrać konkretnego uczestnika:
Java
Node.js
Python
Zastąp nazwę uczestnika nazwą konkretnego uczestnika, którego chcesz znaleźć.
Sesje uczestników
W poniższych sekcjach znajdziesz szczegółowe informacje o tym, jak uzyskać informacje o sesjach uczestników.
Wyszukaj wszystkie sesje uczestników
Aby uzyskać szczegółowe informacje o wszystkich sesjach uczestnika w rekordzie konferencji, użyj metody list()
w zasobach conferenceRecords.participants.participantSessions
z parametrem ścieżki parent
.
Za pomocą pól startTime
lub endTime
możesz filtrować użytkowników, którzy dołączyli do grupy przed określonym czasem lub opuścili ją po tym czasie. Oba pola używają formatu sygnatury czasowej w formacie RFC
3339 UTC
„Zulu”, z dokładnością do nanosekund i maksymalnie 9 cyfr po przecinku:
{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
. Na przykład:
startTime < 2023-10-01T15:01:23Z
endTime < 2023-10-01T15:01:23Z
Metoda zwraca listę sesji uczestników, posortowaną według czasu dołączenia w kolejności malejącej, jako instancję zasobu conferenceRecords.participants.participantSession
.
Poniższy przykładowy kod pokazuje, jak wyświetlić wszystkie sesje uczestników w rekordzie konferencji:
Java
Node.js
Python
Zastąp wartość nadrzędną nazwą rekordu konferencji i nazwą uczestnika.
Wyszukiwanie konkretnej sesji uczestnika
Aby wyszukać konkretną sesję uczestnika, użyj metody get()
zasobu conferenceRecords.participants.participantSessions
z parametrem ścieżki name
. Aby pobrać nazwę uczestnika, użyj metody list()
.
Metoda zwraca nazwę uczestnika jako instancję zasobu conferenceRecords.participants.participantSessions
.
Poniższy przykładowy kod pokazuje, jak pobrać konkretną sesję uczestnika:
Java
Node.js
Python
Zastąp nazwę uczestnika nazwą konkretnego uczestnika, którego chcesz znaleźć.
Pobieranie szczegółów uczestników za pomocą interfejsu People API
Aby pobrać szczegóły dotyczące uczestnika, użyj metody people.get
w interfejsie People API.
- Wyodrębnij identyfikator osoby z nazwy zasobu uczestnika, używając ostatniego elementu ścieżki. Jeśli na przykład nazwa zasobu uczestnika to
conferenceRecords/abc-123/participants/12345
, identyfikator interfejsu People API to12345
. - Uwzględnij źródła
READ_SOURCE_TYPE_PROFILE
,READ_SOURCE_TYPE_CONTACT
iREAD_SOURCE_TYPE_OTHER_CONTACT
. Dzięki temu w odpowiedzi będą uwzględnieni zarówno użytkownicy wewnętrzni organizacji Google Workspace, jak i kontakty zewnętrzne.
W tym przykładzie wyszukiwane są zarówno profile organizacji, jak i kontakty danej osoby:
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