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.titlesnippet.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 表示该值指定了一段时长,字母 MS 分别表示时长(以分钟和秒为单位)。MS 字母前面的 # 字符都是整数,用于指定视频的时长(以分钟或秒为单位)。例如,值为 PT15M33S 表示视频时长为 15 分 33 秒。

如果视频时长至少为 1 小时,时长采用 PT#H#M#S 格式,其中字母 H 前面的 # 用于指定视频时长(以小时为单位),所有其他详细信息与上文所述相同。如果视频时长至少为 1 天,则字母 PT 会分开,并且值的格式为 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 属性设为过去的日期和时间的效果与将视频的 privacyStatusprivate 更改为 public 的效果相同。
status.license string
视频的许可。

此属性的有效值包括:
  • creativeCommon
  • youtube
status.embeddable boolean
此值表示视频是否可以嵌入到其他网站中。
status.publicStatsViewable boolean
此值用于指明视频观看页面上的详细视频统计信息是否可供公开查看。默认情况下,这些统计信息是可见的,即使此属性的值设为 false,视频的观看次数和评分等统计信息仍会公开显示。
status.madeForKids boolean
此值表示视频是否被指定为面向儿童,并包含视频当前的“面向儿童的内容”状态。例如,状态可能会根据 selfDeclaredMadeForKids 属性的值确定。请访问 YouTube 帮助中心,详细了解如何为频道、视频或广播设置观众群。
status.selfDeclaredMadeForKids boolean
videos.insertvideos.update 请求中,频道所有者可以使用此属性将视频指定为面向儿童。在 videos.list 请求中,只有在频道所有者授权了 API 请求时,才会返回属性值。
status.containsSyntheticMedia boolean
videos.insertvideos.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。

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
本地化的视频说明。