Captions: update

Aktualizuje ścieżkę z napisami. Podczas aktualizowania ścieżki z napisami możesz zmienić jej stan wersji roboczej, przesłać nowy plik z napisami lub wykonać obie te czynności.

Ta metoda obsługuje przesyłanie multimediów. Przesłane pliki muszą spełniać te ograniczenia:

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

Wpływ na limit: wywołanie tej metody wiąże się z kosztem limitu w wysokości 450 jednostek.

Częste przypadki użycia

Żądanie

Żądanie HTTP

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

Autoryzacja

Ta prośba wymaga autoryzacji z użyciem co najmniej jednego 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 parametry obsługiwane przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry wymagane
part string
Parametr part służy w tej operacji do 2 celów. Określa właściwości, które operacja zapisu ustawi, oraz właściwości, które będą uwzględnione w odpowiedzi interfejsu API. Jeśli aktualizujesz stan wersji roboczej utworu, ustaw wartość właściwości na snippet. W przeciwnym razie ustaw wartość właściwości na id.

Poniższa lista zawiera nazwy part, które możesz uwzględnić w wartości parametru:
  • id
  • snippet
Parametry opcjonalne
onBehalfOfContentOwner string
Tego parametru można używać tylko w odpowiednio autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów YouTube zajmujących się treściami.

Parametr onBehalfOfContentOwner oznacza, że dane logowania autoryzacji żądania identyfikują użytkownika systemu YouTube CMS, który działa w imieniu właściciela treści określonego w wartości parametru. Ten parametr jest przeznaczony dla partnerów YouTube, którzy są właścicielami wielu różnych kanałów YouTube i nimi zarządzają. Dzięki temu właściciele treści mogą uwierzytelnić się raz i uzyskać dostęp do wszystkich danych dotyczących filmów i kanałów bez konieczności podawania danych uwierzytelniających dla każdego kanału. Rzeczywiste konto CMS, za pomocą którego użytkownik się uwierzytelnia, musi być połączone z określonym właścicielem treści w YouTube.
sync boolean
Ten parametr został wycofany. Uwaga: serwer interfejsu API przetwarza wartość parametru tylko wtedy, gdy żądanie zawiera zaktualizowany plik napisów.

Parametr sync określa, czy YouTube ma automatycznie synchronizować plik napisów ze ścieżką dźwiękową filmu. Jeśli ustawisz wartość true, YouTube automatycznie zsynchronizuje ścieżkę z napisami ze ścieżką audio.

Treść żądania

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

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

    • id

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

    • snippet.isDraft

    Jeśli przesyłasz prośbę o aktualizację, a nie określisz w niej wartości właściwości, która ma już wartość, dotychczasowa wartość właściwości zostanie usunięta.

Odpowiedź

Jeśli operacja się uda, ta metoda zwraca w treści odpowiedzi zasób napisów.

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 komunikatu o błędzie.

Typ błędu Szczegóły błędu Opis
badRequest (400) contentRequired W ramach żądania nie przesłano zaktualizowanego pliku z napisami. Rzeczywista zawartość ścieżki jest wymagana, jeśli parametr sync jest ustawiony na true.
forbidden (403) forbidden Uprawnienia powiązane z żądaniem nie są wystarczające do zaktualizowania ścieżki z napisami. Żądanie może nie być prawidłowo autoryzowane.
notFound (404) captionNotFound Nie udało się znaleźć określonej ścieżki z napisami. Sprawdź, czy wartość właściwości id żądania jest prawidłowa.

Wypróbuj

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