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。 查看 2017 年 2 月 15 日起支援的主題 ID 主題 音樂主題 /m/04rlf 音樂 (父主題) /m/02mscn 基督教音樂 /m/0ggq0m 古典音樂 /m/01lyv 國家/地區 /m/02lkt 電子音樂 /m/0glt670 嘻哈音樂 /m/05rwpb 獨立音樂 /m/03_d0 爵士樂 /m/028sqc 亞洲音樂 /m/0g293 拉丁美洲音樂 /m/064t9 流行樂 /m/06cqb 雷鬼 /m/06j6l 節奏與藍調 /m/06by7 搖滾樂 /m/0gywn 靈魂樂 遊戲主題 /m/0bzvm2 遊戲 (父主題) /m/025zzc 動作遊戲 /m/02ntfj 動作冒險遊戲 /m/0b1vjn 休閒遊戲 /m/02hygl 音樂類電玩遊戲 /m/04q1x3q 益智電玩遊戲 /m/01sjng 賽車電玩遊戲 /m/0403l3g 角色扮演電玩遊戲 /m/021bp2 模擬電玩遊戲 /m/022dc6 運動遊戲 /m/03hf_rm 策略電玩遊戲 運動主題 /m/06ntj 運動 (父項主題) /m/0jm_ 美式足球 /m/018jz 棒球 /m/018w8 籃球 /m/01cgz 拳擊 /m/09xp_ 板球 /m/02vx4 美式足球 /m/037hz 高爾夫 /m/03tmr 冰上曲棍球 /m/01h7lh 混合武術 /m/0410tth 競速遊戲 /m/07bs0 網球 /m/07_53 排球 娛樂主題 /m/02jjt 娛樂 (父項主題) /m/09kqc 幽默文學 /m/02vxn 電影 /m/05qjc 表演藝術 /m/066wd 職業摔角 /m/0f2f9 電視節目 生活風格主題 /m/019_rr 生活方式 (父項主題) /m/032tl 時尚 /m/027x7n 健身 /m/02wbm 食物 /m/03glg 興趣 /m/068hy 寵物 /m/041xxh 外貌吸引力 [美容] /m/07c1v 科技 /m/07bxq 觀光 /m/07yv9 交通工具 社會主題 /m/098wr 社會 (上層主題) /m/09s1f 業務 /m/0kt51 保健 /m/01h6rj 軍事 /m/05qt0 政治 /m/06bvp 宗教 其他主題 /m/01k8wb 資訊
topicDetails.topicCategories[]	list 提供影片內容概要說明的維基百科網址清單。
recordingDetails	object recordingDetails 物件內含影片錄製地點、日期和地址的相關資訊。
recordingDetails.locationDescription	string 這項屬性已於 2017 年 6 月 1 日淘汰。詳情請參閱淘汰公告。 影片錄製地點的文字說明。
recordingDetails.location	object 與影片相關聯的地理位置資訊。請注意，子項屬性值會指出影片擁有者想與影片建立關聯的地點。這個值可編輯，且可搜尋公開影片，並可能會向使用者顯示公開影片。
recordingDetails.location.latitude	double 這項屬性已於 2017 年 6 月 1 日淘汰。詳情請參閱淘汰公告。 以度為單位的緯度。
recordingDetails.location.longitude	double 這項屬性已於 2017 年 6 月 1 日淘汰。詳情請參閱淘汰公告。 經度 (以度為單位)。
recordingDetails.location.altitude	double 這項屬性已於 2018 年 7 月 9 日淘汰。詳情請參閱淘汰公告。 參考橢球體上方的高度 (以公尺為單位)。
recordingDetails.recordingDate	datetime 影片錄製的日期和時間。值採用 ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ) 格式。
fileDetails	object fileDetails 物件會封裝上傳至 YouTube 的影片檔案相關資訊，包括檔案的解析度、長度、音訊和影片轉碼器、串流位元率等。這項資料只能由影片擁有者擷取。 只有當 processingDetails.fileAvailability 屬性的值為 available 時，才會傳回 fileDetails 物件。
fileDetails.fileName	string 上傳的檔案名稱。無論上傳的是影片檔案或其他類型的檔案，都會顯示這個欄位。
fileDetails.fileSize	unsigned long 上傳檔案的大小 (以位元組為單位)。無論上傳的是影片檔案或其他類型的檔案，都會顯示這個欄位。
fileDetails.fileType	string YouTube 影片處理引擎偵測到的上傳檔案類型。目前 YouTube 只會處理影片檔案，但無論上傳的是影片檔案或其他類型的檔案，這個欄位都會顯示。 這個屬性的有效值為： archive – 檔案為封存檔，例如 .zip 封存檔。 audio - 檔案是已知的音訊檔案類型，例如 .mp3 檔案。 document - 檔案是文件或文字檔，例如 MS Word 文件。 image - 檔案為圖片檔，例如 .jpeg 圖片。 other：檔案為其他非影片檔案類型。 project - 檔案是影片專案檔 (例如 Microsoft Windows Movie Maker 專案)，不含實際影片資料。 video - 檔案是已知的影片檔案類型，例如 .mp4 檔案。
fileDetails.container	string 上傳影片檔案的容器格式。
fileDetails.videoStreams[]	list 上傳的影片檔案所含的影片串流清單。清單中的每個項目都包含影片串流的詳細中繼資料。
fileDetails.videoStreams[].widthPixels	unsigned integer 編碼影片內容的寬度 (以像素為單位)。你可以將影片的編碼顯示比例計算為 width_pixels / height_pixels。
fileDetails.videoStreams[].heightPixels	unsigned integer 編碼影片內容的高度 (以像素為單位)。
fileDetails.videoStreams[].frameRateFps	double 視訊串流的影格率，以每秒影格數為單位。
fileDetails.videoStreams[].aspectRatio	double 影片內容的顯示比例，用於指定影片的顯示比例。
fileDetails.videoStreams[].codec	string 串流使用的視訊轉碼器。
fileDetails.videoStreams[].bitrateBps	unsigned long 視訊串流的位元率，以每秒位元數為單位。
fileDetails.videoStreams[].rotation	string YouTube 必須將原始來源內容旋轉多少角度，才能正確顯示影片。 這個屬性的有效值為： clockwise - 影片需要順時針旋轉 90 度。 counterClockwise - 影片必須逆時針旋轉 90 度。 none - 影片不需要旋轉。 other – 影片需要以其他非微不足道的方式旋轉。 upsideDown：影片需要上下顛倒旋轉。
fileDetails.videoStreams[].vendor	string 可明確識別影片供應商的值。通常是四個字母的供應商代碼。
fileDetails.audioStreams[]	list 上傳的影片檔案所含音訊串流的清單。清單中的每個項目都包含音訊串流的詳細中繼資料。
fileDetails.audioStreams[].channelCount	unsigned integer 串流包含的音訊聲道數。
fileDetails.audioStreams[].codec	string 串流使用的音訊轉碼器。
fileDetails.audioStreams[].bitrateBps	unsigned long 音訊串流的位元率 (以每秒位元數為單位)。
fileDetails.audioStreams[].vendor	string 可明確識別影片供應商的值。通常是四個字母的供應商代碼。
fileDetails.durationMs	unsigned long 上傳影片的長度 (以毫秒為單位)。
fileDetails.bitrateBps	unsigned long 上傳影片檔案的總位元率 (影片和音訊)，以每秒位元數為單位。
fileDetails.creationTime	string 上傳的影片檔案建立日期和時間。值採用 ISO 8601 格式指定。目前支援的 ISO 8601 格式如下： 僅限日期：YYYY-MM-DD 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 本地化影片說明。