Zmiany w komentarzach w starszej wersji YouTube Data API w wersji 2

Jeremy Walker, zespół YouTube API
wrzesień 2013 r. (aktualizacja 02.12.2013 r.)

Wprowadzenie

Nowy system komentowania w YouTube, który został uruchomiony w listopadzie 2013 roku i jest oparty na Google+, umożliwia użytkownikom YouTube pobieranie znacznie większej liczby komentarzy do filmów niż w przeszłości. Nowy system ułatwia też wyszukiwanie wartościowych rozmów, ponieważ komentarze są uporządkowane według trafności względem poszczególnych użytkowników.

Chociaż nowe komentarze nie są obecnie obsługiwane w interfejsie YouTube Data API v3, możesz nadal korzystać ze starszej wersji interfejsu API (v2) z kilkoma zastrzeżeniami opisanymi poniżej (i korzyściami opisanymi powyżej).

Zalecamy sprawdzenie, czy integracja nadal działa prawidłowo po przejściu na nowy system komentarzy, i powiadomienie nas o wszelkich błędach (problemy z plikami na stronie youtube.com/dev). Dziękujemy!

Najczęstsze pytania

Co się stało z komentarzami opublikowanymi przed przeniesieniem?

Komentarze opublikowane przed migracją zostały przeniesione do nowego systemu opartego na Google+.

Czy karta komentarzy jest nadal dostępna?

Tak, jeśli na przykład użyjesz interfejsu API do pobierania komentarzy do filmu, otrzymasz kanał komentarzy uporządkowanych według trafności zgodnie z informacjami podanymi w ogłoszeniu*. Od czasu przejścia na nowy system komentarzy komentarze nie są już domyślnie wyświetlane w kolejności chronologicznej. Możesz jednak uporządkować komentarze chronologicznie, ustawiając w prośbie o wyświetlenie danych w interfejsie API wartość parametru orderby na published, jak w tym przykładzie:

https://gdata.youtube.com/feeds/api/videos/VIDEO_ID/comments?orderby=published

Zalecamy stosowanie standardowych sprawdzonych metod, czyli używanie linków next i previous w strumieniach komentarzy, aby przekierowywać użytkowników na stronę. Dzięki temu zyskasz też możliwość przeglądania znacznie większej liczby komentarzy niż dotychczas.

Jeśli jawnie ustawisz wartość start-index, aby przejść do kolejnego poziomu w strumieniach komentarzy (nie zalecane), może to spowodować niespójności i zwrócenie tylko niewielkiej liczby komentarzy.

Aktualizacja (10.11.2013):

* Domyślnie kanały komentarzy są sortowane według ogólnej trafności, a nie trafności dla danego użytkownika. Innymi słowy, żądanie pliku danych z komentarzami z uwierzytelnieniem i bez uwierzytelnienia zwróci te same wyniki. Interfejs API obsługuje spersonalizowany kanał komentarzy zawierający niepubliczne posty. Aby uzyskać ten plik danych, wystarczy wysłać uwierzytelnione żądanie i ustawić wartość parametru relevant-to-me na true w żądaniu interfejsu API, jak pokazano w tym przykładzie: 

https://gdata.youtube.com/feeds/api/videos/VIDEO_ID/comments?relevant-to-me=true

Czy masz plik danych, który pokazuje format nowego pliku danych?

Wszystkie pliki danych z komentarzami obsługują teraz nowy format. Poniżej znajdziesz kilka przykładów.

  • Kanał oparty na trafności: 
    http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true
  • Plik danych uporządkowany chronologicznie: 
    http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true&orderby=published

Czy nadal mogę tworzyć komentarze za pomocą interfejsu API?

Tak, ale aby dodawać nowe komentarze za pomocą interfejsu API w wersji 2, musisz spełnić kilka wymagań:

  1. Zalogowany użytkownik musi mieć kanał w YouTube połączony z kontem Google+ (szczegóły interfejsu API).
  2. Żądanie musi być wysyłane przez HTTPS (obecne wersje starszych bibliotek klienta obsługują to domyślnie).

Jeśli którykolwiek z tych wymagań nie zostanie spełniony, interfejs API zwróci błąd.

Komentarze w Google+ są wątekowane. Co to oznacza dla odpowiedzi na komentarze w YouTube?

Odpowiedzi na komentarze dodane przed tą zmianą będą widoczne jako zwykłe komentarze. Ponadto odpowiadanie bezpośrednio na komentarze za pomocą interfejsu YouTube API nie jest już obsługiwane. Obecnie nie można odpowiadać na komentarze nowego typu za pomocą interfejsu API YouTube.

Odpowiedzi na komentarze w nowym formacie w YouTube za pomocą witryn i aplikacji YouTube oraz Google+ nie są zwracane w kanałach komentarzy starszego interfejsu API. Możesz jednak uzyskać rzeczywiste odpowiedzi za pomocą interfejsów Google+ API.

Jeśli wpis w kanał komentarzy w YouTube reprezentuje komentarz nowego typu, zawiera on tag <yt:googlePlusUserId>. Jeśli ten tag jest dostępny, a komentarz zawiera odpowiedzi (sprawdź element <yt:replyCount>), możesz przeanalizować identyfikator aktywności Google+ z tagu <id> wpisu. Możesz użyć tego identyfikatora, aby wywołać metodę comments:list interfejsu Google+ API i uzyskać listę najnowszych odpowiedzi na ten komentarz.

Poniżej możesz zobaczyć, jak identyfikator aktywności w Google+ (wyróżniony pogrubioną czcionką) pojawia się w rekordzie w sekcji komentarzy:

<entry>
  <id>tag:youtube,2008:video:xpI6VNvRTII:comment:z13rtnibotmidjggs04cdvzgvurngv3pwnw0k</id>
  <yt:googlePlusUserId>123456789</yt:googlePlusUserId>
  <yt:replyCount>4</yt:replyCount>
  <yt:channelId>UCxxxx_xxxxx</yt:channelId>
  ...
</entry>

Co się dzieje w Google+, gdy dodaję komentarz za pomocą interfejsu YouTube API?

Dodanie komentarza za pomocą interfejsu YouTube API nie powoduje wyświetlenia postu w strumieniu Google+ ani nie powoduje wysłania powiadomienia w Google+.

Czy po przejściu na nowy system komentarzy komentarze nadal pojawiają się na kanale aktywności?

Nie teraz.

Czy SUP w starszym interfejsie API nadal działa w przypadku komentarzy?

Nie, nie w przypadku komentarzy. SUP korzysta z pliku danych o aktywności użytkowników. Ponieważ komentarze nie są już widoczne w strumieniach aktywności, nie pojawiają się w SUP.