Captions: insert

Przesyła ścieżkę z napisami.

Ta metoda obsługuje przesyłanie multimediów. Przesłane pliki muszą być zgodne z tymi ograniczeniami:

  • Maksymalny rozmiar pliku: 100 MB
  • Akceptowane typy MIME multimediów: text/xml, application/octet-stream, */*

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

Typowe zastosowania

Żądanie

Żądanie HTTP

POST https://www.googleapis.com/upload/youtube/v3/captions

Autoryzacja

To żądanie wymaga autoryzacji z co najmniej jednym z tych zakresów. Więcej informacji o uwierzytelnianiu i autoryzowaniu znajdziesz w artykule Wdrażanie autoryzacji OAuth 2.0.

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
part string
Parametry part określają części zasobu caption, które będą uwzględnione w odpowiedzi interfejsu API. Ustaw wartość parametru na snippet.

Na tej liście znajdziesz part nazwy, które możesz uwzględnić w wartości parametru:
  • id
  • snippet
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 uwierzytelniające autoryzacji żądania 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 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 uwierzytelniających dla 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.
sync boolean
Ten parametr został wycofany. Parametr sync wskazuje, czy YouTube ma automatycznie synchronizować plik napisów z ścieżką audio filmu. Jeśli ustawisz wartość na true, YouTube zignoruje kody czasu w przesłanym pliku z napisami i wygeneruje nowe kody czasu dla napisów.

Jeśli przesyłasz transkrypcję bez kodów czasu lub podejrzewasz, że kody czasu w pliku są nieprawidłowe i chcesz, aby YouTube je poprawił, ustaw parametr sync na true.

Treść żądania

W treści żądania podaj zasób caption. W przypadku tego zasobu:

Musisz podać wartość tych właściwości:

  • snippet.videoId
  • snippet.language
  • snippet.name

Możesz ustawiać wartości tych właściwości:

  • snippet.videoId
  • snippet.language
  • snippet.name
  • snippet.isDraft

Odpowiedź

Jeśli operacja się powiedzie, zwróci ona w treści odpowiedzi zasób caption.

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 artykule Błędy w interfejsie YouTube Data API.

Typ błędu Szczegóły błędu Opis
badRequest (400) contentRequired Żądanie nie zawiera treści ścieżki z napisami.
conflict (409) captionExists Podany film ma już ścieżkę z napisami z podanymi wartościami snippet.language i snippet.name. Film może mieć wiele ścieżek w tym samym języku, ale każda ścieżka musi mieć inną nazwę.

Istnieje kilka sposobów na rozwiązanie tego problemu. Możesz usunąć istniejący utwór, a następnie wstawić nowy lub zmienić nazwę nowego utworu przed jego wstawieniem.
forbidden (403) forbidden Uprawnienia powiązane z żądaniem nie są wystarczające do przesłania ścieżki z napisami. Prośba może nie być prawidłowo autoryzowana.
invalidValue (400) invalidMetadata Żądanie zawiera nieprawidłowe wartości metadanych, które uniemożliwiają utworzenie utworu. Sprawdź, czy żądanie zawiera prawidłowe wartości właściwości snippet.language, snippet.name i snippet.videoId. Możesz też podać właściwość snippet.isDraft, ale nie jest to wymagane.
notFound (404) videoNotFound Nie udało się znaleźć filmu zidentyfikowanego przez parametr videoId.
invalidValue (400) nameTooLong W żądaniu podany parametr snippet.name jest za długi. Maksymalna długość to 150 znaków.

Wypróbuj

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