Videos

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

video 资源表示 YouTube 视频。

方法

该 API 支持以下针对 videos 资源的方法：

getRating

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

list

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

batchGetStats

检索与 API 请求参数匹配的视频统计信息列表。 立即试用。

insert

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

update

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

delete

删除 YouTube 视频。 立即试用。

rate

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

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,
    "containsSyntheticMedia": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "paidProductPlacementDetails": {
    "hasPaidProductPlacement": boolean
  },
  "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 像素（宽）x 88 像素（高）。 medium - 缩略图的更高分辨率版本。对于视频（或引用视频的资源），此图片的宽度为 320 像素，高度为 180 像素。对于频道，此图片的宽度和高度均为 240 像素。 high - 缩略图图片的高分辨率版本。对于视频（或引用视频的资源），此图片的宽度为 480 像素，高度为 360 像素。对于频道，此图片的宽度和高度均为 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 分钟且不到 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 - E acbG – G acbM - M acbMa15plus - MA15+ acbP - 澳大利亚通信和媒体管理局评定为 P 级的内容。此类节目面向学龄前儿童。 acbPg - PG acbR18plus - R18+ acbUnrated
contentDetails.contentRating.agcomRating	string 意大利通信监管局 (AGCOM) 针对相应视频提供的分级。 此属性的有效值为： agcomT - T agcomUnrated agcomVm14 - VM14 agcomVm18 - VM18
contentDetails.contentRating.anatelRating	string 视频在智利电视上的 Anatel（全国电视协会）分级。 此属性的有效值为： anatelA - A anatelF – F anatelI - 我 anatelI10 – I-10 anatelI12 – I-12 anatelI7 - I-7 anatelR - R anatelUnrated
contentDetails.contentRating.bbfcRating	string 视频的英国电影分级委员会 (BBFC) 分级。 此属性的有效值包括： bbfc12 – 12 bbfc12a – 12A 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 - E 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) 针对加拿大法语广播的视频评级。如需了解详情，请访问 Canadian Broadcast Standards Council 网站。 此属性的有效值为： catvfr13plus - 13 岁以上 catvfr16plus - 16 岁以上 catvfr18plus - 18 岁以上 catvfr8plus – 8 周以上 catvfrG – G catvfrUnrated
contentDetails.contentRating.cbfcRating	string 视频的印度电影审查中央委员会 (CBFC) 分级。 此属性的有效值包括： cbfcA – A cbfcS - S cbfcU - U cbfcUnrated cbfcUA - 不适用 cbfcUA7plus - 不适用 cbfcUA13plus - 不适用 cbfcUA16plus - 不适用
contentDetails.contentRating.cccRating	string 视频的 Consejo de Calificación Cinematográfica（智利）分级。 此属性的有效值为： ccc14 - 14 岁以上 ccc18 - 18 岁以上 ccc18s – 18+ - contenido pornográfico ccc18v – 18+ - contenido excesivamente violento ccc6 – 6+ - Inconveniente para menores de 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 – 14A chvrs18a – 18A chvrsE - E chvrsG – G chvrsPg - PG chvrsR - R chvrsUnrated
contentDetails.contentRating.cicfRating	string 比利时电影控制委员会 (Commission de Contrôle des Films) 评定的视频分级。 此属性的有效值为： cicfE - E 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 - AP cnaUnrated
contentDetails.contentRating.cncRating	string 法国分级制度 - Commission de classification cinematographique 此属性的有效值包括： cnc10 – 10 cnc12 – 12 cnc16 – 16 cnc18 – 18 cncE - E cncT - T cncUnrated
contentDetails.contentRating.csaRating	string 法国视听高评会（负责对广播内容进行分级）对相应视频的分级。 此属性的有效值为： csa10 – 10 csa12 – 12 csa16 – 16 csa18 – 18 csaInterdiction - 禁令 csaT - T csaUnrated
contentDetails.contentRating.cscfRating	string 卢森堡电影分级监督委员会 (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 视频的 Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - Brazil) 分级。 此属性的有效值包括： djctq10 – 10 djctq12 – 12 djctq14 – 14 djctq16 – 16 djctq18 – 18 djctqL – L djctqUnrated
contentDetails.contentRating.djctqRatingReasons[]	list 说明视频获得相应 DJCQT（巴西）分级的原因。
contentDetails.contentRating.ecbmctRating	string 土耳其的评级系统 - 文化和旅游部的评估和分类委员会 此属性的有效值为： ecbmct13a - 13A ecbmct13plus - 13 岁以上 ecbmct15a - 15A ecbmct15plus - 15 岁以上 ecbmct18plus - 18 岁以上 ecbmct7a – 7A ecbmct7plus – 7+ ecbmctG – G ecbmctUnrated ecbmct6a - 6A ecbmct6plus - 6 岁以上 ecbmct10a - 10A ecbmct10plus - 10 岁以上 ecbmct16plus - 16 岁以上
contentDetails.contentRating.eefilmRating	string 视频在爱沙尼亚的评级。 此属性的有效值包括： eefilmK12 – K-12 eefilmK14 - K-14 eefilmK16 – K-16 eefilmK6 - K-6 eefilmL – L 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（映倫）分级。Eirin 是日本的分级制度。 此属性的有效值包括： eirinG – G eirinPg12 - PG-12 eirinR15plus - R15+ eirinR18plus - R18+ eirinUnrated
contentDetails.contentRating.fcbmRating	string 马来西亚电影审查委员会对相应视频的评级。 此属性的有效值包括： fcbm13 – 13 fcbm16 – 16 fcbm18 – 18 fcbm18pa – 18PA fcbm18pl - 18PL fcbm18sg - 18SG fcbm18sx – 18SX fcbmP12 – P12 fcbmP13 - P13 fcbmPg13 - PG13 fcbmU - U fcbmUnrated
contentDetails.contentRating.fcoRating	string 香港电影报刊及物品管理办事处对视频的分级。 此属性的有效值包括： fcoI - 我 fcoIi – II fcoIia - IIA fcoIib - IIB fcoIii - III fcoUnrated
contentDetails.contentRating.fmocRating	string 此属性已于 2015 年 11 月 2 日弃用。请改用 contentDetails.contentRating.cncRating 属性。 视频的 Centre national du cinéma et de l'image animé（法国文化部）分级。 此属性的有效值为： fmoc10 – 10 fmoc12 – 12 fmoc16 – 16 fmoc18 – 18 fmocE - E 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 - FSK 16 fsk18 - FSK 18 fsk6 - FSK 6 fskUnrated
contentDetails.contentRating.grfilmRating	string 视频在希腊的评级。 此属性的有效值包括： grfilmE - E grfilmK – K 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 - 西班牙) 分级。 此属性的有效值为： 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 – 12A 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（阿根廷国家电影和视听艺术学院）分级。 此属性的有效值为： incaaAtp - ATP（适合所有观众） incaaC – X（仅限 18 周岁以上观看，有条件展示） incaaSam13 – 13（仅限 13 岁以上用户） incaaSam16 – 16（仅限 16 周岁以上用户） incaaSam18 – 18（仅限 18 周岁以上用户） incaaUnrated
contentDetails.contentRating.kfcbRating	string 肯尼亚电影分级委员会对相应视频的分级。 此属性的有效值包括： kfcb16plus – 16 kfcbG – GE kfcbPg - PG kfcbR – 18 kfcbUnrated
contentDetails.contentRating.kijkwijzerRating	string voor de Classificatie van Audiovisuele Media (Netherlands)。 此属性的有效值为： kijkwijzer12 – 12 kijkwijzer14 – 14 kijkwijzer16 – 16 kijkwijzer18 – 18 kijkwijzer6 – 6 kijkwijzer9 – 9 kijkwijzerAl - AL kijkwijzerUnrated
contentDetails.contentRating.kmrbRating	string 视频的韩国媒体评级委员会 (영상물등급위원회) 评级。KMRB 会对韩国境内的视频进行分级。 此属性的有效值包括： kmrb12plus - 12 세 이상 관람가 kmrb15plus - 15 세 이상 관람가 kmrbAll - 全年龄段 kmrbR – 청소년 관람불가 kmrbTeenr kmrbUnrated
contentDetails.contentRating.lsfRating	string 印度尼西亚 Lembaga Sensor Film 提供的视频分级。 此属性的有效值为： lsf13 – 13 lsf17 – 17 lsf21 – 21 lsfA – A lsfBo – BO lsfD - D lsfR - R lsfSu - SU lsfUnrated
contentDetails.contentRating.mccaaRating	string 马耳他电影年龄分级委员会对视频的分级。 此属性的有效值包括： mccaa12 – 12 mccaa12a – 12A 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 – K
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 - S mekuUnrated
contentDetails.contentRating.mibacRating	string 意大利文化遗产、活动和旅游部 (Ministero dei Beni e delle Attività Culturali e del Turismo) 针对相应视频的评级。 此属性的有效值为： mibacT mibacUnrated mibacVap mibacVm6 mibacVm12 mibacVm14 mibacVm18
contentDetails.contentRating.mocRating	string 视频的 Ministerio de Cultura（哥伦比亚）分级。 此属性的有效值如下： moc12 – 12 moc15 – 15 moc18 – 18 moc7 – 7 mocBanned - 已禁止 mocE - E 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 菲律宾电影和电视审查和分级委员会 (MTRCB) 对视频的分级。 此属性的有效值为： 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 - PU nbcUnrated
contentDetails.contentRating.nfrcRating	string 视频在保加利亚国家电影中心的分级。 此属性的有效值如下： nfrcA - A nfrcB – B nfrcC – C nfrcD - D nfrcUnrated nfrcX - X
contentDetails.contentRating.nfvcbRating	string 尼日利亚国家电影和视频审查委员会对相应视频的分级。 此属性的有效值为： nfvcb12 – 12 nfvcb12a – 12A 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 - 新西兰) 分级。 此属性的有效值为： 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 - PT pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating	string 视频在委内瑞拉的评级。 此属性的有效值包括： resorteviolenciaA – A resorteviolenciaB – B resorteviolenciaC – C resorteviolenciaD - D resorteviolenciaE - E resorteviolenciaUnrated
contentDetails.contentRating.rtcRating	string 视频的墨西哥广播电视电影总局 (General Directorate of Radio, Television and Cinematography) 分级。 此属性的有效值包括： rtcA - A rtcAa – AA rtcB – B rtcB15 - B15 rtcC – C rtcD - D rtcUnrated
contentDetails.contentRating.rteRating	string 爱尔兰 Raidió Teilifís Éireann 提供的视频分级。 此属性的有效值包括： rteCh – CH rteGa - GA rteMa – MA 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 – L 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，即使视频已设为私享也是如此。 只有在视频的隐私状态为 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 请求时，才会返回此属性值。
status.containsSyntheticMedia	boolean 在 videos.insert 或 videos.update 请求中，频道所有者可以通过此属性披露视频包含逼真的加工或合成 (A/S) 内容。详细了解 与 A/S 内容相关的 YouTube 政策。 A/S 内容的示例包括以下视频： 让其他人以为某个真实人物说了某些话或做了某些事，但实际上此人并未说过或做过 加工有关真实事件或地点的视频片段 生成逼真但实际并未发生的场景
statistics	object statistics 对象包含有关视频的统计信息。
statistics.viewCount	unsigned long 视频的观看次数。 自 2025 年 3 月 31 日起，对于短视频，viewCount 将返回短视频开始播放或重放的次数，而无最低观看时长要求。
statistics.likeCount	unsigned long 表示喜欢相应视频的用户数量。
statistics.dislikeCount	unsigned long 注意：自 2021 年 12 月 13 日起，statistics.dislikeCount 属性已设为私有。这意味着，只有在 API 请求通过视频所有者的身份验证时，API 响应中才会包含相应属性。如需了解详情，请参阅修订历史记录。 表示不喜欢相应视频的用户数量。
statistics.favoriteCount	unsigned long 注意：此属性已被弃用。弃用自 2015 年 8 月 28 日起生效。该属性的值现在始终设置为 0。
statistics.commentCount	unsigned long 视频的评论数。
paidProductPlacementDetails	object paidProductPlacementDetails 对象包含有关视频中付费产品植入的信息。
paidProductPlacementDetails.hasPaidProductPlacement	boolean 如果内容使用付费产品植入，则设置为 true。默认设置为 false。
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 已被弃用，自 2017 年 2 月 27 日起，主题 ID 的运作方式发生了变化。当时，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_ Cricket /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 对象包含有关直播视频广播的元数据。只有当视频是即将开始、正在进行或已完成的直播广播时，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 本地化视频说明。