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.