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

Jeremy Walker, zespół YouTube API
Wrzesień 2013 r. (zaktualizowany 02.12.2013 r.)

Wprowadzenie

Nowy system komentowania w YouTube, wprowadzony w listopadzie 2013 r. i oparty na technologii Google+, umożliwia użytkownikom YouTube pobieranie znacznie większej liczby komentarzy do filmu niż w przeszłości. Nowy system ułatwia także znajdowanie interesujących rozmów, ponieważ komentarze są uporządkowane według trafności dla poszczególnych użytkowników.

Nowe komentarze nie są obecnie obsługiwane w YouTube Data API v3, ale możesz nadal korzystać ze starszej wersji (2) z kilkoma zastrzeżeniami opisanymi poniżej (oraz korzyściami opisanymi powyżej).

Potwierdź, że integracja działa nadal, ponieważ wprowadziliśmy nowy system komentowania, i powiadom nas o błędach (problemy z plikami na youtube.com/dev). Dziękujemy!

Najczęstsze pytania

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

Komentarze przesłane przed przeniesieniem zostały przeniesione do nowego systemu opartego na Google+.

Czy kanał komentarzy jest nadal dostępny?

Tak. Jeśli używasz np. interfejsu API do pobierania komentarzy do filmu, otrzymasz kanał komentarzy uporządkowanych według trafności, jak wspomniano w ogłoszeniu*. Od momentu przejścia na nowy system komentowania komentarze nie są już domyślnie uporządkowane chronologicznie. Nadal możesz jednak uporządkować komentarze chronologicznie, ustawiając wartość parametru orderby na published w żądaniu do interfejsu API, jak w tym przykładzie:

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

Zalecamy stosowanie standardowych sprawdzonych metod korzystania z linków next i previous w pliku danych w komentarzach. W ten sposób skorzystasz z większej liczby komentarzy, niż było to możliwe wcześniej.

Jeśli bezpośrednio ustawisz wartość parametru start-index na stronę komentarzy (niezalecane), może to spowodować niespójne działanie i otrzymać niewielką liczbę komentarzy.

Aktualizacja (10.11.2013 r.):

* Domyślnie kanały komentarzy są sortowane według ogólnej trafności, a nie osobistej. Oznacza to, że uwierzytelnione i nieuwierzytelnione żądanie kanału komentarzy 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ć wartość parametru relevant-to-me na true w żądaniu interfejsu API, jak w tym przykładzie: 

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

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

Wszystkie pliki danych z komentarzami obsługują teraz ten 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
  • Kanał oparty na danych chronologicznych: 
    http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true&orderby=published

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

Tak. Jeśli jednak chcesz tworzyć nowe komentarze za pomocą interfejsu API w wersji 2, musisz spełnić te wymagania:

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

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

Komentarze obsługiwane przez Google+ pozwalają na wątki. Co to oznacza dla komentarzy w YouTube?

Odpowiedzi na komentarze przesłane przed przeniesieniem są teraz wyświetlane jako zwykłe komentarze. Oprócz tego nie można już odpowiadać bezpośrednio na komentarze przy użyciu interfejsu API YouTube. Obecnie nie ma możliwości odpowiadania na komentarze w nowym stylu przez interfejs YouTube API.

Odpowiedzi na komentarze nowego typu w YouTube oraz na stronach i w aplikacjach Google+ nie są zwracane za pomocą kanału komentarzy do starszej wersji interfejsu API. Rzeczywiste odpowiedzi możesz jednak uzyskać za pomocą interfejsów API Google+.

Jeśli wpis w komentarzu w YouTube reprezentuje komentarz w nowym stylu, zawiera on tag <yt:googlePlusUserId>. Jeśli ten tag jest obecny, a komentarz zawiera odpowiedzi (tylko sprawdź element <yt:replyCount>), możesz przeanalizować identyfikator aktywności Google+ z tagu <id> wpisu. Możesz go użyć do wywołania metody comments:list interfejsu API Google+ w celu pobrania listy ostatnich odpowiedzi na ten komentarz.

Fragment kodu poniżej pokazuje, jak identyfikator działania Google+ (pogrubiony poniżej) wyświetla się w polu komentarza:

<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 z Google+ podczas dodawania komentarza przez interfejs YouTube API?

Dodanie komentarza w interfejsie YouTube API nie powoduje wygenerowania posta w strumieniu Google+ ani powiadomienia w Google+.

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

Nie teraz.

Czy SUP w starszej wersji interfejsu API nadal działa w komentarzach?

Nie. SUP korzysta z kanału aktywności użytkownika. Komentarze nie są już widoczne na karcie aktywności, więc nie są widoczne w SUP.