數(shù)據(jù)類型

Activitys

Activity資源包含了特定頻道或用戶的所有活動(dòng)信息，包括打分、分享、喜愛、上傳視頻等等。每個(gè)Activity資源標(biāo)識(shí)出了動(dòng)作類型、頻道或其他資源。

Captions //TODO

Caption資源類似于一段說明，一個(gè)視頻只能有一個(gè)說明。

ChannelBanners

ChannelBanners資源包含一個(gè)頻道最新上傳的圖片資源，即為頻道封面。

ChannelSections //TODO

ChannelSection 資源包含了一個(gè)視頻集合信息。

Channels

Channel資源就是YouTube里的頻道。

CommentThreads

評(píng)論線資源，評(píng)論線是指一個(gè)頂級(jí)評(píng)論和其回復(fù)。頻道Channle和視頻Video都可以有評(píng)論線。

頂級(jí)評(píng)論和回復(fù)其實(shí)都是嵌套在一條評(píng)論線中的評(píng)論Comment。一條評(píng)論線沒有必要包含一條評(píng)論的所有回復(fù)，因此如果需要列出評(píng)論的所有回復(fù)的話，可以使用comments.list 方法。要注意有些評(píng)論沒有回復(fù)。

Comments

評(píng)論資源指的是一條簡單的YouTube評(píng)論。頻道和視頻都具有評(píng)論。需要注意的是，評(píng)論分為頂級(jí)評(píng)論Top-level coment和回復(fù)reply。

GuideCategories

向?qū)Х诸?，包含了基于頻道內(nèi)容、頻道流行度或其他算法的分類。這個(gè)列表有點(diǎn)類似于視頻分類，不同的是，視頻分類可以由視頻上傳者指定，但頻道向?qū)Х诸愔荒苡蒠ouTube來指定。

I18nLanguages

國際化語言，包含了YouTube網(wǎng)站支持的應(yīng)用語言，應(yīng)用語言也可以被當(dāng)做UI語言來使用。對(duì)于YouTube網(wǎng)站來說，應(yīng)用語言可以自動(dòng)的根據(jù)Google賬戶設(shè)置、瀏覽器語言或者IP地址來決定。用戶也可以在YouTube網(wǎng)站頁腳手動(dòng)的設(shè)置自己所希望的UI語言。

每個(gè)國際化資源定義了一個(gè)language code和一個(gè)名字。language code可以被調(diào)用api時(shí)使用。

I18nRegions

國際化地區(qū)，標(biāo)識(shí)了YouTube用戶的地理位置，用戶可以選擇其作為內(nèi)容位置。內(nèi)容位置content region可以當(dāng)做內(nèi)容區(qū)域content locale。對(duì)于YouTube網(wǎng)站來說，一個(gè)內(nèi)容位置可以自動(dòng)的被YouTube域名或者用戶IP試探性地設(shè)置。用戶也可以手動(dòng)地在網(wǎng)站頁腳設(shè)置他想要的內(nèi)容區(qū)域。

PlaylistItems

播放列表實(shí)體，表示另一個(gè)資源，比如包含在播放列表里的視頻video。某種程度上來說，播放列表實(shí)體是描述一個(gè)資源，此資源包含在播放列表中如何使用的信息。

YouTube使用播放列表來標(biāo)識(shí)特定的視頻或頻道集合，比如：
-上傳的視頻
-喜愛的視頻
-頂?shù)囊曨l
-觀看歷史
-稍后觀看

再詳細(xì)一點(diǎn)，這些列表與頻道關(guān)聯(lián)，頻道是一個(gè)人、一個(gè)群組、一個(gè)公司的視頻、播放列表和其他信息的集合。

你可以從一個(gè)已知的頻道中檢索播放列表的ID。你可以使用 playlistItems.list 方法來檢索list。你也可以使用playlistItems.insert 和playlistItems.delete添加或刪除實(shí)體。舉例來說，如果用戶標(biāo)記了一個(gè)視頻為喜愛視頻，你可以插入這個(gè)視頻到喜愛視頻播放列表中。

Playlists

播放列表，播放列表是一堆視頻的的集合，這些視頻可以順序?yàn)g覽也可以分享給其他用戶。一個(gè)播放列表最多可以存放200個(gè)視頻，而且YouTube也沒用限制用戶創(chuàng)建播放列表的個(gè)數(shù)。默認(rèn)情況下，播放列表是公眾都可見的，但是它也可以為私有僅自己可見。

Search

搜索結(jié)果包含了視頻、頻道、播放列表，這些結(jié)果可以通過指定API的請(qǐng)求實(shí)現(xiàn)。當(dāng)一個(gè)搜索結(jié)果指向一個(gè)明確的被標(biāo)記的資源，比如一段視頻，那么搜索結(jié)果將不再有自己的數(shù)據(jù)。

Subscriptions

訂閱，一個(gè)訂閱會(huì)當(dāng)新的視頻加入到了頻道或者其他用戶執(zhí)行了action的時(shí)候就會(huì)通知用戶，這些動(dòng)作包括：上傳視頻，給視頻投票，評(píng)論視頻。

Thumbnails

縮略圖，縮略圖指定了不同的縮略圖圖片大小。請(qǐng)注意一下縮略圖的特征：
-一個(gè)資源的snippet.thumbnails屬性是一個(gè)明確指示了縮略圖可用的對(duì)象
-縮略圖資源包含了一系列的對(duì)象。對(duì)象名字與縮略圖大小相關(guān)，比如 default, medium, high。
-不同類型的資源支持不同的縮略圖尺寸
-不同類型的資源可能使用相同的名字來定義不同類型的縮略圖。比如，視頻里的default縮略圖一般都是120px * 90px的。但頻道里的縮略圖一般確實(shí)88px*88px的
-相同類型的資源可能有不同的縮略圖尺寸，這取決于圖片原始分辨率和上傳的內(nèi)容。比如，HD視頻支持更高分辨率，因此不能返回縮略圖
-如果上傳的縮略圖不符合要求的尺寸，那么圖片會(huì)被resize，并且不改變其長寬比。圖片并不是被剪切了，但有可能有黑邊。

VideoAbuseReportReasons //TODO

舉報(bào)視頻理由

VideoCategories

視頻類型標(biāo)識(shí)了上傳的視頻的類型。

Videos

視頻

Watermarks

水印，可以指定水印點(diǎn)擊事件和持續(xù)事件。