Archivos JSON de Google Takeout

¿Qué hay realmente dentro de un archivo JSON de Google Takeout?

Abajo tienes un registro del Historial de ubicaciones con la forma real que tiene en una exportación de Google Takeout. A la izquierda, el JSON en bruto que llega en el ZIP. A la derecha, lo que ese registro significa de verdad.

{
  "latitudeE7": 487856612,
  "longitudeE7": 23415879,
  "accuracy": 10,
  "timestampMs": "1710440627182",
  "source": "WIFI",
  "deviceTag": 1234567890,
  "platformType": "ANDROID"
}

Lugar
  48.7857° N, 2.3416° E
  Precisión ±10 metros
  Fuente: lectura por Wi-Fi

Cuándo
  14 de marzo de 2024, 18:23 UTC

Dispositivo
  Teléfono Android (uno de los tuyos)

Las reglas de traducción que intervienen en este único registro:

• latitudeE7 / longitudeE7: divide entre 10.000.000 para obtener grados decimales.
• timestampMs: tiempo Unix en milisegundos. Divide entre 1000 y conviértelo con tu biblioteca de fechas favorita.
• accuracy: radio de error en metros. Cuanto más bajo, mejor.
• source: qué sensor produjo la lectura (GPS, WIFI, CELL, UNKNOWN).
• deviceTag: un hash interno que identifica el dispositivo. El mismo hash significa el mismo dispositivo físico en todos los registros.

Una exportación completa de Takeout contiene cientos de miles de registros como este repartidos en decenas de archivos. Leerlos a mano no es realista.

¿Qué es MyActivity.json?

MyActivity.json es el archivo que guarda tu historial de Mi Actividad, un archivo por cada producto de Google. Lo encuentras en carpetas como My Activity/Search, My Activity/YouTube y My Activity/Maps. Cada archivo es una lista de registros como este:

[
  {
    "header": "Search",
    "title": "Searched for best hiking trails",
    "titleUrl": "https://www.google.com/search?q=best+hiking+trails",
    "time": "2024-03-14T18:23:47.182Z",
    "products": ["Search"],
    "activityControls": ["Web & App Activity"]
  }
]

• header: el producto al que pertenece el registro, como Search, YouTube o Maps.
• title: lo que hiciste, en forma de frase. En una cuenta en español, «Buscaste», «Viste», «Visitaste».
• titleUrl: el enlace correspondiente, cuando lo hay.
• time: cuándo ocurrió, como fecha ISO 8601 en UTC.
• products y activityControls: de nuevo el producto, y el ajuste de la cuenta que lo registró.

Takeout exporta Mi Actividad como MyActivity.html por defecto. Para obtener la versión JSON, abre «Varios formatos» junto a Mi Actividad al crear la exportación y elige JSON. Los nombres de las carpetas siguen el idioma de tu cuenta, así que pueden aparecer traducidos. Para saber qué dice de ti el archivo de cada producto, consulta el visor de Mi Actividad de Google y el historial de búsquedas en Google Takeout.

¿Qué es archive_browser.html?

archive_browser.html es el índice de tu exportación. Google lo coloca al principio de la carpeta Takeout, y en cada parte de una exportación dividida. Ábrelo en un navegador para ver qué productos incluye y qué contiene cada carpeta. Es una guía de la exportación, no los datos en sí: tus registros están en las carpetas de cada producto, a su lado.

Mira tu Takeout real en claro

El resumen de abajo son datos de ejemplo con la forma de una exportación real, analizados para que se lean bien. Suelta tu propio ZIP en la herramienta para ver tus cifras.

Cómo analizar a mano el JSON de Google Takeout

Si quieres escribir tu propio analizador, la estructura básica es sencilla en cualquier lenguaje. En Python:

import json
from datetime import datetime, timezone

with open("Records.json") as f:
    data = json.load(f)

for record in data["locations"]:
    lat = record["latitudeE7"] / 1e7
    lon = record["longitudeE7"] / 1e7
    ts_ms = int(record["timestampMs"])
    when = datetime.fromtimestamp(ts_ms / 1000, tz=timezone.utc)
    print(f"{when:%Y-%m-%d %H:%M} - {lat:.4f}, {lon:.4f}")

Eso cubre el caso ideal. Las complicaciones llegan rápido:

• Cambios de esquema. Google ha publicado al menos cuatro formas distintas del Historial de ubicaciones desde 2014. Los archivos antiguos usan timestampMs, los nuevos usan timestamp en ISO 8601. Algunos tienen un arreglo locations en el nivel superior, otros lo envuelven de otra manera. Nuestro visor de Cronología de Google Maps lee todas estas formas.
• Varios archivos por categoría. La actividad de búsqueda se reparte en archivos MyActivity.json por producto (uno para Búsqueda, uno para Maps, uno para Búsqueda de imágenes, etc.). YouTube tiene archivos separados para el historial de reproducciones, el historial de búsquedas, los comentarios y las suscripciones.
• Campos que faltan. Las cuentas antiguas tienen registros sin source, accuracy ni deviceTag. Las nuevas tienen esos campos, pero les pueden faltar otros antiguos, como las visitas a lugares.
• Datos que no son JSON. Gmail llega en MBOX. Chrome puede llegar en JSON y en HTML. Google Fotos tiene sus propias rarezas: la fecha y el lugar de cada foto están en un archivo JSON aparte, a su lado, y por eso las fotos importadas muestran una fecha incorrecta hasta que una herramienta como el corrector de fechas de Google Fotos las vuelve a escribir dentro. Un analizador general de Takeout trata cada formato por separado.
• Codificación. Algunos archivos son UTF-8 con BOM, otros sin él. Algunos tienen caracteres no imprimibles aquí y allá. Los analizadores robustos lo normalizan al leer.

Si quieres publicar un analizador, cuenta con varias horas de trabajo más el mantenimiento cada vez que Google ajusta el formato de exportación. Si solo quieres leer tus datos, la herramienta de abajo te ahorra ese tiempo.

Lee tu Takeout en 60 segundos sin escribir código

TakeoutReader es un visor de Google Takeout que funciona en el navegador. Suelta tu ZIP en la página y el informe aparece al instante. El analizador se encarga de los cambios de esquema, de los archivos múltiples, de las conversiones de formato y de los campos que faltan, para que tú no tengas que hacerlo.

• Nueve categorías: Perfil publicitario (los segmentos que Google deduce sobre ti), Google Fotos (totales, años y lugares), Historial de ubicaciones, Actividad de búsqueda, Historial de YouTube, Historial de Chrome, Actividad de Android, Gmail y Google Chat.
• Formatos de salida: PDF, texto plano, Markdown, CSV.
• Nada se sube. El análisis ocurre por completo en tu navegador con JSZip y fflate. Puedes comprobarlo en las herramientas para desarrolladores mirando la pestaña «Red». Consulta si Google Takeout es seguro para saber por qué importa.
• Sin cuenta, sin inicio de sesión, sin extensión.

Para una revisión completa de lo que Google tiene sobre ti, consulta qué sabe Google de ti. Para centrarte en los registros GPS, usa nuestro visor del Historial de ubicaciones de Google, o abre Records.json directamente en el visor de Cronología de Google Maps para ver cada viaje en un mapa. Para las exportaciones de actividad, consulta el visor de Mi Actividad de Google.

Formatos de archivo habituales en Google Takeout

Una exportación típica contiene varios formatos, según los productos de Google que incluiste:

• JSON: Historial de ubicaciones (Records.json, Semantic Location History/), Mi Actividad (MyActivity.json por producto), YouTube (watch-history.json, search-history.json, subscriptions.json), Chrome (Bookmarks.json, History.json), Actividad de Android y metadatos de Drive.
• HTML: resúmenes ya generados por Google para algunas categorías (Mi Actividad, YouTube). Más rápidos de hojear, pero menos completos que sus equivalentes en JSON.
• MBOX: Gmail. Un formato de correo en texto plano que cualquier cliente de correo (Thunderbird, mutt) puede leer, pero que los navegadores no abren sin conversión.
• CSV: algunos productos incluyen CSV además de JSON (Guardados, Tasks).
• KML: el Historial de ubicaciones también incluye un formato KML de cronología que se puede usar en Google Earth y otros programas de SIG.
• Archivos originales: Fotos y Drive contienen los archivos en bruto (JPG, PDF, etc.) más los metadatos de cada archivo.

Por ahora, TakeoutReader se centra en las nueve categorías que más se piden. Los demás formatos se dejan tal cual.

Preguntas frecuentes