以前の YouTube Data API v2 におけるコメントの変更

YouTube API チーム Jeremy Walker
2013 年 9 月(2013 年 12 月 2 日更新)

はじめに

2013 年 11 月にリリースされた Google+ の新しい YouTube コメント システムでは、YouTube のユーザーが以前よりも多くのコメントを動画ごとに取得できます。新しいシステムでは、コメントは個々のユーザーの関連性で並べ替えられるため、有意義な会話を簡単に見つけることができます。

新しいコメントは現在 YouTube Data API v3 でサポートされていませんが、引き続き以前のバージョンの API(v2)を使用できますが、以下のようにいくつかの注意点があります。

新しいコメント システムに切り替えたことで、統合が引き続き機能することを確認できるほか、バグ(youtube.com/devファイルに関する問題)が発生した場合に Google までお知らせください。よろしくお願いいたします。

よくある質問

移行前に投稿されたコメントはどうなったのですか?

移行前に投稿されたコメントは、Google+ から新しいシステムに移行されます。

コメント フィードは引き続き利用できますか?

はい。たとえば、API を使用して動画のコメントを取得している場合は、お知らせで説明されているように、コメントの関連度順のフィードを取得できます*。新しいコメント システムに切り替えたことで、コメントはデフォルトでは時系列ではなくなりました。次の例に示すように、API リクエストで orderby パラメータの値を published に設定することで、コメントを時系列で並べ替えることができます。

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

コメント フィードで next リンクと previous リンクを使用し、コメントを通じてページを設定するという標準的な方法に従うことをおすすめします。そうすることで、以前よりも多くのコメントをページ表示できるというメリットも得られます。

コメント フィードを使用してページを表示するように start-index の値を明示的に設定すると(推奨されません)、動作に一貫性がなくなる可能性があり、返されるコメントはごくわずかになります。

更新(2013 年 11 月 10 日):

* デフォルトでは、コメント フィードは個人の関連性ではなく、一般的な関連性を基準に並べ替えられます。つまり、認証されたコメント フィード リクエストと未認証のコメント フィード リクエストは同じ結果を返します。この API は、非公開の投稿を含むパーソナライズされたコメント フィードをサポートしています。このフィードを取得するには、次の例に示すように、API リクエストで認証済みリクエストを行い、relevant-to-me パラメータの値を true に設定します。

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 経由でコメントは引き続き作成できますか?

はい。ただし、v2 API を使用して新しいコメントを作成するには、いくつかの要件があります。

  1. 認証されたユーザーは Google+ アカウントにリンクされている YouTube チャンネルを持っている必要があります(API の詳細)。
  2. リクエストは HTTPS 経由で送信する必要があります(レガシー クライアント ライブラリの現在のバージョンでは、デフォルトでサポートされています)

これらの要件のいずれかが満たされない場合、API からエラーが返されます。

Google+ を使用したコメントはスレッド形式です。YouTube のコメントの返信にはどのような影響がありますか?

移行前に投稿されたコメントへの返信は、通常のコメントとして表示されます。また、YouTube API によるコメントへの直接返信はサポートされなくなりました。現時点では、YouTube API で新しいスタイルのコメントに返信する方法はありません。

YouTube および Google+ のサイトとアプリからの新しいスタイルの YouTube コメントに返信しても、以前の API のコメント フィードでは返されません。ただし、実際の返信は Google+ API 経由で取得できます。

YouTube のコメント フィード エントリが新しいスタイルのコメントを表している場合、そのエントリには <yt:googlePlusUserId> タグが含まれます。このタグがあり、コメントに返信がある場合(<yt:replyCount> 要素のみを確認します)は、エントリの <id> タグから Google+ アクティビティ ID を解析できます。この ID を使用して Google+ API の comments:list メソッドを呼び出し、該当するコメントに対する最近の返信のリストを取得できます。

以下の抜粋は、コメント フィード エントリに Google+ のアクティビティ ID が太字で表示されていることを示しています。

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

YouTube API を使用してコメントを投稿すると、Google+ でどうなりますか。

YouTube API でコメントを行っても、Google+ ストリームで投稿が生成されたり、Google+ 通知を作成したりすることはありません。

新しいコメント システムに切り替えても、アクティビティ フィードには引き続きコメントが表示されますか?

いいえ、現時点では有効にしません。

以前の API の SUP は引き続きコメントで使用できますか?

いいえ、コメントはありません。SUP はユーザー アクティビティ フィードを利用しています。アクティビティ フィードにはコメントが表示されなくなったため、コメントは SUP に表示されません。