Изменения в комментариях в устаревшей версии YouTube Data API v2.

Джереми Уокер, команда YouTube API
Сентябрь 2013 г. (обновлено 02.12.2013)

Введение

Новая система комментариев YouTube , запущенная в ноябре 2013 года и работающая на базе Google+, позволяет пользователям YouTube получать гораздо больше комментариев к каждому видео, чем раньше. Новая система также упрощает поиск содержательных разговоров, поскольку комментарии упорядочены по значимости для отдельных пользователей.

Хотя новые комментарии в настоящее время не поддерживаются в API данных YouTube v3, вы можете продолжать использовать старую версию API (v2) с некоторыми оговорками, изложенными ниже (и преимуществами, описанными выше).

Мы рекомендуем вам подтвердить, что ваша интеграция продолжает работать теперь, когда мы перешли на новую систему комментирования, и предупреждать нас, если вы обнаружите какие-либо ошибки ( проблемы с файлами на youtube.com/dev ). Спасибо!

Часто задаваемые вопросы

Что случилось с комментариями, опубликованными до перехода?

Комментарии, опубликованные до перехода, были перенесены в новую систему на базе Google+.

Лента комментариев еще доступна?

Да, например, если вы используете API для получения комментариев к видео , вы получаете поток комментариев, упорядоченных по релевантности, как указано в объявлении .* После перехода на новую систему комментирования комментарии больше не располагаются в хронологическом порядке. заказ по умолчанию. Однако вы все равно можете упорядочить комментарии в хронологическом порядке, установив значение параметра orderby published в вашем запросе API, как показано в следующем примере:

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

Мы рекомендуем вам следовать стандартной передовой практике использования ссылок next и previous в ленте комментариев для пролистывания комментариев. Поступая таким образом, вы также получите дополнительное преимущество, заключающееся в возможности просматривать гораздо больше комментариев, чем раньше.

Если вы явно задали значение для start-index для пролистывания ленты комментариев (не рекомендуется), это может привести к нестабильному поведению, и вы получите лишь небольшое количество возвращенных комментариев.

Обновление (10.11.2013):

* По умолчанию каналы комментариев сортируются по общей значимости, а не по личной значимости. Другими словами, аутентифицированный и неаутентифицированный запрос ленты комментариев вернет одни и те же результаты. API поддерживает персонализированную ленту комментариев, включающую закрытые публикации. Чтобы получить этот канал, просто сделайте запрос с аутентификацией и установите значение true для параметра relevant-to-me в вашем запросе API, как показано в следующем примере: 

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

Есть ли фид, демонстрирующий формат нового фида?

Все каналы комментариев теперь поддерживают новый формат. Некоторые примеры приведены ниже.

  • Лента на основе релевантности: 
    http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true
  • Лента в хронологическом порядке: 
    http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true&orderby=published

Могу ли я по-прежнему создать комментарий через API?

Да, но для написания новых комментариев с помощью API v2 существует несколько требований:

  1. Аутентифицированный пользователь должен иметь канал YouTube, связанный с учетной записью Google+ ( детали API ).
  2. Запрос должен быть отправлен по протоколу HTTPS (текущие версии устаревших клиентских библиотек поддерживают это по умолчанию).

Если какое-либо из этих требований не выполнено, API возвращает ошибку.

Комментарии в Google+ поддерживают цепочку сообщений. Что это означает для ответов на комментарии YouTube?

Ответы на комментарии, оставленные до перехода, теперь отображаются как обычные комментарии. Кроме того, больше не поддерживается прямой ответ на комментарии через API YouTube. В настоящее время невозможно ответить на комментарий в новом стиле через API YouTube.

Ответы на комментарии YouTube в новом стиле через сайты и приложения YouTube и Google+ не возвращаются с помощью фида комментариев устаревшего API. Однако вы можете получить фактические ответы через API Google+.

Если запись в ленте комментариев YouTube представляет собой комментарий нового стиля, она содержит тег <yt:googlePlusUserId> . Если этот тег присутствует и на комментарий есть ответы (просто проверьте элемент <yt:replyCount>), вы можете проанализировать идентификатор активности Google+ из тега <id> записи. Вы можете использовать этот идентификатор для вызова метода comment:list API Google+, чтобы получить список последних ответов на этот комментарий.

В приведенном ниже отрывке показано, как идентификатор активности Google+, выделенный жирным шрифтом, отображается в записи ленты комментариев:

<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>

Что происходит в Google+, когда я оставляю комментарий через API YouTube?

Оставление комментария через API YouTube не создает публикацию в вашей ленте Google+ и не создает уведомление Google+.

Продолжают ли комментарии отображаться в ленте активности после перехода на новую систему комментариев?

Нет, не в этот раз.

Продолжает ли SUP в устаревшем API работать с комментариями?

Нет, не для комментариев. SUP опирается на ленту активности пользователей. Поскольку комментариев больше нет в ленте активности, они не отображаются в SUP.