Captions: download

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

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

Typowe przypadki użycia

Żądanie

Żądanie HTTP

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

Upoważnienie

To żądanie wymaga autoryzacji z co najmniej jednym z poniższych 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
Parametr id wskazuje pobieraną ścieżkę napisów. Wartością jest identyfikator ścieżki z napisami określony przez właściwość id w zasobie caption.
Parametry opcjonalne
onBehalfOfContentOwner string
Ten parametr może być używany tylko w poprawnie autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów w sieci reklamowej YouTube.

Parametr onBehalfOfContentOwner wskazuje, że dane logowania żądania autoryzacji to użytkownik 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 w sieci reklamowej YouTube, którzy mają wiele kanałów YouTube i zarządzają nimi. Umożliwia właścicielom treści uwierzytelnianie tylko raz oraz dostęp do wszystkich filmów i kanałów bez konieczności podawania danych uwierzytelniających dla każdego kanału z osobna. Rzeczywiste konto CMS, z którego użytkownik się uwierzytelnia, musi być powiązane z określonym właścicielem treści w YouTube.
tfmt string
Parametr tfmt wskazuje, że ścieżka z napisami powinna być zwrócona w określonym formacie. Jeśli żądanie nie zawiera parametru, utwór jest zwracany w oryginalnym formacie.

Obsługiwane wartości to:
  • sbv – podtytuł użytkownika
  • scc – format napisów Scenarist
  • srt – podtytuł SubRip
  • ttml – podpis w języku znaczników czasowych
  • vtt – napisy do internetowych ścieżek wideo
tlang string
Parametr tlang wskazuje, że odpowiedź interfejsu API powinna zwracać tłumaczenie określonej ścieżki z napisami. Wartość parametru to dwuliterowy kod języka w standardzie ISO 639-1, który wskazuje wybrany język napisów. Tłumaczenia są generowane z wykorzystaniem tłumaczenia maszynowego, np. Tłumacza Google.

Treść żądania

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

Odpowiedź

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

Błędy

W tabeli poniżej znajdziesz 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 komunikatów o błędach.

Typ błędu Szczegóły błędu Opis
forbidden (403) forbidden Uprawnienia powiązane z żądaniem są niewystarczające do pobrania ścieżki napisów. Prośba mogła nie zostać poprawnie autoryzowana lub zamówienie wideo nie umożliwiało dodania napisów dla osób trzecich.
invalidValue (400) couldNotConvert Nie udało się przekonwertować danych ścieżki napisów na żądany język lub format. Sprawdź, czy żądane wartości tfmt i tlang są prawidłowe, a snippet.status podanej ścieżki audio nie zawiera wartości failed.
notFound (404) captionNotFound Nie udało się znaleźć ścieżki z napisami. Sprawdź, czy wartość parametru id żądania jest prawidłowa.

Wypróbuj

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