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 poprzedniej konferencji lub są obecni na aktywnej konferencji, oraz informacje o ich sesjach.
Uczestnik to osoba
która dołączyła do rozmowy, korzysta z trybu towarzyszącego, ogląda jako widz lub
korzysta z urządzenia w sali połączonego z rozmową. 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łączy do rozmowy. Każda sesja ma 1
participantSessions
zasób. Jeśli uczestnik dołączy do tej samej rozmowy kilka razy z tej samej pary uczestnik-urządzenie, każda sesja otrzyma unikalny identyfikator.
Jeśli jesteś właścicielem lub uczestnikiem przestrzeni spotkania, możesz wywołać metody get i list w zasobach participants i participantSessions, aby pobrać rekordy uczestników.
Uwierzytelnianie i autoryzacja za pomocą danych logowania użytkownika umożliwia 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 w rekordzie konferencji.
Zasób
participants
jest połączony z polem user. user może być tylko jednym z tych obiektów:
A
signedinUserto:osoba dołączająca z komputera osobistego, urządzenia mobilnego lub w trybie towarzyszącym;
konto robota używane przez urządzenia w sali konferencyjnej.
An
anonymousUserto niezidentyfikowany użytkownik, który nie jest zalogowany na konto Google.A
phoneUserto użytkownik, który dzwoni z telefonu, 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 zgodny z interfejsem Admin SDK API i People API. Format: users/{user}. Więcej informacji o używaniu identyfikatora user
ID z People API znajdziesz w artykule Pobieranie szczegółów uczestnika za pomocą
People API.
Pobieranie szczegółów uczestnika
Aby uzyskać szczegółowe informacje o konkretnym uczestniku, użyj
get
metody w
participants
zasobie. Ustaw parametr ścieżki name w formacie conferenceRecords/{conferenceRecord}/participants/{participantRecord}.
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
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARTICIPANT_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
Zastąp ACCESS_TOKEN tokenem dostępu, który przyznaje dostęp do interfejsu API.
Zastąp następujące elementy:
- Nazwę rekordu konferencji nazwą konkretnego identyfikatora rozmowy wideo w rekordzie konferencji.
- Nazwę uczestnika nazwą konkretnego identyfikatora uczestnika w rekordzie konferencji.
Wyświetlanie listy wszystkich uczestników
Aby wyświetlić szczegółowe informacje o wszystkich uczestnikach w rekordzie konferencji, użyj
list
metody w
participants
zasobie. Ustaw parametr ścieżki parent w formacie 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, zobacz Dostosowywanie
paginacji lub filtrowanie listy uczestników.
Poniższy przykładowy kod pokazuje, jak wyświetlić listę wszystkich uczestników w rekordzie konferencji:
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/participants" \
-H "Authorization: Bearer ACCESS_TOKEN"
Zastąp ACCESS_TOKEN tokenem dostępu, który przyznaje dostęp do interfejsu API.
Zastąp nazwę nadrzędną nazwą konkretnego identyfikatora rozmowy wideo w rekordzie konferencji.
Dostosowywanie paginacji lub filtrowanie listy uczestników
Aby dostosować paginację lub filtrować uczestników, przekaż te parametry zapytania:
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: opcjonalnie. Filtr zapytania, który umożliwia pobieranie konkretnych elementów w wynikach zasobuparticipants.Możesz użyć pól
earliestStartTimelublatestEndTime, aby filtrować użytkowników, którzy dołączyli przed określonym czasem lub opuścili spotkanie po określonym czasie. Oba pola używają formatu znacznika czasu w formacie RFC 3339 UTC "Zulu" , z dokładnością do nanosekund i maksymalnie 9 cyframi ułamkowymi:{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z. Na przykład:earliestStartTime < 2023-10-01T15:01:23ZlatestEndTime < 2023-10-01T15:01:23Z
Aby wyświetlić listę wszystkich aktywnych uczestników w istniejącej konferencji, użyj
latestEndTime IS NULL.
Pobieranie szczegółów uczestnika za pomocą People API
Aby pobrać szczegółowe informacje o uczestniku, użyj metody
get w zasobie
people w People API.
Wyodrębnij identyfikator osoby z zasobu
participantza pomocą końcowego komponentu ścieżki. Jeśli na przykład wartość zasobuparticipanttoconferenceRecords/abc-123/participants/12345, identyfikator dla People API to12345.Dołącz
READ_SOURCE_TYPE_PROFILE,READ_SOURCE_TYPE_CONTACTiREAD_SOURCE_TYPE_OTHER_CONTACTReadSourceType. Dzięki temu w odpowiedzi zostaną uwzględnieni zarówno użytkownicy wewnętrzni organizacji Google Workspace, jak i kontakty zewnętrzne.
Poniższy przykładowy kod pokazuje, jak wyszukać 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 przyznaje 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 uczestników w rekordzie konferencji.
Pobieranie szczegółów sesji uczestnika
Aby uzyskać szczegółowe informacje o konkretnej sesji uczestnika, użyj metody
get
w zasobie
participantSessions. Ustaw parametr ścieżki name w formacie conferenceRecords/{conferenceRecord}/participants/{participantRecord}/participantSessions/{participantSessionRecord}.
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
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARTICIPANT_NAME/participantSessions/PARTICIPANT_SESSION_ID" \
-H "Authorization: Bearer ACCESS_TOKEN"
Zastąp ACCESS_TOKEN tokenem dostępu, który przyznaje dostęp do interfejsu API.
Zastąp następujące elementy:
- Nazwę rekordu konferencji nazwą konkretnego identyfikatora rozmowy wideo w rekordzie konferencji.
- Nazwę uczestnika nazwą konkretnego identyfikatora uczestnika w rekordzie konferencji.
- Identyfikator sesji uczestnika identyfikatorem konkretnej sesji uczestnika.
Wyświetlanie listy wszystkich sesji uczestników
Aby wyświetlić szczegółowe informacje o wszystkich sesjach uczestnika w rekordzie konferencji, użyj metody w zasobie.list()participantSessions Ustaw parametr ścieżki parent w formacie conferenceRecords/{conferenceRecord}/participants/{participantRecord}.
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, zobacz 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
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARENT_NAME/participantSessions" \
-H "Authorization: Bearer ACCESS_TOKEN"
Zastąp ACCESS_TOKEN tokenem dostępu, który przyznaje dostęp do interfejsu API.
Zastąp następujące elementy:
- Nazwę rekordu konferencji nazwą konkretnego identyfikatora rozmowy wideo w rekordzie konferencji.
- Nazwę nadrzędną nazwą sesji uczestników w rekordzie konferencji.
Dostosowywanie paginacji lub filtrowanie listy sesji uczestników
Aby dostosować paginację lub filtrować sesje uczestników, przekaż te opcjonalne parametry zapytania:
pageSize: maksymalna liczba sesji 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 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: opcjonalnie. Filtr zapytania, który umożliwia pobieranie konkretnych elementów w wynikach zasobuparticipants.Możesz użyć pól
startTimelubendTime, aby filtrować użytkowników, którzy dołączyli przed określonym czasem lub opuścili spotkanie po określonym czasie. Oba pola używają formatu znacznika czasu w formacie RFC 3339 UTC "Zulu" , z dokładnością do nanosekund i maksymalnie 9 cyframi ułamkowymi:{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z. Na przykład:startTime < 2023-10-01T15:01:23ZendTime < 2023-10-01T15:01:23Z
Aby wyświetlić listę wszystkich aktywnych sesji uczestników w rekordzie konferencji, użyj
endTime IS NULL.