channel
i video
zawierają też usługę, która wskazuje, że dany kanał lub film jest oznaczony jako przeznaczony dla dzieci. Warunki korzystania z usług YouTube oraz zasady dla deweloperów zostały zaktualizowane 10 stycznia 2020 r. Aby uzyskać więcej informacji, zapoznaj się z historiami zmian usługi YouTube Data API oraz Warunków korzystania z usług interfejsu API YouTube.
Aktualizuje metadane filmu.
Wpływ limitu: wywołanie tej metody ma limit kosztów wynoszący 50 jednostek.
Typowe przypadki użycia
Żądanie
Żądanie HTTP
PUT https://www.googleapis.com/youtube/v3/videos
Upoważnienie
To żądanie wymaga autoryzacji z co najmniej jednym z poniższych 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 poniższej tabeli podano parametry obsługiwane przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.
Parametry | ||
---|---|---|
Parametry wymagane | ||
part |
string Parametr part spełnia 2 cele w tej operacji. Określa właściwości, które ustawi operacja zapisu, oraz właściwości, które będzie zawierać odpowiedź interfejsu API.Pamiętaj, że ta metoda zastąpi istniejące wartości dla wszystkich właściwości zmiennych, które są zawarte w dowolnych częściach określonych w wartości parametru. Na przykład część status zawiera ustawienia prywatności filmu. Oznacza to, że jeśli żądanie dotyczy prywatnego filmu, a jego wartość part zawiera część status , ustawienie prywatności filmu zostanie zaktualizowane do dowolnej wartości określonej w treści żądania. Jeśli treść żądania nie określisz wartości, istniejące ustawienie prywatności zostanie usunięte, a film zostanie przywrócony do ustawień domyślnych.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 obliczone przez YouTube dla filmu i nie zawiera wartości, które można ustawić lub zmodyfikować. Jeśli wartość parametru zawiera zmienną part , która nie zawiera zmiennych, ten parametr part nadal będzie uwzględniany w odpowiedzi interfejsu API.Ta lista zawiera nazwy part , które możesz uwzględnić w wartości parametru:
|
|
Parametry opcjonalne | ||
onBehalfOfContentOwner |
string Ten parametr może być używany tylko w poprawnie autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów w sieci reklamowej YouTube. Parametr onBehalfOfContentOwner wskazuje, że dane logowania żądania autoryzacji to użytkownik 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 w sieci reklamowej YouTube, którzy mają wiele kanałów YouTube i zarządzają nimi. Umożliwia właścicielom treści uwierzytelnianie tylko raz oraz dostęp do wszystkich filmów i kanałów bez konieczności podawania danych uwierzytelniających dla każdego kanału z osobna. Rzeczywiste konto CMS, z którego użytkownik się uwierzytelnia, musi być powiązane z określonym właścicielem treści w YouTube. |
Treść żądania
Umieść zasób wideo w treści żądania. Dla tego zasobu:
-
Musisz określić wartość tych właściwości:
id
snippet.title
– ta właściwość jest wymagana tylko wtedy, gdy w żądaniu zostanie zaktualizowany elementsnippet
zasobuvideo
.snippet.categoryId
– ta właściwość jest wymagana tylko wtedy, gdy w żądaniu zostanie zaktualizowany elementsnippet
zasobuvideo
.
-
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ść dla tej właściwości, musisz też ustawić właściwośćstatus.privacyStatus
naprivate
.status.selfDeclaredMadeForKids
recordingDetails.locationDescription
(wycofane)recordingDetails.location.latitude
(wycofane)recordingDetails.location.longitude
(wycofane)recordingDetails.recordingDate
localizations.(key)
localizations.(key).title
localizations.(key).description
Jeśli przesyłasz prośbę o aktualizację, ale nie określa ona wartości właściwości, która już ma wartość, obecna wartość usługi zostanie usunięta.
Odpowiedź
Jeśli operacja się uda, ta 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 informacji znajdziesz w dokumentacji komunikatów o błędach.
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
badRequest (400) |
defaultLanguageNotSet |
Żądanie API próbuje dodać zlokalizowane szczegóły filmu bez określania 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 |
Żądanie próbuje skonfigurować nieprawidłowe ustawienie prywatności dla transmisji domyślnej. |
badRequest (400) |
invalidDescription |
Metadane żądania podaj nieprawidłowy opis filmu. |
badRequest (400) |
invalidPublishAt |
Metadane żądania wskazują nieprawidłowy 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 wideo. |
badRequest (400) |
invalidTitle |
Metadane żądania podają nieprawidłowy lub pusty tytuł filmu. |
badRequest (400) |
invalidVideoMetadata |
Metadane żądania są nieprawidłowe. |
forbidden (403) |
forbidden |
|
forbidden (403) |
forbiddenEmbedSetting |
Żądanie próbuje skonfigurować nieprawidłowe ustawienie umieszczenia 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 |
Żądanie próbuje ustawić nieprawidłową licencję na film. |
forbidden (403) |
forbiddenPrivacySetting |
Żądanie próbuje skonfigurować nieprawidłowe ustawienie prywatności filmu. |
notFound (404) |
videoNotFound |
Nie można znaleźć filmu, który próbujesz zaktualizować. Sprawdź, czy pole id w treści żądania jest prawidłowe. |
Wypróbuj
Użyj APIs Explorer, aby wywołać ten interfejs API i wyświetlić żądanie oraz odpowiedź interfejsu API.