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

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.