Z tego przewodnika dowiesz się, jak za pomocą interfejsu Google Meet REST API uzyskać szczegółowe informacje o różnych elementach spotkania wygenerowanych przez konferencję.
Element to plik lub dane wygenerowane przez Google Meet w odpowiedzi na konferencję. Dotyczy to filmów i innych elementów, takich jak transkrypcje.
Aby wygenerować artefakty, uczestnicy muszą to zrobić 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 Korzystanie z transkrypcji w Google Meet.
Jeśli jesteś właścicielem lub uczestnikiem przestrzeni spotkań, możesz wywołać metody get()
i list()
w zasobach recordings
, transcripts
i transcripts.entries
, aby pobrać artefakty.
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ę.
Przechowywanie artefaktów
Po zakończeniu konferencji Meet zapisuje nagrania i transkrypcje na Dysku Google organizatora spotkania. Domyślnie artefakty Meet są przechowywane zgodnie z regułami Dysku.
Wpisy transkrypcji udostępniane przez interfejs Meet REST API są usuwane 30 dni po zakończeniu konferencji.
Możesz też zarządzać przechowywaniem artefaktów z Meet oddzielnie za pomocą reguł przechowywania dotyczących Meet w Google Vault. Więcej informacji znajdziesz w artykule Przechowywanie danych z Google Meet w Vault.
Nagrania
W sekcjach poniżej znajdziesz szczegółowe informacje o tym, jak uzyskać informacje o nagraniach w rekordzie konferencji.
Meet ma dostęp do identyfikatora nagrania po wygenerowaniu pliku z nagraniem. Użytkownik może usunąć plik nagrania z Dysku Google, ale unikalna nazwa nadal będzie zwracana w Meet.
Zasób recordings
zawiera obiekty DriveDestination
i State
.
Obiekt DriveDestination
zawiera lokalizację eksportu na Dysku, w której 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 Google Drive API, wartość pola file
odpowiada polu id
w zasobie 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 się rozpoczęło, czy się zakończyło, ale plik nagrania nie jest gotowy, lub czy plik nagrania został wygenerowany i jest gotowy do pobrania.
Wyświetlanie 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ć listę wszystkich nazw nagrań za pomocą metody list()
.
Metoda zwraca instancję zasobu recordings
.
Poniższy przykładowy kod pokazuje, jak pobrać konkretne nagranie:
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 instancję zasobu recordings
. Aby dostosować rozmiar strony, przeczytaj artykuł Dostosowywanie podziału na strony .
Poniższy przykładowy kod pokazuje, jak wyświetlić listę wszystkich nagrań w nagraniu konferencji:
Java
Node.js
Python
Zastąp wartość parent nazwą rekordu konferencji.
Transkrypcje
W sekcjach poniżej znajdziesz szczegółowe informacje o tym, jak uzyskać informacje o transkrypcjach rozmów wideo w rekordzie rozmowy.
Gdy dane transkrypcji zostaną wygenerowane, Meet będzie mieć dostęp do identyfikatora transkrypcji. Użytkownik może usunąć plik transkrypcji z Dysku, ale unikalna nazwa nadal będzie zwracana w Meet.
Zasób transcripts
zawiera obiekty DocsDestination
i State
.
Obiekt DocsDestination
zawiera lokalizację eksportu na Dysku, w której zapisywany jest plik transkrypcji Dokumentów Google. Aby pobrać treść lub przejrzeć transkrypcję w przeglądarce, użyj wartości pola exportUri
obiektu. Jeśli znasz interfejs Google Docs API, wartość pola document
odpowiada polu documentId
w zasobie documents
.
Obiekt State
zawiera stan sesji transkrypcji. Umożliwia to sprawdzenie, czy sesja transkrypcji się rozpoczęła, czy się zakończyła, ale plik transkrypcji nie jest gotowy, lub czy plik transkrypcji został wygenerowany i jest gotowy do pobrania.
Wyświetlanie 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ć listę wszystkich nazw transkrypcji za pomocą metody list()
.
Metoda zwraca instancję zasobu transcripts
.
Poniższy przykładowy kod pokazuje, jak pobrać konkretny transkrypt:
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 instancję zasobu transcripts
. Aby dostosować rozmiar strony, przeczytaj artykuł Dostosowywanie podziału na strony .
Poniższy przykładowy kod pokazuje, jak wyświetlić listę wszystkich transkrypcji w nagraniu konferencji:
Java
Node.js
Python
Zastąp wartość parent nazwą rekordu konferencji.
Wpisy w transkrypcji
W sekcjach poniżej znajdziesz szczegółowe informacje o tym, jak uzyskać wypowiedzi poszczególnych uczestników w formie wpisów transkrypcji podczas sesji transkrypcji konferencji.
Transkrypcja zawiera tekst głosu uczestnika, maksymalnie 10 000 słów. Wypowiadany tekst languageCode
(np. en-US
) jest też podany w składni IETF BCP 47.
Każdy wpis w transkrypcji jest połączony z participant
nazwą w konferencji. Aby pobrać szczegóły uczestnika, zobacz Pobieranie szczegółów uczestnika.
Dane dotyczące wpisów w transkrypcji są dostępne przez 30 dni po zakończeniu konferencji.
Pamiętaj, że wpisy transkrypcji zwracane przez interfejs Meet REST API mogą nie odpowiadać transkrypcji w pliku transkrypcji Dokumentów. Dzieje się tak, gdy plik transkrypcji zostanie zmodyfikowany po wygenerowaniu.
Wyświetlanie 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 transkrypcji, możesz wyświetlić listę wszystkich nazw transkrypcji za pomocą metody list()
.
Metoda zwraca instancję zasobu transcripts.entries
.
Poniższy przykładowy kod pokazuje, jak pobrać konkretny wpis transkrypcji:
Java
Node.js
Python
Zastąp nazwę wpisu w transkrypcji nazwą konkretnego wpisu w transkrypcji.
Wyświetlanie listy wszystkich wpisów 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 wpisów transkrypcji dla każdej transkrypcji konferencji, posortowaną według kolumny startTime
w kolejności rosnącej, jako instancję zasobu transcripts.entries
. Aby dostosować rozmiar strony, przeczytaj artykuł Dostosowywanie paginacji .
Poniższy przykładowy kod pokazuje, jak wyświetlić listę wszystkich wpisów w transkrypcji:
Java
Node.js
Python
Zastąp wartość nadrzędną nazwą rekordu konferencji i nazwą transkrypcji.
Dostosowywanie podziału na strony
Przekaż te parametry zapytania, aby dostosować paginację nagrań, transkrypcji i wpisów w transkrypcji:
pageSize
: maksymalna liczba produktów do zwrotu. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podano tego argumentu, zwracanych 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ć następną stronę.
Powiązane artykuły
- Nagrywanie spotkania wideo
- Używanie transkrypcji w Google Meet
- Przechowywanie danych z Google Meet w Vault
- Dostosowywanie funkcji Meet jako administrator