Videos

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

video 資源代表 YouTube 影片。

方法

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

getRating
擷取授權使用者對指定影片清單的評分。 立即試用。
list
傳回符合 API 要求參數的影片清單。 立即試用。
batchGetStats
擷取符合 API 要求參數的影片統計資料清單。立即試用。
插入
將影片上傳至 YouTube，並視需要設定影片的後設資料。
更新
更新影片的中繼資料。 立即試用。
刪除
刪除 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
影片說明。這個屬性值的長度上限為 5,000 個位元組，可包含所有有效的 UTF-8 字元，但 < 和 > 除外。
snippet.thumbnails object
與影片相關聯的縮圖圖片對應表。地圖中的每個物件，其鍵是縮圖圖片的名稱，值則是包含縮圖其他資訊的物件。
snippet.thumbnails.(key) object
有效鍵值如下：
  • default：預設縮圖圖片。影片的預設縮圖 (或參照影片的資源，例如播放清單項目或搜尋結果) 寬 120 像素，高 90 像素。頻道的預設縮圖寬度和高度皆為 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」含有七個字元，但標記「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 時長。舉例來說，如果影片長度至少一分鐘，但不到一小時，時長格式為 PT#M#S，其中字母 PT 表示值指定一段時間，字母 M 和 S 分別代表分鐘和秒數。M 和 S 字母前面的 # 字元都是整數，分別指定影片的分鐘數 (或秒數)。舉例來說，值為 PT15M33S 表示影片長度為 15 分 33 秒。

如果影片長度至少一小時，時長格式為 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 – 澳洲通訊及媒體管理局 (ACMA) 評為 P 的節目。這類節目適合學齡前兒童觀賞。
  • acbPg – PG
  • acbR18plus – R18+
  • acbUnrated
contentDetails.contentRating.agcomRating string
義大利 Autorità per le Garanzie nelle Comunicazioni (AGCOM) 提供的影片分級。

這個屬性的有效值包括：
  • agcomT – T
  • agcomUnrated
  • agcomVm14 - VM14
  • agcomVm18 – VM18
contentDetails.contentRating.anatelRating string
智利電視的 Anatel (Asociación Nacional de Televisión) 影片分級。

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

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

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

這個屬性的有效值包括：
  • bmukk10 – 10 以上
  • bmukk12 – 12+
  • bmukk14 – 14 歲以上
  • bmukk16 – 16 歲以上
  • bmukk6 – 6+
  • bmukk8 – 8+
  • bmukkAa - 未受限
  • bmukkUnrated
contentDetails.contentRating.catvRating string
加拿大電視分級制度 - 加拿大電視分級制度。這是加拿大廣播電視及電信委員會 (CRTC) 對加拿大英語廣播影片的分級。詳情請參閱加拿大廣播標準委員會網站。

這項屬性的有效值如下：
  • 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+ - contenido excesivamente violento
  • ccc6 – 6+ - Inconveniente para menores de 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 – 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
羅馬尼亞全國視聽委員會 (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 - Interdiction
  • csaT – T
  • csaUnrated
contentDetails.contentRating.cscfRating string
盧森堡電影分級監管委員會 (CSCF) 對影片的評等。

這個屬性的有效值為：
  • cscf12 – 12
  • cscf16 – 16
  • cscf18 – 18
  • cscf6 – 6
  • cscf9 – 9
  • cscfA – A
  • cscfAl – AL
  • cscfUnrated
contentDetails.contentRating.czfilmRating string
捷克共和國的影片分級。

這個屬性的有效值如下：
  • czfilm12 – 12
  • czfilm14 – 14
  • czfilm18 – 18
  • czfilmU - U
  • czfilmUnrated
contentDetails.contentRating.djctqRating string
影片的巴西司法部、分級、資格和頭銜 (DJCQT) 分級。

這項屬性的有效值包括：
  • djctq10 – 10
  • djctq12 – 12
  • djctq14 – 14
  • djctq16 – 16
  • djctq18 – 18
  • djctqL - L
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
說明影片獲得 DJCQT (巴西) 分級的原因。
contentDetails.contentRating.ecbmctRating string
土耳其分級制度 - 文化和觀光部評估與分類委員會

這項屬性的有效值如下：
  • ecbmct13a – 13A
  • ecbmct13plus – 13 歲以上
  • ecbmct15a – 15A
  • ecbmct15plus – 15+
  • ecbmct18plus – 18+
  • ecbmct7a – 7A
  • ecbmct7plus – 7+
  • ecbmctG – G
  • ecbmctUnrated
  • ecbmct6a – 6A
  • ecbmct6plus – 6+
  • ecbmct10a – 10A
  • ecbmct10plus – 10 以上
  • ecbmct16plus – 16+
contentDetails.contentRating.eefilmRating string
愛沙尼亞的影片分級。

這個屬性的有效值如下：
  • eefilmK12 – 幼兒園到高中
  • 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
影片的映倫分級。映倫是日本的分級制度。

這個屬性的有效值如下：
  • 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 - 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 (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
芬蘭國家視聽研究所 (Kansallinen Audiovisuaalinen Instituutti) 對影片的分級。

這項屬性的有效值為：
  • meku12 – 12
  • meku16 – 16
  • meku18 – 18
  • meku7 – 7
  • mekuS – S
  • mekuUnrated
contentDetails.contentRating.mibacRating string
義大利文化活動和旅遊部對影片的評等。

這個屬性的有效值包括：
  • mibacT
  • mibacUnrated
  • mibacVap
  • mibacVm6
  • mibacVm12
  • mibacVm14
  • mibacVm18
contentDetails.contentRating.mocRating string
影片的哥倫比亞文化部評等。

這個屬性的有效值如下：
  • 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 (Red Band - Recommended for ages 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 – 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
影片的墨西哥廣播電視電影總局分級。

這個屬性的有效值如下：
  • rtcA – A
  • rtcAa – AA
  • rtcB – B
  • rtcB15 – B15
  • rtcC - C
  • rtcD - D
  • rtcUnrated
contentDetails.contentRating.rteRating string
愛爾蘭 Raidió Teilifís Éireann 提供的影片分級。

這個屬性的有效值如下：
  • rteCh – CH
  • rteGa – 正式發布
  • 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
影片的電視家長輔導 (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。
  • 只有在影片的隱私權狀態為 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 與變造或合成內容相關的政策。

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

影片的觀看次數。

2025 年 3 月 31 日起，系統會計算 Shorts 開始播放或重播的次數，沒有最短觀看時間門檻，並將此數值做為 Shorts 的 viewCount。
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
內嵌播放器的 <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。
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
  • Naive time：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
本地化影片說明。