YouTube 和 YouTube Music 結構定義參考資料

匯出的物件:影片媒體
匯出的物件代表:你上傳的影片
物件會匯出為下列格式:原始格式 / MP4
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
匯出的物件:影片
匯出的物件代表:影片實體資料
物件會以 CSV 格式匯出
匯出的物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
影片 ID用來識別播放清單所屬影片的專屬影片 ID。

範例:
pRXlrbuLZek
字串
約略時間長度 (毫秒)影片的大約時間長度 (以毫秒為單位)。

示例:
1234
int64
影片音訊語言影片音訊語言。

範例:
en
字串
影片類別影片類別。

示例:
未指定類別
電影
enum
影片說明 (原文)創作者提供的原始影片說明。

示例:
這是有趣的影片
字串
影片說明 (原文) 語言創作者提供的 YouTube 影片原始說明語言。

示例:
en
字串
頻道 IDYouTube 影片創作者的頻道 ID。

示例:
UCGg-UqjRgzhYDPJMr-9HXCg
字串
標記YouTube 影片標記 (關鍵字)。

範例:
有趣的影片
字串
影片標題 (原版)創作者提供的影片原始標題 (名稱)。

示例:
2023 年最新搞笑和失敗影片
字串
頻道標題 (原文) 語言創作者提供的 YouTube 影片原始名稱語言。

示例:
en
字串
縮圖網址YouTube 影片翻譯縮圖網址。

示例:
http://thumbnail_url
字串
隱私權影片的隱私權狀態。

示例:
私人
公開
enum
影片狀態影片上傳作業的目前狀態。

示例:
已上傳
已處理
enum
影片建立時間戳記YouTube 影片的建立時間戳記。

範例:
2023-07-17T17:52:49+00:00
時間戳記
影片發布時間戳記YouTube 影片的發布時間戳記。

範例:
2023-07-17T18:52:49+00:00
時間戳記
匯出的物件:影片互動
匯出的物件代表:YouTube 影片互動記錄。
物件會匯出為 CSV 格式。
匯出的物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
影片互動 ID使用者互動的影片 ID。

示例:
pRXlrbuLZek
字串
建立時間影片互動的建立時間

範例:
2023-07-17T17:52:49+00:00
時間戳記
互動類型影片中的互動式貼紙類型。

範例:
CHANNEL_MENTION
VIDEO_LINK
WEB_LINK
enum
提及頻道頻道 ID影片中頻道提及貼紙的相關頻道 ID。

示例:
UCGg-UqjRgzhYDPJMr-9HXCg
重複字串
影片連結影片 ID影片連結貼紙所連結的影片 ID。

示例:
pRXlrbuLZek
重複字串
匯出的物件:影片錄製
匯出的物件代表:YouTube 影片錄製資訊。
物件會匯出為 CSV 格式。
匯出的物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
影片錄製地址Places API 傳回的任意地址名稱字串。

範例:
NASA Johnson Space Center
字串
影片錄製地址 2Places API 傳回的任意地址標題字串。

範例:
倫敦
字串
錄影內容國家/地區影片錄製地點的國家/地區,格式為 ISO 3166-1 alpha-2 國家/地區代碼。

示例:
DE
字串
錄影內容日期影片的錄製日期。

範例:
2023-07-17T17:52:49+00:00
時間戳記
影片 ID影片 ID

範例:
dhLQS_XCG0g
字串
錄影內容位置高度錄影地點的海拔高度。

示例:
305.0
雙精準數
錄影內容位置緯度影片錄製地點的緯度。

示例:
47.3653139
雙精準數
錄影內容位置經度錄影位置的經度。

示例:
8.5244746
雙精準數
地點 ID影片錄製地點的 ID,源自 Google Places API。

示例:
ChIJgUbEo8cfqokR5lP9_Wh_DaM
字串
錄影內容位置郵遞區號影片錄製地點的郵遞區號。

範例:
94114
字串
匯出的物件:影片文字
匯出的物件代表:與 YouTube 影片相關聯的結構化文字,由創作者提供。
物件會匯出為 CSV 格式。
匯出的物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
影片 ID影片的專屬 ID。

示例:
pRXlrbuLZek
字串
建立時間為影片建立影片文字實體的時間。

示例:
2023-07-17T17:52:49+00:00
時間戳記
說明文字區段與影片相關聯的說明,以文字區段的形式呈現。

示例:
這是
我的
影片文字說明。
重複字串
標題文字區段與影片相關聯的標題,分成多個文字片段。

示例:
我的
影片標題
重複字串
更新時間影片文字實體的上次更新時間。

範例:
2023-07-17T17:52:49+00:00
時間戳記
匯出的物件:播放清單
匯出的物件代表:你建立的播放清單
匯出物件的格式:CSV
匯出物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
播放清單 IDYouTube 播放清單 ID (顯示在網址中)。

範例:
PLpjK416fmKwSfobBm4dbk5nHT0KPqDETS
字串
新增影片至播放清單頂端使用者設定,指定是否要將新影片新增至播放清單頂端。

範例:
true
bool
播放清單說明 (譯文) 的建立時間戳記創作者提供的播放清單說明譯文建立時間。

示例:
2023-02-10T00:00:00Z
時間戳記
播放清單說明語言代碼創作者提供的播放清單說明譯文語言代碼。

示例:
en-US
字串
播放清單說明 (譯文)創作者提供的播放清單說明翻譯訊息。

示例:
播放清單說明
字串
播放清單說明 (譯文) 的更新時間創作者提供的每則翻譯訊息更新時間。

示例:
2023-02-10T00:00:00Z
時間戳記
播放清單說明 (原文)播放清單說明的原文。

範例:
搞笑影片
字串
播放清單說明 (原文) 語言播放清單說明的原始語言。

示例:
en-US
字串
播放清單圖片的建立時間戳記播放清單圖片的建立時間。

示例:
2023-02-10T00:00:00Z
時間戳記
播放清單圖片網址播放清單圖片的 FIFE 網址。

示例:
https://lh4.googleusercontent.com/JDjSmaNIR-Px5svzdyVwpGd9B6S8vaCt0sWMxGjpkHOm-u6Q4lmJhVrRwq3oz8MGu3QrfyqjrrDo4CZUtgIa6d97ig=s400-h200
字串
播放清單圖片高度播放清單圖片的高度 (以像素為單位)。

範例:
200
int32
播放清單圖片寬度播放清單圖片的寬度 (以像素為單位)。

範例:
200
int32
播放清單標題 (譯文) 的建立時間戳記創作者提供的播放清單名稱翻譯建立時間。

示例:
2023-02-10T00:00:00Z
時間戳記
播放清單標題語言代碼創作者提供的播放清單名稱翻譯語言代碼。

示例:
en-US
字串
播放清單標題 (譯文)創作者提供的播放清單名稱翻譯訊息。

示例:
播放清單標題
字串
播放清單標題 (譯文) 的更新時間戳記創作者提供的播放清單名稱翻譯更新時間。

示例:
2023-02-10T00:00:00Z
時間戳記
播放清單標題 (原文)播放清單名稱 (標題) 的原文。

範例:
我的影片
字串
播放清單標題 (原文) 語言播放清單名稱 (標題) 的原始語言。

示例:
en-US
字串
播放清單的建立時間戳記播放清單的建立時間。

示例:
2023-02-10T00:00:00Z
字串
播放清單更新時間戳記播放清單的最新更新時間。

示例:
2023-02-10T00:00:00Z
字串
播放清單影片順序播放清單影片的順序。

示例:
手動
新增日期 (最新)
enum
播放清單瀏覽權限使用者播放清單瀏覽權限設定的值。

示例:
公開
私人
不公開
enum
匯出的物件:播放清單影片
匯出的物件代表:每個播放清單中的影片
匯出的物件格式:CSV
匯出的物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
影片 ID用來識別影片所屬播放清單的專屬影片 ID。

範例:
pRXlrbuLZek
字串
播放清單影片的建立時間戳記影片加入播放清單的時間戳記。

範例:
2023-07-17T17:52:49+00:00
時間戳記
匯出物件:頻道
匯出物件代表:頻道相關資訊。
物件會匯出為 CSV 格式。
匯出的物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
頻道 ID頻道的專屬 ID。

範例:
UCGg-UqjRgzhYDPJMr-9HXCg
字串
相關聯的網址使用者提供的頻道相關聯網址。

示例:
twitter.com/TeamYouTube
重複字串
國家/地區與頻道相關聯的國家/地區。

示例:
美國
字串
說明頻道的說明。

範例:
歡迎來到我的頻道!
字串
說明語言說明的語言。

示例:
en
字串
標記與頻道相關聯的關鍵字標記清單。

範例:
cats
coffee
重複字串
標題頻道名稱。

示例:
Creator Insider
字串
標題語言標題的語言。

示例:
en
字串
頻道瀏覽權限頻道的瀏覽權限設定。

示例:
公開
私人
enum
匯出物件:頻道社群管理設定
匯出物件代表:聊天室訊息和留言共用的頻道通用設定。
物件會匯出為 CSV 格式。
匯出的物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
頻道 ID專屬頻道 ID。

示例:
UCkRfArvrzheW2E7b6SVT7vQ
字串
封鎖的字詞YouTube 頻道擁有者設定的封鎖字詞。

示例:
blockedwords1
blockedwords2
重複字串
匯出物件:頻道功能資料
匯出物件代表:YouTube 頻道功能相關資料。
物件會匯出為 CSV 格式。
匯出的物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
頻道 ID專屬頻道 ID。

示例:
UCGg-UqjRgzhYDPJMr-9HXCg
字串
創作者重新導向設定:允許對直播和首播影片進行重新導向的頻道 ID允許將此頻道影片設為重新導向的頻道。

示例:
UCGg-UqjRgzhYDPJMr-9HXCg
字串
遊戲:表情符號前置字元加在自訂表情符號各個表情符號快速鍵的前置字串。

示例:
前置字串
字串
遊戲:會員徽章圖片網址會員頻道自訂徽章 FIFE 網址。

示例:
http://lh3.googleusercontent.com/a/default-user
字串
聊天室設定:頻道聊天室的自動審核功能聊天室設定是否啟用自動審核功能。

範例:
true
bool
YouTube 工作室應用程式設定:留言篩選器的關鍵字留言篩選器關鍵字

示例:
文字搜尋
字串
影片預設允許的留言類型影片預設允許的留言類型。

範例:
所有留言都必須經過審核才能發布
未設定
enum
影片預設目標對象影片預設觀眾限制。

示例:
未設定
所有觀眾
enum
影片預設語言影片的預設音訊語言。

示例:
en_US
字串
影片預設說明影片預設說明。

範例:
defaults_description
字串
影片預設授權影片預設授權。

示例:
未設定
標準 YouTube 授權
enum
影片預設值:位置緯度影片預設緯度。

示例:
0
float
影片預設值:位置經度影片預設經度。

示例:
0
float
影片預設:預設中繼資料語言影片預設中繼資料語言。

範例:
en
字串
影片預設:標記影片預設標記。

範例:

足球
字串
影片預設設定:預設設定的建立時間戳記建立影片預設設定的時間戳記。

示例:
2021-12-04T02:55:23+00:00
時間戳記
影片預設:預設設定的更新時間戳記更新影片預設設定的時間戳記。

範例:
2021-12-04T02:55:23+00:00
時間戳記
影片預設語言:標題影片預設標題。

範例:
標題
字串
匯出的物件:頻道圖片
匯出的物件代表:YouTube 頻道圖片資料。
物件會匯出為 CSV 格式。
匯出的物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
頻道 ID專屬頻道 ID。

示例:
UCGg-UqjRgzhYDPJMr-9HXCg
字串
頻道圖片的建立時間戳記設定這張圖片的時間戳記。

範例:
2021-12-07T19:59:06.228723+00:00
時間戳記
頻道圖片完整內容網址頻道圖片完整內容的 FIFE 網址。

範例:
https://yt3.googleusercontent.com/FRb0bnNVqwOebrgpeN9-7w1UczESnRbCmWoK-OA3R8BD38AgxUtrRsKr9TllL3Gj7SoAiY5h
字串
匯出的物件:頻道頁面設定
匯出的物件代表:頻道頁面的版面配置和說明設定。
物件會匯出為 CSV 格式。
匯出的物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
頻道 ID專屬頻道 ID。

示例:
UCGg-UqjRgzhYDPJMr-9HXCg
字串
連結至這個頻道的 Google Analytics 帳戶 ID與頻道相關聯的 Google Analytics 帳戶 ID。

範例:
YT123
字串
應向頻道觀眾顯示的法律資訊應向頻道觀眾顯示的法律資訊。

示例:
法律文字
字串
橫幅圖片網址頻道橫幅圖片網址。

範例:
https://yt3.googleusercontent.com/FRb0bnNVqwOebrgpeN9-7w1UczESnRbCmWoK-OA3R8BD38AgxUtrRsKr9TllL3Gj7SoAiY5h
字串
創作者商務電子郵件頻道簡介中的商家電子郵件。

示例:
profile@gmail.com
字串
連結網址標題頻道簡介自訂網址的原始標題。

示例:
YouTube 創作者
字串
連結網址頻道簡介自訂網址。

示例:
https://www.youtube.com/@youtubecreators
字串
頻道宣傳短片 ID頻道宣傳短片 ID。

示例:
dhLQS_XCG0g
字串
精選影片 ID頻道精選影片 ID。

示例:
dhLQS_XCG0g
字串
匯出物件:頻道網址設定
匯出物件代表:含有 YouTube 頻道網址相關資訊的一種資料結構。
物件會匯出為 CSV 格式。
匯出的物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
頻道 ID儲存在網址設定中的不重複頻道 ID (虛榮資料)。

示例:
UCGg-UqjRgzhYDPJMr-9HXCg
字串
頻道別名網址名稱儲存在網址設定中的虛名 (虛名資料)。

示例:
janedoe-xt3mf
字串
匯出物件:頻道代名詞
匯出物件代表:YouTube 頻道個人資料中顯示的使用者自選代名詞。
物件會匯出為 CSV 格式。
匯出的物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
頻道 ID專屬頻道 ID。

示例:
UCGg-UqjRgzhYDPJMr-9HXCg
字串
代名詞YouTube 頻道擁有者設定的代名詞選項。

示例:
PRONOUNS_OPTION_HIM
PRONOUNS_OPTION_HER
repeated enum
匯出的物件:品牌連結資料
匯出的物件代表:使用者的 YouTube BrandConnect 訊息資料,包括訊息類型及內容。
物件會匯出為 CSV 格式。
匯出的物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
訊息類型指出品牌連結訊息類型的值。

示例:
拒絕提案
字串
郵件內容表示品牌連結訊息內容的值。

示例:
拒絕問卷調查: 問題:請告訴我們拒絕這項提案的原因。 答:其他。 其他詳細資料:品牌資訊不足
字串
匯出物件:訂閱項目
匯出物件代表:你的頻道訂閱項目。
物件會匯出為 CSV 格式。
匯出的物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
頻道 ID在使用者訂閱項目的 CSV 檔案中,包含您訂閱頻道 ID 的資料欄標題。

範例:
UCkRfArvrzheW2E7b6SVT7vQ
字串
頻道網址在使用者訂閱項目的 CSV 檔案中,包含您訂閱頻道網址的資料欄標題。

範例:
https://www.youtube.com/channel/UCkRfArvrzheW2E7b6SVT7vQ
字串
頻道名稱在使用者訂閱項目的 CSV 檔案中,包含你訂閱頻道名稱的資料欄標題。

示例:
YouTube 創作者
字串
匯出的物件:留言
匯出的物件代表:您建立的留言
物件會以這些格式匯出:CSV
匯出的物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
頻道 ID留言者的頻道 ID。

示例:
UCGg-UqjRgzhYDPJMr-9HXCg
字串
價格超級感謝留言的購買價格,以功能性貨幣的微量單位表示 (即貨幣基本單位的百萬分之一)。

示例:
1050000
int64
貨幣代碼購買超級感謝留言時所用貨幣的三字母貨幣代碼。

示例:
USD
字串
超級感謝 ID與購買超級感謝留言的交易相關聯的專屬 ID。

示例:
ordercode.ABCDEfGH9oo.V.1234567890123456
字串
留言 ID留言的專屬 ID。

示例:
UgzwrNZhRJAOZRYsHk54AaABAg
字串
原始留言 ID與要回覆的留言相關聯的專屬留言 ID。

範例:
UgzwrNZhRJAOZRYsHk54AaABAg
字串
貼文 ID留言所屬 YouTube 貼文的專屬 ID。

示例:
UgkxMRu3PcEPuBRhWIshNa4E3GszdpSVdZCq
字串
影片 ID留言所屬的 YouTube 影片 ID。

範例:
eKgE5Pb_W4k
字串
留言文字留言文字,分成多個文字片段。

示例:
這部
影片
太棒了!
重複字串
價格區間 ID超級感謝留言的購買價格區間。

示例:
super_thanks_50_usd
字串
匯出的物件:訊息
匯出的物件代表:您參與的對話訊息
物件會以這些格式匯出:CSV
匯出的物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
傳送者頻道 ID留言作者 (留言傳送者) 的頻道 ID。

示例:
UCGg-UqjRgzhYDPJMr-9HXCg
字串
訊息 ID郵件的專屬 ID。

示例:
UgzwrNZhRJAOZRYsHk54AaABAg
字串
對話 ID這則訊息所屬對話的不重複 ID。

示例:
UgzwrNZhRJAOZRYsHk54AaABAg
字串
訊息文字訊息文字,分成多個文字片段。

示例:
這部
影片
太棒了!
重複字串
訊息建立時間戳記 (世界標準時間)訊息建立時間的時間戳記。

範例:
2023-07-17T17:52:49+00:00
時間戳記
接收者頻道 ID訊息收件者的頻道 ID。

示例:
UCGg-UqjRgzhYDPJMr-9HXCg
重複字串
媒體分享影片 ID訊息中分享的影片 ID。

示例:
eKgE5Pb_W4k
字串
媒體分享貼文 ID訊息中分享的貼文 ID。

範例:
UgkxMRu3PcEPuBRhWIshNa4E3GszdpSVdZCq
字串
媒體分享播放清單 ID訊息中分享的播放清單 ID。

範例:
PLpjK416fmKwSfobBm4dbk5nHT0KPqDETS
字串
訊息回應使用者對訊息的回應。

範例:
{"comment_reactions": [{"emoji": "🔥", "(reacting_channel, reaction_timestamp)": [["some-channel-id", "2025-10-15T18:22:25.430671+00:00"]]}]}
JSON 字串
匯出物件:傳送的即時通訊訊息
匯出物件代表:你撰寫的即時通訊訊息
物件會以 CSV 格式匯出
匯出物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
頻道 ID作者的頻道 ID。

示例:
UCGg-UqjRgzhYDPJMr-9HXCg
字串
建立時間戳記這則即時通訊訊息的發布時間戳記 (以秒為單位)。

示例:
1696385316
int64
影片 ID發布這則即時通訊訊息的影片 ID。

示例:
zOgKTeB1fW8
字串
訊息文字聊天室訊息的文字。

示例:
這場直播太棒了!
字串
訊息是否為贊助禮物兌換結果作者發布聊天室訊息時是否兌換了贊助禮物。

示例:
true
布林值
購買金額付費聊天室的購買金額 (以微元為單位)。

示例:
1000000
int64
交易貨幣代表購買即時通訊時所用貨幣的 ISO 4217 貨幣代碼。

示例:
USD
字串
交易是否屬於慈善捐款超級留言收益是否會捐給慈善機構。

示例:
true
布林值
贊助禮物大小聊天室贊助禮物購買公告的大小。

示例:
10
uint32
匯出的物件:貼文
匯出的物件代表:你建立的貼文
匯出的物件格式:CSV
匯出的物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
貼文 ID貼文的專屬 ID。

示例:
UgwR0xFSBkKRXKeWHQ14AaABCQ
字串
存取權限制類型貼文的存取權限制類型。例如,貼文僅供贊助者觀看。

範例:
所有人
僅限贊助者
enum
貼文更新時間戳記貼文更新時間戳記。

範例:
2017-08-17T21:32:06Z
時間戳記
圖片高度 (以像素為單位)貼文圖片的高度 (以像素為單位)。

示例:
800
int32
圖片預覽座標貼文中的圖片預覽座標 (左、上、右、下),會乘以圖片尺寸,產生裁剪矩形。

示例:
0.125 0 0.875 1
字串
映像檔名稱貼文中的圖片名稱。

示例:
UgwR0xFSBkKRXKeWHQ14AaABCQ_image_1
字串
圖片寬度 (以像素為單位)貼文圖片的寬度 (以像素為單位)。

示例:
600
int32
貼文到期期間臨時貼文封存時間。

示例:
1 天
時間長度
測驗正確答案說明測驗貼文正確答案的說明。

範例:
{"text":"Some explanation"}
JSON 字串
意見調查選項圖片高度 (以像素為單位)貼文中意見調查選項圖片的高度 (以像素為單位)。

示例:
800
int32
意見調查選項圖片的預覽座標貼文中意見調查選項圖片的預覽座標 (左、上、右、下),會乘以圖片尺寸,產生裁剪矩形。

範例:
0 0 1 1
字串
意見調查選項圖片名稱貼文中的意見調查選項圖片名稱。

示例:
UgwR0xFSBkKRXKeWHQ14AaABCQ_poll_image_1
字串
意見調查選項圖片寬度 (以像素為單位)貼文中意見調查選項圖片的寬度 (以像素為單位)。

示例:
600
int32
意見調查/測驗選項 ID貼文中的意見調查或測驗選項 ID。

示例:
0
1
int32
意見調查/測驗選項文字貼文中的意見調查或測驗選項文字內容。

範例:
{"text":"Option A"}
{"text":"Option B"}
JSON 字串
貼文建立時間戳記貼文建立時間戳記。

範例:
2017-08-17T21:32:06Z
時間戳記
貼文發布時間戳記貼文發布時間戳記。

範例:
2017-08-17T21:32:06Z
時間戳記
貼文類型貼文類型。

範例:
圖片
民調
影片
enum
測驗正確答案測驗貼文正確答案的選項 ID。

示例:
1
int32
分享的播放清單 ID貼文中分享的播放清單 ID。

示例:
PL-Ib9oOPR7OE72Oe7c15d54P9Q2xOQ3rD
字串
分享的貼文 ID貼文中分享的貼文 ID。

示例:
UgwR0xFSBkKRXKeWHQ14AaABCR
字串
分享的影片 ID貼文中分享的影片 ID。

範例:
UwsrzCVZAb9
字串
貼文文字貼文的文字內容。

範例:
{"text":"歡迎來到我的 YouTube 頻道!"}
JSON 字串
匯出物件:貼文留言設定
匯出物件代表:貼文的留言設定。
物件會匯出為 CSV 格式。
匯出的物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
貼文 ID貼文的專屬 ID。

示例:
UgwR0xFSBkKRXKeWHQ14AaABCQ
字串
留言功能啟用狀態貼文的留言啟用狀態。

示例:
啟用留言
停用留言
enum
留言管理貼文的留言管理類型。

範例:
允許所有留言
所有留言都必須經過審核才能發布
enum
匯出的物件:剪輯片段
匯出的物件代表:你建立的剪輯片段
匯出物件的格式:CSV
匯出的物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
短片 ID短片的專屬 ID。

示例:
UgwR0xFSBkKRXKeWHQ14AaABCQ
字串
建立時間剪輯片段的建立時間戳記。

範例:
2023-08-17T21:32:06Z
時間戳記
標題短片標題。

範例:
{"text":"Check out this Clip!"}
JSON 字串
影片 ID短片來源影片的 ID。

示例:
UwsrzCVZAb9
字串
開始時間時間範圍從影片開頭算起的偏移量,即短片的開始時間。

範例:
10 秒
時間長度
時間長度剪輯片段的時間範圍長度。

示例:
10 秒
時間長度
匯出物件:音樂媒體
匯出物件代表:你上傳的音樂媒體
物件匯出格式:原始格式
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
匯出的物件:音樂庫歌曲
匯出的物件代表:您新增到 YouTube Music 媒體庫中的所有歌曲清單。
物件會匯出為 CSV 格式。
匯出的物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
影片 ID影片 ID。

範例:
aC9HkZW2hZk
字串
歌名CSV 欄的標題文字,其中包含使用者音樂庫中每首歌曲的名稱。

示例:
Cruel Summer
字串
專輯名稱CSV 檔案中包含使用者音樂庫內每首歌曲專輯名稱的資料欄標題文字。

示例:
Lover
字串
藝人名稱CSV 欄的標題文字,列出使用者音樂庫中每首歌曲的藝人。

示例:
Taylor Swift
字串
匯出的物件:已上傳音樂的中繼資料
匯出的物件代表:使用者透過 YouTube Music 上傳音樂媒體的相關中繼資料。
物件會以原始上傳格式匯出。
匯出物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
歌名CSV 欄的標題文字,其中包含使用者音樂庫中每首歌曲的名稱。

示例:
空白鍵
字串
專輯名稱CSV 欄的標題文字,其中包含使用者音樂庫中每首歌曲的專輯名稱。

示例:
1989
字串
藝人名稱CSV 欄的標題文字,列出使用者音樂庫中每首歌曲的藝人。

示例:
Taylor Swift
字串
時間長度包含 YouTube Music 歌曲時長的 CSV 欄標題文字。

示例:
9.23s
字串
匯出的物件:儲存至購物車清單
匯出的物件代表:YouTube Shopping 願望清單,其中含有購物車中儲存的商品。
物件會匯出為 CSV 格式。
匯出的物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
建立時間建立產品儲存清單的時間戳記。

示例:
2023-02-10T00:00:00Z
時間戳記
更新時間產品儲存清單上次更新的時間戳記。

示例:
2023-02-10T00:00:00Z
時間戳記
清單 ID產品儲存清單 ID。

示例:
1342452
字串
清單類型產品儲存清單的類型。

示例:
不明
購物願望清單
enum
匯出物件:產品儲存清單項目
匯出物件代表:YouTube Shopping 願望清單項目。
物件會匯出為 CSV 格式。
匯出的物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
產品 ID已儲存產品的 ID。

示例:
E_g_11tf54_cz7
字串
清單 ID產品儲存清單 ID。

示例:
1342452
字串
更新時間產品儲存清單項目上次更新的時間戳記。

示例:
2023-02-10T00:00:00Z
時間戳記
建立時間建立儲存至購物車清單中的產品的時間戳記。

示例:
2023-02-10T00:00:00Z
時間戳記
更新時間產品儲存清單項目上次更新的時間戳記。

示例:
2023-02-10T00:00:00Z
時間戳記
清單類型產品儲存清單的類型。

示例:
不明
購物願望清單
enum
匯出物件:遊戲角落中繼資料
匯出物件代表:已儲存的 YouTube 遊戲角落遊戲。
物件會匯出為 CSV 格式。
匯出的物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
標題遊戲角落遊戲的名稱。

示例:
Cube Crush
字串
遊戲角落 ID特定 Playables 遊戲的 ID。

示例:
axfr358s3902
字串
時間戳記遊戲角落遊戲存檔的時間戳記。

示例:
2023-02-10T18:55:23-0900
時間戳記
匯出的物件:遊戲角落的遊戲進度存檔
匯出的物件代表:遊戲角落的遊戲進度存檔。
物件會以二進位格式匯出。
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
匯出的物件:遊戲角落設定資料
匯出的物件代表:您的 YouTube 遊戲角落設定。
物件會匯出為 CSV 格式。
匯出的物件包含下列欄位:
* 前述欄位代表用於剖析及擷取相關資料匯出的重要資料欄位。匯出作業產生的資料欄位會因服務和使用者動作而異,部分服務或動作不會產生所述的每個資料欄位。
資料欄位 *欄位定義資料欄位類型
標題遊戲角落遊戲的名稱。

示例:
Cube Crush
字串
遊戲角落 ID特定 Playables 遊戲的 ID。

示例:
axfr358s3902
字串
已確認「允許網路」通知是否已確認「允許網路」通知,指出遊戲具有網路存取權。

示例:
true
bool
「允許網路」通知的確認時間戳記上次確認「允許網路」通知的時間戳記。

示例:
2023-02-10T18:55:23-0900
時間戳記
代表資源群組和隨其匯出物件的表格。
資源群組 *說明匯出的物件
youtube.private_videos使用者的私人 YouTube 影片媒體檔案,以及多種相關中繼資料
影片
影片互動
影片錄製
影片文字
影片媒體
youtube.unlisted_videos使用者的 YouTube 不公開影片媒體檔案,以及多種相關中繼資料
影片
影片互動
影片錄製
影片文字
影片媒體
youtube.public_videos使用者的公開 YouTube 影片媒體檔案,以及幾種相關中繼資料
影片
影片互動
影片錄製
影片文字
影片媒體
youtube.channel使用者 YouTube 頻道的相關中繼資料
頻道
頻道功能資料
頻道圖片
頻道頁面設定
頻道網址設定
頻道社群管理設定
頻道代名詞
品牌連結資料
youtube.subscriptions使用者訂閱的 YouTube 頻道清單
個訂閱項目
youtube.private_playlists使用者的私人 YouTube 播放清單
播放清單
播放清單影片
youtube.unlisted_playlists使用者的 YouTube 不公開播放清單
播放清單
播放清單影片
youtube.public_playlists使用者的 YouTube 公開播放清單
播放清單
播放清單影片
youtube.comments使用者的 YouTube 留言
則留言
youtube.live_chat使用者的 YouTube 聊天室訊息
送出的聊天室訊息
youtube.conversations使用者的 YouTube 訊息
則訊息
youtube.posts使用者的 YouTube 貼文
貼文
貼文留言設定
youtube.clips使用者的 YouTube 影片
短片
youtube.music使用者上傳至 YouTube Music 的歌曲和 YouTube Music 媒體庫
上傳音樂的中繼資料
音樂庫歌曲
音樂媒體
youtube.shopping使用者的 YouTube Shopping 願望清單和願望清單項目
儲存至購物車清單
儲存至購物車清單中的產品
youtube.playable使用者的 YouTube 遊戲角落設定和遊戲進度存檔
遊戲角落中繼資料
遊戲角落存檔資料
遊戲角落設定資料
* 如要取得特定資源群組的 OAuth 範圍名稱,請在資源群組後方附加「https://www.googleapis.com/auth/dataportability.」。舉例來說,「myactivity.search」資源群組的 OAuth 範圍名稱為「https://www.googleapis.com/auth/dataportability.myactivity.search」。