Videos

对于 2020 年 7 月 28 日之后创建的未经验证的 API 项目，通过 videos.insert 端点上传的所有视频都将仅限私享观看模式观看。如需解除此限制，每个 API 项目必须接受审核，以验证符合服务条款的要求。如需了解详情，请参阅 API 修订历史记录。

video 资源表示 YouTube 视频。

方法

对于 videos 资源，该 API 支持以下方法：

getRating

检索授权用户对指定视频列表的评分。立即试用。

list

返回与 API 请求参数匹配的视频列表。立即试用。

insert

将视频上传到 YouTube，并且可以选择设置视频的元数据。

update

更新视频的元数据。立即试用。

删除

删除 YouTube 视频。 立即试用。

税率

为视频添加“顶”或“踩”评分，或者移除视频的评分。 立即试用。

reportAbuse

举报包含侮辱性内容的视频。 立即试用。

资源表示法

以下 JSON 结构显示了 videos 资源的格式：

{
  "kind": "youtube#video",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "tags": [
      string
    ],
    "categoryId": string,
    "liveBroadcastContent": string,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "defaultAudioLanguage": string
  },
  "contentDetails": {
    "duration": string,
    "dimension": string,
    "definition": string,
    "caption": string,
    "licensedContent": boolean,
    "regionRestriction": {
      "allowed": [
        string
      ],
      "blocked": [
        string
      ]
    },
    "contentRating": {
      "acbRating": string,
      "agcomRating": string,
      "anatelRating": string,
      "bbfcRating": string,
      "bfvcRating": string,
      "bmukkRating": string,
      "catvRating": string,
      "catvfrRating": string,
      "cbfcRating": string,
      "cccRating": string,
      "cceRating": string,
      "chfilmRating": string,
      "chvrsRating": string,
      "cicfRating": string,
      "cnaRating": string,
      "cncRating": string,
      "csaRating": string,
      "cscfRating": string,
      "czfilmRating": string,
      "djctqRating": string,
      "djctqRatingReasons": [,
        string
      ],
      "ecbmctRating": string,
      "eefilmRating": string,
      "egfilmRating": string,
      "eirinRating": string,
      "fcbmRating": string,
      "fcoRating": string,
      "fmocRating": string,
      "fpbRating": string,
      "fpbRatingReasons": [,
        string
      ],
      "fskRating": string,
      "grfilmRating": string,
      "icaaRating": string,
      "ifcoRating": string,
      "ilfilmRating": string,
      "incaaRating": string,
      "kfcbRating": string,
      "kijkwijzerRating": string,
      "kmrbRating": string,
      "lsfRating": string,
      "mccaaRating": string,
      "mccypRating": string,
      "mcstRating": string,
      "mdaRating": string,
      "medietilsynetRating": string,
      "mekuRating": string,
      "mibacRating": string,
      "mocRating": string,
      "moctwRating": string,
      "mpaaRating": string,
      "mpaatRating": string,
      "mtrcbRating": string,
      "nbcRating": string,
      "nbcplRating": string,
      "nfrcRating": string,
      "nfvcbRating": string,
      "nkclvRating": string,
      "oflcRating": string,
      "pefilmRating": string,
      "rcnofRating": string,
      "resorteviolenciaRating": string,
      "rtcRating": string,
      "rteRating": string,
      "russiaRating": string,
      "skfilmRating": string,
      "smaisRating": string,
      "smsaRating": string,
      "tvpgRating": string,
      "ytRating": string
    },
    "projection": string,
    "hasCustomThumbnail": boolean
  },
  "status": {
    "uploadStatus": string,
    "failureReason": string,
    "rejectionReason": string,
    "privacyStatus": string,
    "publishAt": datetime,
    "license": string,
    "embeddable": boolean,
    "publicStatsViewable": boolean,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "player": {
    "embedHtml": string,
    "embedHeight": long,
    "embedWidth": long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "relevantTopicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "recordingDetails": {
    "recordingDate": datetime
  },
  "fileDetails": {
    "fileName": string,
    "fileSize": unsigned long,
    "fileType": string,
    "container": string,
    "videoStreams": [
      {
        "widthPixels": unsigned integer,
        "heightPixels": unsigned integer,
        "frameRateFps": double,
        "aspectRatio": double,
        "codec": string,
        "bitrateBps": unsigned long,
        "rotation": string,
        "vendor": string
      }
    ],
    "audioStreams": [
      {
        "channelCount": unsigned integer,
        "codec": string,
        "bitrateBps": unsigned long,
        "vendor": string
      }
    ],
    "durationMs": unsigned long,
    "bitrateBps": unsigned long,
    "creationTime": string
  },
  "processingDetails": {
    "processingStatus": string,
    "processingProgress": {
      "partsTotal": unsigned long,
      "partsProcessed": unsigned long,
      "timeLeftMs": unsigned long
    },
    "processingFailureReason": string,
    "fileDetailsAvailability": string,
    "processingIssuesAvailability": string,
    "tagSuggestionsAvailability": string,
    "editorSuggestionsAvailability": string,
    "thumbnailsAvailability": string
  },
  "suggestions": {
    "processingErrors": [
      string
    ],
    "processingWarnings": [
      string
    ],
    "processingHints": [
      string
    ],
    "tagSuggestions": [
      {
        "tag": string,
        "categoryRestricts": [
          string
        ]
      }
    ],
    "editorSuggestions": [
      string
    ]
  },
  "liveStreamingDetails": {
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "concurrentViewers": unsigned long,
    "activeLiveChatId": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

属性

下表定义了此资源中显示的属性：

属性
kind	string 标识 API 资源的类型。其值为 youtube#video。
etag	etag 此资源的 Etag。
id	string YouTube 用来对视频进行唯一标识的 ID。
snippet	object snippet 对象包含视频的基本详情，如视频标题、说明和类别。
snippet.publishedAt	datetime 视频的发布日期和时间。请注意，此时间可能与该视频的上传时间不同。例如，如果某个视频以私享视频的形式上传，后来又设为了公开，则此属性会指明该视频设为公开的时间。 存在几种特殊情况： 如果视频是作为私享视频上传的，并且频道所有者检索了视频元数据，则属性值会指定视频的上传日期和时间。 如果视频作为不公开列出的视频上传，则属性值还会指定该视频的上传日期和时间。在这种情况下，任何知道该视频的唯一视频 ID 的人都可以检索该视频元数据。 该值以 ISO 8601 格式指定。
snippet.channelId	string YouTube 用来唯一标识上传相应视频的频道的 ID。
snippet.title	string 视频的标题。该属性值的长度上限为 100 个字符，并且可以包含除 < 和 > 以外的所有有效的 UTF-8 字符。如果您调用 videos.update 方法并更新 video 资源的 snippet 部分，则必须为此属性的值设置值。
snippet.description	string 视频的说明。属性值的长度上限为 5000 字节，并且可以包含除 < 和 > 以外的所有有效的 UTF-8 字符。
snippet.thumbnails	object 与视频相关的缩略图图片的地图。对于地图中的每个对象，键是缩略图图片的名称，值是包含有关缩略图的其他信息的对象。
snippet.thumbnails.(key)	object 有效的键值对包括： default - 默认的缩略图图片。视频（或引用视频的资源，例如播放列表项或搜索结果）的默认缩略图宽 120 像素，高 90 像素。频道的默认缩略图宽 88 像素，高 88 像素。 medium – 更高分辨率版本的缩略图。对于视频（或引用视频的资源），该图片的宽度为 320 像素，高为 180 像素。对于频道，此图片宽 240 像素，高 240 像素。 high – 缩略图的高分辨率版本。对于视频（或引用视频的资源），该图片的宽度为 480 像素，高度为 360 像素。对于频道，此图片宽 800 像素，高 800 像素。 standard - 分辨率比 high 分辨率更高的缩略图版本。此图片适用于某些视频以及引用视频的其他资源，例如播放列表项或搜索结果。此图片宽 640 像素，高 480 像素。 maxres – 缩略图图像的最高分辨率版本。此图片大小适用于某些视频以及引用视频的其他资源，例如播放列表项目或搜索结果。此图片宽 1280 像素，高 720 像素。
snippet.thumbnails.(key).url	string 图片的网址。
snippet.thumbnails.(key).width	unsigned integer 图片的宽度。
snippet.thumbnails.(key).height	unsigned integer 图片的高度。
snippet.channelTitle	string 视频所属频道的频道标题。
snippet.tags[]	list 与视频相关联的关键字标记的列表。标记可以包含空格。属性值的长度上限为 500 个字符。请注意，计算字符数限制时需遵循以下规则： 属性值是一个列表，列表中的项目之间的英文逗号会计入上限。 如果标记包含空格，则 API 服务器在处理标记值时就像用引号括起来一样，并且引号会计入字符数限制。因此，就字符数限制而言，代码 Foo-Baz 包含 7 个字符，而代码 Foo Baz 包含 9 个字符。
snippet.categoryId	string 与视频关联的 YouTube 视频类别。如果您调用 videos.update 方法并更新 video 资源的 snippet 部分，则必须为此属性的值设置值。
snippet.liveBroadcastContent	string 指明视频是否为即将开始/正在进行的直播。如果视频不是即将进行的/正在进行的直播，则为“none”。 此属性的有效值包括： live none upcoming
snippet.defaultLanguage	string video 资源的 snippet.title 和 snippet.description 属性中的文本语言。
snippet.localized	object snippet.localized 对象包含视频的本地化标题和说明，或者包含视频元数据默认语言的标题。 如果 videos.list 请求使用 hl 参数指定应针对哪种语言返回本地化文本，并且该语言提供该语言的本地化文本，则系统会在资源代码段中返回本地化文本。 如果未指定 hl 参数值或指定了值，但指定语言的本地化元数据不可用，则返回默认语言的元数据。 此属性包含只读值。使用 localizations 对象添加、更新或删除已本地化的影视内容。
snippet.localized.title	string 本地化的视频标题。
snippet.localized.description	string 本地化的视频说明。
snippet.defaultAudioLanguage	string default_audio_language 属性用于指定视频的默认音轨所用的语言。
contentDetails	object contentDetails 对象包含视频内容的相关信息，包括视频时长以及视频是否有字幕的指示。
contentDetails.duration	string 视频的时长。属性值是 ISO 8601 时长。例如，对于时长至少为一分钟但时长不到 1 小时的视频，时长格式为 PT#M#S，其中字母 PT 表示该值指定时间段，字母 M 和 S 分别表示时长（以分钟和秒为单位）。M 和 S 字母前面的 # 字符都是整数，用于指定视频的分钟数（或秒数）。例如，值 PT15M33S 表示视频时长为 15 分 33 秒。 如果视频时长至少为 1 小时，则时长格式为 PT#H#M#S，其中字母 H 前面的 # 指定了视频的时长（以小时为单位），其他详细信息都与上述说明相同。如果视频时长至少为一天，则字母 P 和 T 会分开显示，值的格式为 P#DT#H#M#S。请参阅 ISO 8601 规范，了解完整详情。
contentDetails.dimension	string 指明视频支持 3D 还是 2D 模式。
contentDetails.definition	string 指明视频是以高清模式 (HD) 播放，还是仅以标清模式播放。 此属性的有效值包括： hd sd
contentDetails.caption	string 指示视频是否提供字幕。 此属性的有效值包括： false true
contentDetails.licensedContent	boolean 指明视频是否代表许可内容，即内容上传到与 YouTube 内容合作伙伴关联的频道，然后由该合作伙伴提出版权主张。
contentDetails.regionRestriction	object regionRestriction 对象包含视频在哪些国家/地区可观看（或无法观看）的相关信息。该对象将包含 contentDetails.regionRestriction.allowed 属性或 contentDetails.regionRestriction.blocked 属性。
contentDetails.regionRestriction.allowed[]	list 区域代码列表，用于标识哪些国家/地区的用户可观看视频。如果该属性存在，但其值中未列出某个国家/地区，则该国家/地区将禁止视频显示。如果此属性存在且包含空列表，则视频会在所有国家/地区禁播。
contentDetails.regionRestriction.blocked[]	list 区域代码列表，用于标识视频禁播的国家/地区。如果该属性存在，但其值中未列出某个国家/地区，则视频在该国家/地区可观看。如果此属性存在且包含空列表，则视频可以在所有国家/地区播放。
contentDetails.contentRating	object 指定视频在各种分级方案下获得的分级。
contentDetails.contentRating.acbRating	string 视频的澳大利亚分类委员会 (ACB) 或澳大利亚通信和媒体管理局 (ACMA) 的分级。ACMA 分级用于对儿童电视节目进行分类。 此属性的有效值包括： acbC – 已被澳大利亚通信和媒体管理局划定为C分级的节目。这些节目面向未满 14 周岁的儿童（不包含学龄前儿童）。 acbE - 东 acbG - G acbM - M acbMa15plus - MA15+ acbP – 已被澳大利亚通信和媒体管理局划定为P分级的节目。这些节目面向学龄前儿童。 acbPg - PG acbR18plus - R18 及以上 acbUnrated
contentDetails.contentRating.agcomRating	string 该视频由意大利 Autorità 根据 le Garanzie nelle Comunicazioni (AGCOM) 获得的分级。 此属性的有效值包括： agcomT - T agcomUnrated agcomVm14 - VM14 agcomVm18 - VM18
contentDetails.contentRating.anatelRating	string 该视频对智利电视台的 Anatel (Asociación Nacional de Televisión) 分级。 此属性的有效值包括： anatelA - A anatelF - F anatelI - I anatelI10 - I-10 州际公路 anatelI12 - I-12 州际公路 anatelI7 - I-7 州际公路 anatelR - R anatelUnrated
contentDetails.contentRating.bbfcRating	string 视频的英国电影分类委员会 (BBFC) 分级。 此属性的有效值包括： bbfc12 - 12 bbfc12a - 中午 12 点 bbfc15 - 15 bbfc18 - 18 岁 bbfcPg - PG bbfcR18 - R18 bbfcU - U bbfcUnrated
contentDetails.contentRating.bfvcRating	string 视频由泰国电影和视频审核委员会提供的分级。 此属性的有效值包括： bfvc13 - 13 bfvc15 - 15 bfvc18 - 18 岁 bfvc20 - 20 bfvcB - B bfvcE - 东 bfvcG - G bfvcUnrated
contentDetails.contentRating.bmukkRating	string 该视频由奥地利媒体分类委员会 (Bundesministerium für Unterricht, Kunst und Kultur) 给出的视频分级。 此属性的有效值如下： bmukk10 - 10+ bmukk12 - 12 岁以上 bmukk14 - 14 岁以上 bmukk16 - 16 岁以上 bmukk6 - 6 岁以上 bmukk8 - 8 岁以上 bmukkAa - 无限制 bmukkUnrated
contentDetails.contentRating.catvRating	string 加拿大电视台分级制度 - 加拿大电视分级系统 视频根据加拿大无线电电视与电信委员会 (CRTC) 对加拿大英语广播的分级。如需了解详情，请访问加拿大广播标准委员会网站。 此属性的有效值包括： catv14plus - 14 岁以上 catv18plus - 18 岁以上 catvC - C catvC8 - C8 catvG - G catvPg - PG catvUnrated
contentDetails.contentRating.catvfrRating	string 该视频由加拿大无线电电视与电信委员会 (CRTC) 对加拿大法语广播所做的分级。如需了解详情，请访问加拿大广播标准委员会网站。 此属性的有效值包括： catvfr13plus - 13 岁以上 catvfr16plus - 16 岁以上 catvfr18plus - 18 岁以上 catvfr8plus - 8 岁以上 catvfrG - G catvfrUnrated
contentDetails.contentRating.cbfcRating	string 视频的中央电影认证委员会 (CBFC - India) 的分级。 此属性的有效值包括： cbfcA - A cbfcS - 南 cbfcU - U cbfcUnrated cbfcUA - U/A cbfcUA7plus - U/A cbfcUA13plus - U/A cbfcUA16plus - U/A
contentDetails.contentRating.cccRating	string 视频的 Consejo de Calificación Cinematográfica（智利）分级。 此属性的有效值包括： ccc14 - 14 岁以上 ccc18 - 18 岁以上 ccc18s – 18+ - contenido pornográfico ccc18v – 18 岁以上 - contenido excesivamente 付款方式 ccc6 – 6+ - 7 años 的便利 cccTe - Todo espectador cccUnrated
contentDetails.contentRating.cceRating	string 该视频由葡萄牙 Comissão de Classificação de Espect ′culos 分级。 此属性的有效值如下： cceM12 - 12 cceM14 - 14 cceM16 - 16 cceM18 - 18 岁 cceM4 - 4 人 cceM6 - 6 cceUnrated
contentDetails.contentRating.chfilmRating	string 视频在瑞士的分级。 此属性的值为： chfilm0 - 0 chfilm12 - 12 chfilm16 - 16 chfilm18 - 18 岁 chfilm6 - 6 chfilmUnrated
contentDetails.contentRating.chvrsRating	string 视频的加拿大家庭视频分级系统 (CHVRS) 分级。 此属性的有效值包括： chvrs14a - 14 安 chvrs18a - 18A chvrsE - 东 chvrsG - G chvrsPg - PG chvrsR - R chvrsUnrated
contentDetails.contentRating.cicfRating	string 该视频来自 Commission de Contrôle des Films（比利时）的分级。 此属性的有效值包括： cicfE - 东 cicfKntEna - KNT/ENA cicfKtEa - KT/EA cicfUnrated
contentDetails.contentRating.cnaRating	string 该视频来自罗马尼亚国家 CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) 的分级。 此属性的有效值包括： cna12 - 12 cna15 - 15 cna18 - 18 岁 cna18plus - 18 岁以上 cnaAp – 美联社 cnaUnrated
contentDetails.contentRating.cncRating	string 法国的分级制度 - Commission de category movietographique 此属性的有效值包括： cnc10 - 10 cnc12 - 12 cnc16 - 16 cnc18 - 18 岁 cncE - 东 cncT - T cncUnrated
contentDetails.contentRating.csaRating	string 该视频来自法国 Conseil supérieur de l?audiovisuel 的分级，该分级用于对广播内容进行评分。 此属性的有效值包括： csa10 - 10 csa12 - 12 csa16 - 16 csa18 - 18 岁 csaInterdiction – 禁言 csaT - T csaUnrated
contentDetails.contentRating.cscfRating	string 该视频由卢森堡委员会的 Commission de surveillance de laClassification des layers (CSCF) 提供的分级。 此属性的有效值如下： cscf12 - 12 cscf16 - 16 cscf18 - 18 岁 cscf6 - 6 cscf9 - 9 人 cscfA - A cscfAl - AL cscfUnrated
contentDetails.contentRating.czfilmRating	string 视频在捷克共和国的分级。 此属性的有效值包括： czfilm12 - 12 czfilm14 - 14 czfilm18 - 18 岁 czfilmU - U czfilmUnrated
contentDetails.contentRating.djctqRating	string 视频的 Leaveamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - 巴西) 分级。 此属性的有效值如下： djctq10 - 10 djctq12 - 12 djctq14 - 14 djctq16 - 16 djctq18 - 18 岁 djctqL - 升 djctqUnrated
contentDetails.contentRating.djctqRatingReasons[]	list 解释为何视频获得 DJCQT（巴西）分级的原因。
contentDetails.contentRating.ecbmctRating	string 土耳其的分级制度 - 文化与旅游部评估和分类委员会 此资源的有效值包括： ecbmct13a - 中午 13 点 ecbmct13plus - 13 岁以上 ecbmct15a - 15A ecbmct15plus - 15 岁以上 ecbmct18plus - 18 岁以上 ecbmct7a - 7 安 ecbmct7plus - 7 以上 ecbmctG - G ecbmctUnrated ecbmct6a - 6 安 ecbmct6plus - 6 岁以上 ecbmct10a - 10A ecbmct10plus - 10+ ecbmct16plus - 16 岁以上
contentDetails.contentRating.eefilmRating	string 视频在爱沙尼亚的分级。 此属性的有效值包括： eefilmK12 - 幼儿园到高中 (K-12) eefilmK14 - 幼儿园到高中 (K-14) eefilmK16 - 幼儿园到高中 (K-16) eefilmK6 - 幼儿园到高中 eefilmL - 升 eefilmMs12 - MS-12 eefilmMs6 - MS-6 eefilmPere - Pere eefilmUnrated
contentDetails.contentRating.egfilmRating	string 视频在埃及的分级。 此属性的有效值包括： egfilm18 - 18 岁 egfilmBn - BN egfilmGn - GN egfilmUnrated
contentDetails.contentRating.eirinRating	string 视频的艾琳（映伦）分级。Eirin 是日本分级制度。 此属性的有效值包括： eirinG - G eirinPg12 - PG-12 eirinR15plus - R15 及以上 eirinR18plus - R18 及以上 eirinUnrated
contentDetails.contentRating.fcbmRating	string 该视频由马来西亚电影审查委员会确定的分级。 此属性的有效值包括： fcbm13 - 13 fcbm16 - 16 fcbm18 - 18 岁 fcbm18pa - 18/18 fcbm18pl - 18PL fcbm18sg - 18 新加坡元 fcbm18sx - 18SX fcbmP12 - P12 fcbmP13 - P13 fcbmPg13 - PG13 fcbmU - U fcbmUnrated
contentDetails.contentRating.fcoRating	string 该视频由香港电影、报纸及文献管理局提供的分级。 此属性的有效值包括： fcoI - I fcoIi - II fcoIia - IIA fcoIib - IIB fcoIii - III fcoUnrated
contentDetails.contentRating.fmocRating	string 此属性自 2015 年 11 月 2 日起已弃用。请改用 contentDetails.contentRating.cncRating 属性。 视频中心的 National du cinéma et de l'image animé（法国文化部）分级。 此属性的有效值包括： fmoc10 - 10 fmoc12 - 12 fmoc16 - 16 fmoc18 - 18 岁 fmocE - 东 fmocU - U fmocUnrated
contentDetails.contentRating.fpbRating	string 该视频由南非电影和出版委员会提供的分级。 此属性的有效值包括： fpb10 - 10 fpb1012Pg - 10-12PG fpb13 - 13 fpb16 - 16 fpb18 - 18 岁 fpb79Pg - 7-9PG fpbA - A fpbPg - PG fpbUnrated fpbX18 - X18 fpbXx - XX
contentDetails.contentRating.fpbRatingReasons[]	list 解释视频获得 FPB（南非）分级的原因。
contentDetails.contentRating.fskRating	string 视频的 Freiwillige Selbstkontrolle der Filmwirtschaft（FSK - 德国）分级。 此属性的有效值包括： fsk0 - FSK 0 fsk12 - FSK 12 fsk16 - 16 沙特里亚尔 fsk18 - 18 沙特里亚尔 fsk6 - FSK 6 fskUnrated
contentDetails.contentRating.grfilmRating	string 视频在希腊的评分。 此属性的有效值包括： grfilmE - 东 grfilmK - 千 grfilmK12 - 幼儿园到高中 (K-12) grfilmK13 - 幼儿园到高中 (K-13) grfilmK15 - 幼儿园到高中 (K-15) grfilmK17 - 幼儿园到高中 (K-17) grfilmK18 - 幼儿园到高中 (K-18) grfilmUnrated
contentDetails.contentRating.icaaRating	string 视频的 Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - Spain) 分级。 此属性的有效值包括： icaa12 - 12 icaa13 - 13 icaa16 - 16 icaa18 - 18 岁 icaa7 - 7 icaaApta - APTA icaaUnrated icaaX - X
contentDetails.contentRating.ifcoRating	string 视频的爱尔兰电影分级办公室 (IFCO - Ireland) 分级。如需了解详情，请参阅 IFCO 网站。 此属性的有效值包括： ifco12 - 12 ifco12a - 中午 12 点 ifco15 - 15 ifco15a - 15A ifco16 - 16 ifco18 - 18 岁 ifcoG - G ifcoPg - PG ifcoUnrated
contentDetails.contentRating.ilfilmRating	string 视频在以色列的分级。 此属性的有效值包括： ilfilm12 - 12 ilfilm16 - 16 ilfilm18 - 18 岁 ilfilmAa - AA ilfilmUnrated
contentDetails.contentRating.incaaRating	string 视频的 INCAA (Instituto Nacional de Cine y Artes Audiovisuales - Argentina) 分级。 此属性的有效值如下： incaaAtp – ATP (Apta para todo publico) incaaC – X (Solo apta para Mayores de 18 años, de exhibición condicionada) incaaSam13 - 13 (Solo apta para Mayores de 13 años) incaaSam16 - 16 (Solo apta para Mayores de 16 años) incaaSam18 - 18 (Solo apta para Mayores de 18 años) incaaUnrated
contentDetails.contentRating.kfcbRating	string 视频在肯尼亚电影分类委员会的分级。 此属性的有效值包括： kfcb16plus - 16 kfcbG - 格鲁吉亚 kfcbPg - PG kfcbR - 18 岁 kfcbUnrated
contentDetails.contentRating.kijkwijzerRating	string voor de Classificatie van Audiovisuele Media（荷兰）。 此属性的有效值包括： kijkwijzer12 - 12 kijkwijzer14 - 14 kijkwijzer16 - 16 kijkwijzer18 - 18 岁 kijkwijzer6 - 6 kijkwijzer9 - 9 人 kijkwijzerAl - AL kijkwijzerUnrated
contentDetails.contentRating.kmrbRating	string 该视频的韩国媒体分级委员会 (무선데보세요拼写错误) 分级。适用于韩国的视频的 KMRB 费率。 此属性的有效值包括： kmrb12plus - 12 同一个 可选 kmrb15plus - 15 广告素材的 이선 장람 applied kmrbAll - 선샠람向您发送电子邮件 kmrbR - 안인년 장람불模仿 kmrbTeenr kmrbUnrated
contentDetails.contentRating.lsfRating	string 视频在印度尼西亚 Lembaga 传感器电影中的评分。 此属性的有效值包括： lsf13 - 13 lsf17 - 17 lsf21 - 21 lsfA - A lsfBo - BO lsfD - D lsfR - R lsfSu - SU lsfUnrated
contentDetails.contentRating.mccaaRating	string 马耳他电影年龄分类委员会的视频分级。 此属性的有效值如下： mccaa12 - 12 mccaa12a - 中午 12 点 mccaa14 – 14：此分级已从 2013 年引入的新分类结构中移除。 mccaa15 - 15 mccaa16 – 16：此分级已从 2013 年引入的新分类结构中移除。 mccaa18 - 18 岁 mccaaPg - PG mccaaU - U mccaaUnrated
contentDetails.contentRating.mccypRating	string 该视频由丹麦电影学院（Det Danske Filminstitut）媒体委员会儿童与年轻人协会评定。 此属性的有效值如下： mccyp11 - 11 mccyp15 - 15 mccyp7 - 7 mccypA - A mccypUnrated
contentDetails.contentRating.mcstRating	string 该视频的分级制度（越南）- MCST 此属性的有效值包括： mcst0 - 0 mcst16plus - 16 岁以上 mcstC13 - C13 mcstC16 - C16 mcstC18 - C18 mcstP - P mcstUnrated mcstT13 - T13 mcstT16 - T16 mcstT18 - T18 mcstK - 千
contentDetails.contentRating.mdaRating	string 该视频由新加坡媒体发展管理局 (MDA) 以及新加坡电影审查委员会 (BFC) 给出的分级。 此属性的有效值如下： mdaG - G mdaM18 - M18 mdaNc16 - NC16 mdaPg - PG mdaPg13 - PG13 mdaR21 - R21 mdaUnrated
contentDetails.contentRating.medietilsynetRating	string 该视频的分级来自挪威媒体管理局 Medietilsynet。 此属性的有效值包括： medietilsynet11 - 11 medietilsynet12 - 12 medietilsynet15 - 15 medietilsynet18 - 18 岁 medietilsynet6 - 6 medietilsynet7 - 7 medietilsynet9 - 9 人 medietilsynetA - A medietilsynetUnrated
contentDetails.contentRating.mekuRating	string 该视频由芬兰 Kansallinen Audiovisuaalinen Instituutti（美国视听研究所）提供的分级。 此属性的有效值如下： meku12 - 12 meku16 - 16 meku18 - 18 岁 meku7 - 7 mekuS - 南 mekuUnrated
contentDetails.contentRating.mibacRating	string 该视频由 Ministero dei Beni e delle Attività Culturei e del Turismo（意大利）给出的视频分级。 此属性的有效值如下： mibacT mibacUnrated mibacVap mibacVm6 mibacVm12 mibacVm14 mibacVm18
contentDetails.contentRating.mocRating	string 视频的文化部（哥伦比亚）分级。 此属性的有效值包括： moc12 - 12 moc15 - 15 moc18 - 18 岁 moc7 - 7 mocBanned - 被禁 mocE - 东 mocT - T mocUnrated mocX - X
contentDetails.contentRating.moctwRating	string 视频由台湾文化部 (文化部) 提供的分级。 此属性的有效值包括： moctwG - G moctwP - P moctwPg - PG moctwR - R moctwR12 - R-12 moctwR15 - R-15 moctwUnrated
contentDetails.contentRating.mpaaRating	string 视频的美国电影协会 (MPAA) 分级。 此属性的有效值包括： mpaaG - G mpaaNc17 - NC-17 mpaaPg - PG mpaaPg13 - PG-13 mpaaR - R mpaaUnrated
contentDetails.contentRating.mpaatRating	string 美国电影协会对电影预告片和预览的分级。 此属性的有效值包括： mpaatGb - GB（绿带 - 已批准所有观众观看） mpaatRb - RB（红色手环 - 建议年满 17 周岁的观众观看）
contentDetails.contentRating.mtrcbRating	string 该视频由菲律宾影视审查和分类委员会（菲律宾）提供的分级。 此属性的有效值包括： mtrcbG - G mtrcbPg - PG mtrcbR13 - R-13 mtrcbR16 - R-16 mtrcbR18 - R-18 mtrcbUnrated mtrcbX - X
contentDetails.contentRating.nbcRating	string 该视频由马尔代夫国家分类局提供的分级。 此属性的有效值包括： nbc12plus - 12 岁以上 nbc15plus - 15 岁以上 nbc18plus - 18 岁以上 nbc18plusr - 18+R nbcG - G nbcPg - PG nbcPu - 处理 nbcUnrated
contentDetails.contentRating.nfrcRating	string 视频在保加利亚国家电影中心给出的分级。 此属性的有效值包括： nfrcA - A nfrcB - B nfrcC - C nfrcD - D nfrcUnrated nfrcX - X
contentDetails.contentRating.nfvcbRating	string 视频由尼日利亚国家电影和视频审查委员会发布的分级。 此属性的有效值如下： nfvcb12 - 12 nfvcb12a - 中午 12 点 nfvcb15 - 15 nfvcb18 - 18 岁 nfvcbG - G nfvcbPg - PG nfvcbRe - RE nfvcbUnrated
contentDetails.contentRating.nkclvRating	string 该视频由拉脱维亚国家电影中心 (Nacionêlais Kino centrs) 给出的分级。 此属性的有效值包括： nkclv12plus - 12 岁以上 nkclv18plus - 18 岁以上 nkclv7plus - 7 以上 nkclvU - U nkclvUnrated
contentDetails.contentRating.oflcRating	string 该视频的影片与文学分类办公室 (OFLC - New Zealand) 分级。 此属性的有效值包括： oflcG - G oflcM - M oflcPg - PG oflcR13 - R13 oflcR15 - R15 oflcR16 - R16 oflcR18 - R18 oflcRp13 - RP13 oflcRp16 - RP16 oflcUnrated
contentDetails.contentRating.pefilmRating	string 视频在秘鲁的评分。 此属性的值为： pefilm14 - 14 pefilm18 - 18 岁 pefilmPg - PG pefilmPt - 太平洋时间 pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating	string 视频在委内瑞拉的分级。 此属性的有效值包括： resorteviolenciaA - A resorteviolenciaB - B resorteviolenciaC - C resorteviolenciaD - D resorteviolenciaE - 东 resorteviolenciaUnrated
contentDetails.contentRating.rtcRating	string 视频的广播、电视和电影总局（墨西哥）分级。 此属性的有效值包括： rtcA - A rtcAa - AA rtcB - B rtcB15 - B15 rtcC - C rtcD - D rtcUnrated
contentDetails.contentRating.rteRating	string 该视频由爱尔兰 Raidió Teilifís Eireann 发布的分级。 此属性的有效值包括： rteCh - 瑞士 rteGa - 正式版 rteMa - 马萨诸塞州 rtePs - PS rteUnrated
contentDetails.contentRating.russiaRating	string 该视频的俄罗斯联邦国家电影注册机构 (MKRF - 俄罗斯) 分级。 此属性的有效值包括： russia0 - 0+ russia12 - 12 岁以上 russia16 - 16 岁以上 russia18 - 18 岁以上 russia6 - 6 岁以上 russiaUnrated
contentDetails.contentRating.skfilmRating	string 视频在斯洛伐克的评分。 此属性的值为： skfilmG - G skfilmP2 - P2 skfilmP5 - P5 skfilmP8 - P8 skfilmUnrated
contentDetails.contentRating.smaisRating	string 视频在冰岛的评分。 此属性的有效值包括： smais12 - 12 smais14 - 14 smais16 - 16 smais18 - 18 岁 smais7 - 7 smaisL - 升 smaisUnrated
contentDetails.contentRating.smsaRating	string 该视频由 Statens medieråd（瑞典国家媒体委员会）提供的分级。 此属性的有效值如下： smsa11 - 11 smsa15 - 15 smsa7 - 7 smsaA - 所有年龄段 smsaUnrated
contentDetails.contentRating.tvpgRating	string 视频的电视家长准则 (TVPG) 分级。 此属性的有效值包括： tvpgG - TV-G tvpgMa - TV-MA tvpgPg - TV-PG tvpgUnrated tvpgY - TV-Y tvpgY7 - TV-Y7 tvpgY7Fv - TV-Y7-FV pg14 - TV-14
contentDetails.contentRating.ytRating	string YouTube 用来标识有年龄限制的内容的分级。 此属性的有效值包括： ytAgeRestricted
contentDetails.projection	string 指定视频的投影格式。 此属性的有效值包括： 360 rectangular
contentDetails.hasCustomThumbnail	boolean 指明视频上传者是否已为视频提供了自定义缩略图。只有视频上传者才能看到此属性。
status	object status 对象包含与视频的上传、处理和隐私状态相关的信息。
status.uploadStatus	string 已上传的视频的状态。 此属性的有效值包括： deleted failed processed rejected uploaded
status.failureReason	string 此值说明了视频上传失败的原因。仅当 uploadStatus 属性指示上传失败时，此属性才会显示。 此属性的有效值包括： codec conversion emptyFile invalidFile tooSmall uploadAborted
status.rejectionReason	string 此值说明了 YouTube 拒绝上传的视频的原因。仅当 uploadStatus 属性指示上传遭拒时，此属性才会显示。 此属性的有效值包括： claim copyright duplicate inappropriate legal length termsOfUse trademark uploaderAccountClosed uploaderAccountSuspended
status.privacyStatus	string 视频的隐私状态。 此属性的有效值包括： private public unlisted
status.publishAt	datetime 预定发布视频的日期和时间。仅当视频的隐私状态为私享时才能设置此字段。该值以 ISO 8601 格式指定。关于此属性的行为，请注意以下几点： 如果您在调用 videos.update 方法时设置此属性的值，则还必须将 status.privacyStatus 属性值设为 private，即使视频已经是私享视频也是如此。 如果您的请求将某个视频安排在以前的某个时间发布，则视频会立即发布。因此，将 status.publishAt 属性设置为过去的日期和时间的效果与将视频的 privacyStatus 从 private 更改为 public 的效果相同。
status.license	string 视频的许可。 此属性的有效值包括： creativeCommon youtube
status.embeddable	boolean 此值用于指明视频是否可以嵌入到其他网站。
status.publicStatsViewable	boolean 此值用于指明视频观看页面上的扩展视频统计信息是否公开显示。默认情况下，这些统计信息可供查看，并且即使该属性的值设为 false，视频的观看次数和评分等统计信息仍会公开显示。
status.madeForKids	boolean 此值用于指明视频是否被指定为面向儿童，并且包含视频当前的“面向儿童的内容”状态。例如，可以根据 selfDeclaredMadeForKids 属性的值来确定状态。请参阅 YouTube 帮助中心，详细了解如何为您的频道、视频或广播设置观众群。
status.selfDeclaredMadeForKids	boolean 在 videos.insert 或 videos.update 请求中，此属性可让频道所有者将视频指定为面向儿童。在 videos.list 请求中，仅当频道所有者为 API 请求授权时，系统才会返回属性值。
statistics	object statistics 对象包含视频的相关统计信息。
statistics.viewCount	unsigned long 视频的观看次数。
statistics.likeCount	unsigned long 表示喜欢该视频的用户数量。
statistics.dislikeCount	unsigned long 注意：statistics.dislikeCount 属性自 2021 年 12 月 13 日起已变为不公开属性。这意味着，仅当 API 请求经过视频所有者的身份验证后，相应属性才会包含在 API 响应中。如需了解详情，请参阅修订历史记录。 表示不喜欢视频的用户数量。
statistics.favoriteCount	unsigned long 注意：此属性已废弃。弃用功能自 2015 年 8 月 28 日起生效。现在，该属性的值始终设置为 0。
statistics.commentCount	unsigned long 视频的评论数。
player	object player 对象包含在嵌入式播放器中播放视频时需要使用的信息。
player.embedHtml	string 用于嵌入播放视频的播放器的 <iframe> 代码。 如果用于检索资源的 API 请求指定了 maxHeight 和/或 maxWidth 参数的值，则系统会调整嵌入式播放器的大小，以满足 maxHeight 和/或 maxWidth 要求。 如果视频的宽高比未知，则嵌入式播放器默认采用 4:3 格式。
player.embedHeight	long player.embedHtml 属性中返回的嵌入式播放器的高度。仅当请求为 maxHeight 和/或 maxWidth 参数指定了值且视频的宽高比已知时，系统才会返回此属性。
player.embedWidth	long player.embedHtml 属性中返回的嵌入式播放器的宽度。仅当请求为 maxHeight 和/或 maxWidth 参数指定了值且视频的宽高比已知时，系统才会返回此属性。
topicDetails	object topicDetails 对象可封装与视频关联的主题的相关信息。 重要提示：如需详细了解与主题 ID 相关的即将发生的更改，请参阅 topicDetails.relevantTopicIds[] 和 topicDetails.topicIds[] 属性的定义以及修订历史记录。
topicDetails.topicIds[]	list 重要提示：此属性自 2016 年 11 月 10 日起已弃用。API 不再返回此属性的值，并且现在会由 topicDetails.relevantTopicIds[] 属性值返回与视频关联的所有主题。
topicDetails.relevantTopicIds[]	list 与视频相关的主题 ID 列表。 此属性自 2016 年 11 月 10 日起已弃用。相关支持会持续到 2017 年 11 月 10 日。 重要提示：由于 Freebase 和 Freebase API 的弃用日期，主题 ID 从 2017 年 2 月 27 日起开始工作方式有所不同。当时，YouTube 开始返回一小部分精选主题 ID。 查看自 2017 年 2 月 15 日起支持的主题 ID 主题 音乐主题 /m/04rlf 音乐（家长主题） /m/02mscn 基督教音乐 /m/0ggq0m 古典音乐 /m/01lyv 国家/地区 /m/02lkt 电子音乐 /m/0glt670 嘻哈音乐 /m/05rwpb 独立音乐 /m/03_d0 爵士乐 /m/028sqc 亚洲音乐 /m/0g293 拉丁美洲音乐 /m/064t9 流行音乐 /m/06cqb 雷鬼乐 /m/06j6l 节奏蓝调 /m/06by7 摇滚乐 /m/0gywn 灵魂音乐 游戏主题 /m/0bzvm2 游戏（家长主题） /m/025zzc 动作游戏 /m/02ntfj 动作冒险游戏 /m/0b1vjn 休闲游戏 /m/02hygl 音乐类视频游戏 /m/04q1x3q 益智类视频游戏 /m/01sjng 竞速类视频游戏 /m/0403l3g 角色扮演类视频游戏 /m/021bp2 模拟视频游戏 /m/022dc6 体育游戏 /m/03hf_rm 策略类视频游戏 体育主题 /m/06ntj 体育（父级主题） /m/0jm_ 橄榄球 /m/018jz 棒球 /m/018w8 篮球 /m/01cgz 拳击 /m/09xp_ 板球 /m/02vx4 美式足球 /m/037hz 高尔夫 /m/03tmr 冰球 /m/01h7lh 综合格斗 /m/0410tth 赛车运动 /m/07bs0 网球 /m/07_53 排球 娱乐主题 /m/02jjt 娱乐（父级主题） /m/09kqc 幽默 /m/02vxn 电影 /m/05qjc 表演艺术 /m/066wd 职业摔跤 /m/0f2f9 电视节目 生活时尚主题 /m/019_rr 生活方式（父级主题） /m/032tl 时尚 /m/027x7n 健身 /m/02wbm 食品 /m/03glg 爱好 /m/068hy 宠物 /m/041xxh 身体吸引力 [美容] /m/07c1v 科技 /m/07bxq 旅游 /m/07yv9 车辆 社会主题 /m/098wr 社会（父级主题） /m/09s1f 企业 /m/0kt51 运行状况 /m/01h6rj 军事 /m/05qt0 政治 /m/06bvp 宗教 其他主题 /m/01k8wb 知识
topicDetails.topicCategories[]	list 提供视频内容简要说明的维基百科网址列表。
recordingDetails	object recordingDetails 对象封装了录制视频的位置、日期和地址的相关信息。
recordingDetails.locationDescription	string 此属性自 2017 年 6 月 1 日起已弃用。如需了解详情，请参阅弃用公告。 录制视频的位置的文字说明。
recordingDetails.location	object 与视频相关的地理定位信息。请注意，子属性值用于标识视频所有者希望与视频相关联的位置。该值可修改、可在公开视频上搜索到，并且可能会在公开视频时向用户显示。
recordingDetails.location.latitude	double 此属性自 2017 年 6 月 1 日起已弃用。如需了解详情，请参阅弃用公告。 纬度（以度为单位）。
recordingDetails.location.longitude	double 此属性自 2017 年 6 月 1 日起已弃用。如需了解详情，请参阅弃用公告。 经度（以度为单位）。
recordingDetails.location.altitude	double 此媒体资源自 2018 年 7 月 9 日起已弃用。如需了解详情，请参阅弃用公告。 参考椭球上方的海拔高度（以米为单位）。
recordingDetails.recordingDate	datetime 录制视频的日期和时间。该值以 ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ) 格式指定。
fileDetails	object fileDetails 对象封装了有关上传到 YouTube 的视频文件的信息，包括文件的分辨率、时长、音频和视频编解码器、视频流比特率等。只有视频所有者才能检索此数据。 仅当 processingDetails.fileAvailability 属性的值为 available 时，系统才会返回 fileDetails 对象。
fileDetails.fileName	string 已上传文件的名称。无论上传的是视频文件还是其他类型的文件，此字段都会显示。
fileDetails.fileSize	unsigned long 已上传文件的大小（以字节为单位）。无论上传的是视频文件还是其他类型的文件，此字段都会显示。
fileDetails.fileType	string YouTube 的视频处理引擎检测到的上传文件的类型。目前，YouTube 仅处理视频文件，但无论上传的是视频文件还是其他类型的文件，此字段都会显示。 此属性的有效值包括： archive - 文件是归档文件，例如 .zip 归档文件。 audio - 表示文件属于已知的音频文件类型，例如 .mp3 文件。 document - 文件是文档或文本文件，例如 MS Word 文档。 image - 文件是图片文件，例如 .jpeg 图片。 other - 文件是另一种非视频文件类型。 project - 文件是视频项目文件（如 Microsoft Windows Movie Maker 项目），不包含实际视频数据。 video - 表示文件是已知的视频文件类型，例如 .mp4 文件。
fileDetails.container	string 已上传的视频文件的容器格式。
fileDetails.videoStreams[]	list 上传的视频文件中包含的视频流列表。列表中的每一项都包含关于某个视频流的详细元数据。
fileDetails.videoStreams[].widthPixels	unsigned integer 已编码的视频内容的宽度（以像素为单位）。您可以将视频的编码宽高比计算为 width_pixels / height_pixels。
fileDetails.videoStreams[].heightPixels	unsigned integer 编码后视频内容的高度（以像素为单位）。
fileDetails.videoStreams[].frameRateFps	double 视频流的帧速率（以每秒帧数为单位）。
fileDetails.videoStreams[].aspectRatio	double 视频内容的显示宽高比，用于指定视频的显示宽高比。
fileDetails.videoStreams[].codec	string 数据流使用的视频编解码器。
fileDetails.videoStreams[].bitrateBps	unsigned long 视频流的比特率（以“比特/秒”为单位）。
fileDetails.videoStreams[].rotation	string YouTube 旋转原始源内容以正确显示视频需要多少金额。 此属性的有效值包括： clockwise - 视频需要顺时针旋转 90 度。 counterClockwise - 视频需要逆时针旋转 90 度。 none – 视频不需要旋转。 other - 视频需要以其他重要的方式旋转。 upsideDown - 视频需要上下颠倒。
fileDetails.videoStreams[].vendor	string 一个唯一标识视频供应商的值。通常，此值是一个由四个字母组成的供应商代码。
fileDetails.audioStreams[]	list 上传的视频文件中包含的音频流列表。列表中的每一项都包含有关音频流的详细元数据。
fileDetails.audioStreams[].channelCount	unsigned integer 数据流中包含的声道数量。
fileDetails.audioStreams[].codec	string 流使用的音频编解码器。
fileDetails.audioStreams[].bitrateBps	unsigned long 音频流的比特率（以每秒传输的位数表示）。
fileDetails.audioStreams[].vendor	string 一个唯一标识视频供应商的值。通常，此值是一个由四个字母组成的供应商代码。
fileDetails.durationMs	unsigned long 已上传视频的时长（以毫秒为单位）。
fileDetails.bitrateBps	unsigned long 所上传视频文件的组合（视频和音频）比特率（以每秒传输的位数为单位）。
fileDetails.creationTime	string 上传的视频文件的创建日期和时间。该值以 ISO 8601 格式指定。目前，支持以下 ISO 8601 格式： 仅限日期：YYYY-MM-DD 朴素时间：YYYY-MM-DDTHH:MM:SS 时区的时间：YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails	object processingDetails 对象封装了 YouTube 处理所上传视频文件的进度信息。对象中的属性可标识当前处理状态以及 YouTube 完成视频处理前所剩时间的估计值。该部分还指明了视频是否有不同类型的数据或内容（例如文件详细信息或缩略图）。 processingProgress 对象设计为可轮询，以便上传的视频可以跟踪 YouTube 在处理上传的视频文件时的进度。只有视频所有者才能检索此数据。
processingDetails.processingStatus	string 视频的处理状态。此值用于指明 YouTube 是能够处理视频还是仍在处理视频。 此属性的有效值包括： failed – 视频处理失败。请参阅 ProcessingFailureReason。 processing – 视频正在处理中。请参阅 ProcessingProgress。 succeeded – 视频已成功处理。 terminated – 处理信息已不再可用。
processingDetails.processingProgress	object processingProgress 对象包含有关 YouTube 在处理视频方面取得的进展的信息。只有在视频的处理状态为 processing 时，这些值才具有相关性。
processingDetails.processingProgress.partsTotal	unsigned long 预计需要为视频处理的部分总数。在 YouTube 处理视频期间，此数字可能会更新为更精确的估算值。
processingDetails.processingProgress.partsProcessed	unsigned long YouTube 已处理的视频部分数量。您可以通过以下方式来估算 YouTube 已处理的视频所占的百分比： 100 * parts_processed / parts_total 请注意，由于估算的部分数量会增加，但已处理的片段数量不会相应地增加，因此在 YouTube 处理视频期间，计算出的进度可能会定期减少。
processingDetails.processingProgress.timeLeftMs	unsigned long YouTube 完成视频处理所需的估算时长（以毫秒计）。
processingDetails.processingFailureReason	string YouTube 无法处理视频的原因。仅当 processingStatus 属性的值为 failed 时，此属性才具有值。 此属性的有效值包括： other – 某些其他处理组件失败。 streamingFailed – 无法将视频发送给直播者。 transcodeFailed - 内容转码失败。 uploadFailed – 文件发送失败。
processingDetails.fileDetailsAvailability	string 此值可指明是否有已上传视频的文件详情。您可以通过在 videos.list() 请求中请求 fileDetails 部分来检索视频的文件详细信息。
processingDetails.processingIssuesAvailability	string 此值用于指明视频处理引擎是否生成了可能会提高 YouTube 视频处理能力的建议、说明视频处理问题的警告或会导致视频处理问题的错误。您可以通过请求 videos.list() 请求中的 suggestions 部分来检索这些建议。
processingDetails.tagSuggestionsAvailability	string 此值可指明关键字（标签）建议是否适用于视频。您可以在视频的元数据中添加标签，以便让其他用户更轻松地找到该视频。您可以通过请求 videos.list() 请求中的 suggestions 部分来检索这些建议。
processingDetails.editorSuggestionsAvailability	string 此值用于指明视频是否有能够提升视频画质或播放体验的视频编辑建议。您可以通过请求 videos.list() 请求中的 suggestions 部分来检索这些建议。
processingDetails.thumbnailsAvailability	string 此值用于指明是否已为视频生成缩略图。
suggestions	object suggestions 对象可封装相关建议，这些建议有助于发现提升所上传视频质量或改善所上传视频元数据的机会。只有视频所有者才能检索此数据。 仅当 processingDetails.tagSuggestionsAvailability 属性或 processingDetails.editorSuggestionsAvailability 属性的值为 available 时，系统才会返回 suggestions 对象。
suggestions.processingErrors[]	list 一系列错误，这些错误会导致 YouTube 无法成功处理上传的视频。这些错误表明，无论视频当前的处理状态如何，该状态最终肯定是 failed。 此属性的有效值包括： archiveFile - 归档文件（例如 ZIP 归档文件）。 audioFile - 文件仅包含音频（例如 MP3 文件）。 docFile - 文档或文本文件（例如MS Word 文档）。 imageFile - 图片文件（例如 JPEG 图片）。 notAVideoFile - 其他非视频文件。 projectFile - 电影项目文件（例如Microsoft Windows Movie Maker 项目）。
suggestions.processingWarnings[]	list YouTube 可能难以对上传的视频进行转码或可能导致转码错误的一系列原因。这些警告是在 YouTube 实际处理上传的视频文件之前生成的。此外，它们还可以找出未必表示视频处理会失败，但仍可能会导致问题（如同步问题、视频伪影或音轨缺失）的问题。 此属性的有效值包括： hasEditlist - 目前不支持修改列表。 inconsistentResolution - 容器和视频流解析存在冲突。 problematicAudioCodec - 使用了已知会导致问题的音频编解码器。 problematicVideoCodec – 使用了已知会导致问题的视频编解码器。 unknownAudioCodec - 音频编解码器无法识别，转码可能会失败。 unknownContainer - 文件格式无法识别，转码可能会失败。 unknownVideoCodec - 视频编解码器无法识别，因此转码可能会失败。
suggestions.processingHints[]	list 可提高 YouTube 处理视频能力的建议列表。 此属性的有效值包括： nonStreamableMov - MP4 文件不可流式传输，这会减慢处理速度。 sendBestQualityVideo – 可能有更好的视频质量版本。
suggestions.tagSuggestions[]	list 可添加到视频元数据中的一系列关键字标签，以提高用户在 YouTube 上搜索或浏览时找到您视频的可能性。
suggestions.tagSuggestions[].tag	string 为视频建议的关键字标记。
suggestions.tagSuggestions[].categoryRestricts[]	list 与标签相关的一组视频类别。您可以使用这些信息，根据视频上传者与视频相关联的视频类别显示相应的标签建议。默认情况下，如果未为关键字定义限制，则标记建议适用于所有类别。
suggestions.editorSuggestions[]	list 可用于改善所上传视频画质或播放体验的视频编辑操作列表。 此属性的有效值包括： audioQuietAudioSwap - 音轨会显示为无声播放，可以切换成音质较好的音轨。 videoAutoLevels - 画面亮度似乎处于关闭状态，请进行修正。 videoCrop - 可以剪裁图片周围的边缘（哑光）。 videoStabilize - 视频画面在抖动，可能会稳定。
liveStreamingDetails	object liveStreamingDetails 对象包含有关直播视频广播的元数据。仅当视频是即将开始、正在进行或已完成的直播时，该对象才会显示在 video 资源中。
liveStreamingDetails.actualStartTime	datetime 直播实际开始的时间。该值以 ISO 8601 格式指定。在直播开始前，此值不可用。
liveStreamingDetails.actualEndTime	datetime 直播实际结束的时间。该值以 ISO 8601 格式指定。在广播结束前，此值不可用。
liveStreamingDetails.scheduledStartTime	datetime 预定的直播开始时间。该值以 ISO 8601 格式指定。
liveStreamingDetails.scheduledEndTime	datetime 排定的直播结束时间。该值以 ISO 8601 格式指定。如果值为空或该属性不存在，则广播将安排无限期地继续。
liveStreamingDetails.concurrentViewers	unsigned long 正在观看直播的观看者人数。如果直播有当前观看者，并且直播所有者没有隐藏视频的观看次数，则此属性及其值将显示。请注意，直播结束后，YouTube 会停止跟踪直播的同时观看人数。因此，此属性不会标识在观看已结束的直播归档视频的观看者人数。 YouTube Data API 返回的同时观看人数可能与 YouTube 数据分析中已处理、排除了垃圾视频的同时观看者数量不同。如需详细了解直播指标，请访问 YouTube 帮助中心。
liveStreamingDetails.activeLiveChatId	string 附加到此视频的当前进行中的实时聊天的 ID。只有当视频是正在进行实时聊天的直播时，此字段才会填写。待直播过渡到完成此字段后，系统将移除此字段，并关闭实时聊天功能。对于持续的广播，实时聊天 ID 将不再与此视频相关联，而是与常驻页面上显示的新视频相关联。
localizations	object localizations 对象包含视频元数据的翻译。
localizations.(key)	object 与键值对关联的本地化文本的语言。该值是一个包含 BCP-47 语言代码的字符串。
localizations.(key).title	string 本地化的视频标题。
localizations.(key).description	string 本地化的视频说明。