Z tego przewodnika dowiesz się, jak za pomocą interfejsu Google Meet REST API uzyskać szczegółowe informacje o uczestnikach, którzy wzięli udział w zakończonej konferencji lub uczestniczą w aktywnej konferencji, a także informacje o ich sesjach.
Uczestnik to osoba, która dołączyła do połączenia lub korzysta z trybu towarzyszącego, ogląda spotkanie jako widz lub korzysta z urządzenia w sali połączonego z połączeniem. Każda osoba ma 1 participants
zasób.
Sesja uczestnika to unikalny identyfikator sesji utworzony dla każdej pary uczestnik–urządzenie, która dołącza do połączenia.
Każda sesja ma jeden zasób participantSessions
. Jeśli uczestnik dołączy do tego samego połączenia kilka razy z tej samej pary uczestnik–urządzenie, każda sesja otrzyma unikalny identyfikator.
Jeśli jesteś właścicielem lub uczestnikiem przestrzeni spotkań, możesz wywoływać metody get()
i list()
na zasobach participants
i participantSessions
, aby pobierać rekordy uczestników.
Uwierzytelnianie i autoryzacja za pomocą danych logowania użytkownika umożliwiają aplikacjom Google Meet dostęp do danych użytkownika i wykonywanie operacji w imieniu uwierzytelnionego użytkownika. Uwierzytelnianie za pomocą przekazywania dostępu w całej domenie umożliwia autoryzowanie konta usługi aplikacji do uzyskiwania dostępu do danych użytkowników bez potrzeby pytania każdego użytkownika o zgodę.
Uczestnicy
W sekcjach poniżej znajdziesz szczegółowe informacje o tym, jak uzyskać informacje o uczestnikach nagrania konferencji.
Zasób participants
łączy się z polem 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 towarzyszącym;
Konto robota używane przez urządzenia do rozmów wideo w sali konferencyjnej.
anonymousUser
to niezidentyfikowany użytkownik, który nie jest zalogowany na konto Google.phoneUser
to użytkownik, który dołącza do spotkania przez telefon, a jego tożsamość jest nieznana, ponieważ nie zalogował się na konto Google.
Pamiętaj, że wszystkie 3 obiekty zwracają displayName
, ale signedinUser
zwraca też unikalny identyfikator user
, który jest interoperacyjny z interfejsem Admin SDK API i interfejsem People API. Format: users/{user}
. Więcej informacji o używaniu identyfikatora user
z interfejsem People API znajdziesz w artykule Pobieranie szczegółów uczestnika za pomocą interfejsu People API.
Sprawdzanie szczegółowych informacji o uczestniku
Aby uzyskać szczegółowe informacje o konkretnym uczestniku, użyj metody get()
w zasobie participants
z parametrem ścieżki name
. Jeśli nie znasz nazwy uczestnika, możesz wyświetlić listę wszystkich nazw uczestników za pomocą metody list()
.
Metoda zwraca dane uczestnika jako instancję zasobu participants
.
Poniższy przykładowy kod pokazuje, jak pobrać konkretnego uczestnika:
Java
Node.js
Python
Zastąp nazwę uczestnika nazwą konkretnego identyfikatora uczestnika w rekordzie konferencji.
Wyświetlanie listy wszystkich uczestników
Aby wyświetlić szczegóły wszystkich uczestników rekordu konferencji, użyj metody
list()
w zasobie
participants
z parametrem ścieżki parent
. Format:
conferenceRecords/{conferenceRecord}
.
Metoda zwraca listę uczestników konferencji uporządkowaną według earliestStartTime
w kolejności malejącej jako instancję zasobu participants
. Aby dostosować rozmiar strony i filtrować wyniki zapytania, przeczytaj artykuł Dostosowywanie paginacji lub filtrowanie listy uczestników.
Poniższy przykładowy kod pokazuje, jak wyświetlić listę wszystkich uczestników nagrania konferencji:
Java
Node.js
Python
Zastąp wartość parent nazwą rekordu konferencji.
Dostosowywanie paginacji lub filtrowanie listy uczestników
Przekaż te parametry zapytania, aby dostosować paginację lub filtrowanie uczestników:
pageSize
: maksymalna liczba uczestników do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie określisz tu żadnej wartości, zostanie zwróconych maksymalnie 100 uczestników. Maksymalna wartość to 250. Wartości większe niż 250 są automatycznie zmieniane na 250.pageToken
: token strony otrzymany z poprzedniego wywołania listy. Podaj ten token, aby pobrać następną stronę.filter
: opcjonalne. Filtr zapytania, który umożliwia pobieranie konkretnych elementów w wynikach zasobuparticipants
.W polach
earliestStartTime
ilatestEndTime
możesz filtrować użytkowników, którzy dołączyli przed określonym czasem lub opuścili grupę po określonym czasie. Oba pola używają formatu Timestamp w formacie RFC 3339 UTC „Zulu” z dokładnością do nanosekund i maksymalnie 9 cyframi 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 wyświetlić listę wszystkich aktywnych uczestników istniejącej konferencji, użyj
latestEndTime IS NULL
.
Pobieranie szczegółów uczestnika za pomocą interfejsu People API
Aby pobrać szczegółowe informacje o uczestniku, użyj metody get()
w zasobie people
w interfejsie People API.
Wyodrębnij identyfikator osoby z zasobu
participant
, używając ostatniego komponentu ścieżki. Jeśli na przykład wartośćparticipant
zasobu toconferenceRecords/abc-123/participants/12345
, identyfikator interfejsu People API to12345
.Uwzględnij
READ_SOURCE_TYPE_PROFILE
,READ_SOURCE_TYPE_CONTACT
iREAD_SOURCE_TYPE_OTHER_CONTACT
ReadSourceType
. Dzięki temu w odpowiedzi znajdą się zarówno użytkownicy wewnętrzni organizacji Google Workspace, jak i kontakty zewnętrzne.
Poniższy przykładowy kod pokazuje, jak wyszukiwać osobę w profilach organizacji i kontaktach:
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
Zastąp następujące elementy:
- PERSON_ID: identyfikator osoby do znalezienia.
- ACCESS_TOKEN: token dostępu, który umożliwia dostęp do wielu interfejsów API.
Sesje uczestników
W sekcjach poniżej znajdziesz szczegółowe informacje o tym, jak uzyskać informacje o sesjach uczestnika w rekordzie konferencji.
Wyświetlanie szczegółowych informacji o sesji uczestnika
Aby uzyskać szczegółowe informacje o sesji konkretnego uczestnika, użyj metody
get()
w zasobie
participantSessions
z parametrem ścieżki name
. Jeśli nie znasz nazwy sesji uczestnika, możesz wyświetlić listę wszystkich sesji uczestnika za pomocą metody list()
.
Metoda zwraca nazwę uczestnika jako instancję zasobu participantSessions
.
Poniższy przykładowy kod pokazuje, jak pobrać konkretną sesję uczestnika:
Java
Node.js
Python
Zastąp nazwę uczestnika identyfikatorem sesji konkretnego uczestnika.
Wyświetlanie listy wszystkich sesji uczestników
Aby wyświetlić szczegóły wszystkich sesji uczestnika w rekordzie konferencji, użyj metody list()
w zasobie participantSessions
z parametrem ścieżki parent
. Format:
conferenceRecords/{conferenceRecord}/participants/{participant}
.
Metoda zwraca listę sesji uczestników uporządkowaną według startTime
w kolejności malejącej jako instancję zasobu participantSession
. Aby dostosować rozmiar strony i filtrować wyniki zapytania, przeczytaj artykuł Dostosowywanie paginacji lub filtrowanie listy sesji uczestników.
Poniższy przykładowy kod pokazuje, jak wyświetlić listę wszystkich sesji uczestników w rekordzie konferencji:
Java
Node.js
Python
Zastąp wartość nadrzędną nazwą sesji uczestnika w rekordzie konferencji.
Dostosowywanie paginacji lub filtrowanie listy sesji uczestników
Przekaż te opcjonalne parametry zapytania, aby dostosować paginację lub filtrowanie sesji uczestników:
pageSize
: maksymalna liczba sesji uczestników do zwrócenia. Usługa może zwrócić wartość mniejszą niż ta. Jeśli nie podano tego argumentu, zwracanych jest maksymalnie 100 sesji uczestników. Maksymalna wartość to 250. Wartości większe niż 250 są automatycznie zmieniane na 250.pageToken
: token strony otrzymany z poprzedniego wywołania listy. Podaj ten token, aby pobrać następną stronę.filter
: opcjonalne. Filtr zapytania, który umożliwia pobieranie konkretnych elementów w wynikach zasobuparticipants
.Pól
startTime
iendTime
możesz używać do filtrowania użytkowników, którzy dołączyli przed określonym czasem lub opuścili usługę po określonym czasie. Oba pola używają formatu Timestamp w formacie RFC 3339 UTC „Zulu” z dokładnością do nanosekund i maksymalnie 9 cyframi 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
Aby wyświetlić listę wszystkich aktywnych sesji uczestników w rekordzie konferencji, użyj
endTime IS NULL
.