YouTubeData API参考Videos

KKView远程查看手机电脑摄像头和屏幕

于 2024-08-05 16:27:57 发布

阅读量623

点赞数 25

文章标签： google

本文链接：https://blog.csdn.net/shelutai/article/details/140930427

版权

Videos

bookmark_border

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

video 资源表示 YouTube 视频。

方法

对于 videos 资源，该 API 支持以下方法：

getRating

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

list

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

insert

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

update

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

删除

删除 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
  },
  "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 像素，高 240 像素。 `high` – 缩略图的高分辨率版本。对于视频（或引用视频的资源），该图片的宽度为 480 像素，高度为 360 像素。对于频道，此图片宽 800 像素，高 800 像素。 `standard` - 分辨率比 `high` 分辨率更高的缩略图版本。此图片适用于某些视频以及引用视频的其他资源，例如播放列表项或搜索结果。此图片宽 640 像素，高 480 像素。 `maxres` – 缩略图图像的最高分辨率版本。此图片大小适用于某些视频以及引用视频的其他资源，例如播放列表项目或搜索结果。此图片宽 1280 像素，高 720 像素。
`snippet.thumbnails.(key).url`	`string` 图片的网址。
`snippet.thumbnails.(key).width`	`unsigned integer` 图片的宽度。
`snippet.thumbnails.(key).height`	`unsigned integer` 图片的高度。
`snippet.channelTitle`	`string` 视频所属频道的频道标题。
`snippet.tags[]`	`list` 与视频相关联的关键字标记的列表。标记可以包含空格。属性值的长度上限为 500 个字符。请注意，计算字符数限制时需遵循以下规则：属性值是一个列表，列表中的项目之间的英文逗号会计入上限。如果标记包含空格，则 API 服务器在处理标记值时就像用引号括起来一样，并且引号会计入字符数限制。因此，就字符数限制而言，代码 Foo-Baz 包含 7 个字符，而代码 Foo Baz 包含 9 个字符。
`snippet.categoryId`	`string` 与视频关联的 YouTube 视频类别。如果您调用 `videos.update` 方法并更新 `video` 资源的 `snippet` 部分，则必须为此属性的值设置值。
`snippet.liveBroadcastContent`	`string` 指明视频是否为即将开始/正在进行的直播。如果视频不是即将进行的/正在进行的直播，则为“none”。此属性的有效值包括： `live` `none` `upcoming`
`snippet.defaultLanguage`	`string` `video` 资源的 `snippet.title` 和 `snippet.description` 属性中的文本语言。
`snippet.localized`	`object` `snippet.localized` 对象包含视频的本地化标题和说明，或者包含视频元数据默认语言的标题。如果 `videos.list` 请求使用 `hl` 参数指定应针对哪种语言返回本地化文本，并且该语言提供该语言的本地化文本，则系统会在资源代码段中返回本地化文本。如果未指定 `hl` 参数值或指定了值，但指定语言的本地化元数据不可用，则返回默认语言的元数据。此属性包含只读值。使用 `localizations` 对象添加、更新或删除已本地化的影视内容。
`snippet.localized.title`	`string` 本地化的视频标题。
`snippet.localized.description`	`string` 本地化的视频说明。
`snippet.defaultAudioLanguage`	`string` `default_audio_language` 属性用于指定视频的默认音轨所用的语言。
`contentDetails`	`object` `contentDetails` 对象包含视频内容的相关信息，包括视频时长以及视频是否有字幕的指示。
`contentDetails.duration`	`string` 视频的时长。属性值是 ISO 8601 时长。例如，对于时长至少为一分钟但时长不到 1 小时的视频，时长格式为 `PT#M#S`，其中字母 `PT` 表示该值指定时间段，字母 `M` 和 `S` 分别表示时长（以分钟和秒为单位）。`M` 和 `S` 字母前面的 `#` 字符都是整数，用于指定视频的分钟数（或秒数）。例如，值 `PT15M33S` 表示视频时长为 15 分 33 秒。如果视频时长至少为 1 小时，则时长格式为 `PT#H#M#S`，其中字母 `H` 前面的 `#` 指定了视频的时长（以小时为单位），其他详细信息都与上述说明相同。如果视频时长至少为一天，则字母 `P` 和 `T` 会分开显示，值的格式为 `P#DT#H#M#S`。请参阅 ISO 8601 规范，了解完整详情。
`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à 根据 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` - 中午 12 点 `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` - 东 `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+ - contenido 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` - 14 安 `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 AL 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` - 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 layers (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` - 中午 13 点 `ecbmct13plus` - 13 岁以上 `ecbmct15a` - 15A `ecbmct15plus` - 15 岁以上 `ecbmct18plus` - 18 岁以上 `ecbmct7a` - 7 安 `ecbmct7plus` - 7 以上 `ecbmctG` - G `ecbmctUnrated` `ecbmct6a` - 6 安 `ecbmct6plus` - 6 岁以上 `ecbmct10a` - 10A `ecbmct10plus` - 10+ `ecbmct16plus` - 16 岁以上
`contentDetails.contentRating.eefilmRating`	`string` 视频在爱沙尼亚的分级。此属性的有效值包括： `eefilmK12` - 幼儿园到高中 (K-12) `eefilmK14` - 幼儿园到高中 (K-14) `eefilmK16` - 幼儿园到高中 (K-16) `eefilmK6` - 幼儿园到高中 `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 是日本分级制度。此属性的有效值包括： `eirinG` - G `eirinPg12` - PG-12 `eirinR15plus` - R15 及以上 `eirinR18plus` - R18 及以上 `eirinUnrated`
`contentDetails.contentRating.fcbmRating`	`string` 该视频由马来西亚电影审查委员会确定的分级。此属性的有效值包括： `fcbm13` - 13 `fcbm16` - 16 `fcbm18` - 18 岁 `fcbm18pa` - 18/18 `fcbm18pl` - 18PL `fcbm18sg` - 18 新加坡元 `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` 属性。视频中心的 National du cinéma et de l'image animé（法国文化部）分级。此属性的有效值包括： `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` - 16 沙特里亚尔 `fsk18` - 18 沙特里亚尔 `fsk6` - FSK 6 `fskUnrated`
`contentDetails.contentRating.grfilmRating`	`string` 视频在希腊的评分。此属性的有效值包括： `grfilmE` - 东 `grfilmK` - 千 `grfilmK12` - 幼儿园到高中 (K-12) `grfilmK13` - 幼儿园到高中 (K-13) `grfilmK15` - 幼儿园到高中 (K-15) `grfilmK17` - 幼儿园到高中 (K-17) `grfilmK18` - 幼儿园到高中 (K-18) `grfilmUnrated`
`contentDetails.contentRating.icaaRating`	`string` 视频的 Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - Spain) 分级。此属性的有效值包括： `icaa12` - 12 `icaa13` - 13 `icaa16` - 16 `icaa18` - 18 岁 `icaa7` - 7 `icaaApta` - APTA `icaaUnrated` `icaaX` - X
`contentDetails.contentRating.ifcoRating`	`string` 视频的爱尔兰电影分级办公室 (IFCO - Ireland) 分级。如需了解详情，请参阅 IFCO 网站。此属性的有效值包括： `ifco12` - 12 `ifco12a` - 中午 12 点 `ifco15` - 15 `ifco15a` - 15A `ifco16` - 16 `ifco18` - 18 岁 `ifcoG` - G `ifcoPg` - PG `ifcoUnrated`
`contentDetails.contentRating.ilfilmRating`	`string` 视频在以色列的分级。此属性的有效值包括： `ilfilm12` - 12 `ilfilm16` - 16 `ilfilm18` - 18 岁 `ilfilmAa` - AA `ilfilmUnrated`
`contentDetails.contentRating.incaaRating`	`string` 视频的 INCAA (Instituto Nacional de Cine y Artes Audiovisuales - Argentina) 分级。此属性的有效值如下： `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` - 格鲁吉亚 `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 广告素材的 이선 장람 applied `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` - 中午 12 点 `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` - 千
`contentDetails.contentRating.mdaRating`	`string` 该视频由新加坡媒体发展管理局 (MDA) 以及新加坡电影审查委员会 (BFC) 给出的分级。此属性的有效值如下： `mdaG` - G `mdaM18` - M18 `mdaNc16` - NC16 `mdaPg` - PG `mdaPg13` - PG13 `mdaR21` - R21 `mdaUnrated`
`contentDetails.contentRating.medietilsynetRating`	`string` 该视频的分级来自挪威媒体管理局 Medietilsynet。此属性的有效值包括： `medietilsynet11` - 11 `medietilsynet12` - 12 `medietilsynet15` - 15 `medietilsynet18` - 18 岁 `medietilsynet6` - 6 `medietilsynet7` - 7 `medietilsynet9` - 9 人 `medietilsynetA` - A `medietilsynetUnrated`
`contentDetails.contentRating.mekuRating`	`string` 该视频由芬兰 Kansallinen Audiovisuaalinen Instituutti（美国视听研究所）提供的分级。此属性的有效值如下： `meku12` - 12 `meku16` - 16 `meku18` - 18 岁 `meku7` - 7 `mekuS` - 南 `mekuUnrated`
`contentDetails.contentRating.mibacRating`	`string` 该视频由 Ministero dei Beni e delle Attività Culturei 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` - T `mocUnrated` `mocX` - X
`contentDetails.contentRating.moctwRating`	`string` 视频由台湾文化部 (文化部) 提供的分级。此属性的有效值包括： `moctwG` - G `moctwP` - P `moctwPg` - PG `moctwR` - R `moctwR12` - R-12 `moctwR15` - R-15 `moctwUnrated`
`contentDetails.contentRating.mpaaRating`	`string` 视频的美国电影协会 (MPAA) 分级。此属性的有效值包括： `mpaaG` - G `mpaaNc17` - NC-17 `mpaaPg` - PG `mpaaPg13` - PG-13 `mpaaR` - R `mpaaUnrated`
`contentDetails.contentRating.mpaatRating`	`string` 美国电影协会对电影预告片和预览的分级。此属性的有效值包括： `mpaatGb` - GB（绿带 - 已批准所有观众观看） `mpaatRb` - RB（红色手环 - 建议年满 17 周岁的观众观看）
`contentDetails.contentRating.mtrcbRating`	`string` 该视频由菲律宾影视审查和分类委员会（菲律宾）提供的分级。此属性的有效值包括： `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` - 中午 12 点 `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 Eireann 发布的分级。此属性的有效值包括： `rteCh` - 瑞士 `rteGa` - 正式版 `rteMa` - 马萨诸塞州 `rtePs` - PS `rteUnrated`
`contentDetails.contentRating.russiaRating`	`string` 该视频的俄罗斯联邦国家电影注册机构 (MKRF - 俄罗斯) 分级。此属性的有效值包括： `russia0` - 0+ `russia12` - 12 岁以上 `russia16` - 16 岁以上 `russia18` - 18 岁以上 `russia6` - 6 岁以上 `russiaUnrated`
`contentDetails.contentRating.skfilmRating`	`string` 视频在斯洛伐克的评分。此属性的值为： `skfilmG` - G `skfilmP2` - P2 `skfilmP5` - P5 `skfilmP8` - P8 `skfilmUnrated`
`contentDetails.contentRating.smaisRating`	`string` 视频在冰岛的评分。此属性的有效值包括： `smais12` - 12 `smais14` - 14 `smais16` - 16 `smais18` - 18 岁 `smais7` - 7 `smaisL` - 升 `smaisUnrated`
`contentDetails.contentRating.smsaRating`	`string` 该视频由 Statens medieråd（瑞典国家媒体委员会）提供的分级。此属性的有效值如下： `smsa11` - 11 `smsa15` - 15 `smsa7` - 7 `smsaA` - 所有年龄段 `smsaUnrated`
`contentDetails.contentRating.tvpgRating`	`string` 视频的电视家长准则 (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 请求授权时，系统才会返回属性值。
`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 的弃用日期，主题 ID 从 2017 年 2 月 27 日起开始工作方式有所不同。当时，YouTube 开始返回一小部分精选主题 ID。查看自 2017 年 2 月 15 日起支持的主题 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` 本地化的视频说明。

KKView远程查看手机电脑摄像头和屏幕

关注

25
点赞
踩
25

收藏

觉得还不错? 一键收藏
0
评论
YouTubeData API参考Videos

对于 2020 年 7 月 28 日之后创建的未经验证的 API 项目，通过端点上传的所有视频都将仅限私享观看模式观看。如需解除此限制，每个 API 项目必须，以验证符合的要求。如需了解详情，请参阅。video资源表示 YouTube 视频。
复制链接

扫一扫