Z tego dokumentu dowiesz się, jak za pomocą interfejsu Google Meet REST API uzyskać szczegółowe informacje o różnych artefaktach spotkania wygenerowanych przez konferencję.
Artefakt to plik lub dane wygenerowane przez Google Meet w odpowiedzi na konferencję. Obejmuje to nagrania wideo i inne artefakty, takie jak transkrypcje.
Aby wygenerować artefakty, uczestnicy muszą je skonfigurować w Meet przed zakończeniem konferencji. Więcej informacji znajdziesz w artykule Zarządzanie automatycznymi artefaktami.
Transkrypcje działają niezależnie od nagrań i nie musisz nagrywać spotkania, aby wygenerować transkrypcję. Gdy wszyscy uczestnicy opuszczą spotkanie, transkrypcja zostanie automatycznie zatrzymana. Więcej informacji znajdziesz w artykułach Nagrywanie spotkania wideo i Korzystanie z transkrypcji w Google Meet.
Pobieranie artefaktów
Jeśli jesteś właścicielem lub uczestnikiem przestrzeni spotkań, możesz wywołać metody get i list w zasobach recordings, transcripts, transcripts.entries i smart notes, aby pobrać artefakty. Więcej informacji znajdziesz w sekcjach poniżej.
Uwierzytelnianie i autoryzacja za pomocą danych logowania użytkownika umożliwiają aplikacjom 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 to conferenceRecords/{conferenceRecord}.
Metoda zwraca listę nagrań konferencji uporządkowaną według parametru 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. Dzięki temu możesz sprawdzić, 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 to 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 participantnazwą 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 wpisów 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 to conferenceRecords/{conferenceRecord}/transcripts/{transcript}.
Metoda zwraca listę wpisów transkrypcji strukturalnej dla każdej transkrypcji konferencji, uporządkowaną według kolumny startTime w kolejności rosnącej, jako instancję zasobu transcripts.entries. Aby dostosować rozmiar strony, przeczytaj artykuł Dostosowywanie podziału na strony .
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.
Inteligentne notatki
W sekcjach poniżej znajdziesz szczegółowe informacje o tym, jak uzyskać informacje o inteligentnych notatkach z rozmowy wideo w rekordzie rozmowy.
Gdy dane notatki są wygenerowane, Meet ma dostęp do jej identyfikatora. Może się zdarzyć, że użytkownik usunie plik notatek inteligentnych z Dysku, ale unikalna nazwa nadal będzie zwracana w Meet.
Zasób smartNotes zawiera obiekt State.
Ten obiekt zawiera stan sesji inteligentnych notatek. Umożliwia to sprawdzenie, czy sesja inteligentnych notatek została rozpoczęta, czy zakończyła się, ale plik inteligentnych notatek nie jest gotowy, lub czy plik inteligentnych notatek został wygenerowany i jest gotowy do pobrania.
Zasób smartNotes zawiera też obiekt DocsDestination. Ten obiekt zawiera lokalizację eksportu na Dysku, w której zapisywany jest plik notatek inteligentnych Dokumentów Google. Aby pobrać treść lub przejrzeć inteligentne notatki 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.
Notatkami inteligentnymi możesz zarządzać za pomocą metod get i list.
Szczegółowe informacje o inteligentnych notatkach
Aby uzyskać szczegółowe informacje o konkretnym pliku notatek inteligentnych, użyj metody get w zasobie smartNotes z parametrem ścieżki name. Jeśli nie znasz nazwy notatki inteligentnej, możesz wyświetlić listę wszystkich plików notatek inteligentnych za pomocą metody list.
Metoda zwraca instancję zasobu smartNotes.
Wyświetlanie listy wszystkich inteligentnych notatek
Aby wyświetlić szczegóły wszystkich plików z notatkami inteligentnymi w rekordzie konferencji, użyj metody list w zasobie smartNotes z parametrem ścieżki parent. Format to conferenceRecords/{conferenceRecord}.
Metoda zwraca listę plików z inteligentnymi notatkami z konferencji, posortowaną według kolumny startTime w kolejności rosnącej, jako instancję zasobu smartNotes. Aby dostosować rozmiar strony, zobacz Dostosowywanie podziału na strony .
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ę.