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:
|
|
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.