Historia wersji

Na tej stronie znajdziesz informacje o zmianach w YouTube Data API (wersja 3) i aktualizacjach dokumentacji.

30 września 2026 r.

Definicja zasobu comments została zaktualizowana i zawiera nową właściwość snippet.imageUrl, która udostępnia adres URL obrazu lub animowanego GIF-a dołączonego do komentarza.

Ta funkcja będzie dostępna dla wszystkich użytkowników w listopadzie 2026 r.

14 września 2026 r.

Ta aktualizacja zawiera następujące zmiany:

• Opis metody thumbnails.set został zaktualizowany. Obecnie maksymalny rozmiar przesyłanych miniatur wynosi 50 MB (wcześniej było to 2 MB).
• Zaktualizowaliśmy opis metody playlistImages.insert, aby poinformować, że maksymalny rozmiar przesyłanych obrazów wzrósł z 2 MB do 50 MB.

11 września 2026 r.

W dokumentacji referencyjnej zasobów activities, liveBroadcasts, playlistItems, playlists, search i videos zaktualizowaliśmy definicję właściwości snippet.thumbnails.(key), aby poinformować, że w przypadku niektórych filmów dostępne są teraz miniatury w wyższej rozdzielczości: fhd (1080p), qhd (1440p) i uhd (4K).

1 września 2026 r.

Metoda videos.getRating akceptuje teraz zakres autoryzacji https://www.googleapis.com/auth/youtube.readonly.

27 sierpnia 2026 r.

YouTube ujednolici zliczanie wyświetleń publicznych we wszystkich formatach wideo: długich filmach, transmisjach na żywo i Shorts. YouTube będzie zliczać wyświetlenia publiczne w momencie rozpoczęcia odtwarzania filmu.

Kryteria kwalifikacji do zarabiania i większość podstawowych danych o skuteczności pozostają bez zmian, ponieważ nadal są oparte na danych o zaangażowaniu. Zarobki twórców nadal będą zależeć od „wyświetleń filmów Short z zaangażowaniem” i „godzin czasu oglądania z zaangażowaniem”, które możesz sprawdzić w Statystykach YouTube > Tryb zaawansowany.

Nie zmieniamy wymagań dotyczących udziału w programie partnerskim YouTube. Wymagania dotyczące udziału w programie partnerskim YouTube będą teraz określane jako „kwalifikujące się wyświetlenia filmów Short” i „kwalifikujący się czas oglądania w godzinach” (wcześniej „zweryfikowane wyświetlenia publicznych filmów Short” i „zweryfikowane godziny czasu oglądania publicznych filmów”).

Więcej informacji znajdziesz w artykule Analiza skuteczności treści w YouTube.

Wskaźnik	Stan	Aktywator	Używane do
Wyświetl	Zaktualizowano	Film odtwarza się od pierwszej klatki (obejmuje autoodtwarzanie, najechanie wskaźnikiem i kliknięcie/dotknięcie, aby odtworzyć).	Standardowe liczby wyświetleń publicznych.
Wyświetlenie angażujące	Bez zmian	Odtwarzanie trwa dłużej niż pierwsza klatka lub użytkownik klika/naciska, aby odtworzyć film.	Zarabianie w ramach programu partnerskiego YouTube, większość podstawowych statystyk (współczynnik klikalności, średni czas oglądania) i raporty dotyczące zaangażowania.
Wyświetlenie miniatury	Bez zmian	Miniatura jest wyświetlana bez interakcji i autoodtwarzania.	Mierzy ekspozycję i przygotowywanie pakietów na poziomie pliku danych.

Aktualizacje dokumentacji API: zaktualizowaliśmy opis pola viewCount w dokumentacji referencyjnej kanałów i filmów.

6 sierpnia 2026 r.

Ta aktualizacja zawiera następujące zmiany:

• Wszystkie odwołania do pól contentDetails.like i contentDetails.favorite w sekcji activities.contentDetails zostały usunięte z dokumentacji publicznej, ponieważ te pola nie są zwracane przez interfejs API.

7 lipca 2026 r.

Ta aktualizacja zawiera następujące zmiany:

Interfejs API obsługuje teraz część brandPartner w zasobie videos. Ta sekcja zawiera szczegóły dotyczące marki powiązanej z filmem w ramach dostępu marki zainicjowanego przez twórcę.

Część brandPartner można określić podczas wywoływania tych metod:

• videos.insert
• videos.update
• videos.list

Obiekt brandPartner zawiera te pola:

• channelId: zewnętrzny identyfikator kanału partnera marki.
• channelHandle: uchwyt kanału partnera marki.

Podczas tworzenia linku należy ustawić wartość channelId lub channelHandle, ale w odpowiedzi zwracana jest tylko wartość channelId.

23 czerwca 2026 r.

Ta aktualizacja zawiera następujące zmiany:

• Wszystkie odniesienia do typów zasobów messageDeletedEvent i messageRetractedEvent (oraz odpowiadających im obiektów messageDeletedDetails i messageRetractedDetails) w sekcji liveChatMessages zostały usunięte, ponieważ te zdarzenia nie są zwracane przez interfejs API.

3 czerwca 2026 r.

Ta aktualizacja zawiera następujące zmiany:

Interfejs API obsługuje teraz nową metodę videos.batchGetStats, która pobiera listę statystyk filmów zgodnych z parametrami żądania do interfejsu API.

Wywołanie tej metody ma koszt limitu w wysokości 1 jednostki w jej własnym szczegółowym zasobniku limitu. Domyślny limit tej metody to 10 000 jednostek dziennie.

1 czerwca 2026 r.

Interfejs YouTube Data API przechodzi na szczegółowy system limitów obejmujący mniejsze zestawy metod, począwszy od metod videos.insert i search.list.

Ta aktualizacja upraszcza proces zwiększania limitów, ponieważ umożliwia YouTube łatwiejsze weryfikowanie i zatwierdzanie próśb na podstawie konkretnego sposobu wykorzystania. Ta zmiana jest też kluczowym elementem naszego zobowiązania do zapewnienia stabilności i bezpieczeństwa platformy. Dzięki temu każdy deweloper może działać w chronionym ekosystemie, zachowując jednocześnie poziomy dostępu niezbędne w przypadku zatwierdzonych zastosowań.

Wywołania interfejsu API metod videos.insert i search.list będą rozliczane w ramach odpowiednich limitów. Wywołania interfejsu API wszystkich innych metod będą rozliczane w ramach istniejącego limitu. Deweloperzy mogą wyświetlać limity w konsoli Google Cloud i prosić o dodatkowe limity za pomocą formularza prośby o zwiększenie limitu.

4 grudnia 2025 r.

Dokumentacja interfejsu YouTube Data API i kalkulator limitów zostały zaktualizowane, aby odzwierciedlać zmianę kosztu limitu przesyłania filmu z około 1600 jednostek na około 100 jednostek.

10 lipca 2025 r.

21 lipca 2025 r. YouTube dostosuje treści zwracane przez wykres mostPopular metody video.list. W przeszłości lista mostPopular odzwierciedlała filmy z listy Na czasie. Teraz na liście mostPopular będą się pojawiać filmy z list Na czasie w kategoriach Muzyka, Filmy i Gry. Ta zmiana w interfejsie API jest powiązana z wycofaniem karty Na czasie w YouTube.

26 marca 2025 r.

Od 31 marca 2025 r. YouTube zmieni sposób zliczania wyświetleń filmów Short. Wcześniej w przypadku filmów Short wyświetlenie było zliczane po odtworzeniu filmu przez określoną liczbę sekund. Od teraz liczba wyświetleń będzie wskazywała to, ile razy użytkownicy rozpoczęli lub ponowili odtwarzanie filmu Short, bez wymogu minimalnego czasu oglądania. Więcej informacji

Od 31 marca 2025 r. te pola w interfejsie Data API będą zwracać liczbę wyświetleń filmów Short zgodnie z tą zmianą:

• channels.statistics.viewCount
• videos.statistics.viewCount

30 października 2024 r.

Interfejs API obsługuje teraz możliwość identyfikowania filmów, które zawierają realistyczne treści zmodyfikowane lub wygenerowane syntetycznie (A/S). Dowiedz się więcej o zasadach YouTube dotyczących treści związanych z alkoholem i tytoniem.

Przykłady treści związanych z alkoholem i tytoniem to filmy, które:

• sprawiają, że prawdziwa osoba wydaje się mówić lub robić coś, czego w rzeczywistości nie powiedziała ani nie zrobiła;
• Zmodyfikowanie materiału pokazującego prawdziwe wydarzenie lub miejsce
• Wygenerowanie realistycznie wyglądającej sceny, która faktycznie nie miała miejsca

Aby wskazać, czy film zawiera treści związane z alkoholem lub tytoniem, ustaw właściwość status.containsSyntheticMedia. Tę właściwość można ustawić podczas wywoływania metod videos.insert lub videos.update. Jeśli jest ustawiona, właściwość jest zwracana w zasobie video.

30 kwietnia 2024 r.

Uwaga: to jest ogłoszenie o wycofaniu funkcji.

Ta aktualizacja zawiera następujące zmiany:

Interfejs API nie obsługuje już wstawiania ani pobierania dyskusji na kanale. Ta zmiana jest zgodna z funkcją obsługiwaną w witrynie YouTube, która nie umożliwia publikowania komentarzy na kanałach.

13 marca 2024 r.

Uwaga: to jest ogłoszenie o wycofaniu funkcji.

Ta aktualizacja zawiera następujące zmiany:

Parametr sync w metodach captions.insert i captions.update został wycofany. 12 kwietnia 2024 r. YouTube przestanie obsługiwać parametr .

W związku z tą zmianą deweloperzy muszą podawać informacje o czasie podczas wstawiania lub aktualizowania ścieżek z napisami. W przeciwnym razie przesyłanie się nie powiedzie.

12 marca 2024 r.

Ta aktualizacja zawiera następujące zmiany:

Zaktualizowaliśmy dokumentację zasobu captions, aby poinformować, że maksymalna dozwolona długość pola snippet.name to 150 znaków. Jeśli nazwa ścieżki jest dłuższa, interfejs API zwraca błąd nameTooLong.

7 marca 2024 r.

Uwaga: to jest ogłoszenie o wycofaniu funkcji.

Właściwość zasobu channelbrandingSettings.channel.moderateComments została wycofana. 7 marca 2024 r. YouTube przestanie obsługiwać ten parametr.

31 stycznia 2024 r.

Ta aktualizacja zawiera następujące zmiany:

Nowy parametr forHandle metody channels.list umożliwia pobieranie informacji o kanale przez podanie jego nicka w YouTube.

9 listopada 2023 r.

Wszystkie odwołania do zasobu videoId w Comments zostały usunięte, ponieważ zasób videoId nie jest zwracany w wywołaniu interfejsu API.

12 września 2023 r.

Uwaga: to jest ogłoszenie o wycofaniu funkcji.

Metoda comments.markAsSpam jest wycofana od kilku lat. Ta metoda nie jest już obsługiwana w YouTube ani w interfejsie API.

Do wszystkich dokumentów, w których występuje metoda comments.markAsSpam, dodaliśmy powiadomienie o wycofaniu.

22 sierpnia 2023 r.

Metoda search.list obsługuje teraz parametr videoPaidProductPlacement. Ten parametr umożliwia filtrowanie wyników wyszukiwania tak, aby obejmowały tylko filmy, które twórca oznaczył jako zawierające płatną promocję.

18 sierpnia 2023 r.

Zaktualizowaliśmy definicję zasobu video,liveStreamingDetails.concurrentViewers aby zaznaczyć, że liczba równoczesnych widzów zwracana przez interfejs YouTube Data API może się różnić od przetworzonej i oczyszczonej z niechcianych wiadomości liczby równoczesnych widzów dostępnej w��Statystykach YouTube. Więcej informacji o danych transmisji na żywo znajdziesz w Centrum pomocy YouTube.

7 sierpnia 2023 r.

Jak ogłosiliśmy 12 czerwca 2023 r., parametr relatedToVideoId metody search.list został wycofany. Ten parametr nie jest już obsługiwany, a odniesienia do niego zostały usunięte z dokumentacji API.

28 czerwca 2023 r.

Metoda thumbnails.set obsługuje teraz błąd uploadRateLimitExceeded, który oznacza, że w ciągu ostatnich 24 godzin kanał przesłał zbyt wiele miniatur i powinien spróbować ponownie później.

12 czerwca 2023 r.

Uwaga: to jest ogłoszenie o wycofaniu funkcji.

Parametr relatedToVideoId metody search.list został wycofany. 7 sierpnia 2023 r. przestaniemy obsługiwać parametr .

Do dokumentacji metody search.list dodaliśmy powiadomienie o wycofaniu. Ten parametr zostanie całkowicie usunięty z dokumentacji search.list 7 sierpnia 2023 r. lub później.

Ponadto z przewodnika implementacji interfejsu API usunęliśmy przykład pokazujący, jak pobrać powiązane filmy.

22 sierpnia 2022 r.

Poprawiono adnotacje typu dla pól video.statistics z niepodpisanego typu long na ciąg znaków.

5 sierpnia 2022 r.

YouTube zmienił sposób generowania identyfikatorów napisów i w ramach tej zmiany przypisuje nowe identyfikatory do wszystkich ścieżek napisów. Ta zmiana może być niekompatybilna wstecznie z aplikacjami, które przechowują wartości caption_id, ale nie będzie miała wpływu na aplikacje, które nie przechowują wartości caption_id.

Od teraz do 1 grudnia 2022 r. metody captions.list, captions.update, captions.download i captions.delete będą obsługiwać zarówno stare, jak i nowe identyfikatory ścieżek z napisami. Jednak od 1 grudnia 2022 r. YouTube przestanie obsługiwać stare identyfikatory ścieżek z napisami. Od tego czasu wywoływanie dowolnej z tych metod interfejsu API ze starym identyfikatorem ścieżki z napisami będzie powodować błąd captionNotFound.

Aby przygotować się na tę zmianę, zaplanuj całkowite zastąpienie wszystkich przechowywanych danych ścieżki z napisami w okresie od teraz do 1 grudnia 2022 r. Oznacza to, że w przypadku każdego filmu, dla którego przechowujesz dane ścieżki z napisami, musisz usunąć aktualnie przechowywane dane, a następnie wywołać metodę captions.list, aby pobrać bieżący zestaw ścieżek z napisami do filmu i zapisać dane w odpowiedzi interfejsu API w zwykły sposób.

12 lipca 2022 r.

Zaktualizowaliśmy Warunki korzystania z usług YouTube API. Więcej informacji znajdziesz w historii zmian Warunków korzystania z usług YouTube API.

27 kwietnia 2022 r.

Zaktualizowaliśmy opis metody videos.insert, aby poinformować, że maksymalny rozmiar przesyłanych filmów wzrósł ze 128 GB do 256 GB.

8 kwietnia 2022 r.

Zaktualizowaliśmy definicje parametrów subscriptions.list metody myRecentSubscribers i mySubscribers, aby uwzględnić informację, że maksymalna liczba subskrybentów zwracanych przez interfejs API może być ograniczona. Ta zmiana to korekta w dokumentacji, a nie zmiana w działaniu interfejsu API.

15 grudnia 2021 r.

Zgodnie z informacją podaną 18 listopada 2021 roku w związku ze zmianami, które sprawią, że liczba kliknięć przycisku „Nie lubię” będzie prywatna na całej platformie YouTube, właściwość statistics.dislikeCount zasobu video jest teraz prywatna.

Więcej informacji o tej zmianie znajdziesz na oficjalnym blogu YouTube.

18 listopada 2021 r.

W związku ze zmianami, które sprawią, że liczba negatywnych ocen filmów będzie prywatna na całej platformie YouTube, właściwość statistics.dislikeCount zasobu video zostanie ustawiona jako prywatna 13 grudnia 2021 r. Oznacza to, że właściwość będzie uwzględniana w odpowiedzi interfejsu API z punktu końcowego videos.list tylko wtedy, gdy żądanie do interfejsu API zostało uwierzytelnione przez właściciela filmu.

Ta zmiana nie ma wpływu na punkt końcowy videos.rate.

Deweloperzy, którzy nie wyświetlają publicznie liczby negatywnych ocen, ale nadal potrzebują jej w swoim kliencie interfejsu API, mogą poprosić o dodanie do listy dozwolonych, aby uzyskać wyjątek. Aby poprosić o wyjątek, musisz wypełnić ten formularz zgłoszeniowy.

Więcej informacji o tej zmianie znajdziesz na oficjalnym blogu YouTube.

2 lipca 2021 r.

Uwaga: to jest ogłoszenie o wycofaniu funkcji.

Punkt końcowy commentThreads.update został wycofany i nie jest już obsługiwany. Ten punkt końcowy duplikuje funkcje dostępne w innych punktach końcowych interfejsu API. Zamiast tego możesz zadzwonić pod numer comments.update

metody i jeśli Twój kod wymaga zasobu commentThreads, wykonaj dodatkowe wywołanie metody commentThreads.list.

1 lipca 2021 r.

Wszyscy deweloperzy korzystający z usług API YouTube muszą przejść kontrolę zgodności interfejsu API,aby uzyskać limit większy niż domyślny limit 10 000 jednostek. Do tej pory zarówno proces kontroli zgodności, jak i prośby o dodatkowe przydziały jednostek limitu były przeprowadzane przez deweloperów, którzy wypełniali i przesyłali formularz dotyczący usług YouTube API – kontrola i zwiększenie limitu.

Aby wyjaśnić te procesy i lepiej zaspokajać potrzeby deweloperów korzystających z naszych usług API, dodajemy 3 nowe formularze i przewodnik po ich wypełnianiu:

• Formularz audytu i zwiększenia limitu przydziału: Deweloperzy, którzy przeszli już audyt zgodności interfejsu API, mogą wypełnić i przesłać ten formularz (w pierwszym pytaniu wybierając „Przeprowadzenie audytu zgodności w celu zachowania obecnego limitu przydziału (w związku z prośbą o przejście ponownego audytu)”), aby poprosić o zwiększenie przydzielonego limitu przydziału.
• Formularz odwołania: deweloperzy, których projekty API nie przeszły kontroli zgodności (lub którym odmówiono zwiększenia limitu jednostek), mogą wypełnić i przesłać ten formularz.
• Formularz zmiany kontroli: deweloperzy lub dowolny podmiot zarządzający klientem API w imieniu dewelopera, u których nastąpiła zmiana kontroli (np. w wyniku zakupu lub sprzedaży akcji, fuzji przedsiębiorstw bądź innego rodzaju transakcji firmowej) związana z projektem API, muszą wypełnić i przesłać ten formularz. Dzięki temu zespół interfejsu API YouTube może zaktualizować nasze dane, sprawdzić, czy nowy projekt interfejsu API jest zgodny z przypadkiem użycia, i zweryfikować bieżący przydział limitu dewelopera.

Każdy nowy formularz poinformuje nas o Twoim zamierzonym sposobie korzystania z interfejsu API YouTube i umożliwi nam lepszą pomoc.

Więcej informacji znajdziesz w naszym nowym przewodniku po audytach zgodności interfejsu API.

12 maja 2021 r.

Uwaga: to jest ogłoszenie o wycofaniu funkcji.

Ta aktualizacja obejmuje następujące zmiany w interfejsie API:

• Właściwość contentDetails.relatedPlaylists.favorites zasobu channel została wycofana. Funkcja ulubionych filmów została wycofana kilka lat temu, o czym informowaliśmy w historii zmian z 28 kwietnia 2016 r.

  Przed tą aktualizacją interfejs API tworzył nową playlistę, jeśli klient interfejsu API próbował dodać film do nieistniejącej playlisty ulubionych. W takim przypadku playlista nie zostanie utworzona, a interfejs API zwróci błąd. Próby modyfikowania ulubionych playlist przez dodawanie, zmienianie lub usuwanie elementów również są wycofywane zgodnie z wcześniejszymi ogłoszeniami i w każdej chwili mogą zacząć zwracać błędy.

• Te właściwości zasobu channel zostały wycofane. Te usługi nie są już obsługiwane w interfejsie YouTube Studio ani w YouTube. W rezultacie nie są one już obsługiwane przez interfejs API.

  • brandingSettings.channel.defaultTab
  • brandingSettings.channel.featuredChannelsTitle
  • brandingSettings.channel.featuredChannelsUrls[]
  • brandingSettings.channel.profileColor
  • brandingSettings.channel.showBrowseView
  • brandingSettings.channel.showRelatedChannels

  Wszystkie usługi zostały usunięte z channel reprezentacji zasobu, a ich definicje zostały usunięte z listy usług zasobu. Dodatkowo z dokumentacji dotyczącej poszczególnych metod usunęliśmy błędy związane z tymi właściwościami.

• Te właściwości zasobu channelSection zostały wycofane. Te usługi nie są już obsługiwane w interfejsie YouTube Studio ani w YouTube. W rezultacie nie są one już obsługiwane przez interfejs API.

  • snippet.style
  • snippet.defaultLanguage
  • snippet.localized.title
  • localizations
  • localizations.(key)
  • localizations.(key).title
  • targeting
  • targeting.languages[]
  • targeting.regions[]
  • targeting.countries[]

  W związku z tą zmianą wycofaliśmy też parametr hl metody channelSection.list, ponieważ obsługiwane przez niego funkcje nie są obsługiwane.

  Wszystkie usługi zostały usunięte z channelSection reprezentacji zasobu, a ich definicje zostały usunięte z listy usług zasobu. Dodatkowo z dokumentacji dotyczącej poszczególnych metod usunęliśmy błędy związane z tymi właściwościami.

• W przypadku właściwości snippet.type zasobu channelSection te wartości zostały wycofane: Te wartości nie są już obsługiwane na stronach kanałów w YouTube, a w związku z tym nie są już obsługiwane przez interfejs API.

  • likedPlaylists
  • likes
  • postedPlaylists
  • postedVideos
  • recentActivity
  • recentPosts

• Właściwość snippet.tags[] zasobu playlist została wycofana. Ta właściwość nie jest już obsługiwana w YouTube, dlatego nie jest też obsługiwana przez interfejs API.

9 lutego 2021 r.

Zasób playlistItem obsługuje 2 nowe właściwości:

• Właściwość snippet.videoOwnerChannelId określa identyfikator kanału, na który został przesłany film z playlisty.
• Właściwość snippet.videoOwnerChannelTitle określa nazwę kanału, na który przesłano film z playlisty.

28 stycznia 2021 r.

Ta aktualizacja zawiera następujące zmiany:

• Metody playlistItems.delete, playlistItems.insert, playlistItems.list, playlistItems.update, playlists.delete, playlists.list i playlists.update obsługują nowy błąd playlistOperationUnsupported. Błąd występuje, gdy żądanie próbuje wykonać operację, która nie jest dozwolona w przypadku danej playlisty. Użytkownik nie może na przykład usunąć filmu z playlisty przesłanych filmów ani usunąć samej playlisty.

  W każdym przypadku ten błąd zwraca kod odpowiedzi HTTP 400 (nieprawidłowe żądanie).

• Z dokumentacji usunęliśmy błędy watchHistoryNotAccessible i watchLaterNotAccessible metody playlistItems.list. Chociaż historia oglądania i lista „Obejrzyj później” użytkowników nie są dostępne w interfejsie API, te konkretne błędy nie są przez niego zwracane.

15 października 2020 r.

Do zasad dla deweloperów dodaliśmy 2 nowe sekcje:

• Nowy punkt III.E.4.i zawiera dodatkowe informacje o danych zbieranych i wysyłanych za pomocą odtwarzacza osadzonego YouTube. Odpowiadasz za wszelkie dane użytkowników, które przesyłasz do nas za pomocą dowolnego odtwarzacza osadzonego w YouTube, zanim użytkownik wejdzie w interakcję z odtwarzaczem, aby wskazać zamiar odtworzenia. Możesz ograniczyć udostępnianie danych YouTube, zanim użytkownik wejdzie w interakcję z odtwarzaczem, ustawiając autoodtwarzanie na „false”.
• Nowy punkt III.E.4.j dotyczy sprawdzania statusu treści przeznaczonych dla dzieci przed umieszczeniem ich w witrynach i aplikacjach. Odpowiadasz za wiedzę o tym, kiedy filmy, które umieszczasz w swoim kliencie interfejsu API, są przeznaczone dla dzieci, i za odpowiednie traktowanie danych zebranych z umieszczonego odtwarzacza. Dlatego przed umieszczeniem treści w kliencie interfejsu API za pomocą dowolnego umieszczonego odtwarzacza YouTube musisz sprawdzić jej stan za pomocą interfejsu YouTube Data API Service.

Nowy przewodnik Sprawdzanie statusu filmu jako przeznaczonego dla dzieci wyjaśnia, jak sprawdzić status MFK filmu za pomocą usługi YouTube Data API.

W związku z tymi zmianami do dokumentacji parametrów odtwarzacza osadzonego dodaliśmy przypomnienie, że jeśli włączysz automatyczne odtwarzanie, odtwarzanie będzie się odbywać bez interakcji użytkownika z odtwarzaczem. W związku z tym zbieranie i udostępnianie danych o odtwarzaniu będzie się odbywać po wczytaniu strony.

8 października 2020 r.

Ta aktualizacja obejmuje 3 drobne zmiany związane z zasobem channel:

• Obiekt snippet.thumbnails, który identyfikuje miniatury kanału, może być pusty w przypadku nowo utworzonych kanałów. Jego wypełnienie może potrwać do 1 dnia.
• Właściwość statistics.videoCount odzwierciedla liczbę tylko publicznych filmów na kanale, nawet w przypadku właścicieli. Działa to podobnie jak na stronie YouTube.
• Słowa kluczowe kanału, które są identyfikowane we właściwości brandingSettings.channel.keywords, mogą zostać obcięte, jeśli przekroczą maksymalną dozwoloną długość 500 znaków lub jeśli zawierają nieprawidłowo użyte cudzysłowy ("). Pamiętaj, że limit 500 znaków nie dotyczy poszczególnych słów kluczowych, ale łącznej długości wszystkich słów kluczowych. Działa to tak samo jak w witrynie YouTube.

9 września 2020 r.

Uwaga: to jest ogłoszenie o wycofaniu funkcji.

Ta aktualizacja obejmuje następujące zmiany w interfejsie API. Wszystkie zmiany wejdą w życie 9 września 2020 r. lub później, czyli w dniu ogłoszenia tej informacji. W związku z tym deweloperzy nie powinni już korzystać z żadnych funkcji interfejsu API wymienionych poniżej.

• Te zasoby, metody, parametry i właściwości zasobów interfejsu API są natychmiast wycofywane i przestaną działać w dniu ogłoszenia lub po nim:
  • Te właściwości zasobu channel:
    • Usługa statistics.commentCount
    • obiekt brandingSettings.image i wszystkie jego usługi podrzędne;
    • brandingSettings.hintslista i wszystkie usługi podrzędne,
  • Parametr filtra categoryId metody channels.list
  • zasób guideCategories i metoda guideCategories.list;
• Odpowiedzi interfejsu API dla metody channels.list nie zawierają już właściwości prevPageToken, jeśli żądanie do interfejsu API ustawia parametr managedByMe na true. Ta zmiana nie ma wpływu na właściwość prevPageToken w przypadku innych żądań channels.list ani na właściwość nextPageToken w przypadku żadnych żądań.
• Właściwości contentDetails.relatedPlaylists.watchLater i contentDetails.relatedPlaylists.watchHistory zasobu channel zostały ogłoszone jako wycofane 11 sierpnia 2016 r. Obsługa tych list odtwarzania w przypadku metod playlistItems.insert i playlistItems.delete została w pełni wycofana, a te 2 właściwości zostały usunięte z dokumentacji.
• Parametr mySubscribers metody channels.list, który został ogłoszony jako wycofany 30 lipca 2013 r., został usunięty z dokumentacji. Użyj metody subscriptions.list i jej parametru mySubscribers, aby pobrać listę subskrybentów kanału uwierzytelnionego użytkownika.
• Z dokumentacji usunęliśmy obiekt invideoPromotion zasobu channel i wszystkie jego właściwości podrzędne, które zostały ogłoszone jako wycofane 27 listopada 2017 r..

29 lipca 2020 r.

Uprościliśmy proces naliczania limitu na potrzeby żądań interfejsu API, usuwając dodatkowy koszt związany z parametrem part. Od razu zaczniemy pobierać tylko koszt podstawowy wywoływanej metody. Więcej informacji o uproszczonym limicie znajdziesz tutaj.

W wyniku tej zmiany większość wywołań interfejsu API będzie miała nieco niższy koszt limitu, a niektóre wywołania interfejsu API nadal będą miały taki sam koszt. Ta zmiana nie zwiększa kosztu żadnych wywołań interfejsu API. Ogólnie rzecz biorąc, prawdopodobny efekt jest taki, że przydzielony limit, który można sprawdzić w konsoli Google Cloud, będzie wystarczał na dłużej.

Zdecydowanie zalecamy wszystkim deweloperom przeprowadzenie audytu zgodności w przypadku swoich projektów, aby zapewnić sobie dalszy dostęp do usług YouTube API.

Ta pozycja w historii zmian została pierwotnie opublikowana 20 lipca 2020 r.

28 lipca 2020 r.

Wszystkie filmy przesłane za pomocą punktu końcowego videos.insert z niezweryfikowanych projektów API utworzonych po 28 lipca 2020 r. będą ograniczone do trybu wyświetlania prywatnego. Aby znieść to ograniczenie, każdy projekt musi przejść audyt w celu sprawdzenia zgodności z Warunkami korzystania z usługi.

Twórcy, którzy używają niezweryfikowanego klienta API do przesyłania filmów, otrzymają e-maila z informacją, że ich film został zablokowany jako prywatny i że mogą uniknąć tego ograniczenia, korzystając z oficjalnego lub sprawdzonego klienta.

Ta zmiana nie ma obecnie wpływu na projekty interfejsu API utworzone przed 28 lipca 2020 r. Zdecydowanie zalecamy jednak wszystkim deweloperom przeprowadzenie audytu zgodności w przypadku swoich projektów, aby zapewnić sobie dalszy dostęp do usług YouTube API.

21 lipca 2020 r.

[Aktualizacja: 28 lipca 2020 r.] Aktualizacja dokumentacji, o której mowa w tym wpisie w historii zmian, została ponownie opublikowana 28 lipca 2020 r.

Wczoraj opublikowaliśmy aktualizację dokumentacji dotyczącą procesu naliczania limitu. Ze względu na nieprzewidziane okoliczności zmiana limitu nie weszła jeszcze w życie. W związku z tym w celu zachowania dokładności przywróciliśmy poprzednią wersję dokumentacji. Aby uniknąć nieporozumień, usunęliśmy wpis w historii zmian wyjaśniający tę zmianę. W najbliższej przyszłości opublikujemy go ponownie.

7 lipca 2020 r.

Uwaga: to jest ogłoszenie o wycofaniu funkcji.

Parametry videos.insert i stabilize metody autoLevels są teraz wycofane i zostały usunięte z dokumentacji. Ich wartości są ignorowane i nie mają wpływu na sposób przetwarzania nowo przesłanych filmów.

15 czerwca 2020 r.

Nowy przewodnik Zgodność z zasadami dla deweloperów YouTube zawiera wskazówki i przykłady, które pomogą Ci zadbać o to, aby Twoi klienci API przestrzegali określonych części Warunków i zasad dotyczących usług YouTube API (Warunków korzystania z usług API).

Te wskazówki wyjaśniają, jak YouTube egzekwuje przestrzeganie niektórych aspektów Warunków korzystania z interfejsu API, ale nie zastępują żadnych istniejących dokumentów. W tym przewodniku znajdziesz odpowiedzi na niektóre z najczęstszych pytań, które deweloperzy zadają podczas sprawdzania zgodności z interfejsem API. Mamy nadzieję, że ułatwi Ci to proces tworzenia funkcji, ponieważ pomoże Ci zrozumieć, jak interpretujemy i egzekwujemy nasze zasady.

4 czerwca 2020 r.

Uwaga: jest to aktualizacja wcześniejszego ogłoszenia o wycofaniu.

Funkcja biuletynu kanału została całkowicie wycofana. O tej zmianie poinformowaliśmy po raz pierwszy 17 kwietnia 2020 r. Weszła ona już w życie. W związku z tym metoda activities.insert nie jest już obsługiwana, a metoda activities.list nie zwraca już biuletynów kanału. Więcej informacji znajdziesz w Centrum pomocy YouTube.

17 kwietnia 2020 r.

Uwaga: to jest ogłoszenie o wycofaniu funkcji.

Wycofujemy funkcję biuletynu kanału w YouTube. W związku z tym metoda activities.insert zostanie wycofana, a metoda activities.list przestanie zwracać biuletyny kanału. Zmiany te zaczną obowiązywać w interfejsie API 18 maja 2020 r. lub później. Więcej informacji znajdziesz w Centrum pomocy YouTube.

31 marca 2020 r.

Ta aktualizacja zawiera następujące zmiany:

• Nowe zasoby i metody

  • Nowy zasób member reprezentuje wspierającego kanał w YouTube. Wspierający regularnie przekazuje środki twórcy i otrzymuje specjalne korzyści. Wspierający mogą na przykład czatować, gdy twórca włączy tryb czatu tylko dla wspierających.

    Ten zasób zastępuje zasób sponsor, który jest opisany w interfejsie YouTube Live Streaming API. Zasób sponsor został wycofany, więc klienci interfejsu API powinni zaktualizować wywołania metody sponsors.list, aby zamiast niej używać metody members.list.

  • Nowy zasób membershipsLevel określa poziom cenowy zarządzany przez twórcę, który autoryzował żądanie do interfejsu API. Metoda membershipsLevels.list pobiera listę wszystkich poziomów członkostwa twórcy.

10 stycznia 2020 r.

Interfejs API obsługuje teraz możliwość identyfikowania treści skierowanych do dzieci, które YouTube nazywa „przeznaczonymi dla dzieci”. Więcej informacji o treściach „przeznaczonych dla dzieci” znajdziesz w Centrum pomocy YouTube.

Materiały channel i video zawierają 2 nowe właściwości, które pomagają twórcom i widzom identyfikować treści przeznaczone dla dzieci:

• Właściwość selfDeclaredMadeForKids umożliwia twórcom treści określenie, czy kanał lub film są przeznaczone dla dzieci.
  
  W przypadku kanałów tę właściwość można ustawić podczas wywoływania metody channels.update. W przypadku filmów tę właściwość można ustawić podczas wywoływania metod videos.insert lub videos.update.
  
  Pamiętaj, że ta właściwość jest uwzględniana tylko w odpowiedziach interfejsu API, które zawierają zasoby channel lub video, jeśli właściciel kanału autoryzował żądanie interfejsu API.
• Właściwość madeForKids umożliwia każdemu użytkownikowi pobranie stanu „przeznaczony dla dzieci” kanału lub filmu. 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 lub transmisji znajdziesz w Centrum pomocy YouTube.

Zaktualizowaliśmy też Warunki korzystania z usług YouTube API i zasady dla deweloperów. Więcej informacji znajdziesz w historii zmian Warunków korzystania z usług YouTube API. Zmiany w Warunkach korzystania z usług YouTube API i zasadach dla deweloperów wejdą w życie 10 stycznia 2020 r. czasu pacyficznego.

10 września 2019 r.

Zaktualizowaliśmy dokumentację referencyjną interfejsu API, aby odzwierciedlić zmianę sposobu raportowania liczby subskrybentów w YouTube, a co za tym idzie, w odpowiedziach interfejsu API. W wyniku tej zmiany liczba subskrybentów zwracana przez interfejs YouTube Data API jest zaokrąglana w dół do 3 cyfr znaczących, jeśli liczba subskrybentów jest większa niż 1000. Ta zmiana dotyczy właściwości statistics.subscriberCount zasobu channel.

Uwaga: ta zmiana wpływa na wartość tej usługi nawet w przypadkach, gdy użytkownik wysyła autoryzowane żądanie danych o własnym kanale. Właściciele kanałów nadal mogą wyświetlać dokładną liczbę subskrybentów w YouTube Studio.

Jeśli na przykład kanał ma 123 456 subskrybentów, właściwość statistics.subscriberCount będzie zawierać wartość 123000. Poniższa tabela zawiera przykłady zaokrąglania liczby subskrybentów w odpowiedziach API i skracania jej w innych publicznie widocznych interfejsach użytkownika YouTube:

Przykładowa liczba subskrybentów	YouTube Data API	Publicznie widoczne interfejsy YouTube
1234	1230	1,23 tys.
12 345	12300	12,3 tys.
123 456	123000	123 tys.
1 234 567	1230000	1,23 mln
12,345,678	12300000	12,3 mln
123,456,789	123000000	123 mln

4 kwietnia 2019 r.

Ta aktualizacja zawiera następujące zmiany:

• Zaktualizowaliśmy dokumentację interfejsu API, aby lepiej wyjaśnić typowe przypadki użycia każdej metody i zapewnić dynamiczne, wysokiej jakości przykłady kodu za pomocą widżetu Eksplorator interfejsów API. Przykład znajdziesz w dokumentacji metody channels.list. Na stronach opisujących metody interfejsu API pojawiły się 2 nowe elementy:

  • Widżet APIs Explorer umożliwia wybieranie zakresów autoryzacji, wpisywanie przykładowych wartości parametrów i właściwości, a następnie wysyłanie rzeczywistych żądań interfejsu API i wyświetlanie rzeczywistych odpowiedzi interfejsu API. Widżet oferuje też widok pełnoekranowy, w którym wyświetlane są kompletne przykłady kodu, które dynamicznie aktualizują się, aby używać wpisanych przez Ciebie zakresów i wartości.

  • W sekcji Typowe przypadki użycia znajdziesz opis co najmniej jednego typowego przypadku użycia metody wyjaśnionej na stronie. Możesz na przykład wywołać metodę channels.list, aby pobrać dane o konkretnym kanale lub o kanale bieżącego użytkownika.

    Możesz użyć linków w tej sekcji, aby wypełnić Eksplorator interfejsów API przykładowymi wartościami dla Twojego przypadku użycia lub otworzyć Eksplorator interfejsów API na pełnym ekranie z już wypełnionymi wartościami. Te zmiany mają na celu ułatwienie Ci znajdowania przykładów kodu, które można bezpośrednio zastosować w przypadku użycia, które chcesz wdrożyć we własnej aplikacji.

  Przykładowe fragmenty kodu są obecnie obsługiwane w przypadku języków Java, JavaScript, PHP, Python i curl.

• Zaktualizowaliśmy też narzędzie przykłady kodu, które ma nowy interfejs użytkownika z tymi samymi funkcjami, które opisaliśmy powyżej. Za pomocą tego narzędzia możesz poznawać przypadki użycia różnych metod, wczytywać wartości do narzędzia APIs Explorer i otwierać je w trybie pełnoekranowym, aby uzyskać przykłady kodu w językach Java, JavaScript, PHP i Python.

  W związku z tą zmianą usunęliśmy strony, na których wcześniej były dostępne przykładowe fragmenty kodu w językach Java, JavaScript, PHP i Python.

• Zaktualizowaliśmy krótkie przewodniki dotyczące Javy, JavaScript, PHP i Pythona. Zaktualizowane przewodniki wyjaśniają, jak uruchomić jeden przykład z użyciem klucza interfejsu API, a drugi – z użyciem identyfikatora klienta OAuth 2.0, korzystając z przykładowego kodu z narzędzia APIs Explorer.

Pamiętaj, że opisane powyżej zmiany zastępują interaktywne narzędzie, które zostało dodane do dokumentacji API w 2017 roku.

9 lipca 2018 r.

Ta aktualizacja zawiera następujące zmiany:

• Definicja właściwości snippet.thumbnails zasobu channel została zaktualizowana. Zawiera teraz informację, że podczas wyświetlania miniatur w aplikacji kod powinien używać adresów URL obrazów dokładnie w takiej postaci, w jakiej są one zwracane w odpowiedziach interfejsu API. Na przykład w adresie URL zwróconym w odpowiedzi interfejsu API aplikacja nie powinna używać domeny http zamiast domeny https.

  Od lipca 2018 r. adresy URL miniatur kanałów będą dostępne tylko w domenie https, czyli tak, jak pojawiają się w odpowiedziach interfejsu API. Po tym czasie w aplikacji mogą pojawiać się uszkodzone obrazy, jeśli próbuje ona wczytać obrazy z YouTube z domeny http.

• Uwaga: to jest ogłoszenie o wycofaniu funkcji.

  Właściwość recordingDetails.location.altitude zasobu video została wycofana. Nie gwarantujemy, że filmy będą zwracać wartości dla tej właściwości. Podobnie nawet jeśli żądania interfejsu API próbują ustawić wartość tej właściwości, przychodzące dane mogą nie zostać zapisane.

22 czerwca 2018 r.

Przewodnik po implementacji, wcześniej znany jako Przewodnik po implementacji i migracji, został zaktualizowany. Usunęliśmy z niego instrukcje migracji z interfejsu API w wersji 2 na interfejs API w wersji 3. Usunięto też instrukcje dotyczące funkcji, które zostały wycofane w interfejsie API w wersji 3, np. ulubionych filmów.

27 listopada 2017 r.

Ta aktualizacja zawiera następujące zmiany:

• Uwaga: to jest ogłoszenie o wycofaniu funkcji.

  YouTube wycofuje obsługę funkcji Polecany film i Polecana witryna, które są obsługiwane w interfejsie API za pomocą obiektu invideoPromotion zasobu channel. W związku z tym ten obiekt, w tym wszystkie jego usługi podrzędne, zostaje wycofany.

  Dane invideoPromotion możesz pobierać i ustawiać do 14 grudnia 2017 r. Po tej dacie:

  • Próby pobrania części invideoPromotion podczas wywoływania funkcji channels.list zwrócą pustą wartość invideoPromotion lub nie zwrócą żadnych danych invideoPromotion.
  • Próby aktualizacji danych invideoPromotion podczas wywoływania channels.update będą zwracać odpowiedź o powodzeniu co najmniej do 27 maja 2018 r., ale będą traktowane jako operacje bez efektu, co oznacza, że nie będą faktycznie aktualizować danych.

  Po 27 maja 2018 r. te żądania mogą zwracać komunikaty o błędach, np. informujące, że invalidPromotion jest nieprawidłową częścią.

16 listopada 2017 r.

Ta aktualizacja zawiera następujące zmiany:

• Interaktywne narzędzie do fragmentów kodu obsługuje teraz przykłady kodu w Node.js. Przykłady są też widoczne w dokumentacji niemal wszystkich metod interfejsu API, np. metody channels.list.

  Przykłady z możliwością dostosowania mają na celu zapewnienie punktu początkowego dla aplikacji w Node.js w konkretnych przypadkach użycia. Działanie tej funkcji jest podobne do kodu w przewodniku po Node.js. Przykłady zawierają jednak pewne funkcje narzędziowe, które nie występują w przewodniku:

  • Funkcja removeEmptyParameters przyjmuje listę par klucz-wartość odpowiadających parametrom żądania do interfejsu API i usuwa parametry, które nie mają wartości.
  • Funkcja createResource przyjmuje listę par klucz-wartość odpowiadających właściwościom w zasobie API. Następnie przekształca właściwości w obiekt JSON, który można wykorzystać w operacjach insert i update. Poniższy przykład przedstawia zestaw nazw właściwości i wartości oraz obiekt JSON, który zostałby utworzony przez kod:

    # Key-value pairs:
    {'id': 'ABC123',
     'snippet.title': 'Resource title',
     'snippet.description': 'Resource description',
     'status.privacyStatus': 'private'}
    
    # JSON object:
    {
     'id': 'ABC123',
     'snippet': {
       'title': 'Resource title',
       'description': 'Resource description',
     },
     'status': {
       'privacyStatus': 'private'
     }
    }

  Wszystkie te przykłady są przeznaczone do pobrania i uruchomienia lokalnie. Więcej informacji znajdziesz w instrukcjach narzędzia do fragmentów kodu w sekcji dotyczącej wymagań wstępnych uruchamiania pełnych przykładów kodu lokalnie.

25 października 2017 r.

Ta aktualizacja zawiera następujące zmiany:

• Przykłady kodu w języku Python w interaktywnym narzędziu do tworzenia fragmentów kodu zostały zaktualizowane, aby korzystać z bibliotek google-auth i google-auth-oauthlib zamiast biblioteki oauth2client, która jest obecnie wycofana.

  Oprócz tej zmiany narzędzie udostępnia teraz pełne przykłady kodu dla zainstalowanych aplikacji w Pythonie i aplikacji serwera WWW w Pythonie, które korzystają z nieco innych procesów autoryzacji. Aby zobaczyć pełne przykłady (i tę zmianę):

  1. Otwórz interaktywne narzędzie do tworzenia fragmentów kodu lub dokumentację dowolnej metody interfejsu API, np. metody channels.list.
  2. Kliknij kartę Python nad przykładowymi fragmentami kodu.
  3. Kliknij przełącznik nad kartami, aby przełączyć się z wyświetlania fragmentu na pełną próbkę.
     
  4. Na karcie powinien być teraz widoczny kompletny przykładowy kod, który korzysta z przepływu autoryzacji InstalledAppFlow. Wyjaśnia to opis nad przykładem, który zawiera też link do przykładu aplikacji serwera WWW.
  5. Kliknij link, aby przejść do przykładu serwera WWW. Ten przykład korzysta z platformy Flask do tworzenia aplikacji internetowych i innego procesu autoryzacji.

  Wszystkie te przykłady są przeznaczone do pobrania i uruchomienia lokalnie. Jeśli chcesz uruchomić przykłady, zapoznaj się z instrukcjami uruchamiania pełnych przykładów kodu lokalnie w instrukcjach narzędzia do fragmentów kodu.

29 sierpnia 2017 r.

Ta aktualizacja zawiera następujące zmiany:

• Zaktualizowaliśmy definicję parametru forContentOwner metody search.list, aby zaznaczyć, że jeśli ten parametr ma wartość true, parametr type musi mieć wartość video.
• Zaktualizowaliśmy definicję parametru regionCode metody search.list, aby wyjaśnić, że ogranicza on wyniki wyszukiwania do filmów, które można wyświetlać w określonym regionie.
• YouTube zaktualizował logo i ikony marki. Nowe logo „developed with YouTube” można pobrać ze strony wskazówek dotyczących marki. Inne nowe logo i ikony YouTube są również widoczne na tej stronie i można je pobrać ze strony marki YouTube.

24 lipca 2017 r.

Ta aktualizacja zawiera następujące zmiany:

• Dostępny jest nowy krótki przewodnik po interfejsie YouTube Data API dla iOS. Z tego przewodnika dowiesz się, jak używać interfejsu YouTube Data API w prostej aplikacji na iOS napisanej w języku Objective-C lub Swift.
• Interaktywne narzędzie do tworzenia fragmentów kodu w interfejsie YouTube Data API zawiera teraz dokumentację wyjaśniającą niektóre funkcje narzędzia:
  • Wykonywanie żądań do interfejsu API
  • Przełączanie między fragmentami kodu a pełnymi przykładami kodu
  • Korzystanie z funkcji standardowych
  • Wczytywanie istniejących zasobów (w przypadku metod aktualizacji)

  Uwaga: narzędzie jest też osadzone w dokumentacji interfejsu API dotyczącej metod interfejsu API (przykład).

1 czerwca 2017 r.

Ta aktualizacja zawiera następujące zmiany:

• Uwaga: to jest ogłoszenie o wycofaniu funkcji.

  Wycofujemy te właściwości zasobu video. Usługi będą obsługiwane do 1 grudnia 2017 r., ale nie ma gwarancji, że do tego czasu filmy będą nadal zwracać wartości tych usług. Podobnie żądania videos.insert i videos.update, które ustawiają te wartości właściwości, nie będą generować błędów przed tą datą, ale możliwe, że przychodzące dane nie będą przechowywane.

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude

17 maja 2017 roku

Ta aktualizacja zawiera następujące zmiany:

• Zaktualizowaliśmy dokumentację interfejsu API, aby fragmenty kodu były bardziej powszechne i interaktywne. Strony z wyjaśnieniami metod API, takie jak channels.list czy videos.rate, zawierają teraz interaktywne narzędzie, które umożliwia wyświetlanie i dostosowywanie fragmentów kodu w językach Java, JavaScript, PHP, Python, Ruby, Apps Script i Go.

  W przypadku każdej metody narzędzie wyświetla fragmenty kodu dla co najmniej 1 przypadku użycia, a każdy z nich opisuje typowy sposób wywoływania danej metody. Możesz na przykład wywołać metodę channels.list, aby pobrać dane o konkretnym kanale lub o kanale bieżącego użytkownika.

  Możesz też wchodzić w interakcje z przykładowymi fragmentami kodu:

  • Modyfikuj wartości parametrów i właściwości, a fragmenty kodu będą się dynamicznie aktualizować, aby odzwierciedlać podane przez Ciebie wartości.

  • Przełączaj się między fragmentami kodu a pełnymi przykładami. Fragment kodu pokazuje część kodu, która wywołuje metodę interfejsu API. Pełny przykład zawiera ten fragment kodu, a także powtarzalny kod do autoryzowania i wysyłania żądań. Pełne przykłady można kopiować i uruchamiać z poziomu wiersza poleceń lub lokalnego serwera WWW.

  • Wykonywanie żądań przez kliknięcie przycisku. (Aby wykonywać żądania, musisz autoryzować narzędzie do wywoływania interfejsu API w Twoim imieniu).

  Pamiętaj, że to narzędzie zastąpiło narzędzie APIs Explorer na stronach, na których jest dostępne. (Na każdej stronie znajduje się link, dzięki któremu możesz też wczytać żądanie, nad którym pracujesz, w narzędziu APIs Explorer).

• Zaktualizowaliśmy też narzędzie Fragmenty kodu interfejsu Data API, które ma teraz nowy interfejs użytkownika z tymi samymi funkcjami, które opisaliśmy powyżej. Główne nowe funkcje dostępne na tej stronie to:

  • Obsługa żądań do interfejsu API, które zapisują dane.
  • Obsługa przykładowych kodów w Javie.
  • Bardziej elastyczny i kompleksowy powtarzalny kod do autoryzowania użytkowników i tworzenia żądań do interfejsu API.

27 kwietnia 2017 r.

Ta aktualizacja zawiera następujące zmiany:

• Nowe przewodniki szybkiego startu wyjaśniają, jak skonfigurować prostą aplikację, która wysyła żądania do interfejsu YouTube Data API. Obecnie dostępne są przewodniki dotyczące Android, Apps Script, Go, Javy, JavaScript, Node.js, PHP, Pythona i Ruby.

30 marca 2017 r.

Ta aktualizacja zawiera następujące zmiany:

• Nowa właściwość topicDetails.topicCategories[] zasobu channel zawiera listę adresów URL Wikipedii, które opisują tematykę kanału. Adresy URL odpowiadają identyfikatorom tematów zwróconym we właściwości topicDetails.topicIds[] zasobu.
• Nowa właściwość contentDetails.videoPublishedAt zasobu playlistItem określa czas opublikowania filmu w YouTube. Zasób zawiera już właściwość snippet.publishedAt, która określa czas dodania elementu do playlisty.
• Podobnie jak zasób channel, zasób video zwraca teraz właściwość topicDetails.topicCategories[], która zawiera listę adresów URL Wikipedii opisujących treść filmu. W przypadku zasobów video adresy URL odpowiadają identyfikatorom tematu zwracanym we właściwości topicDetails.relevantTopicIds[] zasobu.
• Nowa właściwość contentDetails.contentRating.mpaatRating zasobu video określa ocenę, jaką Motion Picture Association of America przyznała zwiastunowi lub zapowiedzi filmu.

27 lutego 2017 r.

Zgodnie z ogłoszeniem z 11 sierpnia 2016 r. YouTube zmienił listę obsługiwanych identyfikatorów tematów na listę wyselekcjonowaną. Pełna lista obsługiwanych identyfikatorów tematów znajduje się we właściwościach topicDetails zasobów channel i video oraz w parametrze topicId metody search.list.

Pamiętaj, że na liście wyselekcjonowanej wprowadziliśmy kilka zmian:

• Te tematy zostały dodane jako podtematy tematu Society:

  Nazwa	Identyfikator tematu
  Firma	/m/09s1f
  Zdrowie	/m/0kt51
  Wojsko	/m/01h6rj
  Polityka	/m/05qt0
  Religia	/m/06bvp

• Temat Animated cartoon, który był wcześniej podrzędny względem tematu Entertainment, został usunięty.
• Temat Children's music, który był wcześniej podrzędny względem tematu Music, został usunięty.

W wyniku tej zmiany tematy związane z filmem są teraz zawsze zwracane w wartości właściwości topicDetails.relevantTopicIds[] zasobu video.

29 listopada 2016 r.

Ta aktualizacja zawiera następujące zmiany:

• 10 lutego 2017 r. wprowadzimy 3 niewielkie zmiany na liście identyfikatorów tematów, które będą obsługiwane:

  • Kategoria Professional wrestling, która wcześniej była podrzędna w stosunku do kategorii Sports, jest teraz podrzędna w stosunku do kategorii Entertainment.
  • Kategoria TV shows, która jest elementem podrzędnym w Entertainment, jest nowa.
  • Kategoria Health, która wcześniej była podkategorią kategorii Lifestyle, została usunięta.

  Pamiętaj też, że istnieje kilka kategorii nadrzędnych (Entertainment, Gaming, Lifestyle, Music i Sports). Każdy film powiązany z kategorią podrzędną, np. Tennis, będzie też powiązany z kategorią nadrzędną (Sports).

10 listopada 2016 r.

Ta aktualizacja zawiera następujące zmiany:

• Jak poinformowaliśmy po raz pierwszy 11 sierpnia 2016 r., wycofanie Freebase i interfejsu Freebase API wymaga wprowadzenia kilku zmian związanych z identyfikatorami tematów. Identyfikatory tematów określają tematy powiązane z zasobami channel i video. Możesz też użyć parametru wyszukiwania topicId, aby znaleźć kanały lub filmy związane z określonym tematem.

  10 lutego 2017 r. YouTube zacznie zwracać niewielki zestaw identyfikatorów tematów zamiast znacznie bardziej szczegółowego zestawu identyfikatorów zwracanego do tej pory. Pamiętaj też, że kanały i filmy nie muszą być powiązane z żadnymi tematami, co jest zgodne z obecnym działaniem interfejsu API.

  Aby umożliwić Ci przygotowanie klientów interfejsu API na te zmiany, zaktualizowaliśmy definicje tych parametrów i właściwości interfejsu API, aby zawierały identyfikatory tematów, które będą obsługiwane po tym czasie. Lista kategorii jest taka sama dla wszystkich usług.

  • Właściwość topicDetails.topicIds[] zasobu channel.
  • Właściwość topicDetails.relevantTopicIds[] zasobu video.
  • Parametr topicId metody search.list.

• Uwaga: to jest ogłoszenie o wycofaniu funkcji.

  Wycofywane są te właściwości:

  • Właściwość topicDetails.topicIds[] zasobu channel. Ta usługa będzie obsługiwana do 10 listopada 2017 r.
  • Właściwość topicDetails.relevantTopicIds[] zasobu video. Ta usługa będzie obsługiwana do 10 listopada 2017 r.
  • Właściwość topicDetails.topicIds[] zasobu video. Po 10 lutego 2017 r. ta właściwość nie będzie zawierać wartości. (Po tej dacie wartość właściwości topicDetails.relevantTopicIds[] będzie określać wszystkie tematy powiązane z filmem).

• Freebase został już wycofany, więc przewodnik Wyszukiwanie za pomocą tematów Freebase został usunięty z dokumentacji. W tym przewodniku znajdowały się przykłady kodu pokazujące, jak aplikacja może współpracować z interfejsem Freebase API.

  Dodatkowo z dokumentacji metody search.list usunęliśmy kilka przykładowych kodów związanych z identyfikatorami tematów.

2 listopada 2016 r.

Ta aktualizacja zawiera następujące zmiany:

• Nowe usługi i parametry

  • Zasób video zawiera kilka nowych właściwości:

    • Właściwość player.embedHtml zawiera tag <iframe>, którego możesz użyć do umieszczenia odtwarzacza odtwarzającego film. Nowe właściwości player.embedHeight i player.embedWidth określają wymiary odtwarzacza osadzonego. Te właściwości są zwracane tylko wtedy, gdy żądanie do interfejsu API zawiera wartość co najmniej jednego z parametrów maxHeight lub maxWidth. Te 2 nowe parametry zostały opisane w dalszej części tego wpisu w historii zmian.

    • Nowa właściwość hasCustomThumbnail wskazuje, czy osoba przesyłająca film dostarczyła do niego niestandardową miniaturę. Pamiętaj, że ta właściwość jest widoczna tylko dla osoby, która przesłała film.

    • Nowa ikona fpbRatingReasons[] wskazuje przyczyny, dla których film otrzymał ocenę FPB (RPA).

    • Nowy symbol mcstRating oznacza ocenę, jaką film otrzymał w Wietnamie.

  • Metoda videos.list obsługuje 2 nowe parametry: maxHeight i maxWidth. Podczas pobierania części player z zasobów video możesz użyć jednego lub obu tych parametrów.

    Domyślnie wysokość elementu <iframe> zwracanego we właściwości player.embedHtml wynosi 360 pikseli. Szerokość dostosowuje się do formatu obrazu filmu, dzięki czemu umieszczony odtwarzacz nie ma czarnych pasków otaczających film. Jeśli na przykład format obrazu filmu to 16:9, szerokość odtwarzacza wyniesie 640 pikseli.

    Dzięki nowym parametrom możesz określić, że zamiast domyślnych wymiarów kod osadzania ma używać wysokości lub szerokości odpowiedniej dla układu aplikacji. Serwer interfejsu API odpowiednio skaluje wymiary odtwarzacza, aby zapewnić, że osadzony odtwarzacz nie będzie miał czarnych pasków otaczających film. Pamiętaj, że oba parametry określają maksymalne wymiary odtwarzacza osadzonego. Jeśli więc oba parametry są określone, jeden z wymiarów może być mniejszy niż maksymalna dopuszczalna wartość dla tego wymiaru.

    Załóżmy na przykład, że film ma format 16:9. Dlatego tag player.embedHtml będzie zawierać odtwarzacz o rozmiarze 640 x 360, jeśli parametr maxHeight lub maxWidth nie jest ustawiony.

    • Jeśli parametr maxHeight ma wartość 720, a parametr maxWidth nie jest ustawiony, interfejs API zwróci odtwarzacz o rozmiarze 1280 x 720.
    • Jeśli parametr maxWidth ma wartość 960, a parametr maxHeight nie jest ustawiony, interfejs API zwróci odtwarzacz o wymiarach 960x540.
    • Jeśli parametr maxWidth ma wartość 960, a parametr maxHeight ma wartość 450, interfejs API zwróci odtwarzacz o wymiarach 800 x 450.

    Nowe właściwości player.embedHeight i player.embedWidth, które opisaliśmy powyżej, określają wymiary odtwarzacza.

• Aktualizacje istniejących metod, właściwości i parametrów

  • W opisie zasobu channelSection dodaliśmy informację, że kanał może utworzyć maksymalnie 10 półek bez ustawiania danych kierowania i maksymalnie 100 półek z danymi kierowania.

    Dodatkowo zaktualizowaliśmy właściwość targeting zasobu channelSection, aby odzwierciedlała fakt, że opcje kierowania można ustawiać tylko za pomocą interfejsu API. Opcje kierowania zostaną usunięte, jeśli sekcja kanału zostanie zmodyfikowana w interfejsie na stronie YouTube.

  • Definicja właściwości snippet.name zasobu i18nLanguage została poprawiona, aby odzwierciedlała fakt, że wartość reprezentuje nazwę języka w języku określonym przez parametr hl metody i18nLanguage.list.

  • Właściwość contentDetails.note zasobu playlistItem została zaktualizowana. Obecnie zawiera informację, że maksymalna długość wartości właściwości to 280 znaków.

  • Właściwości contentDetails.startAt i contentDetails.endAt zasobu playlistItem zostały wycofane. Te pola są ignorowane, jeśli są ustawione w żądaniach playlistItems.insert lub playlistItems.update.

  • Metody playlistItems.delete i playlistItems.update obsługują teraz parametr onBehalfOfContentOwner, który jest już obsługiwany w przypadku kilku innych metod. Żądania korzystające z tej metody muszą być też autoryzowane za pomocą tokena, który zapewnia dostęp do zakresu https://www.googleapis.com/auth/youtubepartner.

  • Parametry publishedBefore i publishedAfter metody search.list zostały zaktualizowane, aby wskazywać, że wartości parametrów są włączone. Jeśli na przykład ustawiony jest parametr publishedBefore, interfejs API zwraca zasoby utworzone przed określonym czasem lub w tym czasie.

  • Właściwość contentDetails.contentRating.grfilmRating zasobu video obsługuje 3 dodatkowe wartości: grfilmK12, grfilmK15 i grfilmK18.

  • Opis metody videos.insert został zaktualizowany. Dodaliśmy informację, że maksymalny rozmiar przesyłanych filmów wzrósł z 64 GB do 128 GB.

• Nowe i zaktualizowane błędy

  • Interfejs API obsługuje te nowe błędy:

    Typ błędu	Szczegóły błędu	Opis
    forbidden (403)	homeParameterDeprecated	Metoda activities.list zwraca ten błąd, aby wskazać, że dane o aktywności na stronie głównej użytkownika nie są dostępne w tym interfejsie API. Ten błąd może wystąpić, jeśli w nieautoryzowanym żądaniu ustawisz parametr home na true.
    invalidValue (400)	invalidContentDetails	Metoda playlistItems.insert zwraca ten błąd, aby wskazać, że obiekt contentDetails w żądaniu jest nieprawidłowy. Ten błąd może wystąpić, jeśli pole contentDetails.note zawiera więcej niż 280 znaków.
    forbidden (403)	watchHistoryNotAccessible	Metoda playlistItems.list zwraca ten błąd, aby wskazać, że żądanie próbowało pobrać elementy playlisty „Historia oglądania”, ale nie można ich pobrać za pomocą interfejsu API.
    forbidden (403)	watchLaterNotAccessible	Metoda playlistItems.list zwraca ten błąd, aby wskazać, że żądanie próbowało pobrać elementy z listy odtwarzania „Obejrzyj później”, ale nie można ich pobrać za pomocą interfejsu API.
    badRequest (400)	uploadLimitExceeded	Metoda videos.insert zwraca ten błąd, aby wskazać, że kanał przekroczył liczbę filmów, które może przesłać.
    forbidden (403)	forbiddenEmbedSetting	Metoda videos.update zwraca ten błąd, aby wskazać, że żądanie do interfejsu API próbuje ustawić nieprawidłowe ustawienie osadzania filmu. Pamiętaj, że niektóre kanały mogą nie mieć uprawnień do oferowania odtwarzaczy umieszczonych na innych stronach w przypadku transmisji na żywo. Więcej informacji znajdziesz w Centrum pomocy YouTube.

  • Metoda playlistItems.insert nie zwraca już błędu, jeśli wstawisz do playlisty zduplikowany film. Ten błąd występował wcześniej w przypadku niektórych playlist, np. ulubionych filmów, które nie zezwalały na duplikaty, ale nie są już obsługiwane. Ogólnie rzecz biorąc, playlisty dopuszczają duplikaty filmów.

• Inne aktualizacje

  • Wpis w historii zmian z 15 września 2016 r. został zaktualizowany, aby wyjaśnić, że gdy w odpowiedzi są uwzględnione właściwości contentDetails.relatedPlaylists.watchHistory i contentDetails.relatedPlaylists.watchLater zasobu channel, zawsze zawierają one odpowiednio wartości HL i WL. Co więcej, te właściwości są uwzględniane tylko wtedy, gdy autoryzowany użytkownik pobiera dane o własnym kanale.

15 września 2016 r.

Ta aktualizacja zawiera następujące zmiany:

• W aktualizacji historii zmian z 11 sierpnia 2016 r. omówiliśmy kilka zmian związanych z identyfikatorami tematów, w tym fakt, że zestaw obsługiwanych identyfikatorów tematów zmieni się 10 lutego 2017 r. Lista tematów, które będą obsługiwane, zostanie opublikowana do 10 listopada 2016 r.

• Te zmiany wchodzą w życie od razu. Informacja o tych zmianach została podana w aktualizacji historii zmian z 11 sierpnia 2016 r.:

  • Jeśli metoda activities.list zostanie wywołana z parametrem home ustawionym na true, odpowiedź interfejsu API będzie teraz zawierać elementy podobne do tych, które zalogowany użytkownik YouTube widzi na stronie głównej.

    Jest to niewielka zmiana, która ma na celu zapewnienie większej wygody niż w przypadku zachowania opisanego w historii zmian z 11 sierpnia 2016 r. W tym artykule informowaliśmy, że żądania korzystające z parametru home będą zwracać pustą listę.

  • Właściwości contentDetails.relatedPlaylists.watchHistory i contentDetails.relatedPlaylists.watchLater zasobu channel zawierają teraz odpowiednio wartości HL i WL we wszystkich kanałach.

    Wyjaśniamy, że te właściwości są widoczne tylko dla upoważnionego użytkownika, który pobiera dane o własnym kanale. Właściwości zawsze zawierają wartości HL i WL, nawet w przypadku autoryzowanego użytkownika pobierającego dane o własnym kanale. Dlatego identyfikatorów historii oglądania i playlisty Do obejrzenia nie można pobrać za pomocą interfejsu API.

    Dodatkowo żądania pobrania szczegółów playlisty (playlists.list) lub elementów playlisty (playlistItems.list) z historii oglądania lub playlisty „Do obejrzenia” kanału zwracają teraz puste listy. Dotyczy to nowych wartości HL i WL, a także wszystkich identyfikatorów historii oglądania lub listy „Obejrzyj później”, które Twój klient API mógł już zapisać.

• Obiekt fileDetails.recordingLocation zasobu video i jego usługi podrzędne nie są już zwracane. Wcześniej te dane (np. obiekt nadrzędny fileDetails) mógł pobrać tylko właściciel filmu.

11 sierpnia 2016 r.

Ta aktualizacja zawiera następujące zmiany:

• Nowe Warunki korzystania z usług YouTube API („Zaktualizowane warunki”), które szczegółowo omawiamy na Blogu YouTube dla inżynierów i deweloperów, zawierają wiele zmian w stosunku do obecnych Warunków korzystania z usługi. Oprócz zaktualizowanych warunków, które wejdą w życie 10 lutego 2017 r., ta aktualizacja obejmuje kilka dokumentów pomocniczych, które wyjaśniają zasady, których deweloperzy muszą przestrzegać.

  Pełny zestaw nowych dokumentów opisano w historii zmian zaktualizowanych Warunków. Ponadto w historii zmian będą wyjaśniane przyszłe zmiany zaktualizowanych warunków lub dokumentów pomocniczych. Możesz zasubskrybować kanał RSS z listą zmian w historii zmian, korzystając z linku w tym dokumencie.

• Wycofanie Freebase i interfejsu Freebase API powoduje kilka zmian związanych z identyfikatorami tematów. Identyfikatory tematów są używane w tych zasobach i metodach interfejsu API:

  • Część topicDetails zasobu channel określa tematy powiązane z kanałem.
  • Część topicDetails zasobu video określa tematy powiązane z filmem.
  • Parametr topicId metody search.list umożliwia wyszukiwanie filmów lub kanałów związanych z określonym tematem.

  Zmiany tych funkcji:

  • Od 10 lutego 2017 r. YouTube będzie zwracać niewielki zestaw identyfikatorów tematów zamiast znacznie bardziej szczegółowego zestawu identyfikatorów zwracanego do tej pory. Ten zestaw obsługiwanych tematów będzie zawierać kategorie najwyższego poziomu, takie jak Sport czy Koszykówka, ale nie będzie zawierać np. konkretnych drużyn ani zawodników. Ogłosimy zestaw obsługiwanych tematów, aby dać Ci czas na przygotowanie aplikacji do tej zmiany.

  • Wszystkie identyfikatory tematów Freebase, które zostały już pobrane, można wykorzystywać do wyszukiwania treści do 10 lutego 2017 r. Po tym czasie do pobierania wyników wyszukiwania według tematu będzie można używać tylko mniejszego zestawu tematów zidentyfikowanych w poprzednim punkcie.

  • Po 10 lutego 2017 r., jeśli spróbujesz wyszukać wyniki za pomocą identyfikatora tematu, którego nie ma w mniejszym zbiorze obsługiwanych identyfikatorów tematów, interfejs API zwróci pusty zbiór wyników.

• 12 września 2016 r. wycofaliśmy kilka pól i parametrów interfejsu API:

  • Parametr home metody activities.list umożliwiał autoryzowanemu użytkownikowi pobranie kanału aktywności, który wyświetlałby się na stronie głównej YouTube. Żądania, które po 12 września 2016 r. będą używać tego parametru, będą zwracać pustą listę.

  • Właściwości channel zasobu contentDetails.relatedPlaylists.watchHistory i contentDetails.relatedPlaylists.watchLater są widoczne tylko dla autoryzowanego użytkownika, który pobiera dane o własnym kanale. Po 12 września 2016 r. parametr contentDetails.relatedPlaylists.watchHistory będzie zwracać wartość HL, a parametr contentDetails.relatedPlaylists.watchLater – wartość WL w przypadku wszystkich kanałów.

    Żądania pobrania szczegółów playlisty (playlists.list) historii oglądania lub playlisty Do obejrzenia na kanale będą zwracać pustą listę po 12 września 2016 r. Żądania pobrania elementów playlisty (playlistItems.list) z jednej z tych playlist również będą po tym czasie zwracać pustą listę. Dotyczy to nowych wartości HL i WL, a także wszystkich identyfikatorów historii oglądania lub playlisty Do obejrzenia, które Twój klient interfejsu API mógł już zapisać.

  • Po 12 września 2016 r. obiekt fileDetails.recordingLocation zasobu video ani żadna z jego właściwości podrzędnych nie będą już zwracane. Te dane może pobrać tylko właściciel filmu, ponieważ obiekt nadrzędny fileDetails może być pobrany tylko przez właściciela filmu.

13 czerwca 2016 r.

Ta aktualizacja zawiera następujące zmiany:

• Właściwość contentDetails.googlePlusUserId zasobu channel została wycofana. Wcześniej ta właściwość była dostępna tylko wtedy, gdy kanał był powiązany z profilem Google+. Po wycofaniu ta właściwość nie będzie już uwzględniana w żadnych zasobach channel.

• Właściwość snippet.authorGoogleplusProfileUrl zasobu comment została wycofana. Wcześniej ta właściwość była dostępna tylko wtedy, gdy kanał był powiązany z profilem Google+. Po wycofaniu ta właściwość nie będzie już uwzględniana w żadnych zasobach comment.

Ponieważ po wycofaniu tych właściwości nie będą one zwracane, usunęliśmy je z dokumentacji odpowiednich zasobów.

31 maja 2016 r.

Ta aktualizacja zawiera następujące zmiany:

• Nowy parametr myRecentSubscribers metody subscriptions.list pobiera listę subskrybentów kanału uwierzytelnionego użytkownika w odwrotnej kolejności chronologicznej od czasu, w którym zasubskrybowali oni kanał.

  Pamiętaj, że nowy parametr umożliwia pobranie informacji tylko o 1000 najnowszych subskrybentach kanału uwierzytelnionego użytkownika. Aby pobrać pełną listę subskrybentów, użyj parametru mySubscribers. Ten parametr, który nie zwraca subskrybentów w określonej kolejności, nie ogranicza liczby subskrybentów, których można pobrać.

• Definicja właściwości snippet.thumbnails.(key) została zaktualizowana w przypadku zasobów activity, playlistItem, playlist, search result, thumbnail i video, aby zaznaczyć, że w przypadku niektórych filmów dostępne są dodatkowe rozmiary miniatur.

  • Obraz standard ma szerokość 640 pikseli i wysokość 480 pikseli.
  • maxres obraz ma szerokość 1280 pikseli i wysokość 720 pikseli.

• Definicja parametru part metody channelSection.list została zaktualizowana. Zawiera teraz informację, że część targeting można pobrać za cenę 2 jednostek limitu.

• Metoda videos.list zwraca teraz błąd forbidden (403), gdy nieprawidłowo autoryzowane żądanie próbuje pobrać części fileDetails, processingDetails lub suggestions zasobu video. Te części są dostępne tylko dla właściciela filmu.

17 maja 2016 r.

Nowe narzędzie Data API Code Snippets zawiera krótkie fragmenty kodu do typowych zastosowań interfejsu YouTube Data API. Fragmenty kodu są obecnie dostępne w przypadku wszystkich metod API tylko do odczytu w Apps Script, Go, JavaScript, PHP, Pythonie i Ruby.

W przypadku każdej metody narzędzie wyświetla przykłady kodu dla co najmniej 1 przypadku użycia. Na przykład udostępnia 5 fragmentów kodu dla metody search.list:

• Wyświetlanie filmów według słowa kluczowego
• Wyświetlanie filmów według lokalizacji
• Wyświetlanie listy wydarzeń na żywo
• Wyszukiwanie filmów uwierzytelnionego użytkownika
• Wyświetlanie listy powiązanych filmów

W przypadku każdego zastosowania narzędzie wyświetla parametry użyte w żądaniu do interfejsu API. Możesz modyfikować wartości parametrów. W takim przypadku narzędzie zaktualizuje fragmenty kodu, aby odzwierciedlały podane przez Ciebie wartości parametrów.

Na koniec narzędzie wyświetla odpowiedź interfejsu API na każde żądanie. Jeśli zmodyfikujesz parametry żądania, odpowiedź interfejsu API będzie oparta na podanych przez Ciebie wartościach parametrów. Aby wyświetlać odpowiedzi interfejsu API, musisz autoryzować narzędzie do przesyłania żądań w Twoim imieniu.

28 kwietnia 2016 r.

Ta aktualizacja zawiera następujące zmiany:

• Nowa właściwość contentDetails.projection zasobu video określa format projekcji filmu. Prawidłowe wartości właściwości to 360 i rectangular.

• Właściwości recordingDetails.location i fileDetails.recordingLocation zasobu video zostały zaktualizowane, aby wyjaśnić różnicę między nimi:

  • Właściwość recordingDetails.location określa lokalizację, którą właściciel filmu chce z nim powiązać. Tę lokalizację można edytować i wyszukiwać w publicznych filmach. Może ona być wyświetlana użytkownikom w przypadku publicznych filmów.
  • Wartość właściwości fileDetails.recordingLocation jest niezmienna i reprezentuje lokalizację powiązaną z pierwotnym przesłanym plikiem wideo. Wartość jest widoczna tylko dla właściciela filmu.

• Zaktualizowaliśmy definicję właściwości contentDetails.relatedPlaylists.favorites zasobu channel, aby zaznaczyć, że wartość właściwości może zawierać identyfikator playlisty, która jest pusta i nie można jej pobrać. Wynika to z faktu, że funkcja ulubionych filmów została już wycofana. Pamiętaj, że ta właściwość nie podlega zasadom wycofywania interfejsu API.

• Definicja błędu ineligibleAccount, który może być zwracany przez metody comments.insert, comments.update, commentThreads.insert lub commentThreads.update, została zaktualizowana. Teraz odzwierciedla fakt, że błąd występuje, gdy konto YouTube użyte do autoryzacji żądania do interfejsu API nie zostało połączone z kontem Google użytkownika.

20 kwietnia 2016 r.

Ta aktualizacja zawiera następujące zmiany:

• Zaktualizowaliśmy definicję parametru part metody channels.update, aby dodać informację, że localizations jest też prawidłową wartością tego parametru.

• Sekcja Wykorzystanie limitu w przewodniku dla początkujących została zaktualizowana i zawiera teraz link do Google Developers Console, w której możesz sprawdzić swój limit i jego wykorzystanie.

16 marca 2016 r.

Ta aktualizacja zawiera następujące zmiany:

• Aktualizacje istniejących zasobów i metod

  • Zaktualizowaliśmy dokumentację zasobu channelBanner, aby zaznaczyć, że zalecany rozmiar przesłanego obrazu na baner kanału to 2560 x 1440 pikseli. Minimalny rozmiar (2048 x 1152 piksele) nie uległ zmianie.

  • Nowa właściwość snippet.customUrl zasobu channel określa niestandardowy adres URL powiązany z kanałem. (Nie wszystkie kanały mają niestandardowe adresy URL). W Centrum pomocy YouTube znajdziesz informacje o wymaganiach, które musisz spełnić, aby uzyskać niestandardowy URL, oraz o tym, jak go skonfigurować.

  • Obiekt brandingSettings.watch zasobu channel i wszystkie jego właściwości podrzędne zostały wycofane.

  • Odpowiedź interfejsu API na żądanie search.list zawiera teraz właściwość regionCode. Właściwość określa kod regionu użyty w zapytaniu. Kod regionu informuje interfejs API, że ma zwracać wyniki wyszukiwania dla określonego kraju.

    Wartość właściwości to dwuliterowy kod kraju w standardzie ISO, który identyfikuje region. Metoda i18nRegions.list zwraca listę obsługiwanych regionów. (wartością domyślną jest US); Jeśli podasz nieobsługiwany region, YouTube może wybrać inny region niż domyślny, aby obsłużyć zapytanie.

  • Zaktualizowaliśmy definicje właściwości snippet.label i snippet.secondaryReasons[].label zasobu videoAbuseReportReason, aby uwzględnić informację, że zawierają one zlokalizowany tekst etykiety dla powodów zgłoszenia nadużycia.

    Dodatkowo metoda videoAbuseReportReasons.list obsługuje teraz parametr hl, który określa język, w jakim ma być wyświetlany tekst etykiety w odpowiedzi API. Domyślna wartość parametru to en_US.

  • Nowa właściwość contentDetails.contentRating.ecbmctRating zasobu video określa ocenę filmu wydaną przez turecką Radę ds. Oceny i Klasyfikacji przy Ministerstwie Kultury i Turystyki.

    Dodatkowo właściwości interfejsu API dla innych systemów oceniania obsługują te nowe wartości właściwości:

    • contentDetails.contentRating.fpbRating (Republika Południowej Afryki)
      Ocena: 10; wartość właściwości: fpb10
    • contentDetails.contentRating.moctwRating (Tajwan)
      Ocena: R-12; wartość właściwości: moctwR12
    • contentDetails.contentRating.moctwRating (Tajwan)
      Ocena: R-15; wartość właściwości: moctwR15

  • Właściwość video zasobu liveStreamingDetails.activeLiveChatId zawiera identyfikator aktywnego czatu na żywo powiązanego z filmem. Wartość właściwości jest widoczna tylko wtedy, gdy film jest bieżącą transmisją na żywo z włączonym czatem na żywo. Po zakończeniu transmisji i czatu na żywo właściwość nie jest już zwracana w przypadku filmu.

  • Właściwość status.rejectionReason zasobu video obsługuje nową wartość właściwości legal.

• Interfejs API obsługuje te nowe błędy:

  Typ błędu	Szczegóły błędu	Opis
  badRequest (400)	notEditable	Metody channelSections.insert, channelSections.update i channelSections.delete zwracają ten błąd, aby wskazać, że nie można utworzyć, zaktualizować ani usunąć określonej sekcji kanału.
  badRequest (400)	styleRequired	Metody channelSections.insert i channelSections.update zwracają ten błąd, aby wskazać, że zasób channelSection przesłany w żądaniu do interfejsu API musi zawierać wartość właściwości snippet.style.
  badRequest (400)	typeRequired	Metody channelSections.insert i channelSections.update zwracają ten błąd, aby wskazać, że zasób channelSection przesłany w żądaniu do interfejsu API musi zawierać wartość właściwości snippet.type.
  badRequest (400)	processingFailure	Metoda commentThreads.list zwraca ten błąd, aby wskazać, że serwer interfejsu API nie zdołał przetworzyć żądania. Może to być błąd tymczasowy, ale zwykle oznacza, że dane wejściowe żądania są nieprawidłowe. Sprawdź strukturę zasobu commentThread w treści żądania, aby upewnić się, że jest prawidłowa.
  forbidden (403)	commentsDisabled	Metoda commentThreads.list zwraca ten błąd, aby wskazać, że w filmie zidentyfikowanym przez parametr videoId komentarze są wyłączone.
  badRequest (400)	commentTextTooLong	Metoda commentThreads.insert zwraca ten błąd, aby wskazać, że wstawiany zasób comment zawiera zbyt wiele znaków we właściwości snippet.topLevelComment.snippet.textOriginal.
  invalidValue (400)	videoAlreadyInAnotherSeriesPlaylist	Metoda playlistItems.insert zwraca ten błąd, aby wskazać, że film, który próbujesz dodać do playlisty, jest już częścią innej playlisty serialu. Więcej informacji o playlistach z serii znajdziesz w Centrum pomocy YouTube.
  badRequest (400)	subscriptionForbidden	Metoda subscriptions.insert zwraca ten błąd, aby wskazać, że osiągnięto maksymalną liczbę subskrypcji lub utworzono zbyt wiele ostatnich subskrypcji. W tym drugim przypadku możesz ponowić próbę za kilka godzin.
  badRequest (400)	invalidCategoryId	Metoda videos.update zwraca ten błąd, aby wskazać, że właściwość snippet.categoryId w przesłanym zasobie video określa nieprawidłowy identyfikator kategorii. Użyj metody videoCategories.list, aby pobrać obsługiwane kategorie.
  badRequest (400)	invalidDescription	Metoda videos.update zwraca ten błąd, aby wskazać, że właściwość snippet.description w przesłanym zasobie video zawiera nieprawidłową wartość.
  badRequest (400)	invalidPublishAt	Metoda videos.update zwraca ten błąd, aby wskazać, że właściwość status.publishAt w przesłanym zasobie video określa nieprawidłowy czas zaplanowanej publikacji.
  badRequest (400)	invalidRecordingDetails	Metoda videos.update zwraca ten błąd, aby wskazać, że obiekt recordingDetails w przesłanym zasobie video zawiera nieprawidłowe szczegóły nagrania.
  badRequest (400)	invalidTags	Metoda videos.update zwraca ten błąd, aby wskazać, że właściwość snippet.tags w przesłanym zasobie video zawiera nieprawidłową wartość.
  badRequest (400)	invalidTitle	Metoda videos.update zwraca ten błąd, aby wskazać, że właściwość snippet.title w przesłanym zasobie video zawiera nieprawidłowy lub pusty tytuł filmu.
  badRequest (400)	invalidVideoMetadata	Metoda videos.update zwraca ten błąd, aby wskazać, że metadane żądania są nieprawidłowe. Ten błąd występuje, jeśli żądanie aktualizuje część snippet zasobu video, ale nie ustawia wartości właściwości snippet.title i snippet.categoryId.

18 grudnia 2015 r.

Przepisy Unii Europejskiej (UE) wymagają, aby użytkownicy w UE otrzymywali określone informacje i wyrażali zgodę na wykorzystanie danych. Dlatego w przypadku użytkowników z Unii Europejskiej musisz przestrzegać polityki w zakresie zgody użytkownika z UE. Dodaliśmy informację o tym wymaganiu do Warunków korzystania z interfejsu YouTube API.

19 listopada 2015 r.

Interfejs API umożliwia teraz ustawianie i pobieranie zlokalizowanego tekstu dla właściwości snippet.title i snippet.description zasobów playlist i video, właściwości snippet.title zasobu channelSection oraz właściwości snippet.description zasobu channel.

• Ustawianie zlokalizowanych tytułów i opisów

  Podczas wywoływania metody insert lub update dla zasobu możesz ustawić zlokalizowane wartości. Aby ustawić zlokalizowane wartości zasobu, wykonaj obie te czynności:

  • Sprawdź, czy dla właściwości snippet.defaultLanguage zasobu ustawiono wartość. Ta właściwość określa język właściwości snippet.title i snippet.description zasobu. Jego wartość może być dowolnym obsługiwanym językiem aplikacji lub większością innych kodów języków w formacie ISO 639-1:2002. Jeśli na przykład przesyłasz film z tytułem i opisem w języku angielskim, ustawisz właściwość snippet.defaultLanguage na en.

    Uwaga dotycząca aktualizowania zasobów channel: aby ustawić właściwość snippet.defaultLanguage dla zasobu channel, musisz zaktualizować właściwość brandingSettings.channel.defaultLanguage.

  • Dodaj obiekt localizations do aktualizowanego zasobu. Każdy klucz obiektu to ciąg znaków, który identyfikuje język aplikacji lub kod języka ISO 639-1:2002, a każdy klucz jest powiązany z obiektem zawierającym zlokalizowany tytuł (i opis) zasobu.

    Przykładowy fragment kodu poniżej ustawia domyślny język zasobu na angielski. Dodaje też do filmu zlokalizowane tytuły i opisy w języku niemieckim i hiszpańskim:

    {
      "kind": "youtube#video",
      ...
      "snippet": {
        "title": "Playing soccer",
        "description": "We play soccer in the park on Sundays.",
        "defaultLanguage": "en",
        ...
      },
      "localizations":
        "de": {
          "title": "Fußball spielen",
          "description": "Wir spielen Fußball im Park am Sonntag"
        },
        "es": {
          "title": "Jugar al fútbol",
          "description": "Nosotros jugamos fútbol en el parque los domingos",
        }
      }
    }

  Ważne: pamiętaj, że podczas aktualizowania zlokalizowanych danych zasobu żądanie do interfejsu API musi zawierać wszystkie istniejące zlokalizowane wersje danych. Jeśli na przykład wyślesz kolejną prośbę o dodanie danych w języku portugalskim do filmu z powyższego przykładu, musisz w niej uwzględnić zlokalizowane dane w językach niemieckim, hiszpańskim i portugalskim.

• Pobieranie zlokalizowanych wartości

  Interfejs API obsługuje 2 sposoby pobierania zlokalizowanych wartości zasobu:

  • Dodaj parametr hl do żądania channels.list, channelSections.list, playlists.list lub videos.list, aby pobrać zlokalizowane dane dla konkretnego języka aplikacji obsługiwanego przez witrynę YouTube. Jeśli w tym języku dostępne są zlokalizowane szczegóły zasobu, obiekt snippet.localized zasobu będzie zawierać zlokalizowane wartości. Jeśli jednak zlokalizowane szczegóły nie są dostępne, obiekt snippet.localized będzie zawierać szczegóły zasobu w języku domyślnym zasobu.

    Załóżmy na przykład, że żądanie videos.list zwróciło dane dotyczące opisanego powyżej filmu, w tym zlokalizowane dane w języku niemieckim i hiszpańskim. Jeśli parametr hl miałby wartość de, zasób zawierałby te dane:

    {
      "kind": "youtube#video",
      ...
      "snippet": {
        "title": "Playing soccer",
        "description": "We play soccer in the park on Sundays.",
        "defaultLanguage": "en",
        "localized": {
          "title": "Fußball spielen",
          "description": "Wir spielen Fußball im Park am Sonntag"
        }
        ...
      }
    }

    Jeśli jednak parametr hl miałby wartość fr, obiekt snippet.localized zawierałby tytuł i opis w języku angielskim, ponieważ jest to domyślny język zasobu, a zlokalizowane szczegóły w języku francuskim nie są dostępne.

    Ważne: parametr hl obsługuje tylko wartości identyfikujące języki aplikacji, które są obsługiwane przez witrynę YouTube. Aby sprawdzić, czy zlokalizowany tekst jest dostępny w innych językach, musisz pobrać część localizations zasobu i odfiltrować wyniki, aby sprawdzić, czy zlokalizowany tekst istnieje.
    
    Na przykład musisz pobrać pełną listę lokalizacji, aby sprawdzić, czy zlokalizowany tekst jest dostępny w języku angielskim w regionie Appalachów.
    
    

  • Podczas pobierania zasobu uwzględnij localizations w wartości parametru part, aby pobrać wszystkie zlokalizowane szczegóły tego zasobu. Jeśli pobierasz zlokalizowane dane dla języka, który nie jest bieżącym językiem aplikacji YouTube, musisz użyć tej metody, aby pobrać wszystkie lokalizacje, a następnie odfiltrować je, aby sprawdzić, czy istnieją żądane zlokalizowane dane.

• Błędy związane z wartościami tekstu w języku lokalnym

  Interfejs API obsługuje też te nowe błędy dotyczące zlokalizowanych wartości tekstowych:

  Typ błędu	Szczegóły błędu	Opis
  badRequest (400)	defaultLanguageNotSetError	Ten błąd oznacza, że żądanie, które próbuje wstawić lub zaktualizować obiekt localizations dla zasobu, nie powiodło się, ponieważ dla tego zasobu nie ustawiono właściwości snippet.defaultLanguage. Ten błąd jest obsługiwany przez metody channels.update, channelSections.insert, channelSections.update, playlists.insert, playlists.update, videos.insert i videos.update.
  badRequest (400)	localizationValidationError	Ten błąd oznacza, że nie udało się zweryfikować jednej z wartości w obiekcie localizations zasobu. Ten błąd może wystąpić na przykład wtedy, gdy obiekt zawiera nieprawidłowy kod języka. Ten błąd jest obsługiwany przez metody channels.update, channelSections.insert, channelSections.update, playlists.insert i playlists.update.

4 listopada 2015 r.

Ta aktualizacja zawiera następujące zmiany:

• Aktualizacje istniejących zasobów i metod

  • Parametr order metody search.list został zaktualizowany. Jeśli posortujesz transmisje na żywo według parametru viewCount, wyniki interfejsu API będą posortowane według liczby równoczesnych widzów transmisji, gdy są one jeszcze w toku.

  • W parametrze relatedToVideoId metody search.list dodaliśmy informację, że jeśli ten parametr jest ustawiony, jedynymi innymi obsługiwanymi parametrami są part, maxResults, pageToken, regionCode, relevanceLanguage, safeSearch, type (który musi mieć wartość video) i fields. Ta aktualizacja nie odzwierciedla zmiany w działaniu interfejsu API.

  • Zaktualizowaliśmy definicję właściwości snippet.publishedAt zasobu video, aby zaznaczyć, że wartość właściwości, która określa datę i godzinę opublikowania filmu, może się różnić od czasu przesłania filmu. Jeśli na przykład film zostanie przesłany jako film prywatny, a później zmienisz jego ustawienie na publiczny, wartość właściwości określa czas, w którym film został udostępniony publicznie. Zaktualizowana definicja wyjaśnia też, jak wartość jest wypełniana w przypadku filmów prywatnych i niepublicznych.

    Ta zmiana nie odzwierciedla zmiany w działaniu interfejsu API.

  • Definicja właściwości status.publishAt zasobu video została zaktualizowana i zawiera teraz następującą informację:

    • Jeśli ustawisz wartość tej właściwości podczas wywoływania metody videos.update, musisz też ustawić wartość właściwości status.privacyStatus na private, nawet jeśli film jest już prywatny.
    • Jeśli żądanie zaplanuje publikację filmu na jakiś czas w przeszłości, zostanie on opublikowany od razu. Dlatego ustawienie właściwości status.publishAt na datę i godzinę w przeszłości ma taki sam efekt jak zmiana stanu filmu privacyStatus z private na public.

  • Właściwość contentDetails.contentRating.cncRating zasobu video określa ocenę filmu przyznaną przez francuską komisję ds. klasyfikacji filmów (Commission de classification cinematographique). Ta właściwość zastępuje właściwość contentDetails.contentRating.fmocRating, która została wycofana.

  • Definicja właściwości brandingSettings.channel.keywords zasobu channel została zaktualizowana, aby prawidłowo odzwierciedlać fakt, że wartość właściwości zawiera listę ciągów znaków rozdzielonych spacjami, a nie listę rozdzieloną przecinkami, jak podano wcześniej w dokumentacji. Ta aktualizacja nie odzwierciedla zmiany w działaniu interfejsu API.

  • Dokumentacja metody thumbnails.set została zaktualizowana, aby dokładnie odzwierciedlać fakt, że treść żądania zawiera obraz miniatury, który przesyłasz i łączysz z filmem. Treść żądania nie zawiera zasobu thumbnail. Wcześniej w dokumentacji było napisane, że podczas wywoływania tej metody nie należy podawać treści żądania. Ta aktualizacja nie odzwierciedla zmiany w działaniu interfejsu API.

  • Opis zasobu activity został zaktualizowany, aby odzwierciedlał fakt, że metoda activities.list nie obejmuje obecnie zasobów związanych z nowymi komentarzami do filmów. Zaktualizowano też wartości snippet.type i contentDetails.comment zasobu.

• Nowe i zaktualizowane błędy

  • Interfejs API obsługuje teraz te błędy:

    Szczegóły błędu
    activities.insert	Kod odpowiedzi HTTP badRequest (400) Przyczyna invalidMetadata Opis Właściwość kind nie pasuje do podanego typu dokumentu tożsamości.
    commentThreads.update comments.insert comments.update	Kod odpowiedzi HTTP badRequest (400) Przyczyna commentTextTooLong Opis Wstawiany lub aktualizowany zasób comment zawiera zbyt wiele znaków we właściwości snippet.topLevelComment.snippet.textOriginal.
    playlistItems.insert playlistItems.update	Kod odpowiedzi HTTP forbidden (403) Przyczyna playlistItemsNotAccessible Opis Żądanie nie jest odpowiednio autoryzowane do wstawiania, aktualizowania ani usuwania określonego elementu playlisty.
    playlists.delete playlists.insert playlists.update	Kod odpowiedzi HTTP badRequest (400) Przyczyna playlistForbidden Opis Ta operacja jest zabroniona lub żądanie nie jest odpowiednio autoryzowane.
    search.list	Kod odpowiedzi HTTP badRequest (400) Przyczyna invalidLocation Opis Wartość parametru location lub locationRadius jest nieprawidłowo sformatowana.
    search.list	Kod odpowiedzi HTTP badRequest (400) Przyczyna invalidRelevanceLanguage Opis Wartość parametru relevanceLanguage jest nieprawidłowo sformatowana.
    subscriptions.insert	Kod odpowiedzi HTTP badRequest (400) Przyczyna subscriptionForbidden Opis Ten błąd występuje, gdy spełniony jest jeden z tych warunków: Subskrypcja, którą próbujesz utworzyć, już istnieje Masz już maksymalną liczbę subskrypcji Próbujesz zasubskrybować własny kanał, co nie jest możliwe. Ostatnio utworzono zbyt wiele subskrypcji. Zanim spróbujesz ponownie, musisz odczekać kilka godzin.
    videos.update	Kod odpowiedzi HTTP badRequest (400) Przyczyna invalidDefaultBroadcastPrivacySetting Opis Żądanie próbuje ustawić nieprawidłowe ustawienie prywatności dla domyślnej transmisji.

28 sierpnia 2015 r.

Ta aktualizacja zawiera następujące zmiany:

• Aktualizacje istniejących zasobów i metod

  • Właściwość statistics.favoriteCount zasobu video została wycofana.

    Zgodnie z naszymi zasadami wycofywania ta właściwość będzie nadal uwzględniana w video przez co najmniej rok od daty tego ogłoszenia. Wartość właściwości jest jednak zawsze ustawiona na 0.

7 sierpnia 2015 r.

Ta aktualizacja zawiera następujące zmiany:

• Aktualizacje istniejących zasobów i metod

  • Zaktualizowaliśmy definicję właściwości snippet.tags[] zasobu video, aby podać więcej informacji o tym, jak serwer interfejsu API oblicza długość wartości właściwości. Pamiętaj, że ta aktualizacja nie odzwierciedla zmiany w działaniu interfejsu API.

    W definicji wyjaśniono, że jeśli tag zawiera spację, serwer API traktuje wartość tagu tak, jakby była ujęta w cudzysłów, a cudzysłów wlicza się do limitu znaków. Dlatego w przypadku limitów znaków tag Foo-Baz zawiera 7 znaków, a tag Foo Baz – 9 znaków.

  • Metoda commentThreads.insert nie obsługuje już parametru shareOnGooglePlus, który wcześniej wskazywał, czy komentarz i odpowiedzi na niego powinny być również publikowane w profilu autora w Google+. Jeśli żądanie zawiera ten parametr, serwer interfejsu API go ignoruje, ale w inny sposób obsługuje żądanie.

18 czerwca 2015 r.

Ta aktualizacja zawiera następujące zmiany:

• Aktualizacje istniejących zasobów i metod

  • Nowy parametr order metody commentThreads.list określa kolejność, w jakiej odpowiedź interfejsu API powinna zawierać wątki komentarzy. Wątki można sortować według czasu lub trafności. Domyślnie są one uporządkowane według czasu.

  • Nowa właściwość snippet.defaultAudioLanguage zasobu video określa język używany w domyślnej ścieżce dźwiękowej filmu.

  • Definicja właściwości video zasobu contentDetails.licensedContent została zaktualizowana, aby wyjaśnić, że treści muszą zostać pierwotnie przesłane na kanał połączony z partnerem treści YouTube, a następnie objęte roszczeniem przez tego partnera. Nie odzwierciedla to zmiany w rzeczywistym działaniu interfejsu API.

  • Metody captions.delete, captions.download, captions.insert, captions.list i captions.update obsługują teraz parametr onBehalfOfContentOwner, który jest już obsługiwany w przypadku kilku innych metod. Żądania korzystające z tej metody muszą być też autoryzowane za pomocą tokena, który zapewnia dostęp do zakresu https://www.googleapis.com/auth/youtubepartner.

• Nowe i zaktualizowane błędy

  • Interfejs API obsługuje teraz te błędy:

    Szczegóły błędu
    videos.rate	Kod odpowiedzi HTTP badRequest (400) Przyczyna emailNotVerified Opis Użytkownik musi potwierdzić swój adres e-mail, zanim będzie mógł ocenić film.
    videos.rate	Kod odpowiedzi HTTP badRequest (400) Przyczyna videoPurchaseRequired Opis Filmy do wypożyczenia mogą oceniać tylko użytkownicy, którzy je wypożyczyli.

  • Metody subscriptions.delete i subscriptions.insert nie obsługują już błędów accountClosed i accountSuspended.

27 kwietnia 2015 r.

Ta aktualizacja zawiera następujące zmiany:

• Nowe zasoby i metody

  • Nowy zasób videoAbuseReportReason zawiera informacje o przyczynie, dla której film może zostać oznaczony jako zawierający nieodpowiednie treści. Metoda videoAbuseReportReasons.list umożliwia pobranie listy wszystkich powodów, dla których filmy mogą zostać oznaczone.

  • Nowa metoda videos.reportAbuse umożliwia zgłaszanie filmów zawierających treści nieodpowiednie. Treść żądania zawiera obiekt JSON, który określa film zgłaszany jako zawierający nieodpowiednie treści oraz powód, dla którego film jest uznawany za zawierający takie treści. Prawidłowe przyczyny można uzyskać za pomocą opisanej powyżej metody videoAbuseReportReason.list.

    Zaktualizowaliśmy też przewodnik po migracji, dodając do niego przykład zgłaszania obraźliwego filmu. Dzięki tej zmianie interfejs API w wersji 3 obsługuje teraz wszystkie funkcje interfejsu API w wersji 2, które ma obsługiwać. Wszystkie te funkcje są też opisane w przewodniku po migracji.

• Aktualizacje istniejących zasobów i metod

  • Nowy parametr filtra forDeveloper metody search.list ogranicza wyszukiwanie do filmów przesłanych za pomocą aplikacji lub witryny dewelopera. Parametr forDeveloper można stosować w połączeniu z opcjonalnymi parametrami wyszukiwania, takimi jak parametr q.

    W przypadku tej funkcji każdy przesłany film jest automatycznie oznaczany numerem projektu powiązanym z aplikacją dewelopera w Google Developers Console.

    Gdy w kolejnym żądaniu wyszukiwania parametr forDeveloper zostanie ustawiony na true, serwer interfejsu API użyje danych logowania autoryzacji żądania, aby zidentyfikować dewelopera. Dlatego deweloper może ograniczyć wyniki do filmów przesłanych za pomocą jego aplikacji lub witryny, ale nie do filmów przesłanych za pomocą innych aplikacji lub witryn.

    Nowa funkcja oferuje podobne, choć nie identyczne, działanie jak tagi deweloperskie obsługiwane przez interfejs API w wersji 2.

  • Nowa właściwość snippet.country zasobu channel umożliwia właścicielom kanałów powiązanie ich z konkretnym krajem.

    Uwaga: aby ustawić właściwość snippet.country dla zasobu channel, musisz zaktualizować właściwość brandingSettings.channel.country.

  • Interfejs API obsługuje teraz kierowanie na zasoby channelSection. Kierowanie na sekcję kanału umożliwia ograniczenie widoczności sekcji treści do użytkowników spełniających określone kryteria.

    Interfejs API udostępnia 3 opcje kierowania. Aby sekcja kanału była widoczna, użytkownik musi spełniać wszystkie ustawienia kierowania.

    • targeting.languages[]: lista języków aplikacji YouTube. Użytkownicy, którzy wybrali jeden z tych języków, mogą zobaczyć odpowiednią sekcję kanału.

    • targeting.regions[]: lista preferowanych regionów treści w YouTube. Sekcja kanału jest widoczna dla użytkowników, którzy wybrali jeden z tych regionów, a także dla użytkowników, dla których jeden z tych regionów został wybrany automatycznie.

    • targeting.countries[]: lista krajów, w których sekcja kanału jest widoczna. Każda wartość na liście to kod kraju w formacie ISO 3166-1 alfa-2.

  • Definicja właściwości contentDetails.duration zasobu video została poprawiona, aby odzwierciedlała fakt, że wartość może odnosić się do godzin, dni itp.

  • Dokumentacja metod channelSections.delete, playlistItems.delete, playlists.delete, subscriptions.delete i videos.delete została poprawiona. Odzwierciedla teraz fakt, że w przypadku powodzenia wszystkie te metody zwracają kod odpowiedzi HTTP 204 (No Content).

• Nowe i zaktualizowane błędy

  • Interfejs API obsługuje teraz te błędy:

    Typ błędu	Szczegóły błędu	Opis
    badRequest (400)	targetInvalidCountry	Metody channelSections.insert i channelSections.update zwracają ten błąd, jeśli wstawiony zasób channelSection zawierał nieprawidłową wartość właściwości targeting.countries[].
    badRequest (400)	targetInvalidLanguage	Metody channelSections.insert i channelSections.update zwracają ten błąd, jeśli wstawiony zasób channelSection zawierał nieprawidłową wartość właściwości targeting.languages[].
    badRequest (400)	targetInvalidRegion	Metody channelSections.insert i channelSections.update zwracają ten błąd, jeśli wstawiony zasób channelSection zawierał nieprawidłową wartość właściwości targeting.regions[].
    badRequest (400)	operationNotSupported	Metoda comments.insert zwraca ten błąd, jeśli użytkownik interfejsu API nie może wstawić komentarza w odpowiedzi na komentarz najwyższego poziomu zidentyfikowany przez właściwość snippet.parentId. W zasobie commentThread właściwość snippet.canReply wskazuje, czy bieżący widz może odpowiedzieć w wątku.
    badRequest (400)	invalidChannelId	Metoda search.list zwraca ten błąd, jeśli parametr channelId w żądaniu zawiera nieprawidłowy identyfikator kanału.
    badRequest (400)	subscriptionForbidden	Metoda subscriptions.insert zwraca ten błąd, jeśli użytkownik interfejsu API próbuje zasubskrybować własny kanał.

  • Metoda captions.update nie obsługuje już błędów invalidMetadata i videoNotFound.

16 kwietnia 2015 r.

Ta aktualizacja zawiera następujące zmiany:

• Zaktualizowaliśmy przewodnik po migracji, aby wyjaśnić, jak migrować aplikacje, które nadal korzystają z funkcji komentarzy z interfejsu API w wersji 2.

  W przewodniku wymieniono też kilka funkcji komentowania, które nie były obsługiwane przez interfejs API w wersji 2, ale są obsługiwane przez interfejs API w wersji 3. Obejmują one:

  • Pobieranie komentarzy dotyczących kanału
  • Pobieranie wszystkich wątków komentarzy związanych z kanałem, co oznacza, że odpowiedź API może zawierać komentarze dotyczące kanału lub dowolnego z jego filmów.
  • Aktualizowanie tekstu komentarza
  • Oznaczanie komentarza jako spam
  • Ustawianie stanu moderowania komentarza

• Zaktualizowaliśmy przewodnik Subskrybowanie powiadomień push, aby odzwierciedlał fakt, że powiadomienia są wysyłane tylko do huba Google PubSubHubBub, a nie również do huba Superfeedr, jak wcześniej podano.

9 kwietnia 2015 r.

Ta aktualizacja zawiera następujące zmiany:

• Nowe zasoby commentThread i comment interfejsu API umożliwiają pobieranie, wstawianie, aktualizowanie, usuwanie i moderowanie komentarzy.

  • commentThread Zasób zawiera informacje o wątku komentarzy w YouTube, który obejmuje komentarz najwyższego poziomu i odpowiedzi na niego (jeśli takie istnieją). commentThread Zasób może reprezentować komentarze dotyczące filmu lub kanału.

    Komentarz najwyższego poziomu i odpowiedzi są w rzeczywistości comment zasobami zagnieżdżonymi w zasobie commentThread. Pamiętaj, że zasób commentThread nie musi zawierać wszystkich odpowiedzi na komentarz. Jeśli chcesz pobrać wszystkie odpowiedzi na konkretny komentarz, musisz użyć metody comments.list. Niektóre komentarze nie mają też odpowiedzi.

    Interfejs API obsługuje te metody dla zasobów commentThread:

    • commentThreads.list – pobieranie listy wątków komentarzy. Użyj tej metody, aby pobrać komentarze powiązane z konkretnym filmem lub kanałem.
    • commentThreads.insert – Utwórz nowy komentarz najwyższego poziomu. (Aby odpowiedzieć na istniejący komentarz, użyj metody comments.insert).
    • commentThreads.update – zmodyfikuj komentarz najwyższego poziomu.

  • Zasób comment zawiera informacje o pojedynczym komentarzu w YouTube. commentZasób może reprezentować komentarz dotyczący filmu lub kanału. Może to być komentarz najwyższego poziomu lub odpowiedź na taki komentarz.

    Interfejs API obsługuje te metody dla zasobów comment:

    • comments.list – pobieranie listy komentarzy. Użyj tej metody, aby pobrać wszystkie odpowiedzi na konkretny komentarz.
    • comments.insert – utwórz odpowiedź na istniejący komentarz.
    • comments.update – zmodyfikować komentarz.
    • comments.markAsSpam – oznaczanie co najmniej jednego komentarza jako spamu;
    • comments.setModerationStatus – ustaw stan moderowania co najmniej 1 komentarza. Możesz na przykład zatwierdzić komentarz do publicznego wyświetlenia lub odrzucić go jako nieodpowiedni. Żądanie do interfejsu API musi być autoryzowane przez właściciela kanału lub filmu powiązanego z komentarzami.
    • comments.delete – usuń komentarz.

  Pamiętaj, że w przypadku wywołań metod comments.insert, comments.update, comments.markAsSpam, comments.setModerationStatus, comments.delete, commentThreads.insert i commentThreads.update wymagany jest nowy zakres https://www.googleapis.com/auth/youtube.force-ssl interfejsu API, który został opisany w historii zmian z 2 kwietnia 2015 r..

• Nowy przewodnik Subskrybowanie powiadomień push wyjaśnia, że interfejs API obsługuje teraz powiadomienia push za pomocą PubSubHubBub, czyli protokołu publikowania i subskrybowania typu serwer-serwer dla zasobów dostępnych w internecie. Serwer wywołania zwrotnego PubSubHubBub może otrzymywać powiadomienia o kanałach w formacie Atom, gdy kanał wykona jedną z tych czynności:

  • przesyła film,
  • aktualizuje tytuł filmu,
  • aktualizuje opis filmu,

• Zaktualizowaliśmy też przewodnik po migracji, aby uwzględnić w nim nowe powiadomienia push. Interfejs API w wersji 2 obsługiwał jednak wiele innych typów powiadomień push, które nie są obsługiwane w interfejsie API w wersji 3, więc wzmianka o obsłudze PubSubHubBub nadal znajduje się w sekcji Wycofane tego przewodnika.

• Nowy zakres https://www.googleapis.com/auth/youtube.force-ssl interfejsu API jest teraz prawidłowym zakresem dla każdej metody interfejsu API, która wcześniej obsługiwała zakres https://www.googleapis.com/auth/youtube.

• Interfejs API obsługuje teraz te błędy:

  Typ błędu	Szczegóły błędu	Opis
  badRequest (400)	invalidRating	Metoda videos.rate zwraca ten błąd, jeśli żądanie zawierało nieoczekiwaną wartość parametru rating.

• Metoda subscriptions.insert nie obsługuje już błędu subscriptionLimitExceeded, który wcześniej wskazywał, że subskrybent zidentyfikowany w żądaniu przekroczył limit szybkości subskrypcji.

2 kwietnia 2015 r.

Ta aktualizacja zawiera następujące zmiany:

• Nowy zasób captions reprezentuje ścieżkę z napisami w YouTube. Ścieżka z napisami jest powiązana z dokładnie 1 filmem na YouTube.

  Interfejs API obsługuje metody list, insert, update, download i delete dla ścieżek napisów.

• Zaktualizowaliśmy też przewodnik po migracji, aby wyjaśnić, jak przenieść aplikacje, które nadal korzystają z funkcji napisów w interfejsie API w wersji 2.

• Nowy zakres https://www.googleapis.com/auth/youtube.force-ssl interfejsu API wymaga, aby komunikacja z serwerem API odbywała się przez połączenie SSL.

  Ten nowy zakres przyznaje taki sam dostęp jak zakres https://www.googleapis.com/auth/youtube. W rzeczywistości te 2 zakresy są funkcjonalnie identyczne, ponieważ serwer interfejsu YouTube API jest dostępny tylko przez punkt końcowy HTTPS. W związku z tym, mimo że zakres https://www.googleapis.com/auth/youtube nie wymaga połączenia SSL, nie ma innego sposobu na wysłanie żądania do interfejsu API.

  Nowy zakres jest wymagany w przypadku wywoływania wszystkich metod zasobu caption.

11 marca 2015 r.

Ta aktualizacja zawiera następujące zmiany:

• Przewodnik po migracji do interfejsu YouTube Data API (wersja 3) zawiera nową kartę o nazwie Nowości w interfejsie API w wersji 3, na której znajdziesz listę funkcji obsługiwanych przez interfejs API w wersji 3, a nieobsługiwanych przez interfejs API w wersji 2. Te same funkcje były wcześniej i nadal są wymienione na innych kartach w przewodniku. Na przykład nowa funkcja wyjaśniająca, jak aktualizować dane kampanii promocyjnej In-Video na kanale, jest również wymieniona na karcie Kanały (profile).

• Przewodnik po migracji do interfejsu YouTube Data API (wersja 3) został zaktualizowany. Zawiera informację, że interfejs API w wersji 3 będzie obsługiwać tę funkcję interfejsu API w wersji 2:

  • Oznaczanie filmu

• Zaktualizowaliśmy przewodnik po migracji do interfejsu YouTube Data API (wersja 3), aby poinformować, że w interfejsie API w wersji 3 nie będą obsługiwane te funkcje interfejsu API w wersji 2:

  • Pobieranie rekomendacji filmów – interfejs API w wersji 3 nie pobiera listy, która zawiera tylko filmy rekomendowane dla bieżącego użytkownika interfejsu API. Możesz jednak użyć interfejsu API w wersji 3, aby znaleźć polecane filmy, wywołując metodę activities.list i ustawiając wartość parametru home na true.

    W odpowiedzi interfejsu API zasób odpowiada rekomendowanemu filmowi, jeśli wartość właściwości snippet.type to recommendation. W takim przypadku właściwości contentDetails.recommendation.reason i contentDetails.recommendation.seedResourceId będą zawierać informacje o tym, dlaczego film został zarekomendowany. Pamiętaj, że nie możemy zagwarantować, że odpowiedź będzie zawierać określoną liczbę rekomendowanych filmów.

  • Pobieranie sugestii dotyczących kanału

  • Pobieranie nowych filmów z subskrypcji – interfejs API w wersji 3 nie pobiera listy zawierającej tylko filmy, które zostały niedawno przesłane na kanały subskrybowane przez użytkownika interfejsu API. Możesz jednak użyć interfejsu API w wersji 3, aby znaleźć nowe filmy z subskrypcji, wywołując metodę activities.list i ustawiając wartość parametru home na true.

    W odpowiedzi interfejsu API zasób odpowiada nowemu filmowi w ramach subskrypcji, jeśli wartość właściwości snippet.type to upload. Pamiętaj, że nie ma gwarancji, że odpowiedź będzie zawierać określoną liczbę nowych filmów z subskrypcją.

  • Obsługa kanału RSS

  • Powiadomienia push o aktualizacjach plików danych – interfejs API w wersji 2 obsługiwał powiadomienia push za pomocą protokołu Simple Update Protocol (SUP) lub PubSubHubbub, aby monitorować pliki danych o aktywności użytkowników YouTube. Powiadomienia były wysyłane w przypadku nowych subskrypcji kanałów oraz gdy filmy były oceniane, udostępniane, oznaczane jako ulubione, komentowane lub przesyłane.

    Interfejs API w wersji 3 będzie obsługiwać powiadomienia push za pomocą protokołu PubSubHubbub, ale powiadomienia będą dotyczyć tylko przesyłania filmów oraz aktualizacji tytułów i opisów filmów.

  • Lokalizacja kanału – interfejs API w wersji 2 używał tagu <yt:location> do identyfikowania lokalizacji użytkownika podanej w publicznym profilu kanału w YouTube. Niektórzy deweloperzy używali tego pola do powiązania kanału z określonym krajem, ale danych w tym polu nie można było konsekwentnie wykorzystywać w tym celu.

  • Ustawianie i pobieranie tagów dewelopera – interfejs API w wersji 2 umożliwiał powiązanie słów kluczowych lub tagów dewelopera z filmem w momencie jego przesyłania. Tagi dewelopera nie byłyby wyświetlane użytkownikom YouTube, ale właściciele filmów mogliby wyszukiwać filmy pasujące do konkretnego tagu dewelopera.

    Interfejs API w wersji 3 będzie udostępniać podobną, ale nie identyczną funkcję. W szczególności deweloper będzie mógł wyszukiwać filmy przesłane przez jego aplikację. W przypadku tej funkcji każdy przesłany film jest automatycznie oznaczany numerem projektu powiązanym z aplikacją dewelopera w Google Developers Console. Następnie deweloper używa tego samego numeru projektu do wyszukiwania filmów.

  • Wyświetlanie filmów według daty publikacji, liczby wyświetleń lub oceny – w interfejsie API w wersji 2 parametr orderby umożliwiał sortowanie filmów na playliście według pozycji, czasu trwania, daty publikacji, tytułu i kilku innych wartości. W interfejsie API w wersji 3 elementy playlisty są zwykle sortowane według pozycji w kolejności rosnącej, a inne opcje sortowania nie są dostępne.

    Jest jednak kilka wyjątków. Nowy film, ulubiony film, polubiony film lub ostatnio oglądany film jest automatycznie dodawany jako pierwszy element (snippet.position=0) w przypadku tych typów playlist: Każda z tych list jest więc posortowana od najnowszego do najstarszego elementu na podstawie czasu dodania elementów do listy.

    • przesłane przez użytkowników,
    • ulubione filmy,
    • polubione filmy
    • historia oglądania

    Pamiętaj jednak, że nowy element dodany do playlisty „Do obejrzenia” jest umieszczany na końcu tej listy, więc jest ona posortowana od najstarszego do najnowszego elementu.

  • Przetwarzanie wsadowe – interfejs API w wersji 3 obsługuje jeden z przypadków użycia przetwarzania wsadowego, który był obsługiwany przez interfejs API w wersji 2. Metody channels.list, channelSections.list, guideCategories.list, playlistItems.list, playlists.list, subscriptions.list, videoCategories.list i videos.list interfejsu API w wersji 3 obsługują parametr id, który umożliwia określenie rozdzielonej przecinkami listy identyfikatorów (identyfikatorów filmów, kanałów itp.). Za pomocą tych metod możesz pobrać listę wielu zasobów za pomocą jednego żądania.

  Dzięki tym zmianom przewodnik zawiera teraz wszystkie funkcje, które były obsługiwane w starym interfejsie API (wersja 2), a które zostaną wycofane w obecnej wersji interfejsu API (wersja 3).

4 marca 2015 r.

Ta aktualizacja zawiera następujące zmiany:

• Metody channelSections.delete i channelSections.update obsługują teraz parametr onBehalfOfContentOwner, który jest już obsługiwany w przypadku kilku innych metod.

• Wycofaliśmy te usługi i ich usługi podrzędne:

  • brandingSettings.image.backgroundImageUrl
  • brandingSettings.image.largeBrandedBannerImageImapScript
  • brandingSettings.image.largeBrandedBannerImageUrl
  • brandingSettings.image.smallBrandedBannerImageImapScript
  • brandingSettings.image.smallBrandedBannerImageUrl

  Uwaga: żadna z tych usług nie podlegała zasadom wycofywania interfejsów API.

• Nowa właściwość contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons zasobu video określa przyczyny, dla których film otrzymał ocenę DJCQT (Brazylia).

• Interfejs API obsługuje teraz te błędy:

  Typ błędu	Szczegóły błędu	Opis
  notFound (404)	channelNotFound	Metoda channels.update zwraca ten błąd, jeśli parametr id w żądaniu określa kanał, którego nie można znaleźć.
  badRequest (400)	manualSortRequiredinvalidValue	Metody playlistItems.insert i playlistItems.update zwracają ten błąd, jeśli żądanie próbuje ustawić pozycję elementu playlisty, ale playlista nie korzysta z ręcznego sortowania. Na przykład elementy playlisty mogą być posortowane według daty lub popularności. Aby rozwiązać ten problem, usuń element snippet.position z zasobu wysłanego w treści żądania. Jeśli chcesz, aby element playlisty miał określoną pozycję na liście, musisz najpierw zmienić ustawienie kolejności playlisty na Ręcznie. To ustawienie można zmienić w Menedżerze filmów w YouTube.
  forbidden (403)	channelClosed	Metoda playlists.list zwraca ten błąd, jeśli parametr channelId w żądaniu określa zamknięty kanał.
  forbidden (403)	channelSuspended	Metoda playlists.list zwraca ten błąd, jeśli parametr channelId w żądaniu określa zawieszony kanał.
  forbidden (403)	playlistForbidden	Metoda playlists.list zwraca ten błąd, jeśli parametr id w żądaniu nie obsługuje żądania lub żądanie nie jest prawidłowo autoryzowane.
  notFound (404)	channelNotFound	Metoda playlists.list zwraca ten błąd, jeśli parametr channelId w żądaniu określa kanał, którego nie można znaleźć.
  notFound (404)	playlistNotFound	Metoda playlists.list zwraca ten błąd, jeśli parametr id w żądaniu określa playlistę, której nie można znaleźć.
  notFound (404)	videoNotFound	Metoda videos.list zwraca ten błąd, jeśli parametr id w żądaniu określa film, którego nie można znaleźć.
  badRequest (400)	invalidRating	Metoda videos.rate zwraca ten błąd, jeśli żądanie zawiera nieoczekiwaną wartość parametru rating.

2 marca 2015 r.

Ta aktualizacja zawiera następujące zmiany:

• Metoda search.list obsługuje teraz parametr relevanceLanguage, który umożliwia żądanie wyników najbardziej odpowiednich dla danego języka.

  Zaktualizowaliśmy też przewodnik po migracji do interfejsu YouTube Data API (wersja 3), aby wyjaśnić, jak używać tego nowego parametru. Ten parametr uzupełnia lukę w funkcjach, która wcześniej występowała między obecną wersją interfejsu API (wersja 3) a poprzednią wersją (wersja 2), która została już wycofana.

• Zaktualizowaliśmy też przewodnik po migracji do interfejsu YouTube Data API (wersja 3), aby poinformować o wycofaniu specjalnych kanałów i pól metadanych, które interfejs API w wersji 2 udostępniał do opisywania filmów, zwiastunów, seriali, sezonów i odcinków.

14 stycznia 2015 r.

Ta aktualizacja zawiera następujące zmiany:

• Zaktualizowaliśmy przewodnik po migracji do interfejsu YouTube Data API (wersja 3), aby wyjaśnić, jak używać interfejsu API w wersji 3 do przesyłania filmów za pomocą JavaScriptu. (Więcej informacji znajdziesz w sekcji Przesyłanie filmu). Ta funkcja jest porównywalna z funkcją przesyłania w przeglądarce, którą obsługuje interfejs API w wersji 2. Pamiętaj, że ta zmiana w przewodniku po migracji nie odzwierciedla rzeczywistej zmiany w interfejsie API, ale raczej dostępność nowego przykładowego kodu do przesyłania filmów za pomocą JavaScriptu po stronie klienta.

  W związku z obsługą przesyłania filmów za pomocą biblioteki klienta JavaScript i CORS w przewodniku migracji nie ma już informacji o przesyłaniu w przeglądarce jako funkcji, która może zostać wycofana w interfejsie API w wersji 3.

• Dokumentacja metody videos.insert została zaktualizowana i zawiera teraz opisany powyżej nowy przykładowy kod JavaScript. Zaktualizowaliśmy też listę przykładowych kodów JavaScript dla interfejsu YouTube Data API (wersja 3).

11 listopada 2014 r.

Ta aktualizacja zawiera następujące zmiany:

• Koszt limitu wywołania metody search.list został zmieniony na 100 jednostek.

  Ważne: w wielu przypadkach możesz użyć innych metod interfejsu API, aby pobrać informacje przy niższym koszcie limitu. Rozważ na przykład te 2 sposoby wyszukiwania filmów przesłanych na kanał GoogleDevelopers.

  • Koszt limitu: 100 jednostek

    Wywołaj metodę search.list i wyszukaj GoogleDevelopers.

  • Koszt limitu: 6 jednostek

    Aby znaleźć odpowiedni identyfikator kanału, wywołaj metodę channels.list. Ustaw parametr forUsername na GoogleDevelopers, a parametr part na contentDetails. W odpowiedzi interfejsu API właściwość contentDetails.relatedPlaylists.uploads określa identyfikator playlisty z przesłanymi filmami na kanale.

    Następnie wywołaj metodę playlistItems.list i ustaw parametr playlistId na przechwycony identyfikator, a parametr part na snippet.

8 października 2014 r.

Ta aktualizacja zawiera następujące zmiany:

• Zasób channel zawiera 2 nowe właściwości:

  • Właściwość status.longUploadsStatus 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 do interfejsu API. Prawidłowe wartości właściwości to:

    • allowed – kanał może przesyłać filmy dłuższe niż 15 minut;
    • eligible – kanał może przesyłać filmy dłuższe niż 15 minut, ale najpierw musi włączyć tę funkcję.
    • disallowed – kanał nie może przesyłać filmów dłuższych niż 15 minut lub nie kwalifikuje się do tego.

    Więcej informacji o tych wartościach znajdziesz w definicji właściwości. Więcej informacji o tej funkcji znajdziesz w Centrum pomocy YouTube.

  • Właściwość invideoPromotion.useSmartTiming wskazuje, czy kampania promocyjna kanału korzysta z „inteligentnego harmonogramu”. Ta funkcja próbuje wyświetlać promocje w momencie filmu, w którym istnieje większe prawdopodobieństwo, że użytkownicy klikną reklamę, a mniejsze, że zakłóci ona oglądanie. Ta funkcja wybiera też jedną promocję, która będzie wyświetlana przy każdym filmie.

• Definicje właściwości snippet.title i snippet.categoryId zasobu video zostały zaktualizowane, aby wyjaśnić sposób, w jaki interfejs API obsługuje wywołania metody videos.update. Jeśli wywołasz tę metodę, aby zaktualizować część snippet zasobu video, musisz ustawić wartość obu tych właściwości.

  Jeśli spróbujesz zaktualizować część snippet zasobu video i nie ustawisz wartości obu tych właściwości, interfejs API zwróci błąd invalidRequest. Opis tego błędu również został zaktualizowany.

• Właściwość contentDetails.contentRating.oflcRating zasobu video, która określa ocenę filmu przyznaną przez nowozelandzki urząd ds. klasyfikacji filmów i literatury, obsługuje teraz 2 nowe oceny: oflcRp13 i oflcRp16. Odpowiadają one ocenom RP13 i RP16.

• Metoda channelBanners.insert obsługuje teraz ten błąd:

  Typ błędu	Szczegóły błędu	Opis
  badRequest	bannerAlbumFull	Album grafiki kanału na YouTube właściciela kanału zawiera za dużo obrazów. Właściciel kanału powinien otworzyć stronę http://photos.google.com, przejść do strony albumów i usunąć z albumu niektóre obrazy.

12 września 2014 r.

Ta aktualizacja zawiera następujące zmiany:

• Koszt limitu na wywołanie metody search.list zmienił się z 1 jednostki na 2 jednostki, oprócz kosztu określonych części zasobu.

13 sierpnia 2014 r.

Ta aktualizacja zawiera następujące zmiany:

• Metoda subscriptions.insert obsługuje teraz ten błąd:

  Typ błędu	Szczegóły błędu	Opis
  badRequest	subscriptionLimitExceeded	Subskrybent zidentyfikowany w żądaniu przekroczył limit częstotliwości subskrypcji. Za kilka godzin możesz spróbować zasubskrybować kolejne kanały.

12 sierpnia 2014 r.

Ta aktualizacja zawiera następujące zmiany:

• Nowy przewodnik Migracja aplikacji do interfejsu YouTube Data API (wersja 3) wyjaśnia, jak używać interfejsu YouTube Data API (wersja 3) do wykonywania funkcji dostępnych w interfejsie YouTube Data API (wersja 2). Starszy interfejs API został oficjalnie wycofany 4 marca 2014 r. Ten przewodnik ma pomóc w przeniesieniu aplikacji, które nadal korzystają z interfejsu API w wersji 2, na najnowszą wersję interfejsu API.

8 lipca 2014 r.

Ta aktualizacja zawiera następujące zmiany:

• Metoda playlists.insert obsługuje teraz ten błąd:

  Typ błędu	Szczegóły błędu	Opis
  badRequest	maxPlaylistExceeded	Ten błąd występuje, gdy nie można utworzyć playlisty, ponieważ kanał ma już maksymalną dozwoloną liczbę playlist.

18 czerwca 2014 r.

Ta aktualizacja zawiera następujące zmiany:

• Opis każdej metody interfejsu API został zaktualizowany i zawiera teraz koszt limitu poniesiony w wyniku wywołania tej metody. Podobnie zaktualizowaliśmy definicje part parametrów, aby określić koszt limitu każdego elementu, który można pobrać w wywołaniu interfejsu API. Na przykład wywołanie metody subscriptions.insert ma koszt limitu wynoszący około 50 jednostek. Zasób subscription również składa się z 3 części (snippet, contentDetails i subscriberSnippet), a każda z nich kosztuje 2 jednostki.

  Pamiętaj, że koszty limitów mogą ulec zmianie bez ostrzeżenia.

• Zasób video obsługuje teraz 43 nowe systemy ocen treści, które określają oceny przyznane filmom przez różne krajowe agencje ratingowe. Nowe systemy oceniania pochodzą z Argentyny, Austrii, Belgii, Bułgarii, Chile (telewizja), Chile (film), Czech, Kolumbii, Danii, Egiptu, Estonii, Finlandii, Francji, Grecji, Hongkongu, Islandii, Indonezji, Irlandii, Izraela, Włoch, Kenii, Łotwy, Luksemburga, Malezji, Malediwów, Malty, Holandii, Nigerii, Norwegii, Peru, Filipin, Portugalii, Rumunii, Singapuru, Słowacji, RPA, Szwecji, Szwajcarii, Tajwanu, Tajlandii i Wenezueli.

28 maja 2014 r.

Ta aktualizacja zawiera następujące zmiany:

• Metoda search.list obsługuje teraz parametry location i locationRadius, które umożliwiają wyszukiwanie filmów powiązanych z położeniem geograficznym. Aby uzyskać wyniki na podstawie lokalizacji, żądanie musi zawierać wartości obu parametrów. Jeśli żądanie zawiera tylko jeden z tych parametrów, interfejs API zwróci błąd.

  • Parametr location określa współrzędne geograficzne środka okrągłego obszaru geograficznego.

  • Parametr locationRadius określa maksymalną odległość, w jakiej lokalizacja powiązana z filmem może znajdować się od środka obszaru, aby film nadal był uwzględniany w wynikach wyszukiwania.

13 maja 2014 r.

Ta aktualizacja zawiera następujące zmiany:

• W zasobie channel w sekcji invideoPromotion.items[] dodaliśmy informację, że na kanale można zwykle ustawić tylko 1 promowany produkt. Jeśli spróbujesz wstawić zbyt wiele promowanych produktów, interfejs API zwróci błąd tooManyPromotedItems z kodem stanu HTTP 400.

• Zasób channelSection może teraz zawierać informacje o kilku nowych typach polecanych treści. Właściwość snippet.type zasobu channelSection obsługuje teraz te wartości:

  • postedPlaylists – playlisty, które właściciel kanału opublikował w strumieniu aktywności kanału;
  • postedVideos – filmy opublikowane przez właściciela kanału w strumieniu aktywności kanału.
  • subscriptions – kanały, które subskrybuje właściciel kanału.

• Nowa właściwość contentDetails.contentRating.ifcoRating zasobu video określa ocenę, jaką film otrzymał od irlandzkiego urzędu ds. klasyfikacji filmów.

• Definicja właściwości watermark zasobu position.cornerPosition została zaktualizowana, aby uwzględnić informację, że znak wodny zawsze pojawia się w prawym górnym rogu odtwarzacza.

• Zaktualizowaliśmy definicję parametru q dla metody search.list, aby uwzględnić informację, że w zapytaniu można użyć operatora logicznego NOT (-) do wykluczania filmów powiązanych z określonym wyszukiwanym hasłem. Wartość może też używać operatora logicznego LUB (|), aby znaleźć filmy powiązane z jednym z kilku wyszukiwanych haseł.

• Zaktualizowaliśmy definicję właściwości pageInfo.totalResults, która jest zwracana w odpowiedzi interfejsu API na wywołanie search.list. Dodaliśmy informację, że wartość jest przybliżona i może nie być dokładna. Maksymalna wartość to 1 000 000. Nie używaj tej wartości do tworzenia linków do podziału na strony. Zamiast tego użyj wartości właściwości nextPageToken i prevPageToken, aby określić, czy wyświetlać linki do podziału na strony.

• Metody watermarks.set i watermarks.unset zostały zaktualizowane, aby odzwierciedlać fakt, że interfejs API zwraca kod odpowiedzi HTTP 204 w przypadku żądań zakończonych powodzeniem.

2 maja 2014 r.

Ta aktualizacja zawiera następujące zmiany:

• Nowy zasób i18nLanguage określa język aplikacji obsługiwany przez witrynę YouTube. Język aplikacji jest też nazywany językiem interfejsu. W przypadku witryny YouTube język aplikacji może być wybierany automatycznie na podstawie ustawień konta Google, języka przeglądarki lub lokalizacji IP. Użytkownik może też ręcznie wybrać żądany język interfejsu w stopce witryny YouTube.

  Interfejs API obsługuje metodę wyświetlania obsługiwanych języków aplikacji. Obsługiwane języki można stosować jako wartość parametru hl podczas wywoływania metod interfejsu API, takich jak videoCategories.list i guideCategories.list.

• Nowy zasób i18nRegion identyfikuje obszar geograficzny, który użytkownik YouTube może wybrać jako preferowany region treści. Region treści może być też określany jako język treści. W przypadku witryny YouTube region treści może być wybierany automatycznie na podstawie heurystyki, np. domeny YouTube lub lokalizacji IP użytkownika. Użytkownik może też ręcznie wybrać żądany region treści w stopce witryny YouTube.

  API obsługuje metodę listowania obsługiwanych regionów treści. Obsługiwane kody regionów można używać jako wartości parametru regionCode podczas wywoływania metod interfejsu API, takich jak search.list, videos.list, activities.list i videoCategories.list.

7 kwietnia 2014 r.

Ta aktualizacja zawiera następujące zmiany:

• Nowy zasób channelSection zawiera informacje o zestawie filmów, które kanał wybrał do wyróżnienia. Na przykład sekcja może zawierać najnowsze filmy, najpopularniejsze filmy lub filmy z co najmniej 1 playlisty.

  Interfejs API obsługuje metody wyświetlania, wstawiania, aktualizowania i usuwania sekcji kanału. Możesz pobrać listę sekcji kanału uwierzytelnionego użytkownika, podając konkretny identyfikator kanału lub listę unikalnych identyfikatorów sekcji kanału.

  Zaktualizowaliśmy też dokumentację błędów, aby opisać komunikaty o błędach, które interfejs API obsługuje w przypadku tych nowych metod.

• Zaktualizowaliśmy definicję obiektu fileDetails zasobu video, aby wyjaśnić, że ten obiekt będzie zwracany tylko wtedy, gdy właściwość processingDetails.fileDetailsAvailability filmu ma wartość available.

  Podobnie zaktualizowaliśmy definicję obiektu suggestions zasobu video, aby wyjaśnić, że ten obiekt będzie zwracany tylko wtedy, gdy właściwość processingDetails.tagSuggestionsAvailability lub processingDetails.editorSuggestionsAvailability filmu ma wartość available.

• Zaktualizowaliśmy dokumentację metod videos.insert i videos.update, aby uwzględnić informację, że podczas wywoływania tych metod można ustawić właściwość status.publishAt.

• Zaktualizowaliśmy definicję obiektu channel zasobu invideoPromotion, aby wyjaśnić, że obiekt może pobrać tylko właściciel kanału.

• Lista parametrów metody videos.rate została zaktualizowana, aby odzwierciedlać fakt, że ta metoda nie obsługuje parametru onBehalfOfContentOwner. Był to błąd w dokumentacji, ponieważ żądania videos.rate, w których ustawiono ten parametr, zwracają błąd 500.

31 marca 2014 r.

Ta aktualizacja zawiera następujące zmiany:

• Nowa właściwość status.publishAt zasobu video umożliwia określenie daty i godziny, o której film prywatny ma zostać opublikowany. Tę właściwość można ustawić tylko wtedy, gdy stan prywatności filmu to private i film nigdy nie został opublikowany. Ta nowa usługa nie podlega zasadom wycofywania.

13 marca 2014 r.

Ta aktualizacja zawiera następujące zmiany:

• Interfejs API obsługuje teraz część contentOwnerDetails w przypadku zasobów channel. Nowa część zawiera dane kanału istotne dla partnerów YouTube powiązanych z kanałem, w tym identyfikator właściciela treści powiązanego z kanałem oraz datę i godzinę powiązania właściciela treści z kanałem. Pamiętaj, że ta nowa część nie podlega zasadom wycofywania.

• W dokumentacji podano teraz maksymalną obsługiwaną długość znaków w przypadku tych właściwości:

  Zasób	Właściwość	Maksymalna długość
  channel	invideoPromotion.items[].customMessage	40 znaków
  video	snippet.title	100 znaków
  video	snippet.description	5000 bajtów
  video	snippet.tags	500 znaków. Pamiętaj, że wartość właściwości to lista, a przecinki między elementami listy wliczają się do limitu.

• Właściwość brandingSettings.watch.featuredPlaylistId zasobu channel została wycofana. Jeśli spróbujesz ustawić tę wartość, interfejs API zwróci błąd.

• Do listy wartości, które można ustawić podczas wstawiania lub aktualizowania filmu, dodaliśmy te właściwości zasobu video:

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude
  • recordingDetails.recordingDate

• W dokumentacji błędów podajemy teraz kod odpowiedzi HTTP dla każdego typu błędu.

• Interfejs API obsługuje teraz te błędy:

  Typ błędu	Szczegóły błędu	Opis
  badRequest (400)	invalidCriteria	Metoda channels.list zwraca ten błąd, jeśli żądanie określa parametry filtra, których nie można używać razem.
  badRequest (400)	channelTitleUpdateForbidden	Metoda channels.update zwraca ten błąd, jeśli spróbujesz zaktualizować część brandingSettings kanału i zmienisz wartość właściwości brandingSettings.channel.title. (Pamiętaj, że jeśli pominiesz tę właściwość, interfejs API nie zwróci błędu).
  badRequest (400)	invalidRecentlyUploadedBy	Metoda channels.update zwraca ten błąd, jeśli właściwość invideoPromotion.items[].id.recentlyUploadedBy określa nieprawidłowy identyfikator kanału.
  badRequest (400)	invalidTimingOffset	Metoda channels.update zwraca ten błąd, jeśli część invideoPromotion określa nieprawidłowe przesunięcie czasowe.
  badRequest (400)	tooManyPromotedItems	Metoda channels.update zwraca ten błąd, jeśli część invideoPromotion określa więcej promowanych produktów niż jest dozwolone.
  forbidden (403)	promotedVideoNotAllowed	Metoda channels.update zwraca ten błąd, jeśli właściwość invideoPromotion.items[].id.videoId określa identyfikator filmu, którego nie można znaleźć lub którego nie można użyć jako promowanego produktu.
  forbidden (403)	websiteLinkNotAllowed	Metoda channels.update zwraca ten błąd, jeśli właściwość invideoPromotion.items[].id.websiteUrl określa niedozwolony adres URL.
  required (400)	requiredTimingType	Metoda channels.update zwraca ten błąd, jeśli w żądaniu nie określono domyślnych ustawień czasu, kiedy YouTube ma wyświetlać promowany produkt.
  required (400)	requiredTiming	Metoda channels.update musi określać obiekt invideoPromotion.items[].timing dla każdego promowanego produktu.
  required (400)	requiredWebsiteUrl	Metoda channels.update musi określać właściwość invideoPromotion.items[].id.websiteUrl dla każdego promowanego produktu.
  badRequest (400)	invalidPublishAt	Metoda videos.insert zwraca ten błąd, jeśli metadane żądania określają nieprawidłowy czas publikacji zaplanowanej.

4 marca 2014 r.

Ta aktualizacja zawiera następujące zmiany:

• Interfejs YouTube Data API w wersji 3 podlega teraz zasadom wycofania opisanym w Warunkach korzystania z interfejsów API YouTube. Pamiętaj, że na stronie z interfejsami API, które podlegają zasadom wycofywania, niektóre funkcje interfejsu API w wersji 3 są wyraźnie wyłączone z tych zasad.

5 grudnia 2013 r.

Ta aktualizacja zawiera następujące zmiany:

• Dokumentacja metody search.list została zaktualizowana, aby prawidłowo odzwierciedlać fakt, że podczas przesyłania żądania wyszukiwania nie musisz określać wartości dokładnie jednego parametru filtra. Możesz ustawić wartość dla 0 lub 1 parametru filtra.

• Zaktualizowaliśmy definicje parametrów metody search.list, aby zaznaczyć, że jeśli określisz wartość dowolnego z tych parametrów: typevideo

  • eventType
  • videoCaption
  • videoCategoryId
  • videoDefinition
  • videoDimension
  • videoDuration
  • videoEmbeddable
  • videoLicense
  • videoSyndicated
  • videoType

• Minimalny rozmiar przesyłanych obrazów banera kanału został zmniejszony do 2048 x 1152 pikseli. (Wcześniej minimalny rozmiar wynosił 2120 x 1192 pikseli). Pamiętaj też, że w dokumentacji zasobu channel podane są maksymalne rozmiary wszystkich obrazów banerów wyświetlanych z interfejsu API. Na przykład maksymalny rozmiar brandingSettings.image.bannerTvImageUrl obrazu w przypadku aplikacji telewizyjnych to 2120 x 1192 piksele, ale rzeczywisty obraz może mieć wymiary 2048 x 1152 piksele. Dodatkowe wskazówki dotyczące optymalizacji grafiki kanału pod kątem wyświetlania na różnych typach urządzeń znajdziesz w Centrum pomocy YouTube.

• Zaktualizowaliśmy definicje kilku właściwości zasobów channel, aby odzwierciedlały te informacje:

  • Wartość właściwości brandingSettings.channel.description może mieć maksymalnie 1000 znaków.
  • Właściwość brandingSettings.channel.featuredChannelsTitle może mieć maksymalnie 30 znaków.
  • W brandingSettings.channel.featuredChannelsUrls[] może być teraz wymienionych do 100 kanałów.
  • Wartość właściwości brandingSettings.channel.unsubscribedTrailer, jeśli jest ustawiona, musi określać identyfikator filmu na YouTube, który jest publiczny lub niepubliczny i należy do właściciela kanału.

• Metoda channels.update obsługuje teraz aktualizacje właściwości invideoPromotion.items[].promotedByContentOwner. Ta właściwość określa, czy nazwa właściciela treści będzie wyświetlana podczas wyświetlania promocji. Można ją ustawić tylko wtedy, gdy żądanie do interfejsu API, które ustawia wartość właściwości, jest wysyłane w imieniu właściciela treści za pomocą parametru onBehalfOfContentOwner.

• Metody playlistItems.list i playlistItems.insert obsługują teraz parametr onBehalfOfContentOwner, który jest już obsługiwany w przypadku kilku innych metod.

• Właściwość contentDetails.contentRating.acbRating może teraz określać ocenę przyznaną przez Australian Classification Board (ACB) w przypadku filmów lub przez Australian Communications and Media Authority (ACMA) w przypadku programów telewizyjnych dla dzieci.

• Nowe właściwości contentDetails.contentRating.catvRating i contentDetails.contentRating.catvfrRating identyfikują oceny, które film otrzymał w ramach kanadyjskiego systemu klasyfikacji telewizyjnej i francuskojęzycznego systemu ocen Régie du cinéma, który jest używany w Quebecu.

• Nowa właściwość snippet.assignable zasobu videoCategory wskazuje, czy z daną kategorią filmów można powiązać zaktualizowane lub nowo przesłane filmy.

• Dodaliśmy przykłady kodu dla tych metod:

  • activities.insert (Go)
  • channelBanners.insert (Python)
  • channels.update (Python)
  • playlistItems.list (Go)
  • search.list (Go)
  • thumbnails.set (Java)
  • videos.insert (Go)

24 października 2013 r.

Ta aktualizacja zawiera następujące zmiany:

• Interfejs API obejmuje 2 dodatkowe funkcje, które pomagają znajdować i promować treści transmitowane na żywo:

  Nowa właściwość snippet.liveBroadcastContent w wynikach wyszukiwania wskazuje, czy w zasobie wideo lub na kanale znajdują się treści transmitowane na żywo. Prawidłowe wartości właściwości to upcoming, active i none.

  • Nowa właściwość snippet.liveBroadcastContent zasobu video wskazuje, czy film jest nadchodzącą lub aktywną transmisją na żywo. Na liście poniżej znajdziesz możliwe wartości właściwości:

    • upcoming – film to transmisja na żywo, która jeszcze się nie rozpoczęła.
    • active – film jest transmitowany na żywo.
    • none – film nie jest nadchodzącą ani trwającą transmisją na żywo. Będzie to wartość usługi w przypadku zakończonych transmisji, które nadal są dostępne w YouTube.

  • Nowa właściwość liveStreamingDetails zasobu video to obiekt zawierający metadane dotyczące transmisji na żywo. Aby pobrać te metadane, dodaj liveStreamingDetails do listy części zasobu w wartości parametru part. Metadane zawierają te nowe właściwości:

    • liveStreamingDetails.actualStartTime – czas rozpoczęcia transmisji. (Ta wartość będzie widoczna, gdy stan transmisji będzie active).
    • liveStreamingDetails.actualEndTime – czas rzeczywistego zakończenia transmisji. (Ta wartość będzie widoczna po zakończeniu transmisji).
    • liveStreamingDetails.scheduledStartTime – godzina rozpoczęcia transmisji.
    • liveStreamingDetails.scheduledEndTime – czas, w którym transmisja ma się zakończyć. Jeśli wartość właściwości jest pusta lub właściwość nie występuje, transmisja jest zaplanowana na czas nieokreślony.
    • liveStreamingDetails.concurrentViewers – liczba osób oglądających transmisję na żywo.

    Aby pobrać te metadane, podczas wywoływania metody videos.list, videos.insert lub videos.update w wartości parametru part uwzględnij liveStreamingDetails.

  Pamiętaj, że 1 października 2013 r. udostępniliśmy 2 inne funkcje do identyfikowania treści transmitowanych na żywo: parametr eventType metody search.list i właściwość snippet.liveBroadcastContent wyniku wyszukiwania.

• Metoda videos.insert obsługuje teraz parametr notifySubscribers, który wskazuje, czy YouTube ma wysłać powiadomienie o nowym filmie do użytkowników, którzy subskrybują kanał, na którym znajduje się film. Domyślna wartość parametru to True, co oznacza, że subskrybenci będą otrzymywać powiadomienia o nowo przesłanych filmach. Właściciel kanału, który przesyła wiele filmów, może jednak woleć ustawić wartość False, aby uniknąć wysyłania powiadomień o każdym nowym filmie do subskrybentów kanału.

• Zaktualizowaliśmy listę właściwości, które można modyfikować podczas wywoływania metody channels.update, aby uwzględnić właściwości invideoPromotion.items[].customMessage i invideoPromotion.items[].websiteUrl. Dodatkowo lista została zmodyfikowana, aby wskazywać brandingSettings właściwości, które można modyfikować. Te właściwości brandingSettings można było już modyfikować, więc zmiana w dokumentacji nie odzwierciedla zmiany w dotychczasowych funkcjach interfejsu API.

• Metody playlists.insert, playlists.update i playlists.delete obsługują teraz parametr onBehalfOfContentOwner, który jest już obsługiwany w przypadku kilku innych metod.

• Metoda playlists.insert obsługuje teraz parametr onBehalfOfContentOwnerChannel, który jest już obsługiwany w przypadku kilku innych metod.

• Właściwość contentDetails.contentRating.tvpgRating zasobu video obsługuje teraz wartość pg14, która odpowiada ocenie TV-14.

• Definicja właściwości snippet.liveBroadcastContent, która jest częścią wyników wyszukiwania, została poprawiona, aby odzwierciedlała fakt, że live jest prawidłową wartością właściwości, ale active nie jest prawidłową wartością właściwości.

• Właściwość contentDetails.contentRating.mibacRating zasobu video obsługuje teraz 2 dodatkowe oceny:

  • mibacVap (VAP) – dzieci powinny być pod opieką osoby dorosłej.
  • mibacVm6 (V.M.6) – dozwolone od 6 roku życia.
  • mibacVm12 (V.M.12) – dozwolone od 12 roku życia.

• Nowa właściwość invideoPromotion.items[].promotedByContentOwner zasobu channel wskazuje, czy nazwa właściciela treści będzie wyświetlana podczas promowania. To pole można ustawić tylko wtedy, gdy żądanie do interfejsu API, które ustawia wartość, jest wysyłane w imieniu właściciela treści. Więcej informacji znajdziesz w parametrze onBehalfOfContentOwner.

1 października 2013 r.

Ta aktualizacja zawiera następujące zmiany:

• Nowy obiekt auditDetails zasobu channel zawiera dane kanału, które sieć wielokanałowa ocenia podczas podejmowania decyzji o przyjęciu lub odrzuceniu danego kanału. Pamiętaj, że każde żądanie 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 korzysta z tego zakresu, musi zostać unieważniony, gdy sieć MCN zdecyduje się zaakceptować lub odrzucić kanał, albo w ciągu 2 tygodni od daty wydania tokena.

• Właściwość invideoPromotion.items[].id.type zasobu channel obsługuje teraz wartość recentUpload, która oznacza, że promowany element to najnowszy film przesłany z określonego kanału.

  Domyślnie kanał jest taki sam jak ten, dla którego ustawione są dane promocji In-Video. Możesz jednak promować najnowszy film przesłany z innego kanału, ustawiając wartość nowej właściwości invideoPromotion.items[].id.recentlyUploadedBy na identyfikator kanału dla tego kanału.

• Zasób channel zawiera 3 nowe właściwości – brandingSettings.image.bannerTvLowImageUrl, brandingSettings.image.bannerTvMediumImageUrl i brandingSettings.image.bannerTvHighImageUrl – które określają adresy URL obrazów banerów wyświetlanych na stronach kanału w aplikacjach telewizyjnych.

• Nowa właściwość snippet.liveBroadcastContent w wynikach wyszukiwania wskazuje, czy w zasobie wideo lub na kanale znajdują się treści transmitowane na żywo. Prawidłowe wartości właściwości to upcoming, active i none.

  • W przypadku zasobu video wartość upcoming oznacza, że film jest transmisją na żywo, która jeszcze się nie rozpoczęła, a wartość active oznacza, że film jest trwającą transmisją na żywo.
  • W przypadku zasobu channel wartość upcoming oznacza, że kanał ma zaplanowaną transmisję, która jeszcze się nie rozpoczęła, a wartość acive oznacza, że kanał ma trwającą transmisję na żywo.

• W zasobie watermark właściwość targetChannelId została zmieniona z obiektu na ciąg znaków. Zamiast zawierać właściwość podrzędną, która określa identyfikator kanału w YouTube, do którego prowadzi link z obrazu znaku wodnego, właściwość targetChannelId określa teraz tę wartość samodzielnie. W związku z tym usunięto właściwość targetChannelId.value zasobu.

• Metoda thumbnails.set obsługuje teraz parametr onBehalfOfContentOwner, który jest już obsługiwany w przypadku kilku innych metod.

• Metoda search.list obsługuje teraz parametr eventType, który ogranicza wyszukiwanie tylko do aktywnych, nadchodzących lub zakończonych wydarzeń transmitowanych.

• Nowa właściwość contentDetails.contentRating.mibacRating określa ocenę, jaką film otrzymał od włoskiego Ministerstwa Kultury i Turystyki.

• Interfejs API obsługuje teraz te błędy:

  Typ błędu	Szczegóły błędu	Opis
  badRequest	invalidImage	Metoda thumbnails.set zwraca ten błąd, jeśli podane treści obrazu są nieprawidłowe.
  forbidden	videoRatingDisabled	Metoda videos.rate zwraca ten błąd, jeśli właściciel ocenianego filmu wyłączył możliwość oceniania tego filmu.

27 sierpnia 2013 r.

Ta aktualizacja zawiera następujące zmiany:

• Nowy zasób watermark określa obraz, który wyświetla się podczas odtwarzania filmów z określonego kanału. Możesz też określić kanał docelowy, do którego będzie prowadzić link z obrazu, oraz szczegóły dotyczące czasu, które określają, kiedy znak wodny pojawia się podczas odtwarzania filmów i jak długo jest widoczny.

  Metoda watermarks.set przesyła i ustawia obraz znaku wodnego kanału. Metoda watermarks.unset usuwa obraz znaku wodnego kanału.

  Dokumentacja błędów zawiera opisy komunikatów o błędach, które interfejs API obsługuje w przypadku metod watermarks.set i watermarks.unset.

• Nowa właściwość statistics.hiddenSubscriberCount zasobu channel zawiera wartość logiczną wskazującą, czy liczba subskrybentów kanału jest ukryta. W związku z tym wartość właściwości to false, jeśli liczba subskrybentów kanału jest widoczna publicznie.

• Metoda playlists.list obsługuje teraz parametry onBehalfOfContentOwner i onBehalfOfContentOwnerChannel. Oba parametry są już obsługiwane w przypadku kilku innych metod.

• Metoda videos.list obsługuje teraz parametr regionCode, który określa region treści, dla którego ma zostać pobrany wykres. Tego parametru można używać tylko w połączeniu z parametrem chart. Wartość parametru to kod kraju w formacie ISO 3166-1 alfa-2.

• W error documentation opisano ten nowy typowy błąd żądania, który może wystąpić w przypadku wielu metod interfejsu API:

  Typ błędu	Szczegóły błędu	Opis
  forbidden	insufficientPermissions	Zakresy powiązane z tokenem OAuth 2.0 podanym w żądaniu są niewystarczające do uzyskania dostępu do żądanych danych.

15 sierpnia 2013 r.

Ta aktualizacja zawiera następujące zmiany:

• Obiekt invideoPromotion zasobu channel ma te nowe i zaktualizowane właściwości:

  • Interfejs API umożliwia teraz określenie witryny jako promowanego produktu. Aby to zrobić, ustaw wartość właściwości invideoPromotion.items[].id.type na website i użyj nowej właściwości invideoPromotion.items[].id.websiteUrl, aby określić adres URL. Użyj też nowej właściwości invideoPromotion.items[].customMessage, aby zdefiniować niestandardowy komunikat, który będzie wyświetlany w przypadku promocji.

    Mogą to być linki do powiązanych witryn, witryn sprzedawców lub serwisów społecznościowych. Więcej informacji o włączaniu linków do treści znajdziesz w instrukcjach w Centrum pomocy YouTube dotyczących powiązanych witryn i witryn sprzedawców.

    Dodając linki promocyjne, zgadzasz się, że nie będą one używane do przekierowywania ruchu do nieautoryzowanych witryn i że będą zgodne z zasadami AdWords, zasadami reklam YouTube, wytycznymi dla społeczności YouTube i Warunkami korzystania z usługi YouTube.

  • Właściwości związane z ustawieniami czasu wyświetlania promowanych produktów podczas odtwarzania filmu zostały przekształcone:

    • Obiekt invideoPromotion.timing został przeniesiony do invideoPromotion.items[].timing. Ten obiekt umożliwia teraz dostosowywanie danych o czasie dla każdego promowanego produktu na liście invideoPromotion.items[].

    • Nowy obiekt invideoPromotion.defaultTiming określa domyślne ustawienia czasu trwania promocji. Te ustawienia określają, kiedy promowany produkt będzie wyświetlany podczas odtwarzania jednego z filmów na Twoim kanale. Możesz zastąpić domyślny czas trwania dowolnego promowanego produktu za pomocą obiektu invideoPromotion.items[].timing.

    • Nowa właściwość invideoPromotion.items[].timing.durationMs określa czas wyświetlania promocji w milisekundach. Obiekt invideoPromotion.defaultTiming zawiera też pole durationMs, które określa domyślny czas wyświetlania promowanego produktu.

  • Właściwości invideoPromotion.items[].type i invideoPromotion.items[].videoId zostały przeniesione do obiektu invideoPromotion.items[].id.

• Metoda subscriptions.list obsługuje teraz parametry onBehalfOfContentOwner i onBehalfOfContentOwnerChannel. Oba parametry są już obsługiwane w przypadku kilku innych metod.

• W odpowiedzi interfejsu API na żądanie thumbnails.set wartość właściwości kind zmieniła się z youtube#thumbnailListResponse na youtube#thumbnailSetResponse.

• Dodaliśmy przykłady kodu dla tych metod:

  • channels.update (Java, Python)
  • playlists.insert (.NET, PHP)
  • subscriptions.insert (PHP, Python)
  • thumbnails.set (PHP, Python)
  • videos.insert (PHP)
  • videos.list (PHP)
  • videos.rate (Python)
  • videos.update (Java, PHP, Python)

  Zwróć uwagę, że usunęliśmy też przykład w języku Python dla metody playlistItems.insert, ponieważ funkcjonalność, którą demonstrował, jest teraz obsługiwana przez metodę videos.rate.

• error documentation opisuje ten nowy błąd kontekstu żądania, który może wystąpić w przypadku dowolnej metody interfejsu API obsługującej parametr żądania mine:

  Typ błędu	Szczegóły błędu	Opis
  badRequest	invalidMine	Parametru mine nie można używać w przypadku żądań, w których uwierzytelniony użytkownik jest partnerem YouTube. Musisz usunąć parametr mine, uwierzytelnić się jako użytkownik YouTube, usuwając parametr onBehalfOfContentOwner, lub działać jako jeden z kanałów partnera, podając parametr onBehalfOfContentOwnerChannel, jeśli jest on dostępny dla wywoływanej metody.

8 sierpnia 2013 r.

Ta aktualizacja zawiera następujące zmiany:

• W sekcji Wykorzystanie limitu w przewodniku Wprowadzenie do YouTube Data API wprowadziliśmy zmianę dotyczącą kosztu limitu przesyłania filmu z oko��o 16 000 jednostek na około 1600 jednostek.

30 lipca 2013 r.

Ta aktualizacja zawiera następujące zmiany:

• W zasobie channelBanner wartość właściwości kind zmieniła się z youtube#channelBannerInsertResponse na youtube#channelBannerResource. Ten zasób jest zwracany w odpowiedzi na żądanie channelBanners.insert.

• Nowa właściwość brandingSettings.channel.profileColor zasobu channel określa dominujący kolor, który uzupełnia treści na kanale. Wartość właściwości to znak funta (#) i 6-znakowy ciąg szesnastkowy, np. #2793e6.

• Interfejs API obsługuje teraz możliwość określenia, czy subskrypcja dotyczy wszystkich aktywności na kanale, czy tylko nowych przesłanych filmów. Nowa właściwość contentDetails.activityType zasobu subscription określa typy działań, o których subskrybent będzie otrzymywać powiadomienia. Prawidłowe wartości właściwości to all i uploads.

• Metoda videos.list obsługuje nowe parametry pobierania listy najpopularniejszych filmów w YouTube:

  • Parametr chart określa wykres, który chcesz pobrać. Obecnie jedyną obsługiwaną wartością jest mostPopular. Pamiętaj, że parametr chart jest parametrem filtra, co oznacza, że nie można go używać w tym samym żądaniu co inne parametry filtra (id i myRating).
  • Parametr videoCategoryId określa kategorię filmu, dla której należy pobrać wykres. Tego parametru można używać tylko w połączeniu z parametrem chart. Domyślnie wykresy nie są ograniczone do określonej kategorii.

• Nowa właściwość topicDetails.relevantTopicIds[] zasobu video zawiera listę identyfikatorów tematów w Freebase, które są związane z filmem lub jego treścią. Tematy te mogą być wspomniane w filmie lub mogą się w nim pojawiać.

• Właściwość recordingDetails.location.elevation zasobu video została zmieniona na recordingDetails.location.altitude, a właściwość fileDetails.recordingLocation.location.elevation została zmieniona na fileDetails.recordingLocation.location.altitude.

• Obiekt video zasobu contentDetails.contentRating określa oceny, jakie film otrzymał w ramach różnych systemów oceniania, w tym ocen MPAA, TVPG itp. W przypadku każdego systemu oceniania interfejs API obsługuje teraz wartość oceny, która wskazuje, że film nie został oceniony. Pamiętaj, że w przypadku ocen MPAA ocena „bez oceny” jest często używana do identyfikowania nieocenzurowanych wersji filmów, których ocenzurowana wersja otrzymała oficjalną ocenę.

• Nowa właściwość contentDetails.contentRating.ytRating zasobu video określa treści z ograniczeniem wiekowym. Wartość właściwości to ytAgeRestricted, jeśli YouTube uznał, że film zawiera treści nieodpowiednie dla użytkowników poniżej 18 roku życia. Jeśli właściwość jest nieobecna lub jej wartość jest pusta, oznacza to, że treści nie zostały zidentyfikowane jako objęte ograniczeniem wiekowym.

• Parametr mySubscribers metody channels.list został wycofany. Użyj metody subscriptions.list i jej parametru mySubscribers, aby pobrać listę subskrybentów kanału uwierzytelnionego użytkownika.

• Metody channelBanners.insert, channels.update, videos.getRating i videos.rate obsługują teraz parametr onBehalfOfContentOwner. Ten parametr wskazuje, że uwierzytelniony użytkownik działa w imieniu właściciela treści określonego w wartości parametru.

• Zaktualizowaliśmy dokumentację metody channels.update, aby odzwierciedlić fakt, że można jej używać do aktualizowania obiektu brandingSettings zasobu channel i jego właściwości podrzędnych. Dokumentacja zawiera też zaktualizowaną listę właściwości, które możesz ustawić dla obiektu invideoPromotion zasobu channel.

• error documentation opisuje te nowe błędy:

  Typ błędu	Szczegóły błędu	Opis
  forbidden	accountDelegationForbidden	Ten błąd nie jest związany z konkretną metodą API. Oznacza to, że uwierzytelniony użytkownik nie ma uprawnień do działania w imieniu określonego konta Google.
  forbidden	authenticatedUserAccountClosed	Ten błąd nie jest związany z konkretną metodą API. Oznacza to, że konto YouTube uwierzytelnionego użytkownika jest zamknięte. Jeśli użytkownik działa w imieniu innego konta Google, ten błąd oznacza, że to inne konto jest zamknięte.
  forbidden	authenticatedUserAccountSuspended	Ten błąd nie jest związany z konkretną metodą API. Oznacza to, że konto YouTube uwierzytelnionego użytkownika jest zawieszone. Jeśli użytkownik działa w imieniu innego konta Google, ten błąd oznacza, że to konto jest zawieszone.
  forbidden	authenticatedUserNotChannel	Ten błąd nie jest związany z konkretną metodą API. Oznacza to, że serwer interfejsu API nie może zidentyfikować kanału powiązanego z żądaniem do interfejsu API. Jeśli żądanie jest autoryzowane i używa parametru onBehalfOfContentOwner, należy też ustawić parametr onBehalfOfContentOwnerChannel.
  forbidden	cmsUserAccountNotFound	Ten błąd nie jest związany z konkretną metodą API. Użytkownik CMS nie może działać w imieniu określonego właściciela treści.
  notFound	contentOwnerAccountNotFound	Ten błąd nie jest związany z konkretną metodą API. Nie znaleziono podanego konta właściciela treści.
  badRequest	invalidPart	Ten błąd nie jest związany z konkretną metodą API. Parametr part w żądaniu określa części, których nie można zapisywać w tym samym czasie.
  badRequest	videoChartNotFound	Metoda videos.list zwraca ten błąd, gdy żądanie określa nieobsługiwaną lub niedostępną listę przebojów wideo.
  notFound	videoNotFound	Metoda videos.update zwraca ten błąd, aby wskazać, że nie można znaleźć filmu, który próbujesz zaktualizować. Sprawdź, czy wartość właściwości id w treści żądania jest prawidłowa.

10 czerwca 2013 r.

Ta aktualizacja zawiera następujące zmiany:

• Nowy parametr forUsername metody channels.list umożliwia pobieranie informacji o kanale przez podanie jego nazwy użytkownika w YouTube.

• Metoda activities.list obsługuje teraz parametr regionCode, który nakazuje interfejsowi API zwracanie wyników związanych z określonym krajem. YouTube używa tej wartości, gdy poprzednia aktywność autoryzowanego użytkownika w YouTube nie dostarcza wystarczających informacji do wygenerowania kanału aktywności.

• Zasoby playlist zawierają teraz właściwość snippet.tags. Właściwość będzie zwracana tylko uprawnionym użytkownikom, którzy pobierają dane o swoich playlistach. Uprawnieni użytkownicy mogą też ustawiać tagi playlisty, wywołując metody playlists.insert lub playlists.update.

• Parametr onBehalfOfContentOwner, który był wcze��niej obsługiwany w przypadku metod channels.list i search.list, jest teraz obsługiwany także w przypadku metod videos.insert, videos.update i videos.delete. Pamiętaj, że gdy ten parametr jest używany w wywołaniu metody videos.insert, żądanie musi też zawierać wartość nowego parametru onBehalfOfContentOwnerChannel, który identyfikuje kanał, do którego zostanie dodany film. Kanał musi być połączony z właścicielem treści określonym przez parametr onBehalfOfContentOwner.

  Ten parametr wskazuje, że dane uwierzytelniające autoryzacji żądania identyfikują użytkownika systemu CMS YouTube, który działa w imieniu właściciela treści określonego w wartości parametru. Konto CMS, za pomocą którego użytkownik się uwierzytelnia, musi być połączone z określonym właścicielem treści w YouTube.

  Ten parametr jest przeznaczony dla partnerów treści, którzy są właścicielami wielu różnych kanałów YouTube i nimi zarządzają. Ten parametr umożliwia partnerom jednokrotne uwierzytelnienie i uzyskanie dostępu do wszystkich danych o filmach i kanałach bez konieczności podawania danych uwierzytelniających dla każdego kanału z osobna.

  W przypadku tej wersji parametr umożliwia partnerowi treści wstawianie, aktualizowanie i usuwanie filmów na dowolnym kanale YouTube, którego jest właścicielem.

• error documentation opisuje te nowe błędy:

  Typ błędu	Szczegóły błędu	Opis
  forbidden	insufficientCapabilities	Ten błąd nie jest związany z konkretną metodą API. Oznacza to, że użytkownik systemu CMS wywołujący interfejs API nie ma wystarczających uprawnień do wykonania żądanej operacji. Ten błąd jest związany z użyciem parametru onBehalfOfContentOwner, który jest obsługiwany w przypadku kilku metod interfejsu API.
  unauthorized	authorizationRequired	Metoda activities.list zwraca ten błąd, gdy żądanie używa parametru home, ale nie jest prawidłowo autoryzowane.

• W zasobie channels usunięto właściwość invideoPromotion.channelId, ponieważ identyfikator kanału jest już określony za pomocą właściwości id zasobu.

• Nowy przewodnik Praca z identyfikatorami kanałów wyjaśnia, jak interfejs API używa identyfikatorów kanałów. Ten przewodnik może być szczególnie przydatny dla deweloperów, którzy migrują z poprzedniej wersji interfejsu API i mają aplikacje, które wysyłają żądania treści dla użytkownika default lub opierają się na założeniu, że każdy kanał w YouTube ma unikalną nazwę użytkownika, co nie jest już prawdą.

22 maja 2013 r.

Ta aktualizacja zawiera następujące zmiany:

• Nowa metoda channelBanners.insert umożliwia przesłanie obrazu banera, który można następnie ustawić jako obraz banera kanału za pomocą nowej właściwości brandingSettings.image.bannerExternalUrl zasobu channel.

• Zaktualizowaliśmy dokumentację metody channels.update, aby zawierała listę właściwości, które można modyfikować podczas wywoływania tej metody.

• W dokumentacji zasobu video nie ma już wartości unspecified jako prawidłowej wartości właściwości suggestions.processingErrors[], suggestions.processingHints[], suggestions.processingWarnings[] i suggestions.editorSuggestions[].

• Parametr maxResults metody videos.list ma teraz wartość domyślną 5.

• error documentation zawiera teraz błędy dotyczące metod channelBanners.insert i subscriptions.list. Zawiera też kilka nowych błędów w przypadku metody channels.update.

14 maja 2013 r.

Ta aktualizacja zawiera następujące zmiany:

• Na stronach samodzielnych znajdują się teraz przykłady kodu w językach Java, .NET, PHP i Ruby.

• Strona z przykładowymi kodami w Pythonie zawiera teraz przykłady dodawania subskrypcji, tworzenia playlisty i aktualizowania filmu.

10 maja 2013 r.

Ta aktualizacja zawiera następujące zmiany:

• YouTube nie identyfikuje już eksperymentalnych funkcji i usług interfejsu API. Zamiast tego udostępniamy teraz listę interfejsów API YouTube, które podlegają zasadom wycofywania.

8 maja 2013 r.

Ta aktualizacja zawiera następujące zmiany:

• Zasoby kanału obsługują teraz obiekt inVideoPromotion, który zawiera informacje o kampanii promocyjnej powiązanej z kanałem. Kanał może używać kampanii In-Video, aby wyświetlać miniatury promowanego filmu w odtwarzaczu podczas odtwarzania filmów z kanału.

  Aby pobrać te dane, w żądaniu channels.list w wartości parametru part uwzględnij invideoPromotion.

• Nowa metoda channels.update umożliwia aktualizowanie danych kampanii promocyjnej In-Video na kanale. Pamiętaj, że ta metoda obsługuje tylko aktualizacje części invideoPromotion zasobu channel i nie obsługuje jeszcze aktualizacji innych części tego zasobu.

2 maja 2013 r.

Ta aktualizacja zawiera następujące zmiany:

• Zasoby kanału obsługują teraz właściwość status.isLinked, która wskazuje, czy dane kanału identyfikują 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 wymagana w przypadku wielu działań, np. przesyłania filmów.

• Zasoby subskrypcji obsługują teraz część subscriberSnippet. Ten obiekt zawiera dane fragmentu dotyczące kanału subskrybenta.

• Interfejs API obsługuje teraz metodę videos.getRating, która pobiera oceny przyznane przez uwierzytelnionego użytkownika liście co najmniej 1 filmu.

• Nowy parametr myRating metody videos.list umożliwia pobranie listy filmów, które uwierzytelniony użytkownik ocenił jako like lub dislike.

  Parametry myRating i id są teraz uznawane za parametry filtra, co oznacza, że żądanie do interfejsu API musi zawierać dokładnie jeden z tych parametrów. (Wcześniej parametr id był wymagany w przypadku tej metody).

  W przypadku żądań, które próbują pobrać informacje o ocenie filmu, ale nie mają do tego odpowiednich uprawnień, metoda zwraca błąd forbidden.

• Wraz z wprowadzeniem parametru myRating zaktualizowaliśmy też metodę videos.list, aby obsługiwała stronicowanie. Pamiętaj jednak, że parametry stronicowania są obsługiwane tylko w przypadku żądań korzystających z parametru myRating. (Parametry i informacje dotyczące stronicowania nie są obsługiwane w przypadku żądań, które używają parametru id).

  • Parametr maxResults określa maksymalną liczbę filmów, które interfejs API może zwrócić w zestawie wyników, a parametr pageToken identyfikuje konkretną stronę w zestawie wyników, którą chcesz pobrać.

  • Zasób youtube#videoListResponse, który jest zwracany w odpowiedzi na żądanie videos.list, zawiera teraz obiekt pageInfo, który zawiera szczegóły takie jak łączna liczba wyników i liczba wyników uwzględnionych w bieżącym zestawie wyników. Zasób youtube#videoListResponse może też zawierać właściwości nextPageToken i prevPageToken, z których każda udostępnia token, który można wykorzystać do pobrania konkretnej strony w zestawie wyników.

• Metoda videos.insert obsługuje te nowe parametry:

  • autoLevels – ustaw wartość tego parametru na true, aby poinstruować YouTube, aby automatycznie poprawiał oświetlenie i kolor filmu.
  • stabilize – ustaw wartość tego parametru na true, aby poinstruować YouTube, że ma dostosować film, usuwając drgania spowodowane ruchami kamery.

• Właściwość channelTitle została dodana do snippet w przypadku tych zasobów:

  • playlistItem – właściwość określa nazwę kanału, który dodał element playlisty.
  • playlist – właściwość określa nazwę kanału, który utworzył playlistę.
  • subscription – właściwość określa nazwę subskrybowanego kanału.

• Dodaliśmy przykłady kodu dla tych metod:

  • activities.insert (Ruby)
  • playlistItems.list (.NET)
  • search.list (.NET)
  • subscriptions.insert (Java, Ruby)
  • videos.insert (.NET, Ruby)

• Nowy parametr mySubscribers metody subscriptions.list umożliwia pobranie listy subskrybentów aktualnie uwierzytelnionego użytkownika. Tego parametru można używać tylko w odpowiednio autoryzowanym żądaniu.

  Uwaga: ta funkcja ma zastąpić parametr mySubscribers, który jest obecnie obsługiwany w przypadku metody channels.list. Ten parametr zostanie wycofany.

• W zasobie video wartość właściwości unspecified nie jest już możliwa w przypadku żadnej z tych właściwości:

  • fileDetails.fileType
  • fileDetails.videoStreams[].rotation
  • processingDetails.processingStatus
  • processingDetails.processingFailureReason
  • fileDetails.fileType

• Żądania do interfejsu API, które zawierają nieoczekiwany parametr, zwracają teraz błąd badRequest, a podawana przyczyna błędu to unexpectedParameter.

• Zaktualizowaliśmy błąd, który metoda playlistItems.insert zwraca, gdy lista odtwarzania zawiera już maksymalną liczbę dozwolonych elementów. Błąd jest teraz zgłaszany jako błąd forbidden, a jego przyczyna to playlistContainsMaximumNumberOfVideos.

19 kwietnia 2013 r.

Ta aktualizacja zawiera następujące zmiany:

• Nowa metoda videos.rate umożliwia użytkownikowi ustawienie oceny like lub dislike filmu albo usunięcie oceny filmu.

  Zaktualizowaliśmy też dokumentację błędów, aby zawierała listę błędów, które interfejs API może zwrócić w odpowiedzi na wywołanie metody videos.rate.

• W dokumentacji interfejsu API miniatury są teraz identyfikowane jako osobny zasób, a nowa metoda thumbnails.set umożliwia przesyłanie niestandardowej miniatury filmu do YouTube i ustawianie jej dla filmu.

  Zaktualizowaliśmy też dokumentację błędów, aby zawierała listę błędów, które interfejs API może zwrócić w odpowiedzi na wywołanie metody thumbnails.set.

  Pamiętaj, że ta zmiana nie ma wpływu na istniejące zasoby, które zwracają miniatury. Miniatury są zwracane w tych zasobach w taki sam sposób jak wcześniej, ale w dokumentacji są teraz wymienione nazwy różnych rozmiarów miniatur, które mogą być zwracane przez interfejs API.

• Nowa część channelzasobubrandingSettings określa ustawienia, tekst i obrazy na stronie kanału i stronach odtwarzania filmów.

• Zasób playlistItem zawiera te nowe właściwości:

  • Nowy obiekt status zawiera informacje o stanie elementu playlisty, a właściwość status.privacyStatus określa stan prywatności elementu playlisty.

• Zasób video zawiera te nowe właściwości:

  • Właściwość status.publicStatsViewable wskazuje, czy rozszerzone statystyki filmu na stronie odtwarzania filmu są widoczne publicznie. Domyślnie te statystyki są widoczne, a statystyki takie jak liczba wyświetleń filmu i oceny będą nadal widoczne publicznie, nawet jeśli wartość tej właściwości jest ustawiona na false. Wartość tej właściwości możesz ustawić podczas wywoływania metody videos.insert lub videos.update.

  • Obiekt contentDetails.contentRating zawiera oceny, które film otrzymał w ramach różnych systemów oceniania. Poniższa lista zawiera obsługiwane systemy ocen oraz link do usługi powiązanej z każdym z nich. Definicje właściwości określają obsługiwane wartości oceny dla każdego systemu.

    Kraj	System ocen	Właściwość
    United States	Motion Picture Association of America (MPAA)	contentDetails.contentRating.mpaaRating
    United States	Wytyczne dla rodziców dotyczące nadzorowanego oglądania telewizji	contentDetails.contentRating.tvpgRating
    Australia	Australian Classification Board (ACB)	contentDetails.contentRating.acbRating
    Brazil	Departamento de Justiça, Classificação, Qualificação e Títulos	contentDetails.contentRating.djctqRating
    Canada	Canadian Home Video Rating System (CHVRS)	contentDetails.contentRating.chvrsRating
    France	Centre national du cinéma et de l'image animée (francuskie Ministerstwo Kultury)	contentDetails.contentRating.fmocRating
    Germany	Freiwillige Selbstkontrolle der Filmwirtschaft (FSK)	contentDetails.contentRating.fskRating
    Great Britain	British Board of Film Classification (BBFC)	contentDetails.contentRating.bbfcRating
    India	Centralna Rada ds. Certyfikacji Filmów (CBFC)	contentDetails.contentRating.cbfcRating
    Japan	映倫管理委員会 (EIRIN)	contentDetails.contentRating.eirinRating
    Korea	영상물등급위원회 (KMRB)	contentDetails.contentRating.kmrbRating
    Mexico	Generalna Dyrekcja ds. Radia, Telewizji i Kinematografii (RTC)	contentDetails.contentRating.rtcRating
    New Zealand	Office of Film and Literature Classification	contentDetails.contentRating.oflcRating
    Russia	National Film Registry of the Russian Federation	contentDetails.contentRating.russiaRating
    Spain	Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA)	contentDetails.contentRating.icaaRating

• Dokumentacja metody playlistItems.update została zaktualizowana, aby odzwierciedlać fakt, że właściwość snippet.resourceId musi być określona w zasobie wysłanym jako treść żądania.

• Metoda search.list obsługuje teraz te funkcje:

  • Nowy parametr forMine ogranicza wyszukiwanie tylko do filmów uwierzytelnionego użytkownika.

  • Parametr order obsługuje teraz możliwość sortowania wyników alfabetycznie według tytułu (order=title) lub według liczby filmów w kolejności malejącej (order=videoCount).

  • Nowy parametr safeSearch wskazuje, czy wyniki wyszukiwania powinny zawierać treści objęte ograniczeniami.

• Metoda videos.insert obsługuje kilka nowych błędów, które są wymienione w tabeli poniżej:

  Typ błędu	Szczegóły błędu	Opis
  badRequest	invalidCategoryId	Właściwość snippet.categoryId określa nieprawidłowy identyfikator kategorii. Użyj metody videoCategories.list, aby pobrać obsługiwane kategorie.
  badRequest	invalidRecordingDetails	Pole metadata zawiera nieprawidłowe szczegóły nagrania.
  badRequest	invalidVideoGameRating	Metadane żądania określają nieprawidłową ocenę gry wideo.
  badRequest	invalidVideoMetadata	Metadane żądania są nieprawidłowe.

• Parametr onBehalfOfContentOwner został usunięty z listy obsługiwanych parametrów metod videos.update i videos.delete.

12 marca 2013 r.

Ta aktualizacja zawiera następujące zmiany:

• Właściwość channelTitle została dodana do snippet w przypadku tych zasobów:

  • activity – właściwość określa nazwę kanału odpowiedzialnego za aktywność.
  • search – właściwość określa nazwę kanału powiązanego z zasobem, który jest identyfikowany przez wynik wyszukiwania.
  • video – właściwość określa nazwę kanału, na który przesłano film.

• Metoda search.list obsługuje te nowe parametry:

  • Parametr channelType umożliwia ograniczenie wyszukiwania kanałów w celu pobrania wszystkich kanałów lub tylko programów.

  • Parametr videoType umożliwia ograniczenie wyszukiwania filmów do wszystkich filmów, tylko filmów lub tylko odcinków programów.

• Definicja zasobu video w części recordingDetails została zaktualizowana. Zawiera teraz informację, że obiekt będzie zwracany w przypadku filmu tylko wtedy, gdy ustawione są dane geolokalizacyjne filmu lub czas nagrania.

• Metoda playlistItems.update zwraca teraz błąd invalidSnippet, który jest zwracany, jeśli żądanie do interfejsu API nie zawiera prawidłowego fragmentu kodu.

• Kilka metod interfejsu API obsługuje nowe parametry przeznaczone wyłącznie dla partnerów YouTube. Partnerzy treści w YouTube to studia filmowe i telewizyjne, wytwórnie płytowe oraz inni twórcy treści, którzy udostępniają swoje materiały w YouTube.

  • Parametr onBehalfOfContentOwner wskazuje, że dane uwierzytelniające żądania identyfikują użytkownika systemu CMS YouTube, który działa w imieniu właściciela treści określonego w wartości parametru. Konto CMS, za pomocą którego użytkownik się uwierzytelnia, musi być połączone z określonym właścicielem treści w YouTube.

    Ten parametr jest przeznaczony dla partnerów treści, którzy są właścicielami wielu różnych kanałów YouTube i nimi zarządzają. Ten parametr umożliwia partnerom jednokrotne uwierzytelnienie i uzyskanie dostępu do wszystkich danych o filmach i kanałach bez konieczności podawania danych uwierzytelniających dla każdego kanału z osobna.

    Ten parametr jest obsługiwany przez metody channels.list, search.list, videos.delete, videos.list i videos.update.

  • Parametr managedByMe, który jest obsługiwany przez metodę channels.list, nakazuje interfejsowi API zwrócenie wszystkich kanałów należących do właściciela treści określonego przez parametr onBehalfOfContentOwner.

  • Parametr forContentOwner, który jest obsługiwany przez metodę search.list, nakazuje interfejsowi API ograniczenie wyników wyszukiwania do zasobów należących do właściciela treści określonego przez parametr onBehalfOfContentOwner.

25 lutego 2013 r.

Ta aktualizacja zawiera następujące zmiany:

• Interfejs API obsługuje kilka nowych części i właściwości zasobów video:

  • Nowe sekcje fileDetails, processingDetails i suggestions zawierają informacje dla właścicieli filmów o przesłanych przez nich materiałach. Te dane są bardzo przydatne w aplikacjach, które umożliwiają przesyłanie filmów, i obejmują:

    • stan przetwarzania i postęp,
    • błędy lub inne problemy napotkane podczas przetwarzania filmu;
    • dostępność miniatur,
    • sugestie dotyczące poprawy jakości filmu lub metadanych;
    • szczegóły oryginalnego pliku przesłanego do YouTube,

    Wszystkie te części może pobrać tylko właściciel filmu. Lista poniżej zawiera krótki opis nowych części, a dokumentacja zasobu video definiuje wszystkie właściwości, które zawiera każda część.

    • Obiekt fileDetails zawiera informacje o pliku wideo przesłanym do YouTube, w tym rozdzielczość pliku, czas trwania, kodeki audio i wideo, szybkość transmisji strumieniowej i inne.

    • Obiekt processingProgress zawiera informacje o postępach YouTube w przetwarzaniu przesłanego pliku wideo. Właściwości obiektu określają bieżący stan przetwarzania i szacują czas pozostały do zakończenia przetwarzania filmu przez YouTube. W tej części znajdziesz też informację, czy dla filmu są dostępne różne typy danych lub treści, takie jak szczegóły pliku lub miniatury.

      Ten obiekt jest przeznaczony do odpytywania, aby osoba przesyłająca film mogła śledzić postępy YouTube w przetwarzaniu przesłanego pliku wideo.

    • Obiekt suggestions zawiera sugestie, które wskazują możliwości poprawy jakości filmu lub metadanych przesłanego filmu.

  • Część contentDetails zawiera 4 nowe właściwości. Te usługi można pobierać za pomocą nieuwierzytelnionych żądań.

    • dimension – wskazuje, czy film jest dostępny w 2D czy 3D.
    • definition – określa, czy film jest dostępny w standardowej czy wysokiej rozdzielczości.
    • caption – wskazuje, czy napisy są dostępne w filmie.
    • licensedContent – wskazuje, czy film zawiera treści, do których prawa zgłosił partner YouTube.

  • Część status zawiera 2 nowe usługi. Właściciele filmów mogą ustawić wartości obu tych właściwości podczas wstawiania lub aktualizowania filmu. Te właściwości można też pobierać za pomocą nieuwierzytelnionych żądań.

    • embeddable – wskazuje, czy film można umieścić w innej witrynie.
    • license – określa licencję filmu. Prawidłowe wartości to creativeCommon i youtube.

• Definicja parametru part została zaktualizowana w przypadku metod videos.list, videos.insert i videos.update, aby uwzględniała nowo dodane części opisane powyżej, a także część recordingDetails, która została przypadkowo pominięta.

• Nowa właściwość contentDetails.googlePlusUserId zasobu channel określa identyfikator profilu Google+ powiązanego z kanałem. Tej wartości można użyć do wygenerowania linku do profilu Google+.

• Każdy obiekt miniatury zawiera teraz szerokość i wysokość obrazu. Obecnie miniatury są zwracane w zasobach activity, channel, playlist, playlistItem, search result, subscription i video.

• playlistItems.list obsługuje teraz parametr videoId, którego można używać w połączeniu z parametrem playlistId, aby pobierać tylko element playlisty reprezentujący określony film.

  Jeśli film, który identyfikuje parametr, nie zostanie znaleziony na playliście, interfejs API zwróci błąd notFound.

• W dokumentacji błędów opisano nowy błąd forbidden, który oznacza, że żądanie nie jest odpowiednio autoryzowane do wykonania żądanej czynności.

• Właściwość snippet.channelId zasobu channel została usunięta. Właściwość id zasobu ma tę samą wartość.

30 stycznia 2013 r.

Ta aktualizacja zawiera następujące zmiany:

• Na nowej stronie błędów znajdziesz listę błędów, które może zwracać interfejs API. Strona zawiera ogólne błędy, które mogą występować w przypadku wielu różnych metod interfejsu API, a także błędy specyficzne dla poszczególnych metod.

16 stycznia 2013 r.

Ta aktualizacja zawiera następujące zmiany:

• Przykłady kodu są teraz dostępne w przypadku metod i języków wymienionych na liście poniżej:

  • activities.insert – Java
  • playlistItems.insert – Python
  • playlistItems.list – Java, JavaScript, PHP, Python, Ruby
  • playlists.insert – Java, JavaScript, Python
  • search.list – Java, JavaScript, Python, Ruby
  • videos.insert – Java

• activity Zasób może teraz zgłaszać channelItem działanie, które występuje, gdy YouTube dodaje film do automatycznie wygenerowanego kanału w YouTube. (Algorytm YouTube identyfikuje tematy, które cieszą się na naszej platformie dużą popularnością, i automatycznie generuje dla nich kanały).

• Zaktualizowaliśmy te parametry search.list:

  • Parametr q nie jest już oznaczony jako filtr, co oznacza, że…
  • Parametr relatedToVideo nosi teraz nazwę relatedToVideoId.
  • Parametr published został zastąpiony 2 nowymi parametrami: publishedAfter i publishedBefore, które zostały opisane poniżej.

• Metoda search.list obsługuje te nowe parametry:

  Nazwa parametru	Wartość	Opis
  channelId	string	Zwraca zasoby utworzone przez określony kanał.
  publishedAfter	datetime	Zwraca zasoby utworzone po określonym czasie.
  publishedBefore	datetime	Zwraca zasoby utworzone przed określonym czasem.
  regionCode	string	Zwraca zasoby dla określonego kraju.
  videoCategoryId	string	Filtruj wyniki wyszukiwania filmów, aby uwzględniać tylko te, które są powiązane z określoną kategorią filmu.
  videoEmbeddable	string	Filtruj wyniki wyszukiwania filmów, aby uwzględniać tylko te, które można odtworzyć w odtwarzaczu umieszczonym na stronie internetowej. Aby pobrać tylko filmy, które można umieścić na stronie, ustaw wartość parametru na true.
  videoSyndicated	string	Filtruj wyniki wyszukiwania filmów, aby uwzględniać tylko te, które można odtwarzać poza YouTube.com. Aby pobrać tylko filmy udostępniane na licencji, ustaw wartość parametru na true.

• Kilka zasobów interfejsu API obsługuje nowe właściwości. W tabeli poniżej znajdziesz listę zasobów i ich nowych właściwości:

  Zasób	Nazwa usługi	Wartość	Opis
  activity	contentDetails.playlistItem.playlistItemId	string	Identyfikator elementu na playliście, który YouTube przypisał, aby jednoznacznie identyfikować element na playliście.
  activity	contentDetails.channelItem	object	Obiekt zawierający informacje o zasobie dodanym do kanału. Ta właściwość jest obecna tylko wtedy, gdy element snippet.type ma wartość channelItem.
  activity	contentDetails.channelItem.resourceId	object	Obiekt, który identyfikuje zasób dodany do kanału. Podobnie jak inne resourceId właściwości zawiera ona właściwość kind, która określa typ zasobu, np. film lub playlista. Zawiera też dokładnie jedną z kilku właściwości – videoId, playlistId itp. – która określa identyfikator jednoznacznie identyfikujący ten zasób.
  channel	status	object	Ten obiekt zawiera informacje o stanie prywatności kanału.
  channel	status.privacyStatus	string	stan prywatności kanału, Prawidłowe wartości to private i public.
  playlist	contentDetails	object	Ten obiekt zawiera metadane dotyczące treści playlisty.
  playlist	contentDetails.itemCount	unsigned integer	Liczba filmów na playliście.
  playlist	player	object	Ten obiekt zawiera informacje, które umożliwiają odtwarzanie playlisty w odtwarzaczu umieszczonym na stronie.
  playlist	player.embedHtml	string	Tag <iframe>, który umieszcza odtwarzacz wideo odtwarzający playlistę.
  video	recordingDetails	object	Ten obiekt zawiera informacje, które identyfikują lub opisują miejsce i czas nagrania filmu.
  video	recordingDetails.location	object	Ten obiekt zawiera informacje o geolokalizacji powiązane z filmem.
  video	recordingDetails.location.latitude	double	Szerokość geograficzna w stopniach.
  video	recordingDetails.location.longitude	double	Długość geograficzna w stopniach.
  video	recordingDetails.location.elevation	double	Wysokość nad ziemią w metrach.
  video	recordingDetails.locationDescription	string	opis tekstowy miejsca, w którym nagrano film.
  video	recordingDetails.recordingDate	datetime	Data i godzina nagrania filmu. Wartość jest podana w formacie ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).

• W dokumentacji kilku metod interfejsu API znajdują się teraz informacje o właściwościach, które muszą być określone w treści żądania lub które są aktualizowane na podstawie wartości w treści żądania. W tabeli poniżej znajdziesz listę tych metod oraz wymagane i modyfikowalne właściwości.

  Uwaga: w dokumentacji innych metod mogą już być wymienione wymagane i modyfikowalne właściwości.

  Metoda	Właściwości
  activities.insert	Właściwości wymagane: snippet.description Właściwości, które można modyfikować: snippet.description contentDetails.bulletin.resourceId
  playlists.update	Właściwości wymagane: id
  playlistItems.update	Właściwości wymagane: id
  videos.update	Właściwości wymagane: id

• Interfejs API nie zgłasza już błędu playlistAlreadyExists, jeśli spróbujesz utworzyć lub zaktualizować playlistę, która miałaby taki sam tytuł jak playlista, która już istnieje na tym samym kanale.

• Kilka metod API obsługuje nowe typy błędów. W tabeli poniżej znajdziesz metodę i nowo obsługiwane błędy:

  Metoda	Typ błędu	Szczegóły błędu	Opis
  guideCategories.list	notFound	notFound	Nie można znaleźć kategorii przewodnika określonej przez parametr id. Aby pobrać listę prawidłowych wartości, użyj metody guideCategories.list.
  playlistItems.delete	forbidden	playlistItemsNotAccessible	Żądanie nie jest odpowiednio autoryzowane do usunięcia określonego elementu playlisty.
  videoCategories.list	notFound	videoCategoryNotFound	Nie można znaleźć kategorii filmu określonej przez parametr id. Aby pobrać listę prawidłowych wartości, użyj metody videoCategories.list.