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 を使用して新しいコメントを作成するには、いくつかの要件があります。
- 認証されたユーザーは Google+ アカウントにリンクされている YouTube チャンネルを持っている必要があります(API の詳細)。
- リクエストは 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 に表示されません。