Captions: download

Pobiera ścieżkę z napisami. Ścieżka z napisami jest zwracana w oryginalnym formacie, chyba że żądanie określa wartość parametru tfmt, oraz w oryginalnym języku, chyba że żądanie określa wartość parametru tlang.

Wpływ na limit: wywołanie tej metody ma koszt limitu wynoszący 200 jednostek.

Typowe zastosowania

Żądanie

Żądanie HTTP

GET https://www.googleapis.com/youtube/v3/captions/id

Autoryzacja

To żądanie wymaga autoryzacji z co najmniej jednym z tych zakresów (więcej informacji o uwierzytelnianiu i autoryzacji).

Zakres
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtubepartner

Parametry

Tabela poniżej zawiera listę parametrów obsługiwanych przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry wymagane
id string
Parametry id identyfikują ścieżkę napisów, która jest pobierana. Wartość to identyfikator ścieżki napisów, który jest identyfikowany przez właściwość id w zasobach caption.
Parametry opcjonalne
onBehalfOfContentOwner string
Tego parametru można używać tylko w prawidłowo autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów treści YouTube.

Parametr onBehalfOfContentOwner wskazuje, że dane autoryzacyjne prośby identyfikują użytkownika systemu CMS YouTube, który działa w imieniu właściciela treści określonego w wartości parametru. Ten parametr jest przeznaczony dla partnerów treści w YouTube, którzy są właścicielami wielu kanałów YouTube i nimi zarządzają. Umożliwia ona właścicielom treści jednorazową weryfikację i uzyskanie dostępu do wszystkich danych o filmach i kanałach bez konieczności podawania danych logowania do każdego kanału. Konto CMS, za pomocą którego użytkownik się uwierzytelnia, musi być powiązane ze wskazanym właścicielem treści w YouTube.
tfmt string
Parametr tfmt określa, że ścieżka z napisami powinna zostać zwrócona w określonym formacie. Jeśli parametr nie jest uwzględniony w żądaniu, utwór jest zwracany w pierwotnym formacie.

Obsługiwane wartości:
  • sbv – napisy SubViewer
  • scc – format Scenarist Closed Caption
  • srt – napisy SubRip
  • ttml – napisy w formacie Timed Text Markup Language
  • vtt – napisy do ścieżek tekstowych w filmach internetowych
tlang string
Parametr tlang określa, że odpowiedź interfejsu API powinna zawierać tłumaczenie określonego ścieżki napisów. Wartość parametru to dwuliterowy kod języka w standardzie ISO 639-1, który wskazuje język napisów. Tłumaczenie jest generowane za pomocą tłumaczenia maszynowego, takiego jak Tłumacz Google.

Treść żądania

Podczas wywoływania tej metody nie podawaj treści żądania.

Odpowiedź

Jeśli operacja się powiedzie, metoda zwróci plik binarny. Nagłówek Content-Type odpowiedzi to application/octet-stream.

Błędy

Tabela poniżej zawiera komunikaty o błędach, które interfejs API może zwrócić w odpowiedzi na wywołanie tej metody. Więcej informacji znajdziesz w dokumentacji dotyczącej komunikatów o błędach.

Typ błędu Szczegóły błędu Opis
forbidden (403) forbidden Uprawnienia powiązane z żądaniem nie są wystarczające do pobrania ścieżki z napisami. Prośba może nie być prawidłowo autoryzowana.
invalidValue (400) couldNotConvert Nie udało się przekonwertować danych ścieżki z napisami na żądany język lub format. Upewnij się, że żądane wartości tfmt i tlang są prawidłowe oraz że snippet.status żądanego ścieżki napisów nie jest failed.
notFound (404) captionNotFound Nie udało się znaleźć ścieżki z napisami. Sprawdź wartość parametru id żądania, aby się upewnić, że jest prawidłowa.

Wypróbuj

Użyj adresu APIs Explorer, aby wywołać ten interfejs API i zobaczyć żądanie oraz odpowiedź interfejsu API.