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
iinvideoPromotion
zasobuchannel
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:
|
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.
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.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:
|
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:
|
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. |