Channels

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 i invideoPromotion zasobu channel 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:
  • default – domyślny obraz miniatury. Domyślna miniatura filmu lub zasobu, który odnosi się do filmu, np. elementu playlisty lub wyniku wyszukiwania, ma szerokość 120 pikseli i wysokość 90 pikseli. Domyślna miniatura kanału ma 88 pikseli szerokości i 88 pikseli wysokości.
  • medium – wyższa wersja miniatury obrazu. W przypadku filmu (lub zasobu, który odnosi się do filmu), obraz ma szerokość 320 pikseli i wysokość 180 pikseli. W przypadku kanału obraz ma szerokość 240 pikseli i wysokość 240 pikseli.
  • high – wersja miniatury obrazu w wysokiej rozdzielczości. W przypadku filmu (lub zasobu, który odnosi się do filmu), obraz ma szerokość 480 pikseli i wysokość 360 pikseli. W przypadku kanału obraz ma szerokość 800 pikseli i wysokość 800 pikseli.
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.
  • Zlokalizowany tekst jest zwracany we fragmencie kodu zasobu, jeśli żądanie channels.list używało parametru hl do określania języka, w przypadku którego należy zwrócić zlokalizowany tekst. Wartość parametru hl wskazuje język aplikacji YouTube, a zlokalizowany tekst jest dostępny w tym języku.
  • Metadane dla języka domyślnego są zwracane, jeśli wartość parametru hl nie została określona lub wartość jest określona, ale zlokalizowane metadane nie są dostępne dla tego języka.
Właściwość zawiera wartość tylko do odczytu. Obiekt 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.hiddenSubscriberCount boolean
Wskazuje, czy liczba subskrybentów kanału jest widoczna publicznie.
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:
  • private
  • public
  • unlisted
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:
  • allowed – na ten kanał możesz przesyłać filmy dłuższe niż 15 minut.
  • disallowed – na tym kanale nie można przesyłać filmów dłuższych niż 15 minut. Kanał może przesyłać długie filmy tylko wtedy, gdy ma dobrą opinię (zgodnie z wytycznymi dla społeczności YouTube), a system Content ID nie zablokował żadnych treści na całym świecie.

    Gdy właściciel kanału rozwiąże problemy, które uniemożliwiają przesyłanie jego dłuższych filmów, kanał zostanie przywrócony do stanu allowed lub eligible.
  • eligible – na tym kanale można przesyłać filmy dłuższe niż 15 minut. Właściciel kanału musi jednak najpierw włączyć możliwość przesyłania dłuższych filmów: https://www.youtube.com/verify. Więcej informacji o tej funkcji znajdziesz w Centrum pomocy YouTube.
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.