Channels

Interfejs API umożliwia teraz oznaczanie kanału lub filmów jako przeznaczonych dla dzieci. Zasoby channel i video zawierają teraz także właściwość, która określa, czy dany kanał lub film jest „przeznaczony dla dzieci”. 10 stycznia 2020 r. zaktualizowaliśmy również Warunki korzystania z usług YouTube API oraz zasady dla deweloperów. Aby dowiedzieć się więcej, zapoznaj się z historiami zmian usługi YouTube Data API oraz Warunkami korzystania z usług interfejsu YouTube API.

Zasób channel zawiera informacje o kanale YouTube.

Metody

Interfejs API obsługuje te metody zasobów channels:

list
Zwraca zbiór zawierający co najmniej 0 zasobów channel, które spełniają kryteria żądania. Wypróbuj teraz
aktualizacja
Aktualizuje metadane kanału. Pamiętaj, że obecnie ta metoda obsługuje tylko aktualizacje obiektów brandingSettings i invideoPromotion zasobu channel oraz ich właściwości podrzędnych. Wypróbuj teraz

Reprezentacja zasobu

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,
      "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

Poniższa tabela przedstawia właściwości, które pojawiają się w tym zasobie:

Właściwości
kind string
Określa typ zasobu interfejsu API. Wartością będzie youtube#channel.
etag etag
ETag tego zasobu.
id string
Identyfikator, którego YouTube używa do jednoznacznej identyfikacji 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 nie może przekraczać 1000 znaków.
snippet.customUrl string
Niestandardowy adres URL kanału. W Centrum pomocy YouTube znajdziesz wymagania dotyczące uzyskiwania niestandardowego adresu URL oraz instrukcje, jak go skonfigurować.
snippet.publishedAt datetime
Data i godzina utworzenia kanału. Wartość należy podać w formacie ISO 8601.
snippet.thumbnails object
Mapa miniatur obrazów powiązanych z kanałem. Kluczem dla każdego obiektu na mapie jest nazwa miniatury, a wartością jest obiekt zawierający inne informacje na temat miniatury.

Gdy wyświetlasz miniatury w aplikacji, upewnij się, że kod używa adresów URL obrazów dokładnie w takiej postaci, w jakiej są zwracane w odpowiedziach interfejsu API. Na przykład aplikacja nie powinna używać domeny http zamiast domeny https w adresie URL zwracanym w odpowiedzi interfejsu API.

Adresy URL miniaturek kanału są dostępne tylko w domenie https, tak jak są one wyświetlane w odpowiedziach interfejsu API. Jeśli aplikacja próbuje wczytać obrazy z YouTube z domeny http, możesz zobaczyć uszkodzone obrazy. W przypadku nowo utworzonych kanałów miniatury mogą być puste, a wypełnienie ich danymi może potrwać 1 dzień.
snippet.thumbnails.(key) object
Prawidłowe pary klucz-wartość to:
  • default – domyślny obraz miniatury. Domyślna miniatura filmu lub zasobu nawiązującego do filmu, np. elementu playlisty czy wyniku wyszukiwania – ma 120 pikseli szerokości i 90 pikseli wysokości. Domyślna miniatura kanału ma 88 pikseli szerokości i 88 pikseli wysokości.
  • medium – wersja obrazu miniatury w wyższej rozdzielczości. W przypadku filmu (lub zasobu, który odnosi się do filmu) obraz ten ma 320 pikseli szerokości i 180 pikseli wysokości. W przypadku kanału obraz ma 240 pikseli szerokości i 240 pikseli wysokości.
  • high – wersja obrazu miniatury w wysokiej rozdzielczości. W przypadku filmu (lub zasobu, który odnosi się do filmu) obraz ten ma 480 pikseli szerokości i 360 pikseli wysokości. W przypadku kanału obraz ma 800 pikseli szerokości i 800 pikseli wysokości.
snippet.thumbnails.(key).url string
Adres URL obrazu. Dodatkowe wytyczne dotyczące używania adresów URL miniatur 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 we 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 domyślnym języku jego metadanych.
  • Zlokalizowany tekst jest zwracany we fragmencie kodu zasobu, jeśli żądanie channels.list używa parametru hl do określenia języka, dla którego należy zwrócić zlokalizowany tekst. Wartość parametru hl określa 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 określono wartość, ale zlokalizowane metadane nie są dostępne dla wybranego języka.
Właściwość zawiera wartość tylko do odczytu. Za pomocą obiektu localizations możesz dodawać, aktualizować i usuwać zlokalizowane metadane.
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ść tej właściwości, zaktualizuj wartość właściwości brandingSettings.channel.country.
contentDetails object
Obiekt contentDetails zawiera informacje o treściach na kanale.
contentDetails.relatedPlaylists object
Obiekt relatedPlaylists to mapa, która wskazuje playlisty powiązane z kanałem – np. filmy przesłane na kanał lub polubione. Możesz pobrać dowolną z tych playlist, korzystając z metody playlists.list.
contentDetails.relatedPlaylists.likes string
Identyfikator playlisty, która zawiera filmy polubione na kanale. Aby dodawać elementy do listy lub je z niej usuwać, użyj metod playlistItems.insert i playlistItems.delete.
contentDetails.relatedPlaylists.favorites string
Ta właściwość została wycofana.

Identyfikator playlisty zawierającej ulubione filmy z kanału. Aby dodawać i usuwać elementy na tej liście, używaj metod playlistItems.insert i playlistItems.delete.

Pamiętaj, że funkcja ulubionych filmów została wycofana z YouTube. Na przykład właściwość statistics.favoriteCount zasobu video została wycofana 28 sierpnia 2015 r. W związku z tym z przyczyn historycznych ta wartość właściwości może zawierać identyfikator playlisty, który odnosi się do pustej playlisty, której nie można pobrać.
contentDetails.relatedPlaylists.uploads string
Identyfikator playlisty, która zawiera filmy przesłane na kanał. Użyj metody videos.insert, aby przesyłać nowe filmy, lub metody videos.delete, aby usunąć te przesłane wcześniej.
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 na kanale.
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 wartość ta odzwierciedla liczbę publicznych filmów na kanale, nawet dla właścicieli. Wynika to z liczb wyświetlanych w witrynie YouTube.
topicDetails object
Obiekt topicDetails zawiera informacje o tematach 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 r. Będzie on obsługiwany do 10 listopada 2017 r.

Ważne: ze względu na wycofanie interfejsów Freebase i Freebase API od 27 lutego 2017 r. identyfikatory tematów zaczęły działać inaczej. W tym czasie YouTube zaczął zwracać mały zestaw wybranych identyfikatorów tematów.

topicDetails.topicCategories[] list
Lista adresów URL w Wikipedii, które opisują 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 posiadający jeden z tych linków ma już publiczną tożsamość w YouTube, co jest warunkiem wstępnym wykonania kilku czynności, takich jak przesłanie filmów.
status.longUploadsStatus string
Wskazuje, czy na kanał 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 usługi to:
  • allowed – na ten kanał można przesyłać filmy dłuższe niż 15 minut.
  • disallowed – na ten kanał nie można przesyłać filmów dłuższych niż 15 minut (lub nie można ich przesyłać). Długie filmy na kanał można przesyłać tylko wtedy, gdy mają dobrą opinię (zgodnie z wytycznymi dla społeczności YouTube) i materiały, które nie zostały zablokowane na całym świecie przez system Content ID.

    Gdy właściciel kanału rozwiąże problemy, które uniemożliwiają przesyłanie dłuższych filmów, kanał powróci do stanu allowed lub eligible.
  • eligible – na ten kanał 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 na stronie 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 ma obecny stan „przeznaczony dla dzieci”. Stan może być np. określany na podstawie wartości właściwości selfDeclaredMadeForKids. Więcej informacji o określaniu odbiorców kanału, filmów i transmisji znajdziesz w Centrum pomocy YouTube.
status.selfDeclaredMadeForKids boolean
W żądaniu channels.update ta właściwość pozwala właścicielowi kanału oznaczyć kanał 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 na temat budowania 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 wyświetla się w polu informacji o kanale na jego stronie. Wartość właściwości nie może przekraczać 1000 znaków.
brandingSettings.channel.keywords string
Słowa kluczowe powiązane z Twoim kanałem. Wartość jest listą ciągów znaków rozdzielonych spacjami. Słowa kluczowe w kanale mogą zostać obcięte, jeśli przekraczają maksymalną dozwoloną długość 500 znaków lub zawierają cudzysłów bez zmiany znaczenia ("). Pamiętaj, że limit 500 znaków nie dotyczy limitu na słowo kluczowe, ale jest to 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 pomiaru ruchu na kanale.
brandingSettings.channel.unsubscribedTrailer string
Film, który powinien wyświetlić się w module polecanych filmów w widoku przeglądania na stronie kanału w przypadku użytkowników bez subskrypcji. Subskrybenci mogą zobaczyć inny film, w którym wyróżnione są najnowsze informacje o aktywności na kanale.

Jeśli właściwość została określona, wartością właściwości musi być identyfikator filmu publicznego w YouTube filmu publicznego lub niepublicznego, który należy do właściciela kanału.
brandingSettings.channel.defaultLanguage string
Język tekstu we 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 właściwości podrzędne zostały wycofane.

Obiekt watch zawiera właściwości marki strony odtwarzania filmów z kanału.
brandingSettings.watch.textColor string
Uwaga: ta właściwość została wycofana.

Kolor tekstu w obszarze marki na stronie odtwarzania filmu.
brandingSettings.watch.backgroundColor string
Uwaga: ta właściwość została wycofana.

Kolor tła obszaru marki na stronie odtwarzania filmu.
brandingSettings.watch.featuredPlaylistId string
Uwaga: ta właściwość 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 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 x 175 pikseli.
brandingSettings.image.watchIconImageUrl string
Ta usługa została wycofana.

Adres URL obrazu wyświetlanego nad odtwarzaczem. To jest obraz o wysokości 25 pikseli i automatycznej szerokości, która 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 na 1 piksel, który może służyć do zbierania statystyk wyświetleń kanału i 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 x 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 obrazu 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 wyświetlanego 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 obrazu 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 wyświetlanego 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 wygenerowania obrazu banera o różnych rozmiarach 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.

właściwość.
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 sieć wielokanałowa (MCN) oceniła przy podejmowaniu decyzji o zaakceptowaniu lub odrzuceniu konkretnego kanału. Pamiętaj, że każde żądanie do interfejsu API, które pobiera tę część zasobu, musi dostarczyć token autoryzacji zawierający zakres https://www.googleapis.com/auth/youtubepartner-channel-audit. Dodatkowo każdy token korzystający z tego zakresu musi zostać unieważniony, gdy sieć wielokanałowa zdecyduje się zaakceptować lub odrzucić kanał albo w ciągu 2 tygodni od daty jego wystawienia.
auditDetails.overallGoodStanding boolean
To pole informuje, czy na kanale występują jakieś problemy. Obecnie to pole przedstawia wynik operacji logicznej AND nad właściwościami communityGuidelinesGoodStanding, copyrightStrikesGoodStanding i contentIdClaimsGoodStanding, co oznacza, że ta właściwość ma wartość true, jeśli wszystkie pozostałe mają też wartość true. Jeśli którakolwiek z nich ma wartość false, ta właściwość będzie jednak miała wartość false. Pamiętaj, że metodologia używana do ustalania wartości tej usługi może się zmienić.
auditDetails.communityGuidelinesGoodStanding boolean
Wskazuje, czy kanał przestrzega wytycznych dla społeczności YouTube.
auditDetails.copyrightStrikesGoodStanding boolean
Wskazuje, czy kanał ma ostrzeżenia o naruszeniu praw autorskich.
auditDetails.contentIdClaimsGoodStanding boolean
Wskazuje, czy na kanale są zgłoszone nierozstrzygnięte roszczenia.
contentOwnerDetails object
Obiekt contentOwnerDetails zawiera dane kanału widoczne tylko dla partnera YouTube, który połączył kanał 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ść należy podać 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ą kluczową. 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.