我的活動架構參考資料
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
匯出的物件：活動記錄
匯出的物件代表：您在不同 Google 產品中的活動記錄，並附上時間戳記
物件會以以下格式匯出：HTML JSON
匯出的物件包含下列欄位：
|
* 上述欄位代表主要資料欄位，可用於剖析及擷取相關資料匯出內容。匯出作業產生的資料欄位會因服務和使用者動作而異，且部分服務或動作不會產生上述每個資料欄位。 |
| 資料欄位 * |
欄位定義 |
資料欄位類型 |
| 標頭 |
卡片標題通常是應用程式名稱、網域名稱或產品名稱。
範例：
YouTube：YouTube
搜尋：網域名稱
廣告：廣告
我的廣告中心：我的廣告中心
地圖：地圖
Google Play：Google Play |
字串 |
| title |
使用者活動的概要摘要。
範例：
YouTube：觀看...已訂閱...造訪...
搜尋：搜尋「...」，查看「...」，造訪「...」
廣告：
「造訪」，「查看」
我的廣告中心：選擇顯示更多「...」的廣告、「選擇減少顯示「...」的廣告」、「封鎖「...」的廣告」、「喜歡「...」的廣告」
地圖：查看...附近的區域，前往...、特定地址、搜尋...
Google Play：造訪...搜尋...已安裝...閱讀...
|
字串 |
| titleUrl |
標題中使用的網址。
範例：
YouTube：YouTube 網址
搜尋：搜尋、造訪、觀看網址
廣告：到達網站網址、商家名稱
我的廣告中心：主題
地圖：含有位置座標的網址
Google Play：Play 商店實體網址 |
字串 |
| 字幕 |
標題下方顯示詳細的使用者活動。
範例：
YouTube：
頻道資訊名稱和網址，...
|
字串 |
| 說明 |
有助於說明使用者採取的活動的額外資訊。 |
字串 |
| 時間 |
使用者執行活動的時間和日期。
範例：
地圖：
2023-08-23T03:49:28.734Z
|
字串 |
| 產品 |
這項資料所屬的產品。
範例：
YouTube：YouTube
搜尋：搜尋
廣告：Google Ads
我的廣告中心：廣告
地圖：地圖
Google Play：Google Play 商店/遊戲/圖書 |
list |
| 詳細資料 |
用於顯示使用者活動的來源，例如使用者與廣告或應用程式互動後的活動。
範例：
YouTube："來自 Google 廣告"
|
字串 |
| activityControls |
顯示在使用者的 Google 帳戶中儲存資料的 Google 資料收集設定 (例如定位記錄和網路和應用程式活動)，這些資料會包含在匯出的資料中。
範例：
YouTube：YouTube 觀看記錄、YouTube 搜尋記錄
搜尋：網路和應用程式活動
地圖：網路和應用程式活動
Google Play：Google Play 活動 |
字串 |
| locationInfos |
與這項活動相關的位置。 |
字串 |
| imageFile |
圖片附件的本機檔案名稱。 |
字串 |
| audioFiles |
音訊附件本機檔案名稱清單。 |
list |
| attachedFiles |
附件檔案的本機檔案名稱清單。 |
list |
匯出的物件：圖片附件
匯出的物件代表：與活動記錄相關的圖片
物件會以以下格式匯出：JPEG、PNG、WEBP
|
* 上述欄位代表主要資料欄位，可用於剖析及擷取相關資料匯出內容。匯出作業產生的資料欄位會因服務和使用者動作而異，且部分服務或動作不會產生上述每個資料欄位。 |
|
|
|
匯出的物件：音訊附件
匯出的物件代表：與活動記錄相關的音訊檔案
物件會以以下格式匯出：MPEG
|
* 上述欄位代表主要資料欄位，可用於剖析及擷取相關資料匯出內容。匯出作業產生的資料欄位會因服務和使用者動作而異，且部分服務或動作不會產生上述每個資料欄位。 |
|
|
|
匯出的物件：CSV 附件
匯出的物件代表：與活動記錄相關的 CSV 檔案
物件會以以下格式匯出：CSV
|
* 上述欄位代表主要資料欄位，可用於剖析及擷取相關資料匯出內容。匯出作業產生的資料欄位會因服務和使用者動作而異，且部分服務或動作不會產生上述每個資料欄位。 |
|
|
|
代表資源群組及其匯出的物件的資料表。
| 資源群組 * |
說明 |
匯出的物件 |
時間篩選器說明 |
| myactivity.youtube |
這個資源群組包含 YouTube 活動資料，包括 YouTube 上的廣告互動。 |
活動記錄
圖片附件
音訊附件
CSV 附件
|
使用者執行活動的時間戳記。 |
| myactivity.maps |
這個資源群組包含 Google 地圖活動資料，包括 Google 地圖上的廣告互動。
|
活動記錄
圖片附件
音訊附件
CSV 附件
|
使用者執行活動的時間戳記。 |
| myactivity.search |
這個資源群組包含 Google 搜尋活動的資料，包括 Google 搜尋上的廣告互動。 |
活動記錄
圖片附件
音訊附件
CSV 附件
|
使用者執行活動的時間戳記。 |
| myactivity.myadcenter |
這個資源群組包含「我的廣告中心」活動。 |
活動記錄
圖片附件
音訊附件
CSV 附件
|
使用者執行活動的時間戳記。 |
| myactivity.shopping |
這個資源群組包含購物活動的資料，包括購物廣告互動。 |
活動記錄
圖片附件
音訊附件
CSV 附件
|
使用者執行活動的時間戳記。 |
| myactivity.play |
這個資源群組包含 Google Play 活動資料，包括 Google Play 上的廣告互動。 |
活動記錄
圖片附件
音訊附件
CSV 附件
|
使用者執行活動的時間戳記。 |
|
* 如要取得特定資源群組的 OAuth 範圍名稱，請在資源群組後方加上「https://www.googleapis.com/auth/dataportability」。舉例來說，「myactivity.search」資源群組的 OAuth 範圍名稱為「https://www.googleapis.com/auth/dataportability.myactivity.search」。 |
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-25 (世界標準時間)。
[null,null,["上次更新時間：2025-07-25 (世界標準時間)。"],[[["\u003cp\u003eTakeout exports Google product activity data in HTML or JSON formats, such as YouTube watch history or Google Maps searches.\u003c/p\u003e\n"],["\u003cp\u003eThis data includes activity records with details like timestamps, descriptions, and related images or audio.\u003c/p\u003e\n"],["\u003cp\u003eUsers can access their activity records categorized by product, such as YouTube, Maps, Search, My Ad Center, Shopping and Play.\u003c/p\u003e\n"],["\u003cp\u003eExported data may also include CSV attachments related to user activity.\u003c/p\u003e\n"],["\u003cp\u003eThe data is organized into resource groups accessible through OAuth scopes, offering granular control over data sharing.\u003c/p\u003e\n"]]],[],null,["# My Activity Schema Reference\n\n| Data Field \\* | Field Definition | Data Field Type |\n|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------|\n| header | The card title that will typically be either an app name, domain name, or product name. Examples: YouTube: YouTube Search: Domain name Ads: Ads My Ad Center: My Ad Center Maps: Maps Google Play: Google Play | string |\n| title | High level summary of the user activity. Examples: YouTube: Watched..., Subscribed to..., Visited ... Search: Searched for ..., Viewed ..., Visited ... Ads: Visited, Viewed My Ad Center: Chose to see more ads from, Chose to see fewer ads from, Blocked an ad from, Liked an add from Maps: Viewed area around..., Directions to..., a specific address, Searched for... Google Play: Visited..., Searched..., Installed..., Read... | string |\n| titleUrl | Url used in the title. Examples: YouTube: youtube url Search: Searched, Visited, Viewed url Ads: landing site url, business name My Ad Center: topic Maps: url with location coordinates Google Play: Play Store entities url | string |\n| subtitles | Detailed user activity shown underneath the title. Examples: YouTube: Channel information name and url, ... | string |\n| description | Extra information that helps explain the activity taken by the user. | string |\n| time | Time and date the user did the activity. Examples: Maps: 2023-08-23T03:49:28.734Z | string |\n| products | The Products that this data is a part of. Examples: YouTube: Youtube Search: Search Ads: Google Ads My Ad Center: Ads Maps: Maps Google Play: Google Play Store/Games/Books | list |\n| details | Used to display information about where the user activity comes from, such as if the user activity was the result of the user interacting with an ad or app. Examples: YouTube: \"From Google Ads\" | string |\n| activityControls | Shows the Google data collection settings (like Location History and Web \\& App Activity) that save data in a user's Google account that the exported data is part of. Examples: YouTube: YouTube watch history, YouTube search history Search: Web App Activity Maps: Web App Activity Google Play: Google Play activities | string |\n| locationInfos | The location(s) associated with this activity. | string |\n| imageFile | The local file name for the image attachment. | string |\n| audioFiles | The list of local file names for the audio attachments. | list |\n| attachedFiles | The list of local file names for the attached files. | list |\n[Exported Object: Activity records\nExported Object represents: Timestamped records of your activity across different\nGoogle Products\nObject is exported in these formats: HTML JSON\nExported object has the following fields:]\n\n| | | |\n|---|---|---|\n[Exported Object: Image attachments\nExported Object represents: Images related to your activity records\nObject is exported in these formats: JPEG PNG WEBP]\n\n| | | |\n|---|---|---|\n[Exported Object: Audio attachments\nExported Object represents: Audio files related to your activity records\nObject is exported in these formats: MPEG]\n\n| | | |\n|---|---|---|\n[Exported Object: CSV attachments\nExported Object represents: CSV files related to your activity records\nObject is exported in these formats: CSV]\n\n| Resource Group \\* | Description | Exported Objects | Time Filter Description |\n|-----------------------|-----------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------|-----------------------------------------------|\n| myactivity.youtube | This resource group contains data for YouTube activity, including ad interactions on YouTube. | Activity records Image attachments Audio attachments CSV attachments | The timestamp when the user did the activity. |\n| myactivity.maps | This resource group contains data for Maps activity, including ad interactions on Maps. | Activity records Image attachments Audio attachments CSV attachments | The timestamp when the user did the activity. |\n| myactivity.search | This resource group contains data for Google Search activity, including ad interactions on Google Search. | Activity records Image attachments Audio attachments CSV attachments | The timestamp when the user did the activity. |\n| myactivity.myadcenter | This resource group contains My Ad Center activity. | Activity records Image attachments Audio attachments CSV attachments | The timestamp when the user did the activity. |\n| myactivity.shopping | This resource group contains data for Shopping activity, including ad interactions on Shopping. | Activity records Image attachments Audio attachments CSV attachments | The timestamp when the user did the activity. |\n| myactivity.play | This resource group contains data for Google Play activity, including ad interactions on Google Play. | Activity records Image attachments Audio attachments CSV attachments | The timestamp when the user did the activity. |\n[A table representing Resource Groups and the objects that are exported with it.]"]]
