Youtube API数据类型

数据类型

Activitys

Activity资源包含了特定频道或用户的所有活动信息，包括打分、分享、喜爱、上传视频等等。每个Activity资源标识出了动作类型、频道或其他资源。

Captions //TODO

Caption资源类似于一段说明，一个视频只能有一个说明。

ChannelBanners

ChannelBanners资源包含一个频道最新上传的图片资源，即为频道封面。

ChannelSections //TODO

ChannelSection 资源包含了一个视频集合信息。

Channels

Channel资源就是YouTube里的频道。

CommentThreads

评论线资源，评论线是指一个顶级评论和其回复。频道Channle和视频Video都可以有评论线。

顶级评论和回复其实都是嵌套在一条评论线中的评论Comment。一条评论线没有必要包含一条评论的所有回复，因此如果需要列出评论的所有回复的话，可以使用comments.list 方法。要注意有些评论没有回复。

Comments

评论资源指的是一条简单的YouTube评论。频道和视频都具有评论。需要注意的是，评论分为顶级评论Top-level coment和回复reply。

GuideCategories

向导分类，包含了基于频道内容、频道流行度或其他算法的分类。这个列表有点类似于视频分类，不同的是，视频分类可以由视频上传者指定，但频道向导分类只能由YouTube来指定。

I18nLanguages

国际化语言，包含了YouTube网站支持的应用语言，应用语言也可以被当做UI语言来使用。对于YouTube网站来说，应用语言可以自动的根据Google账户设置、浏览器语言或者IP地址来决定。用户也可以在YouTube网站页脚手动的设置自己所希望的UI语言。

每个国际化资源定义了一个language code和一个名字。language code可以被调用api时使用。

I18nRegions

国际化地区，标识了YouTube用户的地理位置，用户可以选择其作为内容位置。内容位置content region可以当做内容区域content locale。对于YouTube网站来说，一个内容位置可以自动的被YouTube域名或者用户IP试探性地设置。用户也可以手动地在网站页脚设置他想要的内容区域。

PlaylistItems

播放列表实体，表示另一个资源，比如包含在播放列表里的视频video。某种程度上来说，播放列表实体是描述一个资源，此资源包含在播放列表中如何使用的信息。

YouTube使用播放列表来标识特定的视频或频道集合，比如：
-上传的视频
-喜爱的视频
-顶的视频
-观看历史
-稍后观看

再详细一点，这些列表与频道关联，频道是一个人、一个群组、一个公司的视频、播放列表和其他信息的集合。

你可以从一个已知的频道中检索播放列表的ID。你可以使用 playlistItems.list 方法来检索list。你也可以使用playlistItems.insert 和playlistItems.delete添加或删除实体。举例来说，如果用户标记了一个视频为喜爱视频，你可以插入这个视频到喜爱视频播放列表中。

Playlists

播放列表，播放列表是一堆视频的的集合，这些视频可以顺序浏览也可以分享给其他用户。一个播放列表最多可以存放200个视频，而且YouTube也没用限制用户创建播放列表的个数。默认情况下，播放列表是公众都可见的，但是它也可以为私有仅自己可见。

Search

搜索结果包含了视频、频道、播放列表，这些结果可以通过指定API的请求实现。当一个搜索结果指向一个明确的被标记的资源，比如一段视频，那么搜索结果将不再有自己的数据。

Subscriptions

订阅，一个订阅会当新的视频加入到了频道或者其他用户执行了action的时候就会通知用户，这些动作包括：上传视频，给视频投票，评论视频。

Thumbnails

缩略图，缩略图指定了不同的缩略图图片大小。请注意一下缩略图的特征：
-一个资源的snippet.thumbnails属性是一个明确指示了缩略图可用的对象
-缩略图资源包含了一系列的对象。对象名字与缩略图大小相关，比如 default, medium, high。
-不同类型的资源支持不同的缩略图尺寸
-不同类型的资源可能使用相同的名字来定义不同类型的缩略图。比如，视频里的default缩略图一般都是120px * 90px的。但频道里的缩略图一般确实88px*88px的
-相同类型的资源可能有不同的缩略图尺寸，这取决于图片原始分辨率和上传的内容。比如，HD视频支持更高分辨率，因此不能返回缩略图
-如果上传的缩略图不符合要求的尺寸，那么图片会被resize，并且不改变其长宽比。图片并不是被剪切了，但有可能有黑边。

VideoAbuseReportReasons //TODO

举报视频理由

VideoCategories

视频类型标识了上传的视频的类型。

Videos

视频

Watermarks

水印，可以指定水印点击事件和持续事件。