Videos

video 資源代表 YouTube 影片。

方法

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

getRating

擷取授權使用者對指定影片清單給予的評分。立即試用。

list

傳回符合 API 要求參數的影片清單。 立即試用。

batchGetStats

擷取符合 API 要求參數的影片統計資料清單。 立即試用。

insert

將影片上傳至 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
  },
  "brandPartner": {
    "channelId": string,
    "channelHandle": 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 字元，但 < 和 > 除外。 注意：如要讓說明中的網址在 YouTube 使用者介面中顯示為可點選的連結，頻道必須符合平台層級規定，例如通過頻道驗證或啟用進階功能。 只要在說明文字中加入格式正確的時間戳記 (例如 00:00)，即可建立影片章節。
snippet.thumbnails	object 與影片相關聯的縮圖圖片對應。對於對應中的每個物件，鍵是縮圖圖片的名稱，值則是包含縮圖其他資訊的物件。
snippet.thumbnails.(key)	object 有效鍵值如下： default：預設縮圖圖片。影片的預設縮圖 (或參照影片的資源，例如播放清單項目或搜尋結果) 寬 120 像素，高 90 像素。頻道的預設縮圖寬度為 88 像素，高度為 88 像素。 medium：解析度較高的縮圖圖片版本。如果是影片 (或參照影片的資源)，這張圖片的寬度為 320 像素，高度為 180 像素。如果是頻道，這張圖片的寬度和高度均為 240 像素。 high：高解析度版本的縮圖圖片。如果是影片 (或參照影片的資源)，這張圖片的寬度為 480 像素，高度為 360 像素。如果是頻道，這張圖片的寬度和高度為 800 像素。 standard：比 high 解析度圖片更高的縮圖圖片版本。這張圖片適用於部分影片，以及參照影片的其他資源，例如播放清單項目或搜尋結果。這張圖片寬 640 像素，高 480 像素。 maxres：高解析度版本的縮圖圖片。部分影片和其他參照影片的資源 (例如播放清單項目或搜尋結果) 會顯示這個尺寸的圖片。這張圖片的寬度為 1280 像素，高度為 720 像素。 fhd：Full HD 高畫質 (1080p) 版本的縮圖。這個圖片大小適用於部分影片。這張圖片的寬度為 1920 像素，高度為 1080 像素。 qhd：縮圖圖片的 Quad 高畫質 (1440p / 2K) 版本。部分影片可使用這個圖片大小。這張圖片的寬度為 2560 像素，高度為 1440 像素。 uhd：超高解析度 (4K) 版本的縮圖。這個圖片大小適用於部分影片。這張圖片的寬度為 3840 像素，高度為 2160 像素。
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 規格。 注意：由於轉碼和編碼差異，傳回的時間長度可能與實際播放時間長度略有不同 (例如 1 秒)。
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 義大利通訊保障局 (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 加拿大電視分級制度 - 加拿大電視分級制度 (Canadian TV Classification System) 加拿大廣播電視及通訊委員會 (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 – 攔截 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 – 幼稚園至 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 是日本的分級制度。 這項屬性的有效值如下： 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 影片的西班牙電影與視聽藝術協會 (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 (僅限 18 歲以上觀眾觀看，有條件上映) incaaSam13 – 13 (僅適合 13 歲以上觀眾) incaaSam16 – 16 (Solo apta para mayores de 16 años) incaaSam18 - 18 (僅限 18 歲以上觀眾觀看) incaaUnrated
contentDetails.contentRating.kfcbRating	string 肯亞電影分級委員會 (KFCB) 的影片分級。 這項屬性的有效值如下： 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 馬爾他電影年齡分級委員會 (Film Age-Classification Board) 訂定的影片分級。 這項屬性的有效值如下： 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 (Green Band - Approved for all audiences) mpaatRb – RB (Red Band - 建議年滿 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 馬爾地夫國家分類局 (Maldives National Bureau of Classification) 的影片分級。 這項屬性的有效值如下： 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 - 瑞士 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 影片的隱私權狀態。在 videos.insert 要求中，如未指定這項屬性的值，上傳影片的隱私權狀態預設為 public。根據創作者帳戶設定，某些上傳內容可能會預設為private，詳情請參閱 YouTube 說明中心。透過未經驗證的 API 專案上傳的影片，不會限制為私人觀看模式。 這個屬性的有效值如下： 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 這個值表示影片是否可嵌入其他網站。 注意：即使上傳者的設定允許嵌入，影片仍可能因平台政策或第三方著作權聲明 (例如 Content ID) 而無法在嵌入式播放器中播放。
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 影片的觀看次數。 2026 年 8 月 24 日起，頻道所有格式的影片 (長篇影片、直播和 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 物件會封裝與影片相關主題的資訊。 重要事項：請參閱 topicDetails.relevantTopicIds[] 和 topicDetails.topicIds[] 屬性的定義，以及修訂版本記錄，進一步瞭解主題 ID 的近期異動。
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 時間：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 不會再與這部影片連結，而是與持續顯示在網頁上的新影片連結。
brandPartner	object brandPartner 物件包含與影片連結的品牌合作夥伴詳細資料，適用於創作者提出的品牌合作夥伴存取權 (CI BPA)。
brandPartner.channelId	string 品牌合作夥伴的外部頻道 ID。這個欄位開頭必須是「UC」。建立存取權時，必須設定 channelId 或 channelHandle，但回應中只會傳回 channelId。
brandPartner.channelHandle	string 品牌合作夥伴的頻道帳號代碼。這個欄位必須以「@」開頭。建立存取權時，必須設定 channelId 或 channelHandle，但回應中只會傳回 channelId。
localizations	object localizations 物件包含影片中繼資料的翻譯。
localizations.(key)	object 與鍵值相關聯的本地化文字語言。這個值是包含 BCP-47 語言代碼的字串。
localizations.(key).title	string 本地化影片標題。
localizations.(key).description	string 本地化影片說明。