Videos

凡是透過 videos.insert 端點，從 2020 年 7 月 28 日後建立的未經驗證 API 專案上傳的影片，都會限制為私人瀏覽模式。如要解除這項限制，每個 API 專案都必須接受稽核，以驗證是否遵守服務條款。詳情請參閱 API 修訂版本記錄。

video 資源代表 YouTube 影片。

方法

這個 API 支援 videos 資源的下列方法：

getRating
擷取授權使用者對指定影片清單給予的評分。立即試用。
list
傳回與 API 要求參數相符的影片清單。立即試用。
插入
將影片上傳至 YouTube，並視需要設定影片的結構化資料。
update
更新影片中繼資料。立即試用。
刪除
刪除 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
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 像素。
  • medium：縮圖圖片的高解析度版本。對於影片 (或參照影片的資源)，這張圖片的寬度為 320 像素，高度為 180 像素。頻道的圖片寬度和高度為 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 包含七個字元，但標記 Foo Baz 包含九個字元。
snippet.categoryId string
與影片相關聯的 YouTube 影片類別。如果您呼叫 videos.update 方法，並且要更新 video 資源的 snippet 部分，則必須為此屬性設定值。
snippet.liveBroadcastContent string
指明影片是否為即將/正在進行的直播。如果影片不是即將/正在進行的直播，則為「none」。

這個屬性的有效值如下：
  • live
  • none
  • upcoming
snippet.defaultLanguage string
video 資源的 snippet.title 和 snippet.description 屬性中文字的語言。
snippet.localized object
snippet.localized 物件包含影片的本地化標題和說明，或是影片中繼資料中以預設語言顯示的標題。
  • 如果 videos.list 要求使用 hl 參數指定應傳回本地化文字的語言，且該語言有本地化文字，則資源程式碼片段會傳回本地化文字。
  • 如果未指定 hl 參數值，或已指定值，但指定語言沒有本地化中繼資料，系統就會傳回預設語言的中繼資料。
屬性包含唯讀值。使用 localizations 物件新增、更新或刪除本地化標題。
snippet.localized.title string
本地化的影片標題。
snippet.localized.description string
本地化的影片說明。
snippet.defaultAudioLanguage string
default_audio_language 屬性會指定影片預設音軌的語言。
contentDetails object
contentDetails 物件包含影片內容的相關資訊，包括影片長度，以及影片是否提供字幕。
contentDetails.duration string
影片長度。屬性值是 ISO 8601 時間長度。舉例來說，如果影片長度至少 1 分鐘，但不超過 1 小時，則長度格式為 PT#M#S，其中 PT 字母表示值指定的時間長度，M 和 S 字母分別代表長度以分鐘和秒為單位。M 和 S 字母前面的 # 字元都是整數，用於指定影片的分鐘數 (或秒數)。舉例來說，如果值為 PT15M33S，表示影片長度為 15 分 33 秒。

如果影片長度至少為 1 小時，片長格式為 PT#H#M#S，其中字母 H 前方的 # 會以小時為單位指定影片長度，其他所有詳細資料則與上述相同。如果影片長度至少為一天，系統會分開顯示 P 和 T 字母，且值的格式為 P#DT#H#M#S。如需詳盡資訊，請參閱 ISO 8601 規格。
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 – E
  • 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 – T
  • agcomUnrated
  • agcomVm14 – VM14
  • agcomVm18 – VM18
contentDetails.contentRating.anatelRating string
影片的 Anatel (Asociación Nacional de Televisión) 智利電視評級。

這個屬性適用的有效值如下：
  • anatelA – A
  • anatelF – F
  • anatelI – I
  • anatelI10 – I-10
  • anatelI12 – I-12
  • anatelI7 – I-7
  • anatelR – R
  • anatelUnrated
contentDetails.contentRating.bbfcRating string
影片的英國電影分級委員會 (BBFC) 分級。

這個屬性的有效值如下：
  • bbfc12 – 12
  • bbfc12a – 12A
  • bbfc15 – 15
  • bbfc18 – 18
  • bbfcPg – PG
  • bbfcR18 – R18
  • bbfcU - U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
泰國電影和錄影帶審查委員會的影片評級。

這個屬性的有效值如下：
  • bfvc13 – 13
  • bfvc15 – 15
  • bfvc18 – 18
  • bfvc20 – 20
  • bfvcB – B
  • bfvcE – E
  • bfvcG – G
  • bfvcUnrated
contentDetails.contentRating.bmukkRating string
影片的奧地利媒體分級委員會 (Bundesministerium für Unterricht, Kunst und Kultur) 評級。

此屬性適用的有效值如下：
  • bmukk10 – 10 以上
  • bmukk12 – 12 歲以上
  • bmukk14 – 14 歲以上
  • bmukk16 – 16 歲以上
  • bmukk6 – 6 歲以上
  • bmukk8 – 8 歲以上
  • bmukkAa – 未受限制
  • bmukkUnrated
contentDetails.contentRating.catvRating string
加拿大電視分級制度 - 加拿大電視分級制度 加拿大廣播電視電信委員會 (CRTC) 針對加拿大英語廣播節目的分級。詳情請參閱 加拿大廣播標準委員會網站。

這項屬性的有效值如下：
  • catv14plus – 14 歲以上
  • catv18plus – 18 歲以上
  • catvC – C
  • catvC8 – C8
  • catvG – G
  • catvPg – PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
加拿大廣播電視和電信委員會 (CRTC) 針對加拿大法文廣播內容所評定的影片分級。詳情請參閱 加拿大廣播標準委員會網站。

這項屬性的有效值如下：
  • catvfr13plus – 13 歲以上
  • catvfr16plus – 16 歲以上
  • catvfr18plus – 18 歲以上
  • catvfr8plus – 8 歲以上
  • catvfrG – G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
影片的印度中央電影分級委員會 (CBFC) 評級。

這個屬性的有效值如下：
  • cbfcA – A
  • cbfcS – 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 (智利) 評級。

這個屬性的有效值如下：
  • ccc14 – 14 歲以上
  • ccc18 – 18 歲以上
  • ccc18s – 18+ - contenido pornográfico
  • ccc18v – 18+ - 內容過於暴力
  • ccc6 – 6+ - Inconveniente para menores de 7 años
  • cccTe – Todo espectador
  • cccUnrated
contentDetails.contentRating.cceRating string
影片的葡萄牙 CCE 分級。

這個屬性的有效值如下：
  • 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
影片的 Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - 巴西) 分級。

這個屬性的有效值如下：
  • djctq10 – 10
  • djctq12 – 12
  • djctq14 – 14
  • djctq16 – 16
  • djctq18 – 18
  • djctqL – L
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
影片獲得 DJCQT (巴西) 分級的原因。
contentDetails.contentRating.ecbmctRating string
土耳其的評分系統 - 文化和旅遊部評估及分級委員會

這個屬性的有效值為：
  • ecbmct13a – 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 – 幼兒園到高中
  • 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 – PG13
  • fcbmU - U
  • fcbmUnrated
contentDetails.contentRating.fcoRating string
由香港電影、報刊及物品管理處評定的影片分級。

這個屬性的有效值如下：
  • fcoI – I
  • fcoIi – II
  • fcoIia – IIA
  • fcoIib – IIB
  • fcoIii – III
  • fcoUnrated
contentDetails.contentRating.fmocRating string
這項屬性已於 2015 年 11 月 2 日淘汰。請改用 contentDetails.contentRating.cncRating 屬性。

影片的國家電影與動畫圖像中心 (法國文化部) 評級。

這個屬性的有效值如下：
  • fmoc10 – 10
  • fmoc12 – 12
  • fmoc16 – 16
  • fmoc18 – 18
  • fmocE – E
  • fmocU - U
  • fmocUnrated
contentDetails.contentRating.fpbRating string
影片的南非電影與出版物分級委員會分級。

這個屬性的有效值如下：
  • 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 – 幼兒園到高中
  • 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 (Instituto Nacional de Cine y Artes Audiovisuales - Argentina) 評級。

這個屬性的有效值如下：
  • incaaAtp – ATP (Apta para todo publico)
  • incaaC – X (僅限 18 歲以上觀眾，需經過審查)
  • incaaSam13 – 13 (僅限 13 歲以上觀眾)
  • incaaSam16 – 16 (僅限年滿 16 歲者)
  • incaaSam18 – 18 (僅限 18 歲以上觀眾)
  • 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 – 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
芬蘭國家視聽研究所 (National Audiovisual Institute) 的影片分級。

這個屬性的有效值如下：
  • 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 (哥倫比亞) 評級。

這個屬性的有效值如下：
  • moc12 – 12
  • moc15 – 15
  • moc18 – 18
  • moc7 – 7
  • mocBanned – 已停權
  • mocE – E
  • mocT – T
  • mocUnrated
  • mocX – X
contentDetails.contentRating.moctwRating string
影片的臺灣文化部評級。

這個屬性的有效值如下：
  • moctwG – G
  • moctwP – P
  • moctwPg – PG
  • moctwR – R
  • moctwR12 – R-12
  • moctwR15 – R-15
  • moctwUnrated
contentDetails.contentRating.mpaaRating string
影片的美國電影協會 (MPAA) 分級。

這個屬性的有效值如下：
  • mpaaG – G
  • mpaaNc17 – NC-17
  • mpaaPg – PG
  • mpaaPg13 – PG-13
  • mpaaR – R
  • mpaaUnrated
contentDetails.contentRating.mpaatRating string
美國電影協會對電影預告片和預覽片的評級。

這個屬性的有效值如下：
  • mpaatGb – GB (綠帶 - 適合所有觀眾)
  • mpaatRb – RB (紅色標章 - 建議年齡 17 歲以上)
contentDetails.contentRating.mtrcbRating string
由菲律賓電影電視審查分級委員會 (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 – CH
  • 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) 內容。進一步瞭解 YouTube 與 A/S 內容相關的政策。

以下列舉幾種 A/S 內容的例子：
  • 呈現真實人物的言論與動作，但其實並非本人所為
  • 變造真實事件或地點的影片片段
  • 生成看似真實但從未發生的場景
statistics object
statistics 物件包含影片的統計資料。
statistics.viewCount unsigned long

影片的觀看次數。

自 2025 年 3 月 31 日起，Shorts 的 viewCount 會傳回 Shorts 開始播放或重播的次數，且不需達到最短觀看時間門檻。
statistics.likeCount unsigned long
表示喜歡影片的使用者人數。
statistics.dislikeCount unsigned long
注意：自 2021 年 12 月 13 日起，statistics.dislikeCount 屬性已設為不公開。也就是說，只有在 API 要求經過影片擁有者驗證時，屬性才會納入 API 回應。詳情請參閱修訂版本記錄。

表示不喜歡影片的使用者人數。
statistics.favoriteCount unsigned long
注意：此屬性已淘汰。停用日期為 2015 年 8 月 28 日。屬性的值現在一律設為 0。
statistics.commentCount unsigned long
影片的留言數。
paidProductPlacementDetails object
paidProductPlacementDetails 物件包含影片中的付費商品置入資訊。
paidProductPlacementDetails.hasPaidProductPlacement boolean
如果內容使用付費商品置入，請將此屬性設為 true。預設為 false。
player object
player 物件包含用於在嵌入式播放器中播放影片的資訊。
player.embedHtml string
用於嵌入播放影片的播放器的