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 zasób
participants.
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 1 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 niepowtarzalny 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
jest połączony z polem user. user może być tylko jednym z tych obiektów:
signedinUserto:osoba dołączająca z komputera osobistego, urządzenia mobilnego lub w trybie towarzyszącym;
Konto robota używane przez urządzenia w salach konferencyjnych.
anonymousUserto niezidentyfikowany użytkownik, który nie jest zalogowany na konto Google.phoneUserto 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ą wartość displayName, ale obiekt 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. 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:
- Nazwa rekordu konferencji z nazwą konkretnego identyfikatora konferencji w rekordzie konferencji.
- Nazwa uczestnika z identyfikatorem konkretnego 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. 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, przeczytaj artykuł Dostosowywanie podziału na strony lub filtrowanie listy uczestników.
Poniższy przykładowy kod pokazuje, jak wyświetlić listę wszystkich uczestników nagrania 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ę rodzica nazwą konkretnego identyfikatora konferencji w rekordzie 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: opcjonalnie. Filtr zapytania służący do pobierania konkretnych elementów w wynikach zasobuparticipants.Pól
earliestStartTimeilatestEndTimemoż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 standardzie 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:23ZlatestEndTime < 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ładparticipantzasób ma wartośćconferenceRecords/abc-123/participants/12345, identyfikator interfejsu People API to12345.Uwzględnij
READ_SOURCE_TYPE_PROFILE,READ_SOURCE_TYPE_CONTACTiREAD_SOURCE_TYPE_OTHER_CONTACTReadSourceType. 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ę zarówno w profilach organizacji, jak i w 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, którą chcesz znaleźć.
- 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ółów sesji uczestnika
Aby uzyskać szczegółowe informacje o sesji konkretnego 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:
- Nazwa rekordu konferencji z nazwą konkretnego identyfikatora konferencji w rekordzie konferencji.
- Nazwa uczestnika z identyfikatorem konkretnego uczestnika w rekordzie konferencji.
- Identyfikator sesji uczestnika z identyfikatorem konkretnej sesji 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. 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, 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
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:
- Nazwa rekordu konferencji z nazwą konkretnego identyfikatora konferencji w rekordzie konferencji.
- Nazwa nadrzędna z 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ć mniej niż ta wartość. 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: opcjonalnie. Filtr zapytania służący do pobierania konkretnych elementów w wynikach zasobuparticipants.W polach
startTimelubendTimemożesz filtrować użytkowników, którzy dołączyli przed określonym czasem lub opuścili usługę po nim. Oba pola używają formatu Timestamp w standardzie 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:23ZendTime < 2023-10-01T15:01:23Z
Aby wyświetlić listę wszystkich aktywnych sesji uczestników w rekordzie konferencji, użyj
endTime IS NULL.