Z tego przewodnika dowiesz się, jak uzyskać szczegółowe informacje o różnych elementach spotkania wygenerowanych przez konferencję za pomocą interfejsu Google Meet REST API.
Element to plik lub dane wygenerowane przez Google Meet w odpowiedzi na rozmowę wideo. Dotyczy to filmów i innych artefaktów, takich jak transkrypcje.
Aby wygenerować artefakty, uczestnicy muszą je wygenerować w Meet przed zakończeniem konferencji. Transkrypcje działają niezależnie od nagrań i nie musisz nagrywać spotkania, aby wygenerować transkrypcję. Więcej informacji znajdziesz w artykułach Nagrywanie spotkania wideo i Używanie transkrypcji w Google Meet.
Jeśli jesteś właścicielem pokoju spotkań lub uczestnikiem, możesz wywołać metody get()
i
list()
zasobów recordings
, transcripts
i
transcripts.entries
, aby pobrać artefakty.
Uwierzytelnianie i autoryzowanie 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ę.
Przechowywanie artefaktów
Po zakończeniu konferencji Meet zapisuje nagrania i transkrypcje na Dysku Google organizatora. Domyślnie artefakty Meet są przechowywane zgodnie z regułami Dysku.
Zapis treści udostępniany przez interfejs API Meet jest usuwany po 30 dniach od zakończenia konferencji.
Możesz też zarządzać przechowywaniem artefaktów z Meet oddzielnie, używając reguł przechowywania w Google Vault. Więcej informacji znajdziesz w artykule Przechowywanie danych z Google Meet w Vault.
Nagrania
W kolejnych sekcjach znajdziesz szczegółowe informacje o tym, jak uzyskać informacje o nagraniach w rekordzie konferencji.
Meet ma dostęp do identyfikatora nagrania po wygenerowaniu pliku nagrania. Użytkownik może usunąć plik nagrania z Dysku Google, ale unikalna nazwa jest nadal zwracana w Meet.
Zasób recordings
zawiera zarówno obiekty DriveDestination
, jak i State
.
Obiekt DriveDestination
zawiera lokalizację eksportu na Dysku, gdzie nagranie jest zapisywane jako plik MP4. Aby pobrać nagranie lub odtworzyć je w przeglądarce, użyj wartości pola exportUri
obiektu. Jeśli znasz interfejs API Dysku Google, wartość pola file
odpowiada wartości id
w zasobach files
. Więcej informacji znajdziesz w artykule Pobieranie i eksportowanie plików.
Obiekt State
zawiera stan sesji nagrywania. Dzięki temu możesz sprawdzić, czy nagrywanie zostało rozpoczęte, czy zostało zakończone, ale plik z nagraniem nie jest jeszcze gotowy, czy plik z nagraniem został wygenerowany i jest gotowy do pobrania.
Uzyskiwanie szczegółów nagrania
Aby uzyskać szczegółowe informacje o konkretnym nagraniu, użyj metody get()
w zasobie recordings
z parametrem ścieżki name
. Jeśli nie znasz nazwy nagrania, możesz wyświetlić wszystkie nazwy nagrań, korzystając z metody list()
.
Metoda zwraca instancję zasobu recordings
.
Poniższy przykładowy kod pokazuje, jak pobrać konkretny zapis:
Java
Node.js
Python
Zastąp nazwę nagrania nazwą konkretnego identyfikatora nagrania w rekordzie konferencji.
Wyświetlanie listy wszystkich nagrań
Aby wyświetlić szczegóły wszystkich nagrań w rekordzie konferencji, użyj metody list()
w zasobie recordings
z parametrem ścieżki parent
. Format:
conferenceRecords/{conferenceRecord}
.
Metoda zwraca listę nagrań konferencji, uporządkowaną według startTime
w kolejności rosnącej, jako instancja zasobu recordings
. Aby dostosować rozmiar strony, przeczytaj artykuł Dostosowywanie podziału na strony .
Poniższy przykładowy kod pokazuje, jak wyświetlić wszystkie nagrania w zapisie konferencji:
Java
Node.js
Python
Zastąp wartość nadrzędną nazwą rekordu konferencji.
Transkrypcje
W poniższych sekcjach znajdziesz szczegółowe informacje o tym, jak uzyskać transkrypcje konferencji w rekordzie konferencji.
Meet ma dostęp do identyfikatora transkrypcji po wygenerowaniu danych transkrypcji. Użytkownik może usunąć plik transkrypcji z Dysku, ale unikalna nazwa jest nadal zwracana w Meet.
Zasób transcripts
zawiera zarówno obiekty DocsDestination
, jak i State
.
Obiekt DocsDestination
zawiera lokalizację eksportu na Dysku, w której zapisywany jest plik transkrypcji Dokumentów Google. Aby pobrać treści lub przeglądać transkrypcję w przeglądarce, użyj wartości pola exportUri
obiektu. Jeśli znasz interfejs Google Docs API, wartość pola document
odpowiada wartości documentId
w zasobie documents
.
Obiekt State
zawiera stan sesji transkrypcji. Dzięki temu możesz sprawdzić, czy sesja transkrypcji się rozpoczęła, czy zakończyła się, ale plik transkrypcji nie jest gotowy, czy plik transkrypcji został wygenerowany i jest gotowy do pobrania.
Uzyskiwanie szczegółów transkrypcji
Aby uzyskać szczegółowe informacje o konkretnym transkrypcie, użyj metody get()
w zasobie transcripts
z parametrem ścieżki name
. Jeśli nie znasz nazwy transkrypcji, możesz wyświetlić wszystkie nazwy transkrypcji, używając metody list()
.
Metoda zwraca instancję zasobu transcripts
.
Poniższy przykładowy kod pokazuje, jak pobrać konkretny zapis:
Java
Node.js
Python
Zastąp nazwę transkrypcji nazwą konkretnego identyfikatora transkrypcji w rekordzie konferencji.
Wyświetlanie listy wszystkich transkrypcji
Aby wyświetlić szczegóły wszystkich transkrypcji w rekordzie konferencji, użyj metody list()
w zasobie transcripts
z parametrem ścieżki parent
. Format:
conferenceRecords/{conferenceRecord}
.
Metoda zwraca listę transkrypcji konferencji uporządkowaną według startTime
w kolejności rosnącej jako instancja zasobu transcripts
. Aby dostosować rozmiar strony, przeczytaj artykuł Dostosowywanie podziału na strony .
Poniższy przykładowy kod pokazuje, jak wyświetlić wszystkie transkrypcje w nagraniu z rozmowy konferencyjnej:
Java
Node.js
Python
Zastąp wartość nadrzędną nazwą rekordu konferencji.
Wpisy w transkrypcji
W kolejnych sekcjach znajdziesz szczegółowe informacje o tym, jak podczas sesji transkrypcji konferencji uzyskać transkrypcję mowy każdego uczestnika.
Wpis transkrypcji zawiera transkrypcję głosu uczestnika (maksymalnie 10 tys. słów). Tekst languageCode
(na przykład en-US
)
jest również dołączony w składni IETF BCP 47.
Każdy wpis w transkrypcji jest powiązany z nazwą participant
w konferencji. Aby pobrać dane uczestnika, przeczytaj artykuł Pobieranie danych o uczestniku.
Dane dotyczące wpisów w transkrypcji są dostępne przez 30 dni od zakończenia konferencji.
Pamiętaj, że wpisy transkrypcji zwrócone przez interfejs Meet REST API mogą nie odpowiadać transkrypcji w pliku transkrypcji w Dokumentach. Występuje to, gdy plik transkrypcji zostanie zmodyfikowany po wygenerowaniu.
Uzyskiwanie szczegółów wpisu w transkrypcji
Aby uzyskać szczegółowe informacje o konkretnym wpisie w transkrypcji, użyj metody get()
w zasobie transcripts.entries
z parametrem ścieżki name
. Jeśli nie znasz nazwy wpisu w transkrypcji, możesz wyświetlić wszystkie nazwy transkrypcji, używając metody list()
.
Metoda zwraca instancję zasobu transcripts.entries
.
Poniższy przykładowy kod pokazuje, jak pobrać konkretny wpis z transkrypcji:
Java
Node.js
Python
Zastąp nazwę wpisu w transkrypcji nazwą identyfikatora konkretnego wpisu w transkrypcji.
Wyświetlanie listy wszystkich wpisów transkrypcji
Aby wyświetlić szczegółowe informacje o wszystkich wpisach w transkrypcji, użyj metody list()
w zasobie transcripts.entries
z parametrem ścieżki parent
. Format:
conferenceRecords/{conferenceRecord}/transcripts/{transcript}
.
Metoda zwraca listę uporządkowanych transkrypcji w ramach konferencji startTime
, posortowanych według kolumny startTime
w kolejności rosnącej, jako instancja zasobu transcripts.entries
. Aby dostosować rozmiar strony, przeczytaj artykuł Dostosowywanie podziału na strony .
Poniższy przykładowy kod pokazuje, jak wyświetlić wszystkie wpisy transkrypcji w transkrypcji:
Java
Node.js
Python
Zastąp wartość nadrzędną nazwą rekordu konferencji i nazwą transkrypcji.
Dostosowywanie podziału na strony
Aby dostosować podział na strony nagrań, transkrypcji i ich wpisów, podaj te parametry zapytania:
pageSize
: maksymalna liczba produktów do zwrotu. Usługa może zwrócić mniej niż tę wartość. Jeśli nie podano tego argumentu, zwracane jest maksymalnie 10 elementów. Maksymalna wartość to 100. Wartości większe niż 100 są automatycznie zmieniane na 100.pageToken
: token strony otrzymany z poprzedniego wywołania listy. Podaj ten token, aby pobrać kolejną stronę.
Powiązane artykuły
- Nagrywanie spotkania wideo
- Korzystanie z transkrypcji w Google Meet
- Przechowywanie danych z Google Meet w Vault
- Dostosowywanie funkcji Meet jako administrator