Videos: update

Interfejs API umożliwia teraz oznaczanie kanału lub filmów jako "przeznaczone dla dzieci". Oprócz tego zasoby channel i video zawierają teraz właściwość, która określa stan "przeznaczone dla dzieci" danego kanału lub filmu. 10 stycznia 2020 r. zaktualizowaliśmy też Warunki korzystania z usług YouTube API i Zasady dla deweloperów . Więcej informacji znajdziesz w historii zmian dotyczących usługi YouTube Data API i Warunków korzystania z usług YouTube API.

Aktualizuje metadane filmu.

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

Częste zastosowania

Żądanie

Żądanie HTTP

PUT https://www.googleapis.com/youtube/v3/videos

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/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

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 pełni w tej operacji 2 funkcje. Określa właściwości, które zostaną ustawione przez operację zapisu, oraz właściwości, które będą uwzględnione w odpowiedzi interfejsu API.

Pamiętaj, że ta metoda zastąpi dotychczasowe wartości wszystkich zmiennych właściwości zawartych w częściach określonych przez wartość parametru. Na przykład ustawienie prywatności filmu znajduje się w części status. Jeśli więc żądanie aktualizuje film prywatny, a wartość parametru part żądania zawiera część status, ustawienie prywatności filmu zostanie zaktualizowane do wartości określonej w treści żądania. Jeśli treść żądania nie określa wartości, dotychczasowe ustawienie prywatności zostanie usunięte, a film powróci do domyślnego ustawienia prywatności.

Ponadto nie wszystkie części zawierają właściwości, które można ustawić podczas wstawiania lub aktualizowania filmu. Na przykład obiekt statistics zawiera statystyki obliczane przez YouTube dla filmu i nie zawiera wartości, które można ustawić lub zmodyfikować. Jeśli wartość parametru określa part, która nie zawiera zmiennych wartości, ta part nadal będzie uwzględniana w odpowiedzi interfejsu API.

Poniżej znajdziesz listę nazw part, które możesz uwzględnić w wartości parametru:
  • brandPartner
  • contentDetails
  • fileDetails
  • id
  • liveStreamingDetails
  • localizations
  • paidProductPlacementDetails
  • player
  • processingDetails
  • recordingDetails
  • snippet
  • statistics
  • status
  • suggestions
  • topicDetails
Parametry opcjonalne
onBehalfOfContentOwner string
Ten parametr można używać 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 zarządzania treścią w 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 dotyczących ich filmów i kanałów 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.

Treść żądania

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

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

    • id
    • snippet.title – ta właściwość jest wymagana tylko wtedy, gdy żądanie aktualizuje zasobu video snippet.
    • snippet.categoryId – ta właściwość jest wymagana tylko wtedy, gdy żądanie aktualizuje zasobu video snippet.

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

    • snippet.categoryId
    • snippet.defaultLanguage
    • snippet.description
    • snippet.tags[]
    • snippet.title
    • status.embeddable
    • status.license
    • status.privacyStatus
    • status.publicStatsViewable
    • status.publishAt – jeśli ustawisz wartość tej właściwości, musisz też ustawić właściwość status.privacyStatus na private. Tę właściwość można ustawić tylko wtedy, gdy stan prywatności filmu to private i film nigdy nie został opublikowany.
    • status.selfDeclaredMadeForKids
    • status.containsSyntheticMedia
    • recordingDetails.recordingDate
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description

    Jeśli przesyłasz żądanie aktualizacji i nie określisz w nim wartości właściwości, która już ma wartość, dotychczasowa wartość właściwości zostanie usunięta.

Odpowiedź

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

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
badRequest (400) defaultLanguageNotSet Żądanie do interfejsu API próbuje dodać zlokalizowane szczegóły filmu bez określenia domyślnego języka tych szczegółów.
badRequest (400) invalidCategoryId Właściwość snippet.categoryId określa nieprawidłowy identyfikator kategorii. Aby pobrać obsługiwane kategorie, użyj metody videoCategories.list.
badRequest (400) invalidDefaultBroadcastPrivacySetting Żądanie próbuje ustawić nieprawidłowe ustawienie prywatności dla domyślnej transmisji.
badRequest (400) invalidDescription Metadane żądania określają nieprawidłowy opis filmu.
badRequest (400) invalidPublishAt Metadane żądania określają nieprawidłowy zaplanowany czas publikacji.
badRequest (400) invalidRecordingDetails Obiekt recordingDetails w metadanych żądania określa nieprawidłowe szczegóły nagrania.
badRequest (400) invalidTags Metadane żądania określają nieprawidłowe słowa kluczowe filmu.
badRequest (400) invalidTitle Metadane żądania określają nieprawidłowy lub pusty tytuł filmu.
badRequest (400) invalidVideoMetadata Metadane żądania są nieprawidłowe.
forbidden (403) forbidden
forbidden (403) forbiddenEmbedSetting Żądanie próbuje ustawić nieprawidłowe ustawienie osadzania filmu. Pamiętaj, że niektóre kanały mogą nie mieć uprawnień do oferowania osadzonych odtwarzaczy w przypadku transmisji na żywo. Więcej informacji znajdziesz w Centrum pomocy YouTube.
forbidden (403) forbiddenLicenseSetting Żądanie próbuje ustawić nieprawidłową licencję filmu.
forbidden (403) forbiddenPrivacySetting Żądanie próbuje ustawić nieprawidłowe ustawienie prywatności filmu.
notFound (404) videoNotFound Nie można znaleźć filmu, który próbujesz zaktualizować. Sprawdź, czy wartość pola id w treści żądania jest prawidłowa.

Wypróbuj

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