本頁面由 Cloud Translation API 翻譯而成。

Videos

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

video 資源代表 YouTube 影片。

方法

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

getRating: 擷取授權使用者對指定影片清單給予的評分。立即試用。
list: 傳回與 API 要求參數相符的影片清單。立即試用。
插入: 將影片上傳至 YouTube，並視需要設定影片的結構化資料。
update: 更新影片中繼資料。立即試用。
刪除: 刪除 YouTube 影片。立即試用。
rate: 為影片新增或移除喜歡或不喜歡評分。立即試用。
reportAbuse: 檢舉含有不當內容的影片。立即試用。

資源表示法

以下 JSON 結構顯示 videos 資源的格式：

{
  "kind": "youtube#video",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "tags": [
      string
    ],
    "categoryId": string,
    "liveBroadcastContent": string,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "defaultAudioLanguage": string
  },
  "contentDetails": {
    "duration": string,
    "dimension": string,
    "definition": string,
    "caption": string,
    "licensedContent": boolean,
    "regionRestriction": {
      "allowed": [
        string
      ],
      "blocked": [
        string
      ]
    },
    "contentRating": {
      "acbRating": string,
      "agcomRating": string,
      "anatelRating": string,
      "bbfcRating": string,
      "bfvcRating": string,
      "bmukkRating": string,
      "catvRating": string,
      "catvfrRating": string,
      "cbfcRating": string,
      "cccRating": string,
      "cceRating": string,
      "chfilmRating": string,
      "chvrsRating": string,
      "cicfRating": string,
      "cnaRating": string,
      "cncRating": string,
      "csaRating": string,
      "cscfRating": string,
      "czfilmRating": string,
      "djctqRating": string,
      "djctqRatingReasons": [,
        string
      ],
      "ecbmctRating": string,
      "eefilmRating": string,
      "egfilmRating": string,
      "eirinRating": string,
      "fcbmRating": string,
      "fcoRating": string,
      "fmocRating": string,
      "fpbRating": string,
      "fpbRatingReasons": [,
        string
      ],
      "fskRating": string,
      "grfilmRating": string,
      "icaaRating": string,
      "ifcoRating": string,
      "ilfilmRating": string,
      "incaaRating": string,
      "kfcbRating": string,
      "kijkwijzerRating": string,
      "kmrbRating": string,
      "lsfRating": string,
      "mccaaRating": string,
      "mccypRating": string,
      "mcstRating": string,
      "mdaRating": string,
      "medietilsynetRating": string,
      "mekuRating": string,
      "mibacRating": string,
      "mocRating": string,
      "moctwRating": string,
      "mpaaRating": string,
      "mpaatRating": string,
      "mtrcbRating": string,
      "nbcRating": string,
      "nbcplRating": string,
      "nfrcRating": string,
      "nfvcbRating": string,
      "nkclvRating": string,
      "oflcRating": string,
      "pefilmRating": string,
      "rcnofRating": string,
      "resorteviolenciaRating": string,
      "rtcRating": string,
      "rteRating": string,
      "russiaRating": string,
      "skfilmRating": string,
      "smaisRating": string,
      "smsaRating": string,
      "tvpgRating": string,
      "ytRating": string
    },
    "projection": string,
    "hasCustomThumbnail": boolean
  },
  "status": {
    "uploadStatus": string,
    "failureReason": string,
    "rejectionReason": string,
    "privacyStatus": string,
    "publishAt": datetime,
    "license": string,
    "embeddable": boolean,
    "publicStatsViewable": boolean,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean,
    "containsSyntheticMedia": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "paidProductPlacementDetails": {
    "hasPaidProductPlacement": boolean
  },
  "player": {
    "embedHtml": string,
    "embedHeight": long,
    "embedWidth": long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "relevantTopicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "recordingDetails": {
    "recordingDate": datetime
  },
  "fileDetails": {
    "fileName": string,
    "fileSize": unsigned long,
    "fileType": string,
    "container": string,
    "videoStreams": [
      {
        "widthPixels": unsigned integer,
        "heightPixels": unsigned integer,
        "frameRateFps": double,
        "aspectRatio": double,
        "codec": string,
        "bitrateBps": unsigned long,
        "rotation": string,
        "vendor": string
      }
    ],
    "audioStreams": [
      {
        "channelCount": unsigned integer,
        "codec": string,
        "bitrateBps": unsigned long,
        "vendor": string
      }
    ],
    "durationMs": unsigned long,
    "bitrateBps": unsigned long,
    "creationTime": string
  },
  "processingDetails": {
    "processingStatus": string,
    "processingProgress": {
      "partsTotal": unsigned long,
      "partsProcessed": unsigned long,
      "timeLeftMs": unsigned long
    },
    "processingFailureReason": string,
    "fileDetailsAvailability": string,
    "processingIssuesAvailability": string,
    "tagSuggestionsAvailability": string,
    "editorSuggestionsAvailability": string,
    "thumbnailsAvailability": string
  },
  "suggestions": {
    "processingErrors": [
      string
    ],
    "processingWarnings": [
      string
    ],
    "processingHints": [
      string
    ],
    "tagSuggestions": [
      {
        "tag": string,
        "categoryRestricts": [
          string
        ]
      }
    ],
    "editorSuggestions": [
      string
    ]
  },
  "liveStreamingDetails": {
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "concurrentViewers": unsigned long,
    "activeLiveChatId": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

屬性

下表定義了這個資源中顯示的屬性：

屬性

kind string
識別 API 資源的類型。值為 youtube#video。

etag etag
這項資源的 Etag。

id string
YouTube 用於識別影片的專屬 ID。

snippet object
snippet 物件包含影片的基本詳細資料，例如標題、說明和類別。

snippet.publishedAt

datetime
影片發布日期和時間。請注意，這可能與影片上傳時間不同。舉例來說，如果影片上傳時設為私人影片，但之後轉為公開，這個屬性就會指定影片公開的時間。

以下是幾種特殊情況：

如果影片是以私人影片上傳，且頻道擁有者擷取影片中繼資料，則屬性值會指定影片上傳的日期和時間。
如果影片上傳為不公開影片，屬性值也會指定影片上傳的日期和時間。在這種情況下，只要知道影片的專屬 ID，任何人都能擷取影片中繼資料。

這個值採用 ISO 8601 格式指定。

snippet.channelId string
YouTube 用來識別影片上傳頻道的 ID。

snippet.title string
影片的標題。屬性值的長度上限為 100 個字元，可包含所有有效的 UTF-8 字元，但 < 和 > 除外。如果您呼叫 videos.update 方法，且要更新 video 資源的 snippet 部分，則必須為此屬性設定值。

snippet.description string
影片說明。屬性值的長度上限為 5000 個位元組，可包含所有有效的 UTF-8 字元，但 < 和 > 除外。

snippet.thumbnails object
與影片相關聯的縮圖圖片對應表。對於地圖中的每個物件，鍵是縮圖圖片的名稱，值則是包含縮圖其他資訊的物件。

snippet.thumbnails.(key)

object
有效的鍵值如下：

default – 預設縮圖圖片。影片或影片相關資源 (例如播放清單項目或搜尋結果) 的預設縮圖寬度為 120 像素，高度為 90 像素。頻道的預設縮圖寬度和高度為 88 像素。
medium：縮圖圖片的高解析度版本。對於影片 (或參照影片的資源)，這張圖片的寬度為 320 像素，高度為 180 像素。頻道的圖片寬度和高度為 240 像素。
high – 縮圖圖片的高解析度版本。對於影片 (或參照影片的資源)，這張圖片的寬度為 480 像素，高度為 360 像素。頻道的圖片寬度和高度為 800 像素。
standard：縮圖圖片的解析度比 high 解析度圖片更高。這張圖片適用於部分影片和其他參照影片的資源，例如播放清單項目或搜尋結果。此圖片的寬度為 640 像素，高度為 480 像素。
maxres：縮圖圖片的最高解析度版本。部分影片和其他參照影片的資源 (例如播放清單項目或搜尋結果) 會使用這個圖片大小。此圖片的寬度為 1280 像素，高度為 720 像素。

snippet.thumbnails.(key).url string
圖片的網址。

snippet.thumbnails.(key).width unsigned integer
圖片的寬度。

snippet.thumbnails.(key).height unsigned integer
圖片的高度。

snippet.channelTitle string
影片所屬頻道的頻道名稱。

snippet.tags[]

list
與影片相關的關鍵字標記清單。標記可包含空格。資源值的長度上限為 500 個半形字元。請注意下列計算字元上限的規則：

屬性值是清單，清單中項目之間的逗號會計入限制。
如果標記含有空格，API 伺服器會將標記值視為以引號括住，並將引號計入字元限制。因此，就字元限制而言，標記 Foo-Baz 包含七個字元，但標記 Foo Baz 包含九個字元。

snippet.categoryId string
與影片相關聯的 YouTube 影片類別。如果您呼叫 videos.update 方法，並且要更新 video 資源的 snippet 部分，則必須為此屬性設定值。

snippet.liveBroadcastContent

string
指明影片是否為即將/正在進行的直播。如果影片不是即將/正在進行的直播，則為「none」。

這個屬性的有效值如下：

live
none
upcoming

snippet.defaultLanguage string
video 資源的 snippet.title 和 snippet.description 屬性中文字的語言。

snippet.localized

object
snippet.localized 物件包含影片的本地化標題和說明，或是影片中繼資料中以預設語言顯示的標題。

如果 videos.list 要求使用 hl 參數指定應傳回本地化文字的語言，且該語言有本地化文字，則資源程式碼片段會傳回本地化文字。
如果未指定 hl 參數值，或已指定值，但指定語言沒有本地化中繼資料，系統就會傳回預設語言的中繼資料。

屬性包含唯讀值。使用 localizations 物件新增、更新或刪除本地化標題。

snippet.localized.title string
本地化的影片標題。

snippet.localized.description string
本地化的影片說明。

snippet.defaultAudioLanguage string
default_audio_language 屬性會指定影片預設音軌的語言。

contentDetails object
contentDetails 物件包含影片內容的相關資訊，包括影片長度，以及影片是否提供字幕。

contentDetails.duration string
影片長度。屬性值是 ISO 8601 時間長度。舉例來說，如果影片長度至少 1 分鐘，但不超過 1 小時，則長度格式為 PT#M#S，其中 PT 字母表示值指定的時間長度，M 和 S 字母分別代表長度以分鐘和秒為單位。M 和 S 字母前面的 # 字元都是整數，用於指定影片的分鐘數 (或秒數)。舉例來說，如果值為 PT15M33S，表示影片長度為 15 分 33 秒。

如果影片長度至少為 1 小時，片長格式為 PT#H#M#S，其中字母 H 前方的 # 會以小時為單位指定影片長度，其他所有詳細資料則與上述相同。如果影片長度至少為一天，系統會分開顯示 P 和 T 字母，且值的格式為 P#DT#H#M#S。如需詳盡資訊，請參閱 ISO 8601 規格。

contentDetails.dimension string
指出影片是否提供 3D 或 2D 版本。

contentDetails.definition

string
表示影片是否提供高畫質 (HD) 或僅提供標準畫質。

這個屬性的有效值如下：

hd
sd

contentDetails.caption

string
表示影片是否提供字幕。

這個屬性的有效值如下：

false
true

contentDetails.licensedContent boolean
指出影片是否為授權內容，也就是內容已上傳至與 YouTube 內容合作夥伴連結的頻道，並由該合作夥伴提出版權聲明。

contentDetails.regionRestriction object
regionRestriction 物件包含影片可 (或不可) 觀看的國家/地區資訊。物件會包含 contentDetails.regionRestriction.allowed 屬性或 contentDetails.regionRestriction.blocked 屬性。

contentDetails.regionRestriction.allowed[] list
列出可觀看影片的國家/地區代碼。如果有這個屬性，但值中未列出國家/地區，則系統會禁止影片在該國家/地區顯示。如果這個屬性存在且包含空白清單，則影片會在所有國家/地區遭到封鎖。

contentDetails.regionRestriction.blocked[] list
列出影片遭到封鎖的國家/地區代碼。如果有這個屬性，且值中未列出國家/地區，則表示影片可在該國家/地區觀看。如果這個屬性存在且包含空白清單，表示影片可以在所有國家/地區播放。

contentDetails.contentRating object
指定影片在各種評分系統中獲得的分級。

contentDetails.contentRating.acbRating

string
影片的澳洲分級委員會 (ACB) 或澳洲通訊及媒體管理局 (ACMA) 分級資訊。ACMA 分級系統用於分類兒童電視節目。

這個屬性的有效值如下：

acbC：澳洲通訊及媒體局已將節目分級為 C。這些節目適合未滿 14 歲兒童 (不包含學齡前兒童) 觀賞。
acbE – E
acbG – G
acbM – M
acbMa15plus – MA15+
acbP：澳洲通訊及媒體局已將節目分級為 P。這些節目適合學齡前兒童觀賞。
acbPg – PG
acbR18plus – R18+
acbUnrated

contentDetails.contentRating.agcomRating

string
由義大利 Autorità per le Garanzie nelle Comunicazioni (AGCOM) 評定的影片。

這項屬性的有效值如下：

agcomT – T
agcomUnrated
agcomVm14 – VM14
agcomVm18 – VM18

contentDetails.contentRating.anatelRating

string
影片的 Anatel (Asociación Nacional de Televisión) 智利電視評級。

這個屬性適用的有效值如下：

anatelA – A
anatelF – F
anatelI – I
anatelI10 – I-10
anatelI12 – I-12
anatelI7 – I-7
anatelR – R
anatelUnrated

contentDetails.contentRating.bbfcRating

string
影片的英國電影分級委員會 (BBFC) 分級。

這個屬性的有效值如下：

bbfc12 – 12
bbfc12a – 12A
bbfc15 – 15
bbfc18 – 18
bbfcPg – PG
bbfcR18 – R18
bbfcU - U
bbfcUnrated

contentDetails.contentRating.bfvcRating

string
泰國電影和錄影帶審查委員會的影片評級。

這個屬性的有效值如下：

bfvc13 – 13
bfvc15 – 15
bfvc18 – 18
bfvc20 – 20
bfvcB – B
bfvcE – E
bfvcG – G
bfvcUnrated

contentDetails.contentRating.bmukkRating

string
影片的奧地利媒體分級委員會 (Bundesministerium für Unterricht, Kunst und Kultur) 評級。

此屬性適用的有效值如下：

bmukk10 – 10 以上
bmukk12 – 12 歲以上
bmukk14 – 14 歲以上
bmukk16 – 16 歲以上
bmukk6 – 6 歲以上
bmukk8 – 8 歲以上
bmukkAa – 未受限制
bmukkUnrated

contentDetails.contentRating.catvRating

string
加拿大電視分級制度 - 加拿大電視分級制度加拿大廣播電視電信委員會 (CRTC) 針對加拿大英語廣播節目的分級。詳情請參閱加拿大廣播標準委員會網站。

這項屬性的有效值如下：

catv14plus – 14 歲以上
catv18plus – 18 歲以上
catvC – C
catvC8 – C8
catvG – G
catvPg – PG
catvUnrated

contentDetails.contentRating.catvfrRating

string
加拿大廣播電視和電信委員會 (CRTC) 針對加拿大法文廣播內容所評定的影片分級。詳情請參閱加拿大廣播標準委員會網站。

這項屬性的有效值如下：

catvfr13plus – 13 歲以上
catvfr16plus – 16 歲以上
catvfr18plus – 18 歲以上
catvfr8plus – 8 歲以上
catvfrG – G
catvfrUnrated

contentDetails.contentRating.cbfcRating

string
影片的印度中央電影分級委員會 (CBFC) 評級。

這個屬性的有效值如下：

cbfcA – A
cbfcS – S
cbfcU - U
cbfcUnrated
cbfcUA – U/A
cbfcUA7plus – U/A
cbfcUA13plus – U/A
cbfcUA16plus – U/A

contentDetails.contentRating.cccRating

string
影片的 Consejo de Calificación Cinematográfica (智利) 評級。

這個屬性的有效值如下：

ccc14 – 14 歲以上
ccc18 – 18 歲以上
ccc18s – 18+ - contenido pornográfico
ccc18v – 18+ - 內容過於暴力
ccc6 – 6+ - Inconveniente para menores de 7 años
cccTe – Todo espectador
cccUnrated

contentDetails.contentRating.cceRating

string
影片的葡萄牙 CCE 分級。

這個屬性的有效值如下：

cceM12 – 12
cceM14 – 14
cceM16 – 16
cceM18 – 18
cceM4 – 4
cceM6 – 6
cceUnrated

contentDetails.contentRating.chfilmRating

string
影片在瑞士的分級。

這個屬性的有效值如下：

chfilm0 – 0
chfilm12 – 12
chfilm16 – 16
chfilm18 – 18
chfilm6 – 6
chfilmUnrated

contentDetails.contentRating.chvrsRating

string
影片的加拿大家庭錄影帶分級系統 (CHVRS) 分級。

這個屬性的有效值如下：

chvrs14a – 14A
chvrs18a – 18A
chvrsE – E
chvrsG – G
chvrsPg – PG
chvrsR – R
chvrsUnrated

contentDetails.contentRating.cicfRating

string
由比利時電影評級委員會 (Commission de Contrôle des Films) 評定的影片分級。

這個屬性的有效值如下：

cicfE – E
cicfKntEna – KNT/ENA
cicfKtEa – KT/EA
cicfUnrated

contentDetails.contentRating.cnaRating

string
由羅馬尼亞 CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) 評定的影片分級。

這個屬性的有效值如下：

cna12 – 12
cna15 – 15
cna18 – 18
cna18plus – 18 歲以上
cnaAp – AP
cnaUnrated

contentDetails.contentRating.cncRating

string
法國的評級系統 - Commission de classification cinematographique

這個屬性的有效值如下：

cnc10 – 10
cnc12 – 12
cnc16 – 16
cnc18 – 18
cncE – E
cncT – T
cncUnrated

contentDetails.contentRating.csaRating

string
由法國廣播內容分級機構 Conseil supérieur de l?audiovisuel 評定的影片分級。

這個屬性的有效值如下：

csa10 – 10
csa12 – 12
csa16 – 16
csa18 – 18
csaInterdiction – 攔截
csaT – T
csaUnrated

contentDetails.contentRating.cscfRating

string
影片的盧森堡電影分級監管委員會 (CSCF) 評級。

這個屬性的有效值為：

cscf12 – 12
cscf16 – 16
cscf18 – 18
cscf6 – 6
cscf9 – 9
cscfA – A
cscfAl – AL
cscfUnrated

contentDetails.contentRating.czfilmRating

string
影片在捷克共和國的評級。

這個屬性的有效值如下：

czfilm12 – 12
czfilm14 – 14
czfilm18 – 18
czfilmU - U
czfilmUnrated

contentDetails.contentRating.djctqRating

string
影片的 Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - 巴西) 分級。

這個屬性的有效值如下：

djctq10 – 10
djctq12 – 12
djctq14 – 14
djctq16 – 16
djctq18 – 18
djctqL – L
djctqUnrated

contentDetails.contentRating.djctqRatingReasons[] list
影片獲得 DJCQT (巴西) 分級的原因。

contentDetails.contentRating.ecbmctRating

string
土耳其的評分系統 - 文化和旅遊部評估及分級委員會

這個屬性的有效值為：

ecbmct13a – 13A
ecbmct13plus – 13 歲以上
ecbmct15a – 15A
ecbmct15plus – 15 歲以上
ecbmct18plus – 18 歲以上
ecbmct7a – 7A
ecbmct7plus – 7 歲以上
ecbmctG – G
ecbmctUnrated
ecbmct6a – 6A
ecbmct6plus – 6 歲以上
ecbmct10a – 10A
ecbmct10plus – 10 以上
ecbmct16plus – 16 歲以上

contentDetails.contentRating.eefilmRating

string
影片在愛沙尼亞的評級。

這個屬性的有效值如下：

eefilmK12 – 幼兒園到高中
eefilmK14 – K-14
eefilmK16 – K-16
eefilmK6 – K-6
eefilmL – L
eefilmMs12 – MS-12
eefilmMs6 – MS-6
eefilmPere – Pere
eefilmUnrated

contentDetails.contentRating.egfilmRating

string
影片在埃及的評級。

這個屬性的有效值如下：

egfilm18 – 18
egfilmBn – BN
egfilmGn – GN
egfilmUnrated

contentDetails.contentRating.eirinRating

string
影片的 Eirin (映倫) 分級。Eirin 是日本的分級制度。

這個屬性的有效值如下：

eirinG – G
eirinPg12 – PG-12
eirinR15plus – R15+
eirinR18plus – R18+
eirinUnrated

contentDetails.contentRating.fcbmRating

string
影片的馬來西亞電影審查委員會分級。

這個屬性的有效值如下：

fcbm13 – 13
fcbm16 – 16
fcbm18 – 18
fcbm18pa – 18PA
fcbm18pl – 18PL
fcbm18sg – 18SG
fcbm18sx – 18SX
fcbmP12 – P12
fcbmP13 – P13
fcbmPg13 – PG13
fcbmU - U
fcbmUnrated

contentDetails.contentRating.fcoRating

string
由香港電影、報刊及物品管理處評定的影片分級。

這個屬性的有效值如下：

fcoI – I
fcoIi – II
fcoIia – IIA
fcoIib – IIB
fcoIii – III
fcoUnrated

contentDetails.contentRating.fmocRating

string
這項屬性已於 2015 年 11 月 2 日淘汰。請改用 contentDetails.contentRating.cncRating 屬性。

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

這個屬性的有效值如下：

fmoc10 – 10
fmoc12 – 12
fmoc16 – 16
fmoc18 – 18
fmocE – E
fmocU - U
fmocUnrated

contentDetails.contentRating.fpbRating

string
影片的南非電影與出版物分級委員會分級。

這個屬性的有效值如下：

fpb10 – 10
fpb1012Pg – 10-12PG
fpb13 – 13
fpb16 – 16
fpb18 – 18
fpb79Pg – 7-9PG
fpbA – A
fpbPg – PG
fpbUnrated
fpbX18 – X18
fpbXx – XX

contentDetails.contentRating.fpbRatingReasons[] list
影片獲得 FPB (南非) 分級的原因。

contentDetails.contentRating.fskRating

string
影片的 Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - 德國) 分級。

這個屬性的有效值如下：

fsk0 – FSK 0
fsk12 – FSK 12
fsk16 – FSK 16
fsk18 – FSK 18
fsk6 – FSK 6
fskUnrated

contentDetails.contentRating.grfilmRating

string
影片在希臘的評級。

這個屬性的有效值如下：

grfilmE – E
grfilmK – K
grfilmK12 – 幼兒園到高中
grfilmK13 – K-13
grfilmK15 – K-15
grfilmK17 – K-17
grfilmK18 – K-18
grfilmUnrated

contentDetails.contentRating.icaaRating

string
影片的 Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - 西班牙) 分級。

這個屬性的有效值如下：

icaa12 – 12
icaa13 – 13
icaa16 – 16
icaa18 – 18
icaa7 – 7
icaaApta – APTA
icaaUnrated
icaaX – X

contentDetails.contentRating.ifcoRating

string
影片的愛爾蘭電影分級辦公室 (IFCO - 愛爾蘭) 分級。詳情請參閱 IFCO 網站。

這項屬性的有效值如下：

ifco12 – 12
ifco12a – 12A
ifco15 – 15
ifco15a – 15A
ifco16 – 16
ifco18 – 18
ifcoG – G
ifcoPg – PG
ifcoUnrated

contentDetails.contentRating.ilfilmRating

string
影片在以色列的評級。

這個屬性的有效值如下：

ilfilm12 – 12
ilfilm16 – 16
ilfilm18 – 18
ilfilmAa – AA
ilfilmUnrated

contentDetails.contentRating.incaaRating

string
影片的 INCAA (Instituto Nacional de Cine y Artes Audiovisuales - Argentina) 評級。

這個屬性的有效值如下：

incaaAtp – ATP (Apta para todo publico)
incaaC – X (僅限 18 歲以上觀眾，需經過審查)
incaaSam13 – 13 (僅限 13 歲以上觀眾)
incaaSam16 – 16 (僅限年滿 16 歲者)
incaaSam18 – 18 (僅限 18 歲以上觀眾)
incaaUnrated

contentDetails.contentRating.kfcbRating

string
肯亞電影分級委員會的影片分級。

這個屬性的有效值如下：

kfcb16plus – 16
kfcbG – GE
kfcbPg – PG
kfcbR – 18
kfcbUnrated

contentDetails.contentRating.kijkwijzerRating

string
voor de Classificatie van Audiovisuele Media (Netherlands)。

這個屬性的有效值如下：

kijkwijzer12 – 12
kijkwijzer14 – 14
kijkwijzer16 – 16
kijkwijzer18 – 18
kijkwijzer6 – 6
kijkwijzer9 – 9
kijkwijzerAl – AL
kijkwijzerUnrated

contentDetails.contentRating.kmrbRating

string
影片的韓國媒體分級委員會 (영상물등급위원회) 評級。KMRB 會為韓國的影片進行分級。

這個屬性的有效值如下：

kmrb12plus – 12세 이상 관람가
kmrb15plus – 15세 이상 관람가
kmrbAll – 전체관람가
kmrbR – 청소년 관람불가
kmrbTeenr
kmrbUnrated

contentDetails.contentRating.lsfRating

string
由印尼的 Lembaga Sensor Film 評定的影片分級。

這個屬性適用的有效值如下：

lsf13 – 13
lsf17 – 17
lsf21 – 21
lsfA – A
lsfBo – BO
lsfD – D
lsfR – R
lsfSu – SU
lsfUnrated

contentDetails.contentRating.mccaaRating

string
由馬爾他電影分級委員會評定的影片分級。

這個屬性的有效值如下：

mccaa12 – 12
mccaa12a – 12A
mccaa14 – 14 - 這個分級標籤已從 2013 年推出的新分級結構中移除。
mccaa15 – 15
mccaa16 – 16 - 這個分級標籤已從 2013 年推出的新分級結構中移除。
mccaa18 – 18
mccaaPg – PG
mccaaU - U
mccaaUnrated

contentDetails.contentRating.mccypRating

string
丹麥電影學院 (Det Danske Filminstitut) 兒童及青少年媒體評議會的影片分級。

這個屬性的有效值如下：

mccyp11 – 11
mccyp15 – 15
mccyp7 – 7
mccypA – A
mccypUnrated

contentDetails.contentRating.mcstRating

string
影片的越南評級系統 - MCST

這個屬性的有效值如下：

mcst0 – 0
mcst16plus – 16 歲以上
mcstC13 – C13
mcstC16 – C16
mcstC18 – C18
mcstP – P
mcstUnrated
mcstT13 – T13
mcstT16 – T16
mcstT18 – T18
mcstK – K

contentDetails.contentRating.mdaRating

string
由新加坡媒體發展局 (MDA) 和電影審查委員會 (BFC) 評定的影片分級。

這個屬性的有效值如下：

mdaG – G
mdaM18 – M18
mdaNc16 – NC16
mdaPg – PG
mdaPg13 – PG13
mdaR21 – R21
mdaUnrated

contentDetails.contentRating.medietilsynetRating

string
由挪威媒體管理局 Medietilsynet 評定的影片分級。

這個屬性的有效值如下：

medietilsynet11 – 11
medietilsynet12 – 12
medietilsynet15 – 15
medietilsynet18 – 18
medietilsynet6 – 6
medietilsynet7 – 7
medietilsynet9 – 9
medietilsynetA – A
medietilsynetUnrated

contentDetails.contentRating.mekuRating

string
芬蘭國家視聽研究所 (National Audiovisual Institute) 的影片分級。

這個屬性的有效值如下：

meku12 – 12
meku16 – 16
meku18 – 18
meku7 – 7
mekuS – S
mekuUnrated

contentDetails.contentRating.mibacRating

string
由意大利文化資產、旅遊和觀光部 (MiBACT) 評定的影片分級。

這個屬性可用的值如下：

mibacT
mibacUnrated
mibacVap
mibacVm6
mibacVm12
mibacVm14
mibacVm18

contentDetails.contentRating.mocRating

string
影片的 Ministerio de Cultura (哥倫比亞) 評級。

這個屬性的有效值如下：

moc12 – 12
moc15 – 15
moc18 – 18
moc7 – 7
mocBanned – 已停權
mocE – E
mocT – T
mocUnrated
mocX – X

contentDetails.contentRating.moctwRating

string
影片的臺灣文化部評級。

這個屬性的有效值如下：

moctwG – G
moctwP – P
moctwPg – PG
moctwR – R
moctwR12 – R-12
moctwR15 – R-15
moctwUnrated

contentDetails.contentRating.mpaaRating

string
影片的美國電影協會 (MPAA) 分級。

這個屬性的有效值如下：

mpaaG – G
mpaaNc17 – NC-17
mpaaPg – PG
mpaaPg13 – PG-13
mpaaR – R
mpaaUnrated

contentDetails.contentRating.mpaatRating

string
美國電影協會對電影預告片和預覽片的評級。

這個屬性的有效值如下：

mpaatGb – GB (綠帶 - 適合所有觀眾)
mpaatRb – RB (紅色標章 - 建議年齡 17 歲以上)

contentDetails.contentRating.mtrcbRating

string
由菲律賓電影電視審查分級委員會 (Movie and Television Review and Classification Board) 評定的影片分級。

這個屬性可用的值如下：

mtrcbG – G
mtrcbPg – PG
mtrcbR13 – R-13
mtrcbR16 – R-16
mtrcbR18 – R-18
mtrcbUnrated
mtrcbX – X

contentDetails.contentRating.nbcRating

string
由馬爾地文迪內閣分級局評定的影片分級。

這個屬性的有效值如下：

nbc12plus – 12 歲以上
nbc15plus – 15 歲以上
nbc18plus – 18 歲以上
nbc18plusr – 18+R
nbcG – G
nbcPg – PG
nbcPu – PU
nbcUnrated

contentDetails.contentRating.nfrcRating

string
影片的保加利亞國家電影中心分級。

這個屬性的有效值如下：

nfrcA – A
nfrcB – B
nfrcC – C
nfrcD – D
nfrcUnrated
nfrcX – X

contentDetails.contentRating.nfvcbRating

string
由奈及利亞國家電影和錄影帶審查委員會評定的影片分級。

這個屬性適用的有效值如下：

nfvcb12 – 12
nfvcb12a – 12A
nfvcb15 – 15
nfvcb18 – 18
nfvcbG – G
nfvcbPg – PG
nfvcbRe – RE
nfvcbUnrated

contentDetails.contentRating.nkclvRating

string
由 Nacionãlais Kino centrs (拉脫維亞國家電影中心) 評定的影片分級。

這個屬性的有效值如下：

nkclv12plus – 12 歲以上
nkclv18plus – 18 歲以上
nkclv7plus – 7 歲以上
nkclvU - U
nkclvUnrated

contentDetails.contentRating.oflcRating

string
影片的電影和文學分級辦公室 (OFLC - 紐西蘭) 分級。

這個屬性適用的有效值如下：

oflcG – G
oflcM – M
oflcPg – PG
oflcR13 – R13
oflcR15 – R15
oflcR16 – R16
oflcR18 – R18
oflcRp13 – RP13
oflcRp16 – RP16
oflcUnrated

contentDetails.contentRating.pefilmRating

string
影片在秘魯的評級。

這個屬性的有效值如下：

pefilm14 – 14
pefilm18 – 18
pefilmPg – PG
pefilmPt – PT
pefilmUnrated

contentDetails.contentRating.resorteviolenciaRating

string
影片在委內瑞拉的評級。

這個屬性的有效值如下：

resorteviolenciaA – A
resorteviolenciaB – B
resorteviolenciaC – C
resorteviolenciaD – D
resorteviolenciaE – E
resorteviolenciaUnrated

contentDetails.contentRating.rtcRating

string
影片的墨西哥廣播電視電影總署 (General Directorate of Radio, Television and Cinematography) 分級。

這個屬性的有效值如下：

rtcA – A
rtcAa – AA
rtcB – B
rtcB15 – B15
rtcC – C
rtcD – D
rtcUnrated

contentDetails.contentRating.rteRating

string
影片的愛爾蘭 Raidió Teilifís Éireann 評級。

這個屬性的有效值如下：

rteCh – CH
rteGa – GA
rteMa – MA
rtePs – PS
rteUnrated

contentDetails.contentRating.russiaRating

string
影片的俄羅斯聯邦國家電影登記處 (MKRF - 俄羅斯) 分級。

這個屬性的有效值如下：

russia0 – 0 以上
russia12 – 12 歲以上
russia16 – 16 歲以上
russia18 – 18 歲以上
russia6 – 6 歲以上
russiaUnrated

contentDetails.contentRating.skfilmRating

string
影片在斯洛伐克的評級。

這個屬性的有效值如下：

skfilmG – G
skfilmP2 – P2
skfilmP5 – P5
skfilmP8 – P8
skfilmUnrated

contentDetails.contentRating.smaisRating

string
影片在冰島的評級。

這個屬性的有效值如下：

smais12 – 12
smais14 – 14
smais16 – 16
smais18 – 18
smais7 – 7
smaisL – L
smaisUnrated

contentDetails.contentRating.smsaRating

string
由 Statens medieråd (瑞典國家媒體委員會) 評定的影片分級。

這個屬性適用的有效值如下：

smsa11 – 11
smsa15 – 15
smsa7 – 7
smsaA – 所有年齡層
smsaUnrated

contentDetails.contentRating.tvpgRating

string
影片的 TV Parental Guidelines (TVPG) 分級。

這個屬性的有效值如下：

tvpgG – TV-G
tvpgMa – TV-MA
tvpgPg – TV-PG
tvpgUnrated
tvpgY – TV-Y
tvpgY7 – TV-Y7
tvpgY7Fv – TV-Y7-FV
pg14 – TV-14

contentDetails.contentRating.ytRating

string
YouTube 用來識別年齡限制內容的分級。

這個屬性的有效值如下：

ytAgeRestricted

contentDetails.projection

string
指定影片的投影格式。

這個屬性的有效值如下：

360
rectangular

contentDetails.hasCustomThumbnail boolean
指出影片上傳者是否已為影片提供自訂縮圖圖片。只有影片上傳者能查看這個屬性。

status object
status 物件包含影片上傳、處理和隱私權狀態的相關資訊。

status.uploadStatus

string
上傳影片的狀態。

這個屬性的有效值如下：

deleted
failed
processed
rejected
uploaded

status.failureReason

string
這個值會說明影片上傳失敗的原因。只有在 uploadStatus 屬性指出上傳失敗時，才會出現這個屬性。

這個屬性的有效值如下：

codec
conversion
emptyFile
invalidFile
tooSmall
uploadAborted

status.rejectionReason

string
這個值會說明 YouTube 拒絕上傳影片的原因。只有在 uploadStatus 屬性指出上傳內容遭到拒絕時，才會出現這個屬性。

這個屬性的有效值如下：

claim
copyright
duplicate
inappropriate
legal
length
termsOfUse
trademark
uploaderAccountClosed
uploaderAccountSuspended

status.privacyStatus

string
影片的隱私權狀態。

這個屬性的有效值如下：

private
public
unlisted

status.publishAt

datetime
影片的發布日期和時間。只有在影片的隱私權狀態設為「私人」時，才能設定這項資訊。這個值採用 ISO 8601 格式指定。請注意下列兩個額外關於此屬性行為的事項：

如果在呼叫 videos.update 方法時設定這個屬性的值，即使影片已設為私人，也必須將 status.privacyStatus 屬性值設為 private。
如果您要求將影片排定在過去的某個時間發布，影片就會立即發布。因此，將 status.publishAt 屬性設為過去日期和時間的效果，就和將影片的 privacyStatus 從 private 變更為 public 相同。

status.license

string
影片的授權。

這個屬性的有效值如下：

creativeCommon
youtube

status.embeddable boolean
這個值表示影片是否可嵌入其他網站。

status.publicStatsViewable boolean
這個值會指出影片觀賞頁面上的延伸影片統計資料是否可供大眾查看。根據預設，這些統計資料會公開顯示，即使這個屬性的值設為 false，影片的觀看次數和評分等統計資料仍會公開顯示。

status.madeForKids boolean
這個值會指出影片是否指定為兒童導向，並包含影片目前的「兒童專屬」狀態。舉例來說，系統可能會根據 selfDeclaredMadeForKids 屬性的值來判斷狀態。如要進一步瞭解如何設定頻道、影片或直播的目標觀眾，請參閱 YouTube 說明中心。

status.selfDeclaredMadeForKids boolean
在 videos.insert 或 videos.update 要求中，這個屬性可讓頻道擁有者將影片指定為兒童導向內容。在 videos.list 要求中，只有在頻道擁有者授權 API 要求時，系統才會傳回屬性值。

status.containsSyntheticMedia

boolean
在 videos.insert 或 videos.update 要求中，這個屬性可讓頻道擁有者揭露影片含有逼真的變造或合成 (A/S) 內容。進一步瞭解 YouTube 與 A/S 內容相關的政策。

以下列舉幾種 A/S 內容的例子：

呈現真實人物的言論與動作，但其實並非本人所為
變造真實事件或地點的影片片段
生成看似真實但從未發生的場景

statistics object
statistics 物件包含影片的統計資料。

statistics.viewCount

unsigned long

影片的觀看次數。

自 2025 年 3 月 31 日起，Shorts 的 viewCount 會傳回 Shorts 開始播放或重播的次數，且不需達到最短觀看時間門檻。

statistics.likeCount unsigned long
表示喜歡影片的使用者人數。

statistics.dislikeCount

unsigned long

注意：自 2021 年 12 月 13 日起，statistics.dislikeCount 屬性已設為不公開。也就是說，只有在 API 要求經過影片擁有者驗證時，屬性才會納入 API 回應。詳情請參閱修訂版本記錄。

表示不喜歡影片的使用者人數。

statistics.favoriteCount unsigned long
注意：此屬性已淘汰。停用日期為 2015 年 8 月 28 日。屬性的值現在一律設為 0。

statistics.commentCount unsigned long
影片的留言數。

paidProductPlacementDetails object
paidProductPlacementDetails 物件包含影片中的付費商品置入資訊。

paidProductPlacementDetails.hasPaidProductPlacement boolean
如果內容使用付費商品置入，請將此屬性設為 true。預設為 false。

player object
player 物件包含用於在嵌入式播放器中播放影片的資訊。

player.embedHtml

string
用於嵌入播放影片的播放器的 <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 已淘汰，自 2017 年 2 月 27 日起，主題 ID 的運作方式已有所不同。當時，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：影片需要旋轉 180 度。

fileDetails.videoStreams[].vendor string
用於明確識別影片供應商的值。這個值通常是四個字母的供應商代碼。

fileDetails.audioStreams[] list
上傳的影片檔案中所含音訊串流清單。清單中的每個項目都包含音訊串流的詳細中繼資料。

fileDetails.audioStreams[].channelCount unsigned integer
串流包含的音訊聲道數。

fileDetails.audioStreams[].codec string
串流使用的音訊轉碼器。

fileDetails.audioStreams[].bitrateBps unsigned long
音訊串流的位元率，以每秒位元數為單位。

fileDetails.audioStreams[].vendor string
用於明確識別影片供應商的值。這個值通常是四個字母的供應商代碼。

fileDetails.durationMs unsigned long
上傳影片的長度 (以毫秒為單位)。

fileDetails.bitrateBps unsigned long
上傳的視訊檔案 (視訊和音訊) 總位元率，以每秒位元數為單位。

fileDetails.creationTime

string
上傳的影片檔案建立日期和時間。這個值採用 ISO 8601 格式指定。目前支援下列 ISO 8601 格式：

僅日期：YYYY-MM-DD
原始時間：YYYY-MM-DDTHH:MM:SS
含時區的時間：YYYY-MM-DDTHH:MM:SS+HH:MM

processingDetails object
processingDetails 物件會封裝 YouTube 處理上傳影片檔案的進度資訊。物件中的屬性會指出目前的處理狀態，以及 YouTube 處理影片所需的預估時間。這個部分也會指出影片是否提供不同類型的資料或內容，例如檔案詳細資料或縮圖。

processingProgress 物件可用於輪詢，讓上傳的影片追蹤 YouTube 處理上傳影片檔案的進度。只有影片擁有者才能擷取這項資料。

processingDetails.processingStatus

string
影片的處理狀態。這個值表示 YouTube 是否已處理影片，或影片是否仍在處理中。

這個屬性的有效值如下：

failed – 影片處理失敗。請參閱 ProcessingFailureReason。
processing – 影片目前正在處理中。請參閱 ProcessingProgress。
succeeded：已成功處理影片。
terminated – 處理資訊已不再提供。

processingDetails.processingProgress object
processingProgress 物件包含 YouTube 處理影片的進度資訊。只有在影片的處理狀態為 processing 時，這些值才會相關。

processingDetails.processingProgress.partsTotal unsigned long
預估影片需要處理的部分總數。在 YouTube 處理影片時，系統可能會更新更精確的預估值。

processingDetails.processingProgress.partsProcessed unsigned long
YouTube 已處理的影片片段數量。你可以透過以下計算方式，估算 YouTube 已處理的影片百分比：
100 * parts_processed / parts_total

請注意，由於估算的部分數量可能會增加，但已處理的部分數量並未相應增加，因此在 YouTube 處理影片時，計算出的進度可能會週期性地減少。

processingDetails.processingProgress.timeLeftMs unsigned long
YouTube 處理影片所需的時間 (以毫秒為單位)。

processingDetails.processingFailureReason

string
YouTube 無法處理影片的原因。只有在 processingStatus 屬性的值為 failed 時，這個屬性才會有值。

這個屬性的有效值如下：

other – 其他處理元件發生錯誤。
streamingFailed：無法將影片傳送給串流播放器。
transcodeFailed – 內容轉碼失敗。
uploadFailed – 檔案提交失敗。

processingDetails.fileDetailsAvailability string
這個值會指出上傳影片是否有檔案詳細資料。您可以透過 videos.list() 要求中的 fileDetails 部分，擷取影片的檔案詳細資料。

processingDetails.processingIssuesAvailability string
這個值表示影片處理引擎是否已產生可改善 YouTube 處理影片能力的建議、說明影片處理問題的警告，或是導致影片處理問題的錯誤。您可以透過在 videos.list() 要求中要求 suggestions 部分，擷取這些建議。

processingDetails.tagSuggestionsAvailability string
這個值會指出影片是否有關鍵字 (標記) 建議。你可以在影片中繼資料中新增標記，方便其他使用者找到影片。您可以透過在 videos.list() 要求中要求 suggestions 部分，擷取這些建議。

processingDetails.editorSuggestionsAvailability string
這個值會指出影片是否有可改善影片品質或播放體驗的影片編輯建議。您可以透過在 videos.list() 要求中要求 suggestions 部分，擷取這些建議。

processingDetails.thumbnailsAvailability string
這個值用於指出系統是否已為影片產生縮圖圖片。

suggestions object
suggestions 物件會封裝建議，指出可改善上傳影片品質或中繼資料的機會。只有影片擁有者才能擷取這項資料。

只有在 processingDetails.tagSuggestionsAvailability 屬性或 processingDetails.editorSuggestionsAvailability 屬性的值為 available 時，系統才會傳回 suggestions 物件。

suggestions.processingErrors[]

list
導致 YouTube 無法順利處理上傳影片的錯誤清單。這些錯誤表示無論影片目前的處理狀態為何，最終狀態幾乎一定會是 failed。

這個屬性的有效值如下：

archiveFile – 封存檔案 (例如 ZIP 封存檔)。
audioFile – 檔案只含有音訊 (例如 MP3 檔案)。
docFile – 文件或文字檔案 (例如 MS Word 文件)。
imageFile – 圖片檔案 (例如 JPEG 圖片)。
notAVideoFile：其他非影片檔案。
projectFile – 電影專案檔案 (例如 Microsoft Windows Movie Maker 專案)。

suggestions.processingWarnings[]

list
YouTube 可能無法順利轉碼上傳的影片，或轉碼結果有誤的可能原因清單。這些警告會在 YouTube 實際處理上傳的影片檔案前產生。此外，這些屬性可找出可能導致同步問題、影片瑕疵或缺少音軌等問題，但不一定會導致影片處理失敗。

這個屬性的有效值如下：

hasEditlist – 目前不支援編輯清單。
inconsistentResolution – 容器和串流解析度相衝突。
problematicAudioCodec：使用已知會造成問題的音訊編解碼。
problematicVideoCodec：使用了已知會導致問題的視訊轉碼器。
unknownAudioCodec：無法辨識的音訊編解碼器，轉碼可能會失敗。
unknownContainer：系統無法辨識的檔案格式，轉碼作業可能會失敗。
unknownVideoCodec：系統無法辨識的視訊編解碼器，轉碼可能會失敗。

suggestions.processingHints[]

list
列出可能有助於 YouTube 處理影片的建議。

這個屬性的有效值如下：

nonStreamableMov – MP4 檔案無法串流，因此處理速度會變慢。
sendBestQualityVideo – 可能有畫質較佳的影片。

suggestions.tagSuggestions[] list
可新增至影片中繼資料的關鍵字標記清單，可提高使用者在 YouTube 上搜尋或瀏覽時找到影片的機率。

suggestions.tagSuggestions[].tag string
建議的影片關鍵字標記。

suggestions.tagSuggestions[].categoryRestricts[] list
一組與標記相關的影片類別。你可以根據影片上傳者與影片建立關聯的影片類別，利用這項資訊顯示適當的標記建議。根據預設，如果關鍵字未定義任何限制，代碼建議就會與所有類別相關。

suggestions.editorSuggestions[]

list
一組影片編輯作業清單，可能可改善上傳影片的影片品質或播放體驗。

這個屬性的有效值如下：

audioQuietAudioSwap – 音軌似乎沒有聲音，可以換成品質較佳的音軌。
videoAutoLevels：圖片亮度似乎不對，可以修正。
videoCrop – 系統會裁剪圖片周圍偵測到的邊框 (外框)。
videoStabilize：影片似乎有晃動，可使用防震功能。

liveStreamingDetails object
liveStreamingDetails 物件包含直播影片廣播的中繼資料。只有在影片是即將播出、正在播出或已完成的直播時，這個物件才會出現在 video 資源中。

liveStreamingDetails.actualStartTime datetime
廣播實際開始的時間。這個值採用 ISO 8601 格式指定。這個值會在廣播開始後才可使用。

liveStreamingDetails.actualEndTime datetime
廣播實際結束的時間。這個值採用 ISO 8601 格式指定。這個值必須等到廣播結束後才會提供。

liveStreamingDetails.scheduledStartTime datetime
廣播預定開始的時間。這個值採用 ISO 8601 格式指定。

liveStreamingDetails.scheduledEndTime datetime
廣播活動的預定結束時間。這個值採用 ISO 8601 格式指定。如果值為空白或屬性不存在，則系統會排定廣播活動無限期持續放送。

liveStreamingDetails.concurrentViewers

unsigned long
目前觀看直播的觀眾人數。如果直播目前有觀眾，且直播擁有者未隱藏影片的觀看次數，系統就會提供這項屬性及其值。請注意，YouTube 會在直播結束後停止追蹤直播的同時觀看人數。因此，這個屬性不會識別觀看已結束的直播影片封存檔的觀眾人數。

YouTube Data API 傳回的同時觀看人數可能與透過 YouTube 數據分析處理後的同時觀看人數不同。如要進一步瞭解直播指標，請前往 YouTube 說明中心。

liveStreamingDetails.activeLiveChatId string
這部影片目前連結的有效聊天室 ID。只有在影片是目前正在直播且有聊天室的情況下，這個欄位才會填入資料。廣播轉換為完成狀態後，系統會移除這個欄位，並關閉聊天室。對於持續直播，聊天室 ID 將不再與該影片連結，而是連結至持續頁面顯示的新影片。

localizations object
localizations 物件包含影片中繼資料的翻譯。

localizations.(key) object
與鍵值相關聯的本地化文字語言。這個值是包含 BCP-47 語言代碼的字串。

localizations.(key).title string
本地化的影片標題。

localizations.(key).description string
本地化的影片說明。

Videos 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

方法

資源表示法

屬性

Videos