Videos: update

Interfejs API obsługuje teraz możliwość oznaczania kanału lub filmów jako przeznaczonych dla dzieci. Dodatkowo zasoby 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:
  • contentDetails
  • fileDetails
  • id
  • liveStreamingDetails
  • localizations
  • player
  • processingDetails
  • recordingDetails
  • snippet
  • statistics
  • status
  • suggestions
  • topicDetails
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 element snippet zasobu video.
    • snippet.categoryId – ta właściwość jest wymagana tylko wtedy, gdy w żądaniu zostanie zaktualizowany element snippet zasobu video.

  • 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 na private.
    • 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.