Videos

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
  },
  "brandPartner": {
    "channelId": string,
    "channelHandle": 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 视频的说明。属性值的长度上限为 5,000 字节，可以包含除 < 和 > 之外的所有有效 UTF-8 字符。 注意：如需让说明中的网址在 YouTube 界面中呈现为可点击的链接，频道必须满足平台级要求，例如完成频道验证或启用高级功能。 您可以在说明文本中添加格式化的时间戳（例如 00:00），从而创建视频章节。
snippet.thumbnails	object 与视频关联的缩略图的映射。对于地图中的每个对象，键是缩略图的名称，值是包含有关缩略图的其他信息的对象。
snippet.thumbnails.(key)	object 有效的键值包括： default - 默认缩略图。视频（或引用视频的资源，例如播放列表项或搜索结果）的默认缩略图宽度为 120 像素，高度为 90 像素。频道的默认缩略图尺寸为 88 像素（宽）x 88 像素（高）。 medium - 缩略图的更高分辨率版本。对于视频（或引用视频的资源），此图片宽 320 像素，高 180 像素。对于频道，此图片的宽度为 240 像素，高度为 240 像素。 high - 缩略图的高分辨率版本。对于视频（或引用视频的资源），此图片的宽度为 480 像素，高度为 360 像素。对于频道，此图片的尺寸为 800px（宽）x 800px（高）。 standard - 分辨率比 high 分辨率图片更高的缩略图。此图片适用于某些视频以及引用视频的其他资源，例如播放列表项或搜索结果。此图片的宽度为 640 像素，高度为 480 像素。 maxres - 缩略图的高分辨率版本。此图片尺寸适用于某些视频以及引用视频的其他资源，例如播放列表项或搜索结果。此图片的宽度为 1280 像素，高度为 720 像素。 fhd - 缩略图的全高清 (1080p) 版本。此图片尺寸适用于部分视频。此图片的宽度为 1920 像素，高度为 1080 像素。 qhd - 缩略图的 2K 分辨率 (1440p / 2K) 版本。此图片尺寸适用于部分视频。此图片的宽度为 2560 像素，高度为 1440 像素。 uhd - 缩略图图片的超高分辨率 (4K) 版本。此图片尺寸适用于部分视频。此图片的宽度为 3840 像素，高度为 2160 像素。
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 规范。 注意：由于转码和编码的差异，返回的时长可能与实际播放时长略有不同（例如，相差 1 秒）。
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 - 澳大利亚通信和媒体管理局 (ACMA) 评定为 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 - 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 – S cbfcU - U cbfcUnrated cbfcUA - U/A cbfcUA7plus - 不适用 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 violento ccc6 - 6+ - 不适合 7 岁以下儿童 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 视频在罗马尼亚国家视听委员会 (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 视频在法国视听最高委员会 (Conseil supérieur de l'audiovisuel) 的分级，该委员会负责对广播内容进行分级。 此属性的有效值如下： 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 - 几内亚 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 - I fcoIi – II fcoIia - IIA fcoIib - IIB fcoIii - III fcoUnrated
contentDetails.contentRating.fmocRating	string 此属性已于 2015 年 11 月 2 日弃用。请改用 contentDetails.contentRating.cncRating 属性。 视频的法国国家电影和动画中心（法国文化部）分级。 此属性的有效值为： fmoc10 - 10 fmoc12 - 12 fmoc16 - 16 fmoc18 - 18 fmocE – E fmocU - U fmocUnrated
contentDetails.contentRating.fpbRating	string 南非电影和出版物委员会 (FPB) 为视频评定的分级。 此属性的有效值如下： 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 - 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 – 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（Instituto Nacional de Cine y Artes Audiovisuales - 阿根廷）分级。 此属性的有效值包括： incaaAtp - ATP（适合所有观众） incaaC - X（仅限 18 岁及以上观众观看，有条件放映） incaaSam13 – 13（仅适合年满 13 周岁的用户） incaaSam16 - 16（仅限 16 周岁及以上人士观看） incaaSam18 – 18（仅限 18 周岁及以上用户） incaaUnrated
contentDetails.contentRating.kfcbRating	string 肯尼亚电影分级委员会 (KFCB) 提供的视频分级。 此属性的有效值为： 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 - 청소년 관람불가 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 - 回复 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 – 葡萄牙 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 - 马萨诸塞州 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 视频的 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 视频的隐私状态。在 videos.insert 请求中，如果您未为此属性指定值，则上传视频的隐私状态默认为 public。如 YouTube 帮助中心所述，根据创作者账号设置，某些上传内容可能会默认设为private。从未经核实的 API 项目上传的视频不受私享观看模式的限制。 此属性的有效值为： 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 此值表示视频是否可以嵌入到其他网站中。 注意：即使上传者的设置允许嵌入，视频仍可能因平台政策或第三方版权主张（例如 Content ID）而无法在嵌入式播放器中播放。
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 视频的观看次数。 自 2026 年 8 月 24 日起，对于频道上的所有视频格式（长视频、直播和短视频），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_ 板球 /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 将不再与此视频相关联，而是与持续网页上显示的新视频相关联。
brandPartner	object brandPartner 对象包含与视频关联的品牌合作伙伴的详细信息，用于创作者发起的品牌合作伙伴访问权限 (CI BPA)。
brandPartner.channelId	string 品牌合作伙伴的外部频道 ID。此字段必须以“UC”开头。建立访问权限时，必须设置 channelId 或 channelHandle，但响应中只会返回 channelId。
brandPartner.channelHandle	string 品牌合作伙伴的频道标识名。此字段必须以“@”开头。建立访问权限时，必须设置 channelId 或 channelHandle，但响应中仅返回 channelId。
localizations	object localizations 对象包含视频元数据的翻译。
localizations.(key)	object 与键值对关联的本地化文本的语言。此值是一个包含 BCP-47 语言代码的字符串。
localizations.(key).title	string 本地化的视频标题。
localizations.(key).description	string 本地化视频说明。