Ta strona została przetłumaczona przez Cloud Translation API.

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.