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, czy dany kanał lub film jest oznaczony jako przeznaczony dla dzieci. 10 stycznia 2020 r. zaktualizowaliśmy też Warunki korzystania z usług YouTube API i zasady dla deweloperów. Więcej informacji znajdziesz w historiach zmian w usłudze interfejsu YouTube Data API oraz w Warunkach korzystania z usług YouTube API.
Zasób channel
zawiera informacje o kanale w YouTube.
Metody
Interfejs API obsługuje te metody dotyczące zasobów channels
:
- list
- Zwraca kolekcję zerową lub większą liczbę zasobów typu
channel
, które pasują do kryteriów żądania. Wypróbuj teraz - zaktualizuj
- Aktualizuje metadane kanału. Pamiętaj, że ta metoda obecnie obsługuje tylko aktualizacje obiektów
brandingSettings
iinvideoPromotion
zasobuchannel
oraz jego właściwości podrzędnych. Wypróbuj teraz
Reprezentacja zasobów
Poniższa struktura JSON pokazuje format zasobu channels
:
{ "kind": "youtube#channel", "etag": etag, "id": string, "snippet": { "title": string, "description": string, "customUrl": string, "publishedAt": datetime, "thumbnails": { (key): { "url": string, "width": unsigned integer, "height": unsigned integer } }, "defaultLanguage": string, "localized": { "title": string, "description": string }, "country": string }, "contentDetails": { "relatedPlaylists": { "likes": string, "favorites": string, "uploads": string } }, "statistics": { "viewCount": unsigned long, "subscriberCount": unsigned long, // this value is rounded to three significant figures "hiddenSubscriberCount": boolean, "videoCount": unsigned long }, "topicDetails": { "topicIds": [ string ], "topicCategories": [ string ] }, "status": { "privacyStatus": string, "isLinked": boolean, "longUploadsStatus": string, "madeForKids": boolean, "selfDeclaredMadeForKids": boolean }, "brandingSettings": { "channel": { "title": string, "description": string, "keywords": string, "trackingAnalyticsAccountId": string, "moderateComments": boolean, "unsubscribedTrailer": string, "defaultLanguage": string, "country": string }, "watch": { "textColor": string, "backgroundColor": string, "featuredPlaylistId": string } }, "auditDetails": { "overallGoodStanding": boolean, "communityGuidelinesGoodStanding": boolean, "copyrightStrikesGoodStanding": boolean, "contentIdClaimsGoodStanding": boolean }, "contentOwnerDetails": { "contentOwner": string, "timeLinked": datetime }, "localizations": { (key): { "title": string, "description": string } } }
Właściwości
Tabela poniżej określa właściwości wyświetlane w tym zasobie:
Właściwości | |
---|---|
kind |
string Określa typ zasobu interfejsu API. Wartość będzie wynosić youtube#channel . |
etag |
etag ETag tego zasobu. |
id |
string Identyfikator, którego YouTube używa do jednoznacznego identyfikowania kanału. |
snippet |
object Obiekt snippet zawiera podstawowe informacje o kanale, takie jak tytuł, opis i miniatury. |
snippet.title |
string Tytuł kanału. |
snippet.description |
string Opis kanału Wartość właściwości może mieć maksymalnie 1000 znaków. |
snippet.customUrl |
string Niestandardowy adres URL kanału W Centrum pomocy YouTube dowiesz się, jakie wymagania należy spełnić, aby uzyskać niestandardowy URL, a także jak skonfigurować adres URL. |
snippet.publishedAt |
datetime Data i godzina utworzenia kanału. Wartość jest podana w formacie ISO 8601. |
snippet.thumbnails |
object Mapa miniaturek powiązanych z kanałem Kluczem jest nazwa obrazu miniatury, a wartość to obiekt zawierający inne informacje o miniaturze. Podczas wyświetlania miniatur w aplikacji upewnij się, że w kodzie stosowane są adresy URL obrazów dokładnie w takiej postaci, w jakiej są zwracane w odpowiedziach interfejsu API. Na przykład Twoja aplikacja nie powinna używać domeny http zamiast domeny https w adresie URL zwracanym w odpowiedzi interfejsu API.Adresy URL miniatur kanałów są dostępne tylko w domenie https , a w ten sposób adresy URL są widoczne w odpowiedziach interfejsu API. Uszkodzone obrazy mogą pojawiać się w Twojej aplikacji, gdy aplikacja próbuje wczytać obrazy z YouTube z domeny http . Miniatury nowych kanałów mogą być puste, a wypełnienie nimi może zająć nawet 1 dzień. |
snippet.thumbnails.(key) |
object Prawidłowe pary klucz-wartość to:
|
snippet.thumbnails.(key).url |
string Adres URL obrazu. Dodatkowe wskazówki dotyczące używania adresów URL miniaturek w aplikacji znajdziesz w definicji właściwości snippet.thumbnails . |
snippet.thumbnails.(key).width |
unsigned integer Szerokość obrazu. |
snippet.thumbnails.(key).height |
unsigned integer Wysokość obrazu. |
snippet.defaultLanguage |
string Język tekstu w właściwościach snippet.title i snippet.description zasobu channel . |
snippet.localized |
object Obiekt snippet.localized zawiera zlokalizowany tytuł i opis kanału lub tytuł i opis kanału w języku domyślnym, w przypadku metadanych kanału.
localizations umożliwia dodawanie, aktualizowanie i usuwanie zlokalizowanych metadanych. |
snippet.localized.title |
string Zlokalizowany tytuł kanału. |
snippet.localized.description |
string Zlokalizowany opis kanału. |
snippet.country |
string Kraj, z którym jest powiązany kanał. Aby ustawić wartość właściwości, zaktualizuj wartość właściwości brandingSettings.channel.country . |
contentDetails |
object Obiekt contentDetails zawiera informacje o zawartości kanału. |
contentDetails.relatedPlaylists |
object Obiekt relatedPlaylists to mapa, która identyfikuje playlisty powiązane z kanałem, takie jak przesłane filmy i polubione filmy. Możesz pobrać dowolną z tych playlist za pomocą metody playlists.list . |
contentDetails.relatedPlaylists.likes |
string Identyfikator playlisty zawierającej filmy, które Ci się spodobały. Aby dodawać elementy do listy lub je z niej usuwać, użyj metod playlistItems.insert i playlistItems.delete . |
contentDetails.relatedPlaylists.favorites |
string Ta usługa została wycofana. Identyfikator playlisty z ulubionymi filmami z tego kanału. Aby dodać lub usunąć elementy z listy, użyj metod playlistItems.insert i playlistItems.delete .YouTube ma wycofaną funkcję ulubionych filmów. Na przykład właściwość statistics.favoriteCount zasobu video została wycofana 28 sierpnia 2015 roku. Z powodów historycznych ta wartość właściwości może zawierać identyfikator playlisty, która odnosi się do pustej playlisty, dlatego nie można jej pobrać. |
contentDetails.relatedPlaylists.uploads |
string Identyfikator playlisty zawierającej filmy przesłane na kanał. Użyj metody videos.insert , aby przesłać nowe filmy, lub metody videos.delete , aby usunąć przesłane wcześniej filmy. |
statistics |
object Obiekt statistics zawiera statystyki kanału. |
statistics.viewCount |
unsigned long Liczba wyświetleń kanału. |
statistics.commentCount |
unsigned long Ta usługa została wycofana. Liczba komentarzy do kanału. |
statistics.subscriberCount |
unsigned long Liczba subskrybentów kanału Ta wartość jest zaokrąglana w dół do 3 znaczących cyfr. Więcej informacji o zaokrąglaniu liczby subskrybentów znajdziesz w historii zmian lub w Centrum pomocy YouTube. |
statistics.videoCount |
unsigned long Liczba publicznych filmów przesłanych na kanał. Pamiętaj, że ta wartość odzwierciedla liczbę publicznych filmów na kanale, nawet dla właścicieli. Jest to zgodne z liczbą wyświetlaną na stronie YouTube. |
topicDetails |
object Obiekt topicDetails zawiera informacje dotyczące tematów powiązanych z kanałem.Ważne: więcej informacji o zmianach związanych z identyfikatorami tematów znajdziesz w definicji właściwości topicDetails.topicIds[] i historii zmian. |
topicDetails.topicIds[] |
list Lista identyfikatorów tematów powiązanych z kanałem. Ta usługa została wycofana 10 listopada 2016 roku. Będzie on obsługiwany do 10 listopada 2017 r. Ważne: ze względu na wycofanie interfejsu Freebase oraz Freebase API od 27 lutego 2017 roku identyfikatory tematów zaczęły działać inaczej. W tym czasie YouTube zaczął zwracać niewielki zestaw wybranych identyfikatorów tematów. |
topicDetails.topicCategories[] |
list Lista adresów URL Wikipedii opisujących zawartość kanału. |
status |
object Obiekt status zawiera informacje o stanie prywatności kanału. |
status.privacyStatus |
string Stan prywatności kanału. Prawidłowe wartości tej właściwości to:
|
status.isLinked |
boolean Wskazuje, czy dane kanału identyfikują użytkownika, który jest już powiązany z nazwą użytkownika YouTube lub kontem Google+. Użytkownik, który ma 1 z tych linków, ma już publiczną tożsamość w YouTube, co jest wymagane do kilku działań, takich jak przesyłanie filmów. |
status.longUploadsStatus |
string Wskazuje, czy na kanale można przesyłać filmy dłuższe niż 15 minut. Ta właściwość jest zwracana tylko wtedy, gdy właściciel kanału autoryzował żądanie do interfejsu API. Więcej informacji o tej funkcji znajdziesz w Centrum pomocy YouTube. Prawidłowe wartości tej właściwości to:
|
status.madeForKids |
boolean Ta wartość wskazuje, czy kanał jest oznaczony jako przeznaczony dla dzieci, i zawiera aktualny stan kanału „przeznaczone dla dzieci”. Stan może być określany na przykład na podstawie wartości właściwości selfDeclaredMadeForKids . Zajrzyj do Centrum pomocy YouTube, aby dowiedzieć się więcej o określaniu odbiorców swojego kanału, filmów lub transmisji.
|
status.selfDeclaredMadeForKids |
boolean W ramach żądania channels.update ta właściwość pozwala właścicielowi kanału oznaczyć go jako skierowanych do dzieci. Wartość właściwości jest zwracana tylko wtedy, gdy właściciel kanału autoryzował żądanie do interfejsu API.
|
brandingSettings |
object Obiekt brandingSettings zawiera informacje o budowaniu marki kanału. |
brandingSettings.channel |
object Obiekt channel zawiera właściwości marki strony kanału. |
brandingSettings.channel.title |
string Tytuł kanału. Maksymalna długość tytułu to 30 znaków. |
brandingSettings.channel.description |
string Opis kanału, który pojawi się w polu z informacjami o kanale. Wartość właściwości może mieć maksymalnie 1000 znaków. |
brandingSettings.channel.keywords |
string Słowa kluczowe powiązane z kanałem. Wartość jest listą ciągów rozdzielanych spacjami. Słowa kluczowe pochodzące z kanału mogą zostać skrócone, jeśli przekraczają maksymalną dozwoloną długość 500 znaków lub zawierają cudzysłowy bez zmiany ( " ). Limit 500 znaków nie jest wyznaczony na podstawie limitu poszczególnych słów kluczowych, a jedynie limit łącznej długości wszystkich słów kluczowych. |
brandingSettings.channel.trackingAnalyticsAccountId |
string Identyfikator konta Google Analytics, którego chcesz używać do śledzenia i mierzenia ruchu na kanale. |
brandingSettings.channel.moderateComments |
boolean To ustawienie określa, czy komentarze przesłane przez użytkowników na stronie kanału muszą zostać zatwierdzone przez właściciela kanału, aby były widoczne publicznie. Wartością domyślną jest false . |
brandingSettings.channel.unsubscribedTrailer |
string Film, który powinien być odtwarzany w module Polecane filmy w widoku przeglądania na stronie kanału dla widzów bez subskrypcji Subskrybenci mogą zobaczyć inny film, który przedstawia ostatnią aktywność na kanale. Jeśli określisz właściwość, wartość musi być identyfikatorem filmu w YouTube należącego do publicznego lub niepublicznego właściciela, który należy do właściciela kanału. |
brandingSettings.channel.defaultLanguage |
string Język tekstu w właściwościach snippet.title i snippet.description zasobu channel . |
brandingSettings.channel.country |
string Kraj, z którym jest powiązany kanał. Zaktualizuj tę właściwość, aby ustawić wartość właściwości snippet.country . |
brandingSettings.watch |
object Uwaga: ten obiekt i wszystkie jego usługi podrzędne zostały wycofane. Obiekt watch zawiera właściwości marki promujące strony odtwarzania filmów na kanale. |
brandingSettings.watch.textColor |
string Uwaga: ta usługa została wycofana. Kolor tekstu w obszarze marki na stronie odtwarzania filmu. |
brandingSettings.watch.backgroundColor |
string Uwaga: ta usługa została wycofana. Kolor tła obszaru marki na stronie odtwarzania filmu. |
brandingSettings.watch.featuredPlaylistId |
string Uwaga: ta usługa została wycofana. Jeśli spróbujesz ustawić jego wartość, interfejs API zwróci błąd. |
brandingSettings.image |
object Ta usługa i wszystkie jej usługi podrzędne zostały wycofane. Obiekt image zawiera informacje o obrazach wyświetlanych na stronie kanału lub na stronach odtwarzania filmów. |
brandingSettings.image.bannerImageUrl |
string Ta usługa została wycofana. Adres URL obrazu banera wyświetlanego na stronie kanału w YouTube. Obraz ma wymiary 1060 na 175 pikseli. |
brandingSettings.image.bannerMobileImageUrl |
string Ta usługa została wycofana. Adres URL obrazu banera wyświetlanego na stronie kanału w aplikacjach mobilnych. Obraz ma wymiary 640 na 175 pikseli. |
brandingSettings.image.watchIconImageUrl |
string Ta usługa została wycofana. Adres URL obrazu wyświetlanego nad odtwarzaczem. Obraz o wysokości 25 pikseli i szerokości automatycznej nie może przekraczać 170 pikseli. Jeśli nie prześlesz tego obrazu, zamiast obrazu pojawi się nazwa Twojego kanału. |
brandingSettings.image.trackingImageUrl |
string Ta usługa została wycofana. Adres URL piksela śledzącego o wymiarach 1 x 1 piksela, którego można używać do zbierania statystyk dotyczących wyświetleń kanału lub stron filmów. |
brandingSettings.image.bannerTabletLowImageUrl |
string Ta usługa została wycofana. Adres URL obrazu banera o niskiej rozdzielczości wyświetlanego na stronie kanału w aplikacjach na tablety. Maksymalny rozmiar obrazu to 1138 x 188 pikseli. |
brandingSettings.image.bannerTabletImageUrl |
string Ta usługa została wycofana. Adres URL obrazu banera wyświetlanego na stronie kanału w aplikacjach na tablety. Obraz ma wymiary 1707 na 283 piksele. |
brandingSettings.image.bannerTabletHdImageUrl |
string Ta usługa została wycofana. Adres URL obrazu banera o wysokiej rozdzielczości wyświetlanego na stronie kanału w aplikacjach na tablety. Maksymalny rozmiar obrazu to 2276 x 377 pikseli. |
brandingSettings.image.bannerTabletExtraHdImageUrl |
string Ta usługa została wycofana. Adres URL banera o bardzo wysokiej rozdzielczości, który wyświetla się na stronie kanału w aplikacjach na tablety. Maksymalny rozmiar obrazu to 2560 x 424 piksele. |
brandingSettings.image.bannerMobileLowImageUrl |
string Ta usługa została wycofana. Adres URL obrazu banera o niskiej rozdzielczości wyświetlanego na stronie kanału w aplikacjach mobilnych. Maksymalny rozmiar obrazu to 320 x 88 pikseli. |
brandingSettings.image.bannerMobileMediumHdImageUrl |
string Ta usługa została wycofana. Adres URL obrazu banera o średniej rozdzielczości, który jest wyświetlany na stronie kanału w aplikacjach mobilnych. Maksymalny rozmiar obrazu to 960 x 263 piksele. |
brandingSettings.image.bannerMobileHdImageUrl |
string Ta usługa została wycofana. Adres URL obrazu banera o wysokiej rozdzielczości wyświetlanego na stronie kanału w aplikacjach mobilnych. Maksymalny rozmiar obrazu to 1280 x 360 pikseli. |
brandingSettings.image.bannerMobileExtraHdImageUrl |
string Ta usługa została wycofana. Adres URL banera o bardzo wysokiej rozdzielczości, który wyświetla się na stronie kanału w aplikacjach mobilnych. Maksymalny rozmiar obrazu to 1440 x 395 pikseli. |
brandingSettings.image.bannerTvImageUrl |
string Ta usługa została wycofana. Adres URL obrazu banera o bardzo wysokiej rozdzielczości, który wyświetla się na stronie kanału w aplikacjach telewizyjnych. Maksymalny rozmiar obrazu to 2120 x 1192 piksele. |
brandingSettings.image.bannerTvLowImageUrl |
string Ta usługa została wycofana. Adres URL obrazu banera o niskiej rozdzielczości wyświetlanego na stronie kanału w aplikacjach telewizyjnych. Maksymalny rozmiar obrazu to 854 x 480 pikseli. |
brandingSettings.image.bannerTvMediumImageUrl |
string Ta usługa została wycofana. Adres URL obrazu banera o średniej rozdzielczości, który jest wyświetlany na stronie kanału w aplikacjach telewizyjnych. Maksymalny rozmiar obrazu to 1280 x 720 pikseli. |
brandingSettings.image.bannerTvHighImageUrl |
string Ta usługa została wycofana. Adres URL obrazu banera o wysokiej rozdzielczości wyświetlanego na stronie kanału w aplikacjach telewizyjnych. Maksymalny rozmiar obrazu to 1920 x 1080 pikseli. |
brandingSettings.image.bannerExternalUrl |
string Ta właściwość określa lokalizację obrazu banera, którego YouTube używa do generowania różnych rozmiarów obrazu banera dla kanału. |
brandingSettings.hints[] |
list Ta usługa i wszystkie jej usługi podrzędne zostały wycofane. Obiekt hints zawiera dodatkowe właściwości marki. |
brandingSettings.hints[].property |
string Ta usługa została wycofana. Usługa. |
brandingSettings.hints[].value |
string Ta usługa została wycofana. Wartość właściwości. |
auditDetails |
object Obiekt auditDetails zawiera dane kanału, które sieci wielokanałowe oceniają przy podejmowaniu decyzji o zaakceptowaniu lub odrzuceniu danego kanału. Pamiętaj, że każde żądanie interfejsu API, które pobiera tę część zasobu, musi dostarczyć token autoryzacji zawierający zakres https://www.googleapis.com/auth/youtubepartner-channel-audit . Dodatkowo token musi zostać unieważniony, gdy sieć wielokanałowa zdecyduje się zaakceptować lub odrzucić kanał lub w ciągu 2 tygodni od jego przyznania. |
auditDetails.overallGoodStanding |
boolean To pole wskazuje, czy występują problemy z kanałem. Obecnie to pole reprezentuje wynik operacji logicznej AND obejmującej właściwości communityGuidelinesGoodStanding , copyrightStrikesGoodStanding i contentIdClaimsGoodStanding , co oznacza, że ta właściwość ma wartość true , jeśli wszystkie te pozostałe właściwości mają też wartość true . Ta właściwość będzie jednak miała wartość false , jeśli którakolwiek z tych właściwości ma wartość false . Pamiętaj jednak, że metodologia ustalania wartości tej właściwości może się zmienić. |
auditDetails.communityGuidelinesGoodStanding |
boolean Wskazuje, czy kanał przestrzega wytycznych dla społeczności YouTube. |
auditDetails.copyrightStrikesGoodStanding |
boolean Wskazuje, czy kanał otrzymał ostrzeżenia o naruszeniu praw autorskich. |
auditDetails.contentIdClaimsGoodStanding |
boolean Wskazuje, czy kanał jest objęty nierozstrzygniętymi roszczeniami. |
contentOwnerDetails |
object Obiekt contentOwnerDetails zawiera dane kanału, które są widoczne tylko dla partnera YouTube, który połączył go ze swoim Menedżerem treści. |
contentOwnerDetails.contentOwner |
string Identyfikator właściciela treści połączonego z kanałem. |
contentOwnerDetails.timeLinked |
datetime Data i godzina połączenia kanału z właścicielem treści Wartość jest podana w formacie ISO 8601. |
localizations |
object Obiekt localizations zawiera tłumaczenia metadanych kanału. |
localizations.(key) |
object Język zlokalizowanych metadanych powiązanych z parą klucz-wartość. Wartość jest ciągiem znaków zawierającym kod języka BCP-47. |
localizations.(key).title |
string Zlokalizowany tytuł kanału. |
localizations.(key).description |
string Zlokalizowany opis kanału. |