My Activity Schema Reference
Stay organized with collections
Save and categorize content based on your preferences.
Exported Object: Activity records
Exported Object represents: Timestamped records of your activity across different
Google Products
Object is exported in these formats: HTML JSON
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and
ingesting the relevant data exports. Data fields produced in an export vary by service
and user action and some services or actions don't produce each data field described.
|
Data Field * |
Field Definition |
Data Field Type |
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 |
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 |
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 |
subtitles |
Detailed user activity shown underneath the title.
Examples: YouTube:
Channel information name and url, ...
|
string |
description |
Extra information that helps explain the activity taken by the user. |
string |
time |
Time and date the user did the activity.
Examples: Maps:
2023-08-23T03:49:28.734Z
|
string |
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 |
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 |
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 |
locationInfos |
The location(s) associated with this activity. |
string |
imageFile |
The local file name for the image attachment. |
string |
audioFiles |
The list of local file names for the audio attachments. |
list |
attachedFiles |
The list of local file names for the attached files. |
list |
Exported Object: Image attachments
Exported Object represents: Images related to your activity records
Object is exported in these formats: JPEG PNG WEBP
* The preceding fields represent key data fields for the purposes of parsing and
ingesting the relevant data exports. Data fields produced in an export vary by service
and user action and some services or actions don't produce each data field described.
|
|
|
|
Exported Object: Audio attachments
Exported Object represents: Audio files related to your activity records
Object is exported in these formats: MPEG
* The preceding fields represent key data fields for the purposes of parsing and
ingesting the relevant data exports. Data fields produced in an export vary by service
and user action and some services or actions don't produce each data field described.
|
|
|
|
Exported Object: CSV attachments
Exported Object represents: CSV files related to your activity records
Object is exported in these formats: CSV
* The preceding fields represent key data fields for the purposes of parsing and
ingesting the relevant data exports. Data fields produced in an export vary by service
and user action and some services or actions don't produce each data field described.
|
|
|
|
A table representing Resource Groups and the objects that are exported with it.
Resource Group * |
Description |
Exported Objects |
Time Filter Description |
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. |
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. |
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. |
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. |
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. |
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. |
* To obtain the OAuth Scope Name for a particular Resource Group, append
"https://www.googleapis.com/auth/dataportability." to the Resource Group. For example,
the OAuth Scope Name for the "myactivity.search" Resource Group is
"https://www.googleapis.com/auth/dataportability.myactivity.search".
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-02-13 UTC.
[null,null,["Last updated 2025-02-13 UTC."],[[["\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.]"]]