Aby korzystać z interfejsu Google Meet Media API i powiązanych z nim zakresów OAuth 2.0, Twoja aplikacja musi spełniać te wymagania.
Wymagania techniczne
Podczas pracy z interfejsem Meet Media API obowiązują te ograniczenia:
Klienci muszą obsługiwać wszystkie te kodeki:
AV1VP9VP8
Klienci muszą używać implementacji kodeków zgodnych z wymaganiami dotyczącymi kodeków w interfejsie Meet Media API, w tym:
libvpx(Google) do dekodowaniaVP8lubVP9dav1d(VideoLAN) do dekodowaniaAV1
Klienci muszą obsługiwać te rozszerzenia nagłówka WebRTC:
- Absolute Send Time
- Transport-Wide Congestion Control
- Absolute Capture Time
- Dependency Descriptor
- Audio Level Indication
(
urn:ietf:params:rtp-hdrext:ssrc-audio-level)
Klienci muszą okresowo wysyłać pełny pakiet danych. Więcej informacji znajdziesz na stronie danych klienta.
Aby uzyskać najlepsze wyniki i pomoc:
Klienci powinni używać biblioteki
libwebrtc, a jej wersja nie powinna być starsza niż 12 miesięcy od najnowszejSTABLEstabilnej wersji Chromium. Przeglądarki Chromium używają bibliotekilibwebrtcdo implementowania interfejsów JavaScript API WebRTC.Klienci powinni utrzymywać minimalną przepustowość wynoszącą 4 Mb/s.
Włączanie interfejsu Meet REST API
Zanim zaczniesz korzystać z interfejsów API Google, musisz je włączyć w projekcie w chmurze Google. W jednym projekcie Google Cloud możesz włączyć co najmniej 1 interfejs API.W konsoli Google Cloud włącz interfejs Google Meet REST API.
Zasady wycofywania kodeków
Google zastrzega sobie prawo do zaprzestania używania kodeka w dowolnym momencie.
Gdy wprowadzimy nowy kodek, deweloperzy otrzymają 12 miesięcy na dostosowanie klientów do jego obsługi.
Uwierzytelnianie i autoryzacja
Klienci interfejsu Google Meet Media API łączą się z konferencją w imieniu konkretnego użytkownika, używając protokołu OAuth 2.0 do uwierzytelniania i autoryzacji.
Odpowiedni dostęp
Zakresy interfejsu Meet Media API
Zakresy autoryzacji to uprawnienia, o które prosisz użytkowników, aby autoryzowali Twoją aplikację do uzyskiwania dostępu do treści spotkania. Gdy ktoś zainstaluje Twoją aplikację, użytkownik zostanie poproszony o potwierdzenie tych zakresów. Zasadniczo należy wybrać jak najwęższy zakres i unikać żądania zakresów, których aplikacja nie potrzebuje. Użytkownicy chętniej przyznają dostęp do ograniczonych, jasno opisanych zakresów.
Interfejs Meet Media API obsługuje ten zakres OAuth 2.0:
| Kod zakresu | Opis | Wykorzystanie |
|---|---|---|
https://www.googleapis.com/auth/meetings.conference.media.readonly |
Nagrywaj obraz i dźwięk w czasie rzeczywistym podczas rozmów wideo w Google Meet. | Z ograniczonym dostępem |
https://www.googleapis.com/auth/meetings.conference.media.audio.readonly |
Nagrywaj dźwięk w czasie rzeczywistym podczas rozmów wideo w Google Meet. | Z ograniczonym dostępem |
https://www.googleapis.com/auth/meetings.conference.media.video.readonly |
Nagrywaj obraz w czasie rzeczywistym podczas rozmów wideo w Google Meet. | Z ograniczonym dostępem |
Ze względu na poufny charakter konferencji wszystkie zakresy interfejsu Meet Media API są ograniczone:
- Z ograniczonym dostępem: te zakresy zapewniają szeroki dostęp do danych użytkowników Google i wymagają przejścia procesu weryfikacji zakresu z ograniczonym dostępem. Informacje o tym wymaganiu znajdziesz w zasadach dotyczących danych użytkownika w usługach interfejsów API Googlei dodatkowych wymaganiach dotyczących określonych zakresów interfejsów API. Jeśli przechowujesz dane z zakresu z ograniczonym dostępem na serwerach (lub je przesyłasz), musisz przejść ocenę bezpieczeństwa.
Oprócz zakresów interfejsu Meet Media API musisz też poprosić o ogólny zakres odczytu spotkania za pomocą OAuth. Ten zakres jest wymagany do uzyskania dostępu do metadanych spotkania, takich jak informacje o uczestnikach i wpisach multimedialnych, oraz do nawiązania połączenia.
| Kod zakresu | Opis | Wykorzystanie |
|---|---|---|
https://www.googleapis.com/auth/meetings.space.read |
Zezwalaj aplikacjom na odczytywanie metadanych dowolnego miejsca spotkania, do którego użytkownik ma dostęp. | Poufne |
Jeśli Twoja aplikacja wymaga dostępu do innych interfejsów API Google, możesz też dodać te zakresy. Więcej informacji o zakresach interfejsów API Google znajdziesz w artykule Używanie OAuth 2.0 do korzystania z interfejsów API Google.
Aby określić, jakie informacje są wyświetlane użytkownikom i recenzentom aplikacji, przeczytaj artykuł Konfigurowanie ekranu zgody OAuth i wybieranie zakresów.
Więcej informacji o konkretnych zakresach OAuth 2.0 znajdziesz w artykule Zakresy OAuth 2.0 dla interfejsów API Google.
Wymagania dotyczące użytkownika
Aby korzystać z interfejsu Meet Media API, uczestnicy Meet muszą też spełniać pewne minimalne wymagania, aby konferencja była kwalifikowana.
Wersje aplikacji mobilnej
Użytkownicy mobilni muszą zaktualizować aplikację do tych wersji:
| Platforma | Aplikacja | Wersja |
|---|---|---|
| Android | Aplikacja Meet | 309 |
| iOS | Aplikacja Meet | 308 |
| Android | Aplikacja Gmail | 2025.05.30 |
| iOS | Aplikacja Gmail | 6.0.250518 |
Nieobsługiwane platformy
Nie obsługujemy klientów sprzętowych innych firm, którzy korzystają z Meet. Jeśli na przykład użytkownicy korzystają ze sprzętowego urządzenia Cisco do prowadzenia wideokonferencji, na którym działa Meet, instancja interfejsu Meet Media API nie może dołączyć do połączenia.
Ograniczenia wiekowe
Interfejs Meet Media API nie może zbierać multimediów z kont zarejestrowanych na osoby niepełnoletnie.
Są to zwykle konta osób, które nie osiągnęły wieku świadomego wyrażenia zgody w swoim kraju (zwykle poniżej 18 lat) lub które nie osiągnęły wieku świadomego wyrażenia zgody, gdy konto zostało utworzone przez rodzica w aplikacji Google Family Link.
Pamiętaj, że w niektórych regionach (np. w UE) obowiązują dodatkowe ograniczenia dotyczące tego, jakie konta są uważane za konta osób niepełnoletnich.
Jeśli uważasz, że konto jednego z Twoich użytkowników jest objęte ograniczeniami, możesz poprosić o weryfikację wieku, aby sprawdzić, czy konto jest zweryfikowane pod kątem wieku. Więcej informacji o potwierdzaniu wieku.