Captions: download

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

Wpływ na limit: wywołanie tej metody kosztuje 200 jednostek limitu.

Ta metoda wymaga, aby użytkownik miał uprawnienia do edytowania filmu.

Częste 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

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

Parametry
Parametry wymagane
id string
Parametr id identyfikuje pobieraną ścieżkę z napisami. Wartość to 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 prawidłowo autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów YouTube.

Parametr onBehalfOfContentOwner wskazuje, że dane uwierzytelniające autoryzację żądania identyfikują użytkownika systemu CMS YouTube, który działa w imieniu właściciela treści określonego w wartości parametru. Parametr `**onBehalfOfContentOwner**` wskazuje, że dane uwierzytelniające żądania identyfikują użytkownika systemu CMS YouTube, który działa w imieniu właściciela treści określonego w wartości parametru. Umożliwia to właścicielom treści jednokrotne uwierzytelnienie i uzyskanie dostępu do wszystkich danych wideo i danych kanału bez konieczności podawania danych uwierzytelniających dla każdego pojedynczego kanału. Rzeczywiste konto CMS, za pomocą którego uwierzytelnia się użytkownik, musi być połączone z określonym 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. `string`Parametr `**tfmt**` określa, że ścieżka z napisami powinna zostać zwrócona w określonym formacie.Jeśli parametr nie zostanie uwzględniony w żądaniu, ścieżka zostanie zwrócona w oryginalnym formacie.

Obsługiwane wartości to:
  • sbv – Napisy SubViewer
  • scc – format napisów Scenarist Closed Caption
  • srt – format napisów SubRip
  • ttml – napisy w języku znaczników Timed Text Markup Language
  • vtt – napisy w formacie Timed Text Markup Language
tlang string
Parametr tlang określa, że odpowiedź interfejsu API powinna zawierać tłumaczenie określonej ścieżki z napisami. Wartość parametru to 2-literowy kod języka ISO 639-1, który identyfikuje żądany język napisów. Tłumaczenie jest generowane za pomocą 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, ta metoda zwróci plik binarny. Nagłówek Content-Type w 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 z napisami. Żądanie może nie być prawidłowo autoryzowane.
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 żądanej ścieżki z napisami nie ma wartości failed.
notFound (404) captionNotFound Nie udało się znaleźć ścieżki z napisami. Sprawdź wartość parametru id w żądaniu, aby upewnić się, że jest prawidłowa.

Wypróbuj

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