Channels

Interfejs API umożliwia teraz oznaczenie kanału lub filmów oznaczonych jako „przeznaczone dla dzieci”. Ponadto channel a zasoby typu video zawierają teraz właściwość, która identyfikuje treści „przeznaczone dla dzieci” o stanie tego kanału lub filmu. Warunki korzystania z usług YouTube API oraz zasady dla deweloperów również zostały zaktualizowane 10 stycznia 2020 r. Więcej informacji znajdziesz w historii zmian dla YouTube Data API oraz Warunki korzystania z usług YouTube API.

Zasób channel zawiera informacje o kanale w YouTube.

Metody

Interfejs API obsługuje następujące metody w przypadku zasobów channels:

list
Zwraca kolekcję niezawierającą co najmniej 0 zasobów typu channel, które pasują do kryteriów żądania. Wypróbuj
zaktualizuj
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

Reprezentowanie zasobu

Poniższa struktura JSON przedstawia 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

Tabela poniżej zawiera właściwości widoczne w tym zasobie:

Właściwości
kind string
Określa typ zasobu interfejsu API. Wartość wyniesie 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ść właściwości może mieć maksymalnie 1000 znaków.
snippet.customUrl string
Niestandardowy adres URL kanału. W Centrum pomocy YouTube znajdziesz opis wymagań, które należy spełnić, aby otrzymać niestandardowy URL, a także dowiedzieć się, jak go skonfigurować.
snippet.publishedAt datetime
Data i godzina utworzenia kanału. Wartość jest podana w formacie ISO 8601.
snippet.thumbnails object
Mapa miniatur obrazów powiązanych z kanałem. Dla każdego obiektu na mapie kluczem jest nazwa miniatury obrazu, a wartością jest obiekt zawierający inne informacje o miniaturze.

Gdy wyświetlasz miniatury w aplikacji, upewnij się, że w kodzie są używane adresy 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 zwróconym w odpowiedzi interfejsu API.

Adresy URL miniatur kanału są dostępne tylko w domenie https. W ten sposób wyświetlają się one w odpowiedziach interfejsu API. Jeśli aplikacja próbuje wczytać obrazy YouTube z domeny http, mogą pojawić się w niej obrazy uszkodzone. W przypadku nowo utworzonych kanałów obrazy miniatur mogą być puste. Zapełnienie ich może potrwać nawet 1 dzień.
snippet.thumbnails.(key) object
Prawidłowe wartości klucza to:
  • default – domyślny obraz miniatury. Domyślna miniatura filmu – lub zasób odnoszący się do filmu, taki jak element playlisty lub wynik 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 powiązanego z filmem) obraz ma 320 pikseli szerokości i 180 pikseli wysokości. W przypadku kanału ten obraz ma 240 pikseli szerokości i 240 pikseli wysokości.
  • high – wersja obrazu miniatury w wysokiej rozdzielczości. W przypadku filmu (lub zasobu powiązanego z filmem) obraz ma 480 pikseli szerokości i 360 pikseli wysokości. W przypadku kanału ten obraz ma 800 pikseli szerokości i 800 pikseli wysokości.
snippet.thumbnails.(key).url string
Adres URL obrazu. Więcej informacji o korzystaniu z 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 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 metadanych kanału.
  • 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 ma być zwracany 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 jest określona lub określona wartość jest określona, ale zlokalizowane metadane są niedostępne dla podanego języka.
Właściwość zawiera wartość tylko do odczytu. Obiekty localizations pozwalają 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 kanał jest powiązany. 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 identyfikuje playlisty powiązane z kanałem, np. filmy przesłane przez kanał lub polubione. 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ę podobają. Aby dodać elementy do tej listy lub je z niej usunąć, użyj metod playlistItems.insert i playlistItems.delete.
contentDetails.relatedPlaylists.favorites string
Ta usługa została wycofana.

Identyfikator playlisty zawierającej ulubione filmy z kanału. Aby dodać elementy do tej listy lub je z niej usunąć, użyj metod playlistItems.insert i playlistItems.delete.

Pamiętaj, że wycofaliśmy funkcję ulubionych filmów w YouTube. Na przykład właściwość statistics.favoriteCount zasobu video została wycofana 28 sierpnia 2015 r. W związku z tym z powodów historycznych ta wartość właściwości może zawierać identyfikator playlisty, który odnosi się do pustej playlisty, więc nie może zostać pobrana.
contentDetails.relatedPlaylists.uploads string
Identyfikator playlisty, która zawiera filmy przesłane na kanał. Użyj metody videos.insert, aby przesłać nowe filmy, lub metody videos.delete, aby usunąć wcześniej przesłane 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 na kanale.
statistics.subscriberCount unsigned long
Liczba subskrybentów kanału Ta wartość jest zaokrąglana w dół do trzech znaczących wartości. Zapoznaj się z Historia wersji lub Więcej informacji znajdziesz w Centrum pomocy YouTube. na temat zaokrąglania liczby subskrybentów.
statistics.hiddenSubscriberCount boolean
Wskazuje, czy liczba subskrybentów kanału jest widoczna publicznie.
statistics.videoCount unsigned long
Liczba filmów publicznych przesłanych na kanał. Pamiętaj, że ta wartość odzwierciedla liczbę publiczne filmy na kanale, nawet dla właścicieli. To zachowanie jest zgodne z liczbami widoczne na stronie 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 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: 27 lutego 2017 r. identyfikatory tematów zaczęły działać inaczej w związku z wycofaniem Freebase i interfejsu Freebase API. Wtedy YouTube zaczął zwracać mały zestaw identyfikatorów wybranych tematów.
topicDetails.topicCategories[] list
Lista adresów URL Wikipedii, które opisują treści na kanale.
status object
Obiekt status zawiera informacje o stanie prywatności kanału.
status.privacyStatus string
Stan prywatności kanału.

Prawidłowe wartości dla 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 jeden z tych linków, ma już publiczną tożsamość YouTube, co jest wymagane do wykonania kilku czynności, takich jak przesył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 właściwości to:
  • allowed – na ten kanał można przesyłać filmy dłuższe niż 15 minut.
  • disallowed – ten kanał nie może 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 jego treści nie są 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 najpierw zezwolić na przesyłanie 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 skierowany do dzieci i zawiera obecnie „przeznaczony dla dzieci” o stanie kanału. Stanem może być na przykład wyznaczany na podstawie wartości właściwości selfDeclaredMadeForKids. Zobacz Centrum pomocy YouTube Informacje na temat określania odbiorców kanału, filmów lub transmisji.
status.selfDeclaredMadeForKids boolean
W żądaniu channels.update umożliwia właścicielowi kanału oznaczenie go jako skierowanego do dzieci. jest zwracana tylko wtedy, gdy właściciel kanału autoryzował żądanie do interfejsu API.
brandingSettings object
Obiekt brandingSettings zawiera informacje o marce kanału.
brandingSettings.channel object
Obiekt channel zawiera właściwości marki na stronie kanału.
brandingSettings.channel.title string
Tytuł kanału. Tytuł może mieć maksymalnie 30 znaków.
brandingSettings.channel.description string
Opis kanału, który jest wyświetlany w polu informacji o kanale na jego stronie. Wartość 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 rozdzielaną spacjami listą ciągów znaków. Kanał słowa kluczowe mogą zostać obcięte, jeśli przekraczają maksymalną dozwoloną długość 500 znaków lub jeśli zawiera cudzysłowy bez zmiany znaczenia ("). Pamiętaj, że limit 500 znaków nie oznacza limitu liczby słów kluczowych, ale raczej ograniczenia łą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 swoim kanale.
brandingSettings.channel.unsubscribedTrailer string
Film, który powinien być odtwarzany w module polecanego filmu w widoku przeglądania strony kanału użytkownikom bez subskrypcji. Subskrybenci mogą zobaczyć inny film, który przedstawia niedawną aktywność na kanale.

Wartość usługi, jeśli została określona, musi być identyfikatorem filmu w YouTube publicznego lub niepublicznego filmu należącego 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 kanał jest powiązany. 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 na stronach odtwarzania filmów z kanału.
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 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 witrynie YouTube. Obraz ma 1060 x 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 640 x 175 pikseli.
brandingSettings.image.watchIconImageUrl string
Ta usługa została wycofana.

Adres URL obrazu widocznego 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 monitorowania o wymiarach 1 na 1, którego można używać do gromadzenia 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 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 jest wyświetlany 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 w 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 wyświetlanego 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 jest wyświetlany na stronie kanału w aplikacjach telewizyjnych. Maksymalny rozmiar obrazu to 2120 x 1192 piksele.
brandingSettings.image.bannerTvLowImageUrl string
Ta właściwość 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 wykorzystywanego przez YouTube do wygenerowania reklamy. różnych rozmiarów banerów w przypadku 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 o kanale, które sieć wielokanałowa oceniła, podejmując decyzję o zaakceptowaniu lub odrzuceniu danego kanału. Pamiętaj, że każde żądanie interfejsu API, które pobiera tę część zasobu, musi zawierać token autoryzacji zawierający zakres https://www.googleapis.com/auth/youtubepartner-channel-audit. Poza tym każdy token korzystający z tego zakresu musi zostać unieważniony, gdy sieć wielokanałowa zdecyduje się zaakceptować lub odrzucić kanał lub w ciągu 2 tygodni od daty jego wydania.
auditDetails.overallGoodStanding boolean
To pole informuje, czy występują jakieś problemy z kanałem. Obecnie to pole reprezentuje wynik operacji logicznej AND dla właściwości communityGuidelinesGoodStanding, copyrightStrikesGoodStanding i contentIdClaimsGoodStanding. Oznacza to, że ta właściwość ma wartość true, jeśli wszystkie te usługi również mają wartość true. Jeśli któraś z nich ma wartość false, ta właściwość będzie jednak miała wartość false. Uwaga: metodologia używana do ustawiania wartości tej usługi może się jednak zmienić.
auditDetails.communityGuidelinesGoodStanding boolean
Wskazuje, czy kanał przestrzega wytycznych dla społeczności YouTube.
auditDetails.copyrightStrikesGoodStanding boolean
Wskazuje, czy kanał ma jakieś ostrzeżenia o naruszeniu praw autorskich.
auditDetails.contentIdClaimsGoodStanding boolean
Wskazuje, czy na kanale są jakieś 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ść 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 wartością klucza. 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.