Youtube API数据类型

2016-09-01  本文已影响1850人  RainFool

数据类型

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

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

上一篇下一篇

猜你喜欢

热点阅读