此页面由 Cloud Translation API 翻译。

Videos

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

video 资源表示 YouTube 视频。

方法

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

getRating: 检索已获授权的用户对指定视频列表所给出的评分。立即试用。
list: 返回与 API 请求参数匹配的视频列表。立即试用。
insert: 将视频上传到 YouTube，并可选择设置视频的元数据。
update: 更新视频的元数据。立即试用。
delete: 删除 YouTube 视频。立即试用。
rate: 为视频添加赞或踩评分，或移除视频评分。立即试用。
reportAbuse: 举报包含滥用内容的视频。立即试用。

资源表示法

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

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

属性

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

属性

kind string
用于标识 API 资源的类型。该值将为 youtube#video。

etag etag
此资源的 ETag。

id string
YouTube 用于唯一标识视频的 ID。

snippet object
snippet 对象包含视频的基本详细信息，例如标题、说明和类别。

snippet.publishedAt

datetime
视频的发布日期和时间。请注意，此时间可能与视频上传的时间不同。例如，如果视频在上传时设为私享，之后再设为公开，此属性将指定视频的公开时间。

以下是几种特殊情况：

如果视频作为私享视频上传，并且频道所有者检索了视频元数据，则该属性值会指定视频的上传日期和时间。
如果视频作为不公开列出的视频上传，则该属性值还会指定视频的上传日期和时间。在这种情况下，只要知道视频的唯一视频 ID，任何人都可以检索视频元数据。

该值采用 ISO 8601 格式指定。

snippet.channelId string
此 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 像素。
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 - E
acbG - G
acbM - M
acbMa15plus - MA15+
acbP - 已获得澳大利亚通信和媒体管理局 (ACMA) 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) 负责。如需了解详情，请访问 Canadian Broadcast Standards Council 网站。

此属性的有效值如下：

catv14plus - 14 周岁以上
catv18plus - 18 周岁以上
catvC - C
catvC8 - C8
catvG - G
catvPg - PG
catvUnrated

contentDetails.contentRating.catvfrRating

string
加拿大法语广播内容的加拿大广播电视和电信委员会 (CRTC) 评级。如需了解详情，请访问 Canadian Broadcast Standards Council 网站。

此属性的有效值如下：

catvfr13plus - 13 周岁以上
catvfr16plus - 16 周岁以上
catvfr18plus - 18 周岁以上
catvfr8plus - 8 或更高版本
catvfrG - G
catvfrUnrated

contentDetails.contentRating.cbfcRating

string
视频的印度中央电影分级委员会 (CBFC) 分级。

此属性的有效值如下：

cbfcA - A
cbfcS - S
cbfcU - U
cbfcUnrated
cbfcUA - 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 - 18A
chvrsE - E
chvrsG - G
chvrsPg - PG
chvrsR - R
chvrsUnrated

contentDetails.contentRating.cicfRating

string
比利时电影委员会 (Commission de Contrôle des Films) 对视频的评级。

此属性的有效值为：

cicfE - E
cicfKntEna - KNT/ENA
cicfKtEa - KT/EA
cicfUnrated

contentDetails.contentRating.cnaRating

string
罗马尼亚 CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) 对视频的分级。

此属性的有效值为：

cna12 - 12
cna15 - 15
cna18 - 18
cna18plus - 18 周岁以上
cnaAp - AP
cnaUnrated

contentDetails.contentRating.cncRating

string
法国分级制度 - Commission de classification cinematographique

此属性的有效值如下：

cnc10 - 10
cnc12 - 12
cnc16 - 16
cnc18 - 18
cncE - E
cncT - T
cncUnrated

contentDetails.contentRating.csaRating

string
法国 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
视频的巴西司法、分类、资质和影视内容分级委员会 (DJCQT) 分级。

此属性的有效值包括：

djctq10 - 10
djctq12 - 12
djctq14 - 14
djctq16 - 16
djctq18 - 18
djctqL - L
djctqUnrated

contentDetails.contentRating.djctqRatingReasons[] list
说明视频获得 DJCQT（巴西）分级的原因。

contentDetails.contentRating.ecbmctRating

string
土耳其分级制度 - 土耳其文化和旅游部评估和分类委员会

此属性的有效值为：

ecbmct13a - 13A
ecbmct13plus - 13 周岁以上
ecbmct15a - 15A
ecbmct15plus - 15 岁以上
ecbmct18plus - 18 周岁以上
ecbmct7a - 7A
ecbmct7plus - 7 或更高版本
ecbmctG - G
ecbmctUnrated
ecbmct6a - 6A
ecbmct6plus - 6 岁以上
ecbmct10a - 10A
ecbmct10plus - 10 以上
ecbmct16plus - 16 周岁以上

contentDetails.contentRating.eefilmRating

string
视频在爱沙尼亚的分级。

此属性的有效值如下：

eefilmK12 - 基础教育 (K-12)
eefilmK14 - K-14
eefilmK16 - K-16
eefilmK6 - K-6
eefilmL - L
eefilmMs12 - MS-12
eefilmMs6 - MS-6
eefilmPere - Pere
eefilmUnrated

contentDetails.contentRating.egfilmRating

string
视频在埃及的分级。

此属性的有效值如下：

egfilm18 - 18
egfilmBn - BN
egfilmGn - GN
egfilmUnrated

contentDetails.contentRating.eirinRating

string
视频的 Eirin (映倫) 分级。Eirin 是日本的分级制度。

此属性的有效值如下：

eirinG - G
eirinPg12 - PG-12
eirinR15plus - R15+
eirinR18plus - R18+
eirinUnrated

contentDetails.contentRating.fcbmRating

string
马来西亚电影审查委员会对视频的分级。

此属性的有效值如下：

fcbm13 - 13
fcbm16 - 16
fcbm18 - 18
fcbm18pa - 18PA
fcbm18pl - 18PL
fcbm18sg - 18SG
fcbm18sx - 18SX
fcbmP12 - P12
fcbmP13 - P13
fcbmPg13 - 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) 分级。如需了解详情，请访问 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 (Netherlands)。

此属性的有效值为：

kijkwijzer12 - 12
kijkwijzer14 - 14
kijkwijzer16 - 16
kijkwijzer18 - 18
kijkwijzer6 - 6
kijkwijzer9 - 9
kijkwijzerAl - AL
kijkwijzerUnrated

contentDetails.contentRating.kmrbRating

string
视频的韩国媒体分级委员会 (영상물등급위원회) 分级。KMRB 负责为韩国的视频分级。

此属性的有效值如下：

kmrb12plus – 12세 이상 관람가
kmrb15plus – 15세 이상 관람가
kmrbAll – 전체관람가
kmrbR – 청소년 관람불가
kmrbTeenr
kmrbUnrated

contentDetails.contentRating.lsfRating

string
印度尼西亚电影审查机构 (Lembaga Sensor Film) 对视频的评级。

此属性的有效值为：

lsf13 - 13
lsf17 - 17
lsf21 - 21
lsfA - A
lsfBo - BO
lsfD - D
lsfR - R
lsfSu - SU
lsfUnrated

contentDetails.contentRating.mccaaRating

string
马耳他电影分级委员会对视频的分级。

此属性的有效值如下：

mccaa12 - 12
mccaa12a - 12A
mccaa14 - 14 - 此分级已从 2013 年引入的新分类结构中移除。
mccaa15 - 15
mccaa16 - 16 - 此分级已从 2013 年引入的新分类结构中移除。
mccaa18 - 18
mccaaPg - PG
mccaaU - U
mccaaUnrated

contentDetails.contentRating.mccypRating

string
丹麦电影学院 (Det Danske Filminstitut) 儿童和青少年媒体委员会对视频的分级。

此属性的有效值为：

mccyp11 - 11
mccyp15 - 15
mccyp7 - 7
mccypA - A
mccypUnrated

contentDetails.contentRating.mcstRating

string
视频在越南的分级制度 - MCST

此属性的有效值如下：

mcst0 - 0
mcst16plus - 16 周岁以上
mcstC13 - C13
mcstC16 - C16
mcstC18 - C18
mcstP - P
mcstUnrated
mcstT13 - T13
mcstT16 - T16
mcstT18 - T18
mcstK - K

contentDetails.contentRating.mdaRating

string
新加坡媒体发展局 (MDA) 对视频的分级，具体而言是新加坡电影审查委员会 (BFC) 对视频的分级。

此属性的有效值为：

mdaG - G
mdaM18 - M18
mdaNc16 - NC16
mdaPg - PG
mdaPg13 - 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 - 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 - 英国（绿色分级 - 适合所有观众）
mpaatRb - RB（红色条纹 - 建议 17 周岁以上观看）

contentDetails.contentRating.mtrcbRating

string
菲律宾电影和电视评价和分级委员会 (Movie and Television Review and Classification Board) 对视频的分级。

此属性的有效值为：

mtrcbG - G
mtrcbPg - PG
mtrcbR13 - R-13
mtrcbR16 - R-16
mtrcbR18 - R-18
mtrcbUnrated
mtrcbX - X

contentDetails.contentRating.nbcRating

string
马尔代夫国家分级局对视频的分级。

此属性的有效值为：

nbc12plus - 12 岁以上
nbc15plus - 15 岁以上
nbc18plus - 18 周岁以上
nbc18plusr - 18+R
nbcG - G
nbcPg - PG
nbcPu - PU
nbcUnrated

contentDetails.contentRating.nfrcRating

string
保加利亚国家电影中心对视频的分级。

此属性的有效值如下：

nfrcA - A
nfrcB - B
nfrcC - C
nfrcD - D
nfrcUnrated
nfrcX - X

contentDetails.contentRating.nfvcbRating

string
尼日利亚国家电影和视频审查委员会对视频的分级。

此属性的有效值为：

nfvcb12 - 12
nfvcb12a - 12A
nfvcb15 - 15
nfvcb18 - 18
nfvcbG - G
nfvcbPg - PG
nfvcbRe - RE
nfvcbUnrated

contentDetails.contentRating.nkclvRating

string
视频的 Nacionãlais Kino centrs（拉脱维亚国家电影中心）分级。

此属性的有效值为：

nkclv12plus - 12 岁以上
nkclv18plus - 18 周岁以上
nkclv7plus - 7 或更高版本
nkclvU - U
nkclvUnrated

contentDetails.contentRating.oflcRating

string
视频的电影和文学分级办公室 (OFLC - 新西兰) 分级。

此属性的有效值为：

oflcG - G
oflcM - M
oflcPg - PG
oflcR13 - R13
oflcR15 - R15
oflcR16 - R16
oflcR18 - R18
oflcRp13 - RP13
oflcRp16 - RP16
oflcUnrated

contentDetails.contentRating.pefilmRating

string
视频在秘鲁的分级。

此属性的有效值如下：

pefilm14 - 14
pefilm18 - 18
pefilmPg - PG
pefilmPt - PT
pefilmUnrated

contentDetails.contentRating.resorteviolenciaRating

string
视频在委内瑞拉的分级。

此属性的有效值如下：

resorteviolenciaA - A
resorteviolenciaB - B
resorteviolenciaC - C
resorteviolenciaD - D
resorteviolenciaE - E
resorteviolenciaUnrated

contentDetails.contentRating.rtcRating

string
视频的墨西哥广播电视电影总局 (General Directorate of Radio, Television and Cinematography) 分级。

此属性的有效值如下：

rtcA - A
rtcAa - AA
rtcB - B
rtcB15 - B15
rtcC - C
rtcD - D
rtcUnrated

contentDetails.contentRating.rteRating

string
爱尔兰 Raidió Teilifís Éireann 对视频的评分。

此属性的有效值如下：

rteCh - 瑞士
rteGa - GA
rteMa - MA
rtePs - PS
rteUnrated

contentDetails.contentRating.russiaRating

string
视频的俄罗斯联邦国家电影注册处 (MKRF - 俄罗斯) 分级。

此属性的有效值包括：

russia0 - 0+
russia12 - 12 岁以上
russia16 - 16 周岁以上
russia18 - 18 周岁以上
russia6 - 6 岁以上
russiaUnrated

contentDetails.contentRating.skfilmRating

string
视频在斯洛伐克的评级。

此属性的有效值如下：

skfilmG - G
skfilmP2 - P2
skfilmP5 - P5
skfilmP8 - P8
skfilmUnrated

contentDetails.contentRating.smaisRating

string
视频在冰岛的分级。

此属性的有效值如下：

smais12 - 12
smais14 - 14
smais16 - 16
smais18 - 18
smais7 - 7
smaisL - L
smaisUnrated

contentDetails.contentRating.smsaRating

string
瑞典国家媒体委员会 (Statens medieråd) 对视频的评级。

此属性的有效值为：

smsa11 - 11
smsa15 - 15
smsa7 - 7
smsaA - 所有年龄段
smsaUnrated

contentDetails.contentRating.tvpgRating

string
视频的 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

视频的观看次数。

自 2025 年 3 月 31 日起，对于 Shorts 短视频，viewCount 将返回短视频开始播放或重放的次数，而无最低观看时长要求。

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

Videos 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

方法

资源表示法

属性

Videos