Wycofanie interfejsu YouTube Data API w wersji 2: najczęstsze pytania

Moja aplikacja korzysta z komentarzy, napisów lub innych funkcji, które nie są dostępne w interfejsie YouTube Data API w wersji 3. Co mam zrobić?

Na razie możesz nadal używać interfejsu API w wersji 2 do komentowania i przesyłania napisów do filmów. Wkrótce dodamy tę funkcję do interfejsu API w wersji 3. Nie mamy jeszcze konkretnych dat, ale udostępnimy tę funkcję, aby deweloperzy mieli jak najwięcej czasu na przejście na wersję 3.

W przypadku niektórych innych funkcji, w miarę rozwoju YouTube, nie będzie 100% zgodności funkcji między interfejsami API w wersji 2 i 3. Więcej informacji o funkcjach obsługiwanych w wersji 3 znajdziesz w dokumentacji interfejsu API w wersji 3.

W wersji 2 mogę uwierzytelniać się za pomocą adresu e-mail i hasła za pomocą ClientLogin. Jak przejść na OAuth 2.0?

Zapoznaj się z naszym przewodnikiem Przechodzenie z ClientLogin na OAuth 2.0.

Czym różni się limit w wersji 2 od limitu w wersji 3? Jakie są podobieństwa?

Zarówno w przypadku wersji 2, jak i 3 obowiązuje system limitów oparty na kosztach, w którym niektóre operacje (np. przesyłanie) zużywają więcej limitu niż inne (np. wyszukiwanie).

Najważniejsza różnica między systemami v2 i v3 polega na tym, że v3 udostępnia globalną pulę limitów, czego nie robił v2. W v2 żądania wysyłane przy użyciu jednego klucza dewelopera, ale pochodzące z różnych adresów IP lub od różnych uwierzytelnionych użytkowników, nie mogły powodować globalnych błędów limitu dla tego klucza dewelopera – najgorsze, co mogło się zdarzyć, to lokalny błąd limitu powiązany z adresem IP lub kanałem w YouTube.

W wersji 3 istnieje globalna pula limitów (50 mln jednostek dziennie), a wszystkie wywołania interfejsu API powiązane z określonym projektem w Konsoli deweloperów zmniejszają limit z tej puli. Dlatego teoretycznie jeden adres IP lub kanał może wykorzystać cały limit powiązany z rejestracją interfejsu API, co może spowodować przerwę w działaniu usługi, która wpłynie na innych użytkowników.

Możesz jednak chronić się przed sytuacją, w której jeden użytkownik wyczerpie globalną pulę limitów. W tej publicznej dokumentacji znajdziesz informacje o tym, jak definiować i stosować bardziej rygorystyczne limity żądań dla poszczególnych użytkowników.

Interfejs Data API w wersji 2 obsługiwał anonimowy dostęp do interfejsu API w przypadku zapytań tylko do odczytu, takich jak wyszukiwanie filmów. Dlaczego muszę się zarejestrować, aby wykonywać wywołania tylko do odczytu w wersji 3?

Interfejs API w wersji 3 jest oparty na nowoczesnej infrastrukturze interfejsów API Google, w której korzystanie z wielu różnych interfejsów API może być powiązane z określoną rejestracją w Konsoli deweloperów. Dzięki temu deweloperzy mają ujednolicony widok używanych przez siebie technologii Google.

W przypadku wywołań interfejsu API, które mają dostęp tylko do publicznie dostępnych danych, takich jak zapytania, klienci interfejsu API mogą określić prosty klucz interfejsu API podczas wysyłania żądania do interfejsu API. Wywołania interfejsu API, które uzyskują dostęp do prywatnych danych użytkownika, muszą określać tokeny OAuth 2.0.

Programiści mogą uzyskać proste klucze interfejsu API i dane logowania potrzebne do generowania tokenów OAuth 2.0 w Google Developers Console. Programiści mogą też przetestować interfejs API bez tworzenia projektu, korzystając z narzędzia APIs Explorer.

Czy po migracji do wersji 3 mogę nadal używać tych samych bibliotek klienta, których używałem w wersji 2?

Interfejs API w wersji 3 różni się od wersji 2, dlatego musisz używać nowego zestawu bibliotek klienta. Wszystkie są dostępne na stronie https://developers.google.com/youtube/v3/libraries i obsługują autoryzację OAuth 2.

Wcześniej korzystałem(-am) z interfejsu YouTube Insight API, który jest częścią wersji 2. Jakie mam inne możliwości?

Zalecamy wszystkim deweloperom przejście z interfejsu YouTube Insight API, który został wycofany we wrześniu 2013 r., na nowy YouTube Analytics API.

Korzystam z interfejsu GData API (w wersji 1 lub 2) w przypadku kanałów RSS/Atom z filmami w YouTube. Czy po wycofaniu tych funkcji będę mieć jakieś alternatywne rozwiązanie?

Obecnie nie ma bezpośredniej alternatywy. Zalecamy udostępnienie użytkownikom aplikacji możliwości zarządzania subskrypcjami w YouTube i pobierania ich za pomocą metod usługi subscriptions interfejsu YouTube Data API w wersji 3.

Nadal korzystam z niektórych funkcji wersji 2, które nie są jeszcze dostępne w wersji 3, więc muszę mieć dostęp do obu wersji interfejsu API w tej samej aplikacji. Jakie są sprawdzone metody?

Możesz użyć obsługi OAuth 2.0 w bibliotekach klienta w wersji 3, aby uzyskać tokeny autoryzacji, które będą działać w przypadku operacji zapisu w wersjach 2 i 3. Każdy token, który ma zakres https://gdata.youtube.com lub https://www.googleapis.com/auth/youtube, będzie działać w przypadku obu interfejsów API.

W przypadku wywołań interfejsu API, które nie wymagają tokenów OAuth 2.0, uzyskaj klucz interfejsu API w wersji 3 na stronie https://cloud.google.com/console i używaj go zarówno w wersji 2, jak i w wersji 3.

Zalecamy przeniesienie aplikacji na interfejs API w wersji 3, jeśli to możliwe, nawet jeśli nadal musisz wywoływać interfejs API w wersji 2 w przypadku niektórych funkcji. Dzięki temu Twoja aplikacja będzie mogła korzystać z bardziej zaawansowanych funkcji, które oferuje wersja 3. Uprościsz też przyszłe migracje, gdy w końcu udostępnimy funkcje tylko w wersji 2, które będą obsługiwane w wersji 3.