Videos

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

video 资源表示 YouTube 视频。

方法

对于 videos 资源,该 API 支持以下方法:

getRating
检索授权用户对指定视频列表的评分。立即试用
list
返回与 API 请求参数匹配的视频列表。立即试用
插入
将视频上传到 YouTube,并视需要设置视频的元数据。
update
更新视频的元数据。 立即试用
删除
删除 YouTube 视频。 立即试用
税率
为视频添加“顶”或“踩”评分,或者移除视频的评分。 立即试用
举报滥用行为
举报包含侮辱性内容的视频。 立即试用

资源表示法

以下 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
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "player": {
    "embedHtml": string,
    "embedHeight": long,
    "embedWidth": long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "relevantTopicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "recordingDetails": {
    "recordingDate": datetime
  },
  "fileDetails": {
    "fileName": string,
    "fileSize": unsigned long,
    "fileType": string,
    "container": string,
    "videoStreams": [
      {
        "widthPixels": unsigned integer,
        "heightPixels": unsigned integer,
        "frameRateFps": double,
        "aspectRatio": double,
        "codec": string,
        "bitrateBps": unsigned long,
        "rotation": string,
        "vendor": string
      }
    ],
    "audioStreams": [
      {
        "channelCount": unsigned integer,
        "codec": string,
        "bitrateBps": unsigned long,
        "vendor": string
      }
    ],
    "durationMs": unsigned long,
    "bitrateBps": unsigned long,
    "creationTime": string
  },
  "processingDetails": {
    "processingStatus": string,
    "processingProgress": {
      "partsTotal": unsigned long,
      "partsProcessed": unsigned long,
      "timeLeftMs": unsigned long
    },
    "processingFailureReason": string,
    "fileDetailsAvailability": string,
    "processingIssuesAvailability": string,
    "tagSuggestionsAvailability": string,
    "editorSuggestionsAvailability": string,
    "thumbnailsAvailability": string
  },
  "suggestions": {
    "processingErrors": [
      string
    ],
    "processingWarnings": [
      string
    ],
    "processingHints": [
      string
    ],
    "tagSuggestions": [
      {
        "tag": string,
        "categoryRestricts": [
          string
        ]
      }
    ],
    "editorSuggestions": [
      string
    ]
  },
  "liveStreamingDetails": {
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "concurrentViewers": unsigned long,
    "activeLiveChatId": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

属性

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

属性
kind string
标识 API 资源类型。其值为 youtube#video
etag etag
此资源的 Etag。
id string
YouTube 用来对视频进行唯一标识的 ID。
snippet object
snippet 对象包含视频的基本详情,例如标题、说明和类别。
snippet.publishedAt datetime
视频发布的日期和时间。请注意,此时间可能与视频上传的时间不同。例如,如果某个视频作为私享视频上传,后来又变为公开状态,则此属性会指明该视频公开的时间。

存在几种特殊情况:
  • 如果视频作为私享视频上传,并且频道所有者检索了视频元数据,则属性值会指定视频的上传日期和时间。
  • 如果视频作为不公开列出的视频上传,则属性值还会指定视频的上传日期和时间。在这种情况下,任何知道视频唯一视频 ID 的人都可以检索视频元数据。
该值以 ISO 8601 格式指定。
snippet.channelId string
YouTube 用来唯一标识上传视频的目标频道的 ID。
snippet.title string
视频的标题。属性值的长度上限为 100 个字符,可以包含除 <> 以外的所有有效的 UTF-8 字符。如果您调用 videos.update 方法并更新 video 资源的 snippet 部分,则必须为此属性设置一个值。
snippet.description string
视频的说明。属性值的长度上限为 5000 字节,并且可以包含除 <> 以外的所有有效的 UTF-8 字符。
snippet.thumbnails object
与视频相关的缩略图图。对于映射中的每个对象,键都是缩略图的名称,其值是包含有关缩略图的其他信息的对象。
snippet.thumbnails.(key) object
有效的键值对包括:
  • default - 默认缩略图。视频(或引用视频的资源,例如播放列表项或搜索结果)的默认缩略图为 120 像素宽 90 像素高。频道的默认缩略图为 88 像素宽 88 像素高。
  • medium – 更高分辨率版本的缩略图。对于视频(或引用视频的资源),此图片的宽度为 320 像素,高度为 180 像素。对于频道,此图片的宽度为 240 px,高度为 240 px。
  • high - 缩略图的高分辨率版本。对于视频(或引用视频的资源),此图片的宽度为 480 像素,高度为 360 像素。对于频道,此图片的宽度为 800 px,高度为 800 px。
  • standard - 缩略图的分辨率甚至高于 high 分辨率版本。此图片适用于某些视频和其他资源(例如播放列表项或搜索结果)显示。此图片的宽度为 640 px,高度为 480 px。
  • maxres - 缩略图的最高分辨率版本。此图片大小适用于某些视频和其他资源(例如播放列表项或搜索结果),此图片的宽度为 1280 px,高度为 720 px。
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 小时的视频,时长的格式为 PT#M#S,其中字母 PT 表示相应的值表示时间段,字母 MS 分别表示时长(以分钟和秒为单位)。MS 字母前面的 # 字符都是整数,用于指定视频的分钟数(或秒数)。例如,值 PT15M33S 表示视频时长为 15 分 33 秒。

如果视频时长至少为 1 小时,则时长格式为 PT#H#M#S,其中字母 H 前面的 # 指定了视频的时长(以小时为单位),其他所有详细信息与上文所述相同。如果视频时长至少为一天,则字母 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 – 已被澳大利亚通信与媒体管理局划定为C分级的节目。这些节目面向未满 14 周岁的儿童(不包含学龄前儿童)。
  • acbE - 东
  • acbG - G
  • acbM - M
  • acbMa15plus - MA15+
  • acbP – 已被澳大利亚通信与媒体管理局划定为P分级的节目。这些节目面向学龄前儿童。
  • acbPg - PG
  • acbR18plus - R18+
  • acbUnrated
contentDetails.contentRating.agcomRating string
该视频由意大利 Autorità per le Garanzie nelle Comunicazioni (AGCOM) 给出的视频分级。

此属性的有效值包括:
  • agcomT - 平日
  • agcomUnrated
  • agcomVm14 - VM14
  • agcomVm18 - VM18
contentDetails.contentRating.anatelRating string
该视频在智利电视机的 Anatel (Asociación Nacional de Televisión) 的分级。

此属性的有效值包括:
  • anatelA - A
  • anatelF - 周五
  • 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
该视频由泰国电影和视频审核委员会 (Board of Film and Video Censors) 评定。

此属性的有效值包括:
  • bfvc13 - 13
  • bfvc15 - 15
  • bfvc18 - 18 岁
  • bfvc20 - 20
  • bfvcB - B
  • bfvcE - 东
  • 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 - India) 的分级。

此属性的有效值包括:
  • 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(智利)评分。

此属性的有效值包括:
  • ccc14 - 14 岁以上
  • ccc18 - 18 岁以上
  • ccc18s - 18 岁以上 - conenido pornográfico
  • ccc18v - 18 岁以上 - contenido excesivamente 暴力内容
  • ccc6 - 6 岁以上 - 7 años 较为方便
  • cccTe - Todo espectador
  • cccUnrated
contentDetails.contentRating.cceRating string
该视频由葡萄牙 Comissão de Classificação de Espect ́culos 分级。

此属性的有效值包括:
  • cceM12 - 12
  • cceM14 - 14 岁
  • cceM16 - 16
  • cceM18 - 18 岁
  • cceM4 - 4
  • cceM6 - 6
  • cceUnrated
contentDetails.contentRating.chfilmRating string
视频在瑞士的分级。

此属性的有效值包括:
  • chfilm0 - 0
  • chfilm12 - 12
  • chfilm16 - 16
  • chfilm18 - 18 岁
  • chfilm6 - 6
  • chfilmUnrated
contentDetails.contentRating.chvrsRating string
该视频的加拿大家庭视频分级系统 (CHVRS) 分级。

此属性的有效值包括:
  • chvrs14a - 14A
  • chvrs18a - 18A
  • chvrsE - 东
  • chvrsG - G
  • chvrsPg - PG
  • chvrsR - R
  • chvrsUnrated
contentDetails.contentRating.cicfRating string
该视频由 Commission de Contrôle des Films(比利时)提供的分级。

此属性的有效值包括:
  • cicfE - 东
  • cicfKntEna - KNT/ENA
  • cicfKtEa - KT/EA
  • cicfUnrated
contentDetails.contentRating.cnaRating string
该视频由罗马尼亚 CONSILIUL NATIONAL AUDIOVIZUALULUI (CNA) 发布。

此属性的有效值包括:
  • cna12 - 12
  • cna15 - 15
  • cna18 - 18 岁
  • cna18plus - 18 岁以上
  • cnaAp - 美联社
  • cnaUnrated
contentDetails.contentRating.cncRating string
法国的分级制度 - Commission de category movietographique

此属性的有效值包括:
  • cnc10 - 10
  • cnc12 - 12
  • cnc16 - 16
  • cnc18 - 18 岁
  • cncE - 东
  • cncT - 平日
  • cncUnrated
contentDetails.contentRating.csaRating string
该视频由法国 Conseil supérieur de l?audiovisuel 给出,用于对广播内容进行评分。

此属性的有效值包括:
  • csa10 - 10
  • csa12 - 12
  • csa16 - 16
  • csa18 - 18 岁
  • csaInterdiction - 禁言
  • csaT - 平日
  • csaUnrated
contentDetails.contentRating.cscfRating string
该视频由卢森堡的 Commission de surveillance de la 敏感类别 desmovies (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
该视频的 Leaveamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - 巴西) 评分。

此属性的有效值包括:
  • djctq10 - 10
  • djctq12 - 12
  • djctq14 - 14 岁
  • djctq16 - 16
  • djctq18 - 18 岁
  • djctqL - 左
  • 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 - 左
  • eefilmMs12 - MS-12
  • eefilmMs6 - MS-6
  • eefilmPere - Pere
  • eefilmUnrated
contentDetails.contentRating.egfilmRating string
该视频在埃及的分级。

此属性的有效值包括:
  • egfilm18 - 18 岁
  • egfilmBn - BN
  • egfilmGn - GN
  • egfilmUnrated
contentDetails.contentRating.eirinRating string
视频的 Eirin(映伦)分级。Eirin 是日本的分级制度。

此属性的有效值包括:
  • eirinG - G
  • eirinPg12 - PG-12
  • eirinR15plus - R15+
  • eirinR18plus - R18+
  • eirinUnrated
contentDetails.contentRating.fcbmRating string
该视频由马来西亚电影审查委员会发布的分级。

此属性的有效值包括:
  • fcbm13 - 13
  • fcbm16 - 16
  • fcbm18 - 18 岁
  • fcbm18pa - 18PA
  • fcbm18pl - 18PL
  • fcbm18sg - 18SG
  • fcbm18sx - 18SX
  • fcbmP12 - P12
  • fcbmP13 - P13
  • fcbmPg13 - PG13
  • fcbmU - U
  • fcbmUnrated
contentDetails.contentRating.fcoRating string
该视频由香港电影、报纸与文献管理局提供的分级。

此属性的有效值包括:
  • fcoI - I
  • fcoIi - II
  • fcoIia - IIA
  • fcoIib - IIB
  • fcoIii - III
  • fcoUnrated
contentDetails.contentRating.fmocRating string
此属性自 2015 年 11 月 2 日起已弃用。请改用 contentDetails.contentRating.cncRating 属性。

该视频的 Centrenation du cinéma et de l'image animé (French Ministry of Culture) 评分。

此属性的有效值包括:
  • fmoc10 - 10
  • fmoc12 - 12
  • fmoc16 - 16
  • fmoc18 - 18 岁
  • fmocE - 东
  • 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 - 东
  • 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
该视频的韩国媒体分级委员会 (Experienceวิลลิงหลั) 的分级。韩国的视频采用 KMRB 费率。

此属性的有效值包括:
  • kmrb12plus – 12 과 이보 보람요
  • kmrb15plus - 15🧠? 이미 보람选择一个选项
  • kmrbAll - האם람해
  • kmrbR - הכ년 보람불个性化广告
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
该视频在印度尼西亚 Lembaga 传感器电影中的评分。

此属性的有效值包括:
  • 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)的儿童与年轻人媒体委员会 (Media Council for Children and Young People) 评定的分级。

此属性的有效值包括:
  • 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 Audiovisualinen Instituutti(国家视听研究所)的分级。

此属性的有效值包括:
  • meku12 - 12
  • meku16 - 16
  • meku18 - 18 岁
  • meku7 - 7
  • mekuS - 周六
  • 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
该视频的文化部(哥伦比亚)分级。

此属性的有效值包括:
  • moc12 - 12
  • moc15 - 15
  • moc18 - 18 岁
  • moc7 - 7
  • mocBanned - 已禁止
  • mocE - 东
  • mocT - 平日
  • 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
该视频由电影和电视评论与分类委员会(菲律宾)提供的分级。

此属性的有效值包括:
  • 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
该视频由尼日利亚国家电影和视频审查委员会 (National Film and Video Censors Board) 评定。

此属性的有效值包括:
  • 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 - New Zealand) 的分级。

此属性的有效值包括:
  • 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 - 东
  • 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 - 正式版
  • rteMa - 摩洛哥
  • rtePs - PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
该视频的俄罗斯联邦国家电影注册机构 (MKRF - Russia) 的分级。

此属性的有效值包括:
  • 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 - 左
  • smaisUnrated
contentDetails.contentRating.smsaRating string
该视频由瑞典国家媒体委员会 Statens medieråd 提供的分级。

此属性的有效值包括:
  • smsa11 - 11
  • smsa15 - 15
  • smsa7 - 7
  • smsaA - 所有年龄段
  • smsaUnrated
contentDetails.contentRating.tvpgRating string
该视频的 TV 家长控制 (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 请求授权的情况下,系统才会返回属性值。
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
视频的评论数。
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。

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 - 文档或文本文件(例如Microsoft 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
本地化的视频说明。