Channels: 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 kanału. Pamiętaj, że ta metoda obecnie obsługuje tylko aktualizacje obiektów brandingSettings, invideoPromotion i localizations zasobu channel oraz ich właściwości podrzędnych.

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/channels

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.

Obecnie w interfejsie API można ustawić tylko wartość parametru: brandingSettings, invideoPromotion lub localizations. (jedną z tych części możesz zaktualizować tylko w jednym żądaniu).

Pamiętaj, że ta metoda zastępuje istniejące wartości wszystkich właściwości zmiennych, które są zawarte w części określonej przez wartość parametru.
Parametry opcjonalne
onBehalfOfContentOwner string
Ten parametr może być używany tylko w poprawnie autoryzowanym żądaniu. Parametr onBehalfOfContentOwner wskazuje, że uwierzytelniony użytkownik działa w imieniu właściciela treści wskazanego 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, za pomocą którego uwierzytelnia się użytkownik, musi być połączone z określonym właścicielem treści w YouTube.

Treść żądania

Podaj zasób kanału w treści żądania. Dla tego zasobu:

  • Musisz określić wartość tych właściwości:

    • id

  • Możesz ustawić wartości tych właściwości:

    • brandingSettings.channel.country
    • brandingSettings.channel.description
    • brandingSettings.channel.defaultLanguage
    • brandingSettings.channel.keywords
    • brandingSettings.channel.moderateComments
    • brandingSettings.channel.trackingAnalyticsAccountId
    • brandingSettings.channel.unsubscribedTrailer
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description
    • status.selfDeclaredMadeForKids

    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 kanału 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) brandingValidationError Jedna z wartości w obiekcie brandingSettings nie przeszła weryfikacji. Użyj metody channels.list, aby pobrać istniejące ustawienia kanału i zaktualizować wartości właściwości zgodnie ze wskazówkami w dokumentacji zasobu channels.
badRequest (400) channelTitleUpdateForbidden Podczas aktualizowania brandingSettings part kanału musisz ustawić wartość właściwości brandingSettings.channel.title na aktualny tytuł kanału lub pominąć tę właściwość. Interfejs API zwróci błąd, jeśli zmienisz wartość usługi.
badRequest (400) defaultLanguageNotSetError Musisz skonfigurować właściwość defaultLanguage, aby zaktualizować localizations.
badRequest (400) invalidBrandingOption Jedno z podanych ustawień marki nie istnieje. Aby pobrać prawidłowe wartości, użyj metody channels.list i pamiętaj o ich zaktualizowaniu zgodnie ze wskazówkami w dokumentacji zasobów channels.
badRequest (400) invalidCustomMessage Metadane żądania wskazują nieprawidłowy komunikat niestandardowy. Sprawdź wartość właściwości invideoPromotion.items[].customMessage w zasobie, który wysłał żądanie.
badRequest (400) invalidDuration Metadane żądania określają nieprawidłowy czas trwania w części invideopromotion.
badRequest (400) invalidDuration Metadane żądania określają nieprawidłowy typ pozycji określającej położenie promowanego elementu w odtwarzaczu. Sprawdź wartość właściwości invideoPromotion.position.type w zasobie, który wysłał żądanie.
badRequest (400) invalidRecentlyUploadedBy Metadane żądania podają nieprawidłowy identyfikator kanału. Sprawdź wartość właściwości invideoPromotion.items[].id.recentlyUploadedBy w zasobie, który wysłał żądanie.
badRequest (400) invalidTimingOffset Metadane żądania wskazują nieprawidłowe przesunięcie czasowe w części invideopromotion.
badRequest (400) invalidTimingOffset Metadane żądania wskazują nieprawidłowe przesunięcie czasowe określające, kiedy promowany produkt powinien zostać wyświetlony w odtwarzaczu. Sprawdź wartość właściwości invideoPromotion.timing.offsetMs w zasobie, który wysłał żądanie.
badRequest (400) invalidTimingType Metadane żądania określają nieprawidłową metodę określania czasu, w którym promowany produkt powinien być wyświetlany w odtwarzaczu. Sprawdź wartość właściwości invideoPromotion.timing.type w zasobie, który wysłał żądanie.
badRequest (400) localizationValidationError Jedna z wartości w obiekcie lokalizacji nie przeszła weryfikacji. Aby pobrać prawidłowe wartości, użyj metody channels.list i pamiętaj o ich zaktualizowaniu zgodnie ze wskazówkami w dokumentacji zasobów kanału.
badRequest (400) tooManyPromotedItems W części invideopromotion została przekroczona dozwolona liczba elementów objętych promocją.
forbidden (403) channelForbidden Kanał określony w parametrze id nie obsługuje żądania lub nie jest ono prawidłowo autoryzowane.
forbidden (403) promotedVideoNotAllowed Nie udało się znaleźć kanału, który próbujesz zaktualizować API. Sprawdź wartość właściwości id w zasobie channel, który wysłał żądanie, aby mieć pewność, że identyfikator kanału jest prawidłowy.
forbidden (403) websiteLinkNotAllowed Podany adres URL witryny jest niedozwolony.
notFound (404) channelNotFound Nie można znaleźć kanału określonego w parametrze id.
notFound (404) channelNotFound Nie można znaleźć kanału określonego za pomocą parametru id lub nie są dostępne żadne opcje promowania marki.
notFound (404) unknownChannelId Nie znaleziono podanego identyfikatora kanału.
notFound (404) unknownChannelId Nie znaleziono podanego identyfikatora kanału.
notFound (404) unknownVideoId Nie można znaleźć identyfikatora filmu określonego jako promowany produkt.
required (400) requiredItemIdType Metadane żądania muszą określać typ elementu w sekcji invideopromotion.
required (400) requiredItemId Metadane żądania muszą zawierać identyfikator elementu, który jest częścią invideopromotion.
required (400) requiredTimingOffset Metadane żądania muszą określać domyślne przesunięcie czasowe, aby YouTube mogło określić, kiedy wyświetlić promowany produkt. Ustaw wartość właściwości invideoPromotion.defaultTiming.offsetMs w zasobie wysyłanym przez żądanie.
required (400) requiredTimingOffset Metadane żądania muszą określać przesunięcie czasowe, aby YouTube mógł określić, kiedy wyświetlić promowany produkt. Ustaw wartość właściwości invideoPromotion.timing.offsetMs w zasobie wysyłanym przez żądanie.
required (400) requiredTimingType Metadane żądania muszą określać metodę czasową, aby YouTube mógł określić, kiedy wyświetla się promowany produkt. Ustaw wartość właściwości invideoPromotion.defaultTiming.type w zasobie wysyłanym przez żądanie.
required (400) requiredTimingType Metadane żądania muszą określać metodę czasową, aby YouTube mógł określić, kiedy wyświetla się promowany produkt. Ustaw wartość właściwości invideoPromotion.timing.type w zasobie wysyłanym przez żądanie.
required (400) requiredTiming Metadane żądania muszą zawierać informacje o czasie w elemencie invideoPromotion.
required (400) requiredVideoId Metadane żądania muszą zawierać identyfikator filmu, aby można było zidentyfikować promowany produkt.
required (400) requiredWebsiteUrl Metadane żądania muszą zawierać adres URL witryny w sekcji invideopromotion. Ustaw wartość właściwości invideoPromotion.items[].id.websiteUrl w zasobie wysyłanym przez żądanie.

Wypróbuj

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