Videos: update

Interfejs API umożliwia teraz oznaczenie kanału lub filmów jako przeznaczonych dla dzieci. Dodatkowo zasoby channel i video zawierają teraz właściwość, która wskazuje, że kanał lub film jest oznaczony jako przeznaczony dla dzieci. 10 stycznia 2020 r. zaktualizowaliśmy też Warunki korzystania z usług interfejsu API YouTube oraz Zasady dla deweloperów. Więcej informacji znajdziesz w historiach zmian usługi YouTube Data API oraz Warunkach korzystania z tych usług.

Aktualizuje metadane filmu.

Wpływ na limit: wywołanie tej metody ma koszt związany z limitem wynoszący 50 jednostek.

Typowe 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 służy w tej operacji do 2 celów. Określa właściwości, które zostaną ustawione przez operację zapisu, a także 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 właściwości, które można zmienić, a które są zawarte w dowolnych częściach określonych przez wartość parametru. Na przykład ustawienia prywatności filmu znajdują się w sekcji status. Jeśli więc Twoje żądanie dotyczy aktualizacji filmu prywatnego, a wartość parametru part zawiera część status, ustawienie prywatności filmu zostanie zaktualizowane zgodnie z wartością podaną w ciele żądania. Jeśli treść żądania nie określa wartości, obecne ustawienie prywatności zostanie usunięte, a film zostanie przywrócony do domyślnego ustawienia prywatności.

Poza tym 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żesz ustawić lub zmodyfikować. Jeśli wartość parametru określa part, który nie zawiera wartości, które można zmienić, ten part będzie nadal uwzględniany w odpowiedzi interfejsu API.

Następująca lista zawiera nazwy part, które możesz uwzględnić w wartości parametru:
  • contentDetails
  • fileDetails
  • id
  • liveStreamingDetails
  • localizations
  • paidProductPlacementDetails
  • player
  • processingDetails
  • recordingDetails
  • snippet
  • statistics
  • status
  • suggestions
  • topicDetails
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 do 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 w 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.

Treść żądania

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

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

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

  • Możesz ustawić wartości dla 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ć wartość właściwości status.privacyStatus na private.
    • status.selfDeclaredMadeForKids
    • status.containsSyntheticMedia
    • recordingDetails.recordingDate
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description

    Jeśli przesyłasz żądanie aktualizacji, a w prośbie nie ma 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ę powiedzie, metoda zwróci w treści odpowiedzi zasob filmowy.

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. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją dotyczącą komunikatów o błędach.

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSet Żądanie 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ślnego kanału.
badRequest (400) invalidDescription Metadane żądania zawierają nieprawidłowy opis filmu.
badRequest (400) invalidPublishAt Metadane żądania podają nieprawidłowy zaplanowany czas publikacji.
badRequest (400) invalidRecordingDetails Obiekt recordingDetails w metadanych żądania zawiera nieprawidłowe szczegóły nagrywania.
badRequest (400) invalidTags Metadane żądania zawierają nieprawidłowe słowa kluczowe filmu.
badRequest (400) invalidTitle Metadane żądania zawierają 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 osadzenia filmu. Pamiętaj, że niektóre kanały mogą nie mieć uprawnień do oferowania osadzonych odtwarzaczy dla transmisji na żywo. Więcej informacji znajdziesz w Centrum pomocy YouTube.
forbidden (403) forbiddenLicenseSetting Żądanie próbuje ustawić nieprawidłową licencję dla 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ź wartość pola id w treści żądania, aby upewnić się, że jest prawidłowa.

Wypróbuj

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