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ż znajdowanie wartościowych rozmów, ponieważ komentarze są uporządkowane według trafności dla poszczególnych użytkowników.

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

Po przejściu na nowy system komentarzy warto potwierdzić, że integracja działa nadal. Jeżeli natrafisz na błędy (zgłoś problemy na stronie youtube.com/dev), poinformuj nas o tym. 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 kanał komentarzy jest nadal dostępny?

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. Nadal możesz jednak posortować komentarze chronologicznie, ustawiając wartość parametru orderby w żądaniu do interfejsu API na published, jak pokazano 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 będziesz mieć też możliwość przeglądania znacznie większej liczby komentarzy niż wcześniej.

Jeśli wyraźnie ustawisz wartość parametru start-index tak, by obejmowała strony w kanale komentarzy (niezalecane), może to spowodować niespójne działanie i zwrócić niewielką liczbę komentarzy.

Aktualizacja (10 listopada 2013 r.):

* 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, który obejmuje posty niepubliczne. Aby uzyskać ten plik danych, wystarczy wysłać uwierzytelnione żądanie i ustawić w nim wartość parametru relevant-to-me na true, jak pokazano w tym przykładzie: 

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

Czy dostępny jest plik danych, który pokazuje format nowego pliku danych?

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

  • Plik danych oparty na trafności: 
    http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true
  • Kanał oparty na chronologii: 
    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 móc pisać nowe komentarze za pomocą interfejsu API w wersji 2, należy spełnić kilka wymagań:

  1. Uwierzytelniony użytkownik musi mieć kanał YouTube połączony z kontem Google+ (szczegóły interfejsu API).
  2. Żądanie musi być wysyłane przez HTTPS (bieżące wersje starszych bibliotek klienta obsługują tę funkcję 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. Rzeczywiste odpowiedzi można jednak uzyskać przez interfejsy API Google+.

Jeśli wpis w kanale komentarzy YouTube dotyczy komentarza w nowym stylu, zawiera on tag <yt:googlePlusUserId>. Jeśli ten tag jest obecny i komentarz zawiera odpowiedzi (sprawdź element <yt:replyCount>), możesz przeanalizować identyfikator aktywności w 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.

Ten fragment pokazuje, jak identyfikator aktywności w Google+ (pogrubiony tekst) jest wyświetlany w wpisie w kanale 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ę stanie w Google+, gdy dodam komentarz przez interfejs API YouTube?

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

Czy komentarze nadal będą wyświetlane w kanale aktywności od czasu przejścia na nowy system komentowania?

Nie teraz.

Czy SUP w starszym interfejsie API nadal działa z komentarzami?

Nie, nie w przypadku komentarzy. SUP korzysta z pliku danych o aktywności użytkowników. Komentarze nie są już widoczne w sekcji aktywności, więc nie wyświetlają się na SUP.