Videos

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

video 资源表示 YouTube 视频。

方法

该 API 支持对 videos 资源使用以下方法：

getRating

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

list

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

insert

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

update

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

delete

删除 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,
    "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 此 ID 是 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 分钟且不足 1 小时的视频，时长采用 PT#M#S 格式，其中字母 PT 表示该值指定了一段时长，字母 M 和 S 分别表示时长（以分钟和秒为单位）。M 和 S 字母前面的 # 字符都是整数，用于指定视频的时长（以分钟或秒为单位）。例如，值为 PT15M33S 表示视频时长为 15 分 33 秒。 如果视频时长至少为 1 小时，时长采用 PT#H#M#S 格式，其中字母 H 前面的 # 用于指定视频时长（以小时为单位），所有其他详细信息与上文所述相同。如果视频时长至少为 1 天，则字母 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 - 已获得澳大利亚通信和媒体管理局 (Australian Communications and Media Authority) C 分级的节目。这类节目适合未满 14 周岁的儿童（学龄前儿童除外）。 acbE - 东 acbG - G acbM - 一月 acbMa15plus - MA15+ acbP - 已获得澳大利亚通信和媒体管理局 (Australian Communications and Media Authority) P 分级的节目。这些节目面向学龄前儿童。 acbPg - PG acbR18plus - R18+ acbUnrated
contentDetails.contentRating.agcomRating	string 意大利 Autorità per 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 - 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) 对加拿大法语广播节目的分级。如需了解详情，请访问加拿大广播标准委员会网站。 此属性的有效值包括： catvfr13plus - 13 周岁以上 catvfr16plus - 16 岁以上 catvfr18plus - 18 岁以上 catvfr8plus - 8 或更高版本 catvfrG - G catvfrUnrated
contentDetails.contentRating.cbfcRating	string 视频的印度中央电影分级委员会 (CBFC) 分级。 此属性的有效值如下： 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 (Chile) 分级。 此属性的有效值为： 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 葡萄牙委员会 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 - 18 安 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 - 东 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 movies) (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 - 巴西) 分级。 此属性的有效值包括： djctq10 - 10 djctq12 - 12 djctq14 - 14 djctq16 - 16 djctq18 - 18 djctqL - L djctqUnrated
contentDetails.contentRating.djctqRatingReasons[]	list 说明视频获得 DJCQT（巴西）分级的原因。
contentDetails.contentRating.ecbmctRating	string 土耳其的分级制度 - 文化和旅游部评估和分级委员会 此属性的有效值包括： ecbmct13a - 13 安 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 - 幼儿园至 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 - PG-13 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 属性。 视频的 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 (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 - GE 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 이용 선람미 kmrbAll - ☰람弗 kmrbR - ALL 람낈 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 - PG-13 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 意大利文化和旅游部 (MiBACT) 对视频的评级。 此属性的有效值为： mibacT mibacUnrated mibacVap mibacVm6 mibacVm12 mibacVm14 mibacVm18
contentDetails.contentRating.mocRating	string 视频的 Ministerio de Cultura (Colombia) 分级。 此属性的有效值如下： moc12 - 12 人 moc15 - 15 moc18 - 18 moc7 - 7 mocBanned - 已禁止 mocE - E mocT - T mocUnrated mocX - X
contentDetails.contentRating.moctwRating	string 台湾文化部对视频的评级。 此属性的有效值包括： moctwG - G moctwP - 下午 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 - 英国（绿色分级 - 适合所有观众） 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 - 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 视频的广播、电视和电影总局（墨西哥）分级。 此属性的有效值包括： rtcA - A rtcAa - AA rtcB - B rtcB15 - B15 rtcC - C rtcD - D rtcUnrated
contentDetails.contentRating.rteRating	string 视频评分由爱尔兰歌手 Raidió Teilifís Éireann 提供。 此属性的有效值包括： rteCh - 瑞士 rteGa - GA rteMa - MA rtePs - 下午 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 视频的 TV Parental Guidelines (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 请求时，才会返回属性值。
status.containsSyntheticMedia	boolean 在 videos.insert 或 videos.update 请求中，此属性可以让频道所有者披露某个视频包含逼真的加工内容或合成 (A/S) 内容。详细了解与 A/S 内容相关的 YouTube 政策。 A/S 内容示例包括存在以下情况的视频： 让现实中存在的人看似说了某些话或做了某些事，但实际上他们并未说过或做过 加工有关真实事件或地点的视频片段 生成逼真但实际并不存在的场景
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 视频收到的评论数。
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 日起已弃用。我们将继续支持该 API 直到 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_ 板球 /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 本地化的视频说明。