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

Videos: update

Interfejs API umożliwia teraz oznaczanie kanału lub filmów jako przeznaczonych dla dzieci. Zasoby channel i video zawierają teraz także właściwość, która określa, czy dany kanał lub film jest „przeznaczony dla dzieci”. 10 stycznia 2020 r. zaktualizowaliśmy również Warunki korzystania z usług YouTube API oraz zasady dla deweloperów. Aby dowiedzieć się więcej, zapoznaj się z historiami zmian usługi YouTube Data API oraz Warunkami korzystania z usług interfejsu YouTube API.

Aktualizuje metadane filmu.

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

Typowe przypadki użycia

Prośba

Żądanie HTTP

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

Upoważnienie

To żądanie 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/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 ustawi operacja zapisu, a także właściwości uwzględnione w odpowiedzi interfejsu API. Ta metoda zastąpi obecne wartości w przypadku wszystkich właściwości zmiennych, które znajdują się we wszystkich częściach określonych w wartości parametru. Na przykład ustawienia prywatności filmu znajdują się w części `status`. W związku z tym, jeśli Twoje żądanie aktualizuje prywatny film, a jego wartość parametru `part` zawiera część `status`, ustawienia prywatności tego filmu zostaną zmienione na dowolną wartość określoną w treści żądania. Jeśli treść żądania nie będzie określać wartości, istniejące ustawienie prywatności zostanie usunięte, a film zostanie przywrócony do ustawień domyślnych. Ponadto nie wszystkie elementy zawierają właściwości, które można ustawić podczas wstawiania lub aktualizowania filmu. Na przykład obiekt `statistics` zawiera statystyki filmu obliczane przez YouTube i nie zawiera wartości, które można ustawić lub zmienić. Jeśli wartość parametru określa element `part`, który nie zawiera wartości zmiennych, będzie on nadal uwzględniony w odpowiedzi interfejsu API. Na poniższej liście znajdziesz nazwy `part`, które możesz uwzględnić w wartości parametru: `part` `contentDetails` `fileDetails` `id` `liveStreamingDetails` `localizations` `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 dostawców treści w YouTube. Parametr `onBehalfOfContentOwner` wskazuje, że dane uwierzytelniające żądanie identyfikują użytkownika YouTube CMS działającego w imieniu właściciela treści określonego w wartości parametru. Jest on przeznaczony dla dostawców treści w YouTube, którzy mają wiele różnych kanałów w YouTube i nimi zarządzają. Dzięki niej właściciele treści mogą jednorazowo uwierzytelnić się i uzyskiwać dostęp do wszystkich swoich filmów oraz danych dotyczących kanałów bez konieczności podawania danych uwierzytelniających dla każdego kanału z osobna. Konto CMS, za pomocą którego użytkownik uwierzytelnia się, musi być powiązane z określonym właścicielem treści 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 wartość snippet zasobu video.
- snippet.categoryId – ta właściwość jest wymagana tylko wtedy, gdy żądanie aktualizuje wartość 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ść dla tej właściwości, musisz też ustawić we właściwości status.privacyStatus wartość private.
- status.selfDeclaredMadeForKids
- recordingDetails.locationDescription (wycofano)
- recordingDetails.location.latitude (wycofano)
- recordingDetails.location.longitude (wycofano)
- recordingDetails.recordingDate
- localizations.(key)
- localizations.(key).title
- localizations.(key).description
Jeśli przesyłasz prośbę o aktualizację usługi, która ma już wartość, ale nie jest w niej określona, obecna wartość usługi zostanie usunięta.

Odpowiedź

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

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 szczegółów znajdziesz w dokumentacji komunikatów o błędach.

Typ błędu	Szczegóły błędu	Opis
`badRequest (400)`	`defaultLanguageNotSet`	Żądanie do interfejsu API ma na celu dodanie zlokalizowanych szczegółów filmu bez określenia domyślnego języka szczegółów filmu.
`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`	Wystąpiła próba ustawienia nieprawidłowego ustawienia 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 czas zaplanowanej 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 wideo.
`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`	W żądaniu zażądano ustawienia nieprawidłowego ustawienia umieszczania filmu. Pamiętaj, że niektóre kanały mogą nie mieć uprawnień do oferowania osadzonych odtwarzaczy podczas transmisji na żywo. Więcej informacji znajdziesz w Centrum pomocy YouTube.
`forbidden (403)`	`forbiddenLicenseSetting`	To żądanie próbuje ustawić nieprawidłową licencję dla filmu.
`forbidden (403)`	`forbiddenPrivacySetting`	Żądanie stanowi próbę ustawienia nieprawidłowego ustawienia prywatności filmu.
`notFound (404)`	`videoNotFound`	Nie można znaleźć filmu, który próbujesz zaktualizować. Sprawdź, czy wartość w polu `id` w treści żądania jest prawidłowa.

Wypróbuj

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