Channels

Interfejs API umożliwia teraz oznaczenie kanału lub filmów jako przeznaczonych dla dzieci. Dodatkowo zasoby channel i video zawierają teraz właściwość, która wskazuje, że kanał lub film jest oznaczony jako przeznaczony dla dzieci. 10 stycznia 2020 r. zaktualizowaliśmy też Warunki korzystania z usług interfejsu API YouTube oraz Zasady dla deweloperów. Więcej informacji znajdziesz w historii zmian interfejsu YouTube Data APIWarunków korzystania z usług interfejsu API YouTube.

Zasób channel zawiera informacje o kanale w YouTube.

Metody

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

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

Reprezentacja zasobu

Struktura JSON poniżej 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

Właściwości występujące w tym zasobie są opisane w tabeli poniżej:

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 używany przez YouTube 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ść tej właściwości może mieć maksymalnie 1000 znaków.
snippet.customUrl string
Niestandardowy adres URL kanału. W Centrum pomocy YouTube znajdziesz informacje o wymaganiach dotyczących uzyskania niestandardowego adresu URL oraz o tym, jak go skonfigurować.
snippet.publishedAt datetime
Data i godzina utworzenia kanału. Wartość jest podawana w formacie ISO 8601.
snippet.thumbnails object
Mapa miniatur powiązanych z kanałem W przypadku każdego obiektu na mapie kluczem jest nazwa miniatury, a wartością obiekt, który zawiera inne informacje o miniaturze.

Podczas wyświetlania miniatur w aplikacji upewnij się, że kod używa adresów URL obrazów dokładnie tak, jak są one 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 miniatur kanału są dostępne tylko w domenie https, w której występują w odpowiedziach interfejsu API. Jeśli aplikacja próbuje wczytać obrazy z YouTube z domeny http, możesz zobaczyć w niej uszkodzone obrazy. W przypadku nowo utworzonych kanałów miniatury mogą być puste i może minąć nawet dobę, zanim się wypełnią.
snippet.thumbnails.(key) object
Prawidłowe wartości klucza:
  • default – domyślna miniatura. Domyślna miniatura filmu lub zasobu odwołującego 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 – wersja miniatury w wyższej rozdzielczości. W przypadku filmu (lub zasobu odwołującego się do filmu) obraz ma szerokość 320 pikseli i wysokość 180 pikseli. W przypadku kanału obraz ma 240 pikseli szerokości i 240 pikseli wysokości.
  • high – wersja miniatury w wysokiej rozdzielczości. W przypadku filmu (lub zasobu odwołującego się do filmu) obraz ma szerokość 480 pikseli i wysokość 360 pikseli. W przypadku kanału obraz ma 800 pikseli szerokości i 800 pikseli wysokości.
snippet.thumbnails.(key).url string
Adres URL obrazu. Więcej wskazówek dotyczących 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 w atrybutach snippet.titlesnippet.description zasobu channel.
snippet.localized object
Obiekt snippet.localized zawiera zlokalizowany tytuł i opis kanału lub zawiera tytuł i opis kanału w języku domyślnym dla metadanych kanału.
  • Lokalizowany tekst jest zwracany w fragmentach zasobów, jeśli żądanie channels.list używa parametru hl do określenia języka, w którym ma być zwrócony tekst lokalizowany. Wartość parametru hl wskazuje język aplikacji w YouTube, w którym jest dostępny tekst lokalizowany.
  • Metadane w języku domyślnym są zwracane, jeśli wartość parametru hl nie jest określona lub jeśli wartość jest określona, ale zlokalizowane metadane nie są dostępne w wybranym języku.
Właściwość zawiera wartość tylko do odczytu. Aby dodawać, aktualizować lub usuwać zlokalizowane metadane, użyj obiektu localizations.
snippet.localized.title string
Zlokalizowany tytuł kanału.
snippet.localized.description string
Zlokalizowany opis kanału.
snippet.country string
Kraj, z którym powiązany jest 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 kanału.
contentDetails.relatedPlaylists object
Obiekt relatedPlaylists to mapa identyfikująca playlisty powiązane z kanałem, takie jak przesłane przez niego filmy lub filmy, które zostały przez niego polubione. Możesz pobrać dowolną z tych playlist, korzystając z metody playlists.list.
contentDetails.relatedPlaylists.likes string
Identyfikator playlisty zawierającej filmy, które zostały dodane do listy ulubionych. Aby dodawać lub usuwać elementy z tej listy, użyj metod playlistItems.insertplaylistItems.delete.
contentDetails.relatedPlaylists.favorites string
Ta właściwość została wycofana.

Identyfikator playlisty zawierającej ulubione filmy na kanale. Aby dodawać lub usuwać elementy z tej listy, użyj metod playlistItems.insert i playlistItems.delete.

Pamiętaj, że funkcja ulubionych filmów została wycofana. Na przykład właściwość statistics.favoriteCount zasobu video została wycofana 28 sierpnia 2015 r. Z tego powodu z historycznych powodów ta wartość właściwości może zawierać identyfikator playlisty, który odnosi się do pustej playlisty, więc nie można jej pobrać.
contentDetails.relatedPlaylists.uploads string
Identyfikator playlisty zawierającej przesłane przez kanał filmy. Aby przesłać nowe filmy, użyj metody videos.insert, a aby usunąć wcześniej przesłane filmy – metody videos.delete.
statistics object
Obiekt statistics zawiera statystyki kanału.
statistics.viewCount unsigned long
Liczba wyświetleń kanału.
statistics.commentCount unsigned long
Ta właściwość 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 cyfr znaczących. 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 tylko liczbę publicznych filmów na kanale, nawet jeśli są one dostępne tylko dla właścicieli. Takie zachowanie jest zgodne z liczbami widocznymi na stronie YouTube.
topicDetails object
Obiekt topicDetails zawiera informacje o tematach powiązanych z kanałem.

Ważne: więcej informacji o zmianach dotyczących identyfikatorów tematów znajdziesz w definicji usługi topicDetails.topicIds[] i w 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 ona obsługiwana do 10 listopada 2017 r.

Ważne: ze względu na wycofanie Freebase i interfejsu Freebase API od 27 lutego 2017 r. identyfikatory tematów działają inaczej. Wtedy YouTube zaczął zwracać niewielki zestaw zweryfikowanych identyfikatorów tematów.

topicDetails.topicCategories[] list
Lista adresów URL Wikipedii opisujących treści na kanale.
status object
Obiekt status zawiera informacje o stanie prywatności kanału.
status.privacyStatus string
Stan prywatności kanału.

Dozwolone wartości tej właściwości to:
  • private
  • public
  • unlisted
status.isLinked boolean
Wskazuje, czy dane kanału wskazują na użytkownika, który jest już połączony z nazwą użytkownika w YouTube lub kontem Google+. Użytkownik, który ma jeden z tych linków, ma już publiczną tożsamość w YouTube, która jest warunkiem wstępnym do wykonywania pewnych działań, takich jak przesyłanie filmów.
status.longUploadsStatus string
Wskazuje, czy kanał może 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 interfejsu API. Więcej informacji o tej funkcji znajdziesz w Centrum pomocy YouTube.

Dopuszczalne wartości tej właściwości to:
  • allowed – na tym kanale można 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. Długie filmy mogą przesyłać tylko kanały, które mają dobrą opinię w kontekście przestrzegania wytycznych dla społeczności YouTube i nie mają nałożonej na nie globalnej blokady Content ID.

    Gdy właściciel kanału rozwiąże problemy, które uniemożliwiają przesyłanie dłuższych filmów, kanał wróci do stanu allowed lub eligible.
  • eligible – na tym kanale możesz przesyłać filmy dłuższe niż 15 minut. Właściciel kanału musi jednak najpierw umożliwić przesyłanie dłuższych filmów, korzystając z weryfikacji telefonicznie. Więcej informacji o tej funkcji znajdziesz w Centrum pomocy YouTube.
status.madeForKids boolean
Ta wartość wskazuje, czy kanał jest przeznaczony dla dzieci, oraz zawiera aktualny stan „przeznaczony dla dzieci”. Stan może być na przykład określany na podstawie wartości właściwości selfDeclaredMadeForKids. Więcej informacji o ustawianiu odbiorców kanału, filmów lub transmisji znajdziesz w Centrum pomocy YouTube .
status.selfDeclaredMadeForKids boolean
W żądaniu channels.update ta właściwość pozwala właścicielowi kanału oznaczyć go jako skierowany do dzieci. Wartość właściwości jest zwracana tylko wtedy, gdy właściciel kanału autoryzował żądanie interfejsu API.
brandingSettings object
Obiekt brandingSettings zawiera informacje o markowaniu kanału.
brandingSettings.channel object
Obiekt channel zawiera właściwości brandingowe 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 z informacjami o kanale na jego stronie. Wartość tej właściwości może mieć maksymalnie 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 kanału mogą zostać skrócone, jeśli ich długość przekracza maksymalną dozwoloną liczbę znaków (500) lub jeśli zawierają nieunikające znaki cudzysłowe ("). Pamiętaj, że limit 500 znaków nie dotyczy każdego słowa kluczowego, tylko łą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 w Twoim kanale.
brandingSettings.channel.unsubscribedTrailer string
Film, który powinien być odtwarzany w module polecanych filmów w widoku przeglądania na stronie kanału dla widzów, którzy nie subskrybują kanału. Subskrybenci mogą zobaczyć inny film, który prezentuje nowszą aktywność na kanale.

Jeśli jest podany, wartość tej właściwości musi być identyfikatorem filmu w YouTube, który jest publiczny lub niepubliczny i którego właścicielem jest właściciel kanału.
brandingSettings.channel.defaultLanguage string
Język tekstu w atrybutach snippet.titlesnippet.description zasobu channel.
brandingSettings.channel.country string
Kraj, z którym powiązany jest 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 stron odtwarzania filmów na kanale.
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 z logo na stronie odtwarzania filmu.
brandingSettings.watch.featuredPlaylistId string
Uwaga: ta właściwość została wycofana. Jeśli spróbujesz ustawić jego wartość, 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 filmu.
brandingSettings.image.bannerImageUrl string
Ta właściwość została wycofana.

Adres URL obrazu banera wyświetlanego na stronie kanału w YouTube. Obraz ma wymiary 1060 x 175 pikseli.
brandingSettings.image.bannerMobileImageUrl string
Ta właściwość została wycofana.

Adres URL obrazu banera wyświetlanego na stronie kanału w aplikacjach mobilnych. Obraz ma rozmiar 640 × 175 pikseli.
brandingSettings.image.watchIconImageUrl string
Ta właściwość została wycofana.

Adres URL obrazu, który pojawia się nad odtwarzaczem. To obraz o wysokości 25 pikseli i płynnej szerokości, która nie może przekraczać 170 pikseli. Jeśli nie prześlesz tego obrazu, zamiast niego pojawi się nazwa kanału.
brandingSettings.image.trackingImageUrl string
Ta właściwość została wycofana.

Adres URL piksela śledzącego o wymiarach 1 x 1 piksel, który może służyć do zbierania statystyk wyświetleń kanału lub stron filmów.
brandingSettings.image.bannerTabletLowImageUrl string
Ta właściwość została wycofana.

Adres URL obrazu banera o niskiej rozdzielczości, który wyświetla się na stronie kanału w aplikacjach na tablety. Maksymalny rozmiar obrazu to 1138 x 188 pikseli.
brandingSettings.image.bannerTabletImageUrl string
Ta właściwość 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 właściwość została wycofana.

Adres URL obrazu banera w wysokiej rozdzielczości, który wyświetla się na stronie kanału w aplikacjach na tablety. Maksymalny rozmiar obrazu to 2276 x 377 pikseli.
brandingSettings.image.bannerTabletExtraHdImageUrl string
Ta właściwość została wycofana.

Adres URL obrazu banera w 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 właściwość została wycofana.

Adres URL obrazu banera o niskiej rozdzielczości, który wyświetla się na stronie kanału w aplikacjach mobilnych. Maksymalny rozmiar obrazu to 320 x 88 pikseli.
brandingSettings.image.bannerMobileMediumHdImageUrl string
Ta właściwość 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 właściwość została wycofana.

Adres URL obrazu banera w wysokiej rozdzielczości, który wyświetla się na stronie kanału w aplikacjach mobilnych. Maksymalny rozmiar obrazu to 1280 x 360 pikseli.
brandingSettings.image.bannerMobileExtraHdImageUrl string
Ta właściwość została wycofana.

Adres URL obrazu banera w 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 właściwość została wycofana.

Adres URL obrazu banera w bardzo wysokiej rozdzielczości, który wyświetla się na stronie kanału w aplikacjach telewizyjnych. Maksymalny rozmiar obrazu to 2120 x 1192 piks.
brandingSettings.image.bannerTvLowImageUrl string
Ta właściwość została wycofana.

Adres URL obrazu banera o niskiej rozdzielczości, który wyświetla się na stronie kanału w aplikacjach telewizyjnych. Maksymalny rozmiar obrazu to 854 x 480 pikseli.
brandingSettings.image.bannerTvMediumImageUrl string
Ta właściwość została wycofana.

Adres URL obrazu banera o średniej rozdzielczości, który wyświetla się na stronie kanału w aplikacjach telewizyjnych. Maksymalny rozmiar obrazu to 1280 x 720 pikseli.
brandingSettings.image.bannerTvHighImageUrl string
Ta właściwość została wycofana.

Adres URL obrazu banera w wysokiej rozdzielczości, który wyświetla się 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 związane z marką.
brandingSettings.hints[].property string
Ta właściwość została wycofana.

Usługa
brandingSettings.hints[].value string
Ta właściwość została wycofana.

Wartość właściwości.
auditDetails object
Obiekt auditDetails zawiera dane kanału, które sieć wielokanałowa (MCN) ocenia, aby zdecydować, czy zaakceptować dany kanał. Pamiętaj, że każde żądanie interfejsu API, które pobiera tę część zasobu, musi zawierać token autoryzacji z zakresem https://www.googleapis.com/auth/youtubepartner-channel-audit. Ponadto każdy token, który wykorzystuje ten zakres, musi zostać cofnięty, gdy sieć wielokanałowa zdecyduje się zaakceptować lub odrzucić kanał, lub w ciągu 2 tygodni od daty wydania tokena.
auditDetails.overallGoodStanding boolean
To pole wskazuje, czy występują jakieś problemy z kanałem. Obecnie to pole reprezentuje wynik operacji logicznej AND na właściwościach communityGuidelinesGoodStanding, copyrightStrikesGoodStandingcontentIdClaimsGoodStanding, co oznacza, że ta usługa ma wartość true, jeśli wszystkie te właściwości mają wartość true. Jednak ta usługa będzie miała wartość false, jeśli któraś z tych usług ma wartość false. Pamiętaj jednak, że metodologia używana do ustawiania wartości tej właściwości może ulec zmianie.
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ą nierozwiązane roszczenia.
contentOwnerDetails object
Obiekt contentOwnerDetails zawiera dane kanału, które są 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 powiązany z kanałem.
contentOwnerDetails.timeLinked datetime
Data i godzina połączenia kanału z właścicielem treści. Wartość jest podawana w formacie ISO 8601.
localizations object
Obiekt localizations zawiera tłumaczenia metadanych kanału.
localizations.(key) object
Język zlokalizowanych metadanych powiązanych z wartością klucza. Wartość to ciąg znaków zawierający kod języka zgodny ze standardem BCP-47.
localizations.(key).title string
Zlokalizowany tytuł kanału.
localizations.(key).description string
Zlokalizowany opis kanału.