Data Portability API mit einem Python-Skript aufrufen

In dieser Kurzanleitung rufen Sie ein OAuth-Token für Ihr Konto ab und senden mit einem Python-Script Anfragen an die Endpunkte der Data Portability API.

Lerninhalte

In dieser Kurzanleitung verwenden Sie ein Python-Script, um Folgendes zu tun:

  • Sende eine authentifizierte Anfrage an den InitiatePortabilityArchive-Endpunkt, indem du ein gültiges OAuth-Token angibst. Die Antwort ist ein gültiges job_id.
  • Senden Sie eine authentifizierte Anfrage an den GetPortabilityArchiveState-Endpunkt und laden Sie die Daten herunter. Die Antwort sollte einen gültigen Jobstatus und, wenn der Job abgeschlossen ist, eine signierte URL enthalten.
  • OAuth-Token mit zeitbasiertem Zugriff für spätere Wiederverwendung speichern
  • Sende eine authentifizierte Anfrage an den ResetAuthorization-Endpunkt. Mit dieser Anfrage werden alle vom Nutzer gewährten OAuth-Bereiche widerrufen.
  • Senden Sie eine authentifizierte Anfrage an den InitiatePortabilityArchive-Endpunkt, indem Sie ein gültiges OAuth-Token zusammen mit start_time oder end_time angeben, um einen Zeitfilter auf Ihre Anfrage anzuwenden.

Vorbereitung

Für diese Kurzanleitung benötigen Sie Folgendes:

  • Prüfen Sie, ob die Data Portability API für Sie verfügbar ist. Eine Liste der unterstützten Länder und Regionen finden Sie unter Häufig gestellte Fragen auf der Seite „Kopie Ihrer Daten mit Drittanbietern teilen“.
  • Führen Sie die Einrichtungsschritte für die Data Portability API aus und prüfen Sie, ob Sie ein neues Projekt verwenden.
  • Sie benötigen Zugriff auf ein Konto, das Ihrer Organisation gehört oder von ihr verwaltet wird. In dieser Kurzanleitung werden die Suchaktivitäten dieses Kontos exportiert.

Bevor Sie mit dieser Kurzanleitung beginnen, müssen Sie OAuth, Python und das OAuth-Paket für die Python-Clientbibliotheken einrichten.

OAuth einrichten

  • Folgen Sie der Anleitung, um OAuth für installierte Anwendungen zu konfigurieren. Dieser Ablauf ähnelt dem OAuth-Ablauf für Webserveranwendungen. Beachten Sie beim Konfigurieren Ihrer OAuth-Client-ID Folgendes:
    • Der Anwendungstyp sollte Desktop-App sein.
    • Nachdem Sie die Client-ID erstellt haben, laden Sie das Client-Secret im JSON-Format herunter und geben Sie der Datei den Namen client_secrets.json.
    • Beachten Sie beim Konfigurieren von Bereichen für die Data Portability API, dass in dieser Kurzanleitung die folgenden Ressourcengruppen verwendet werden:

Python einrichten

Sie müssen Python auf Ihrem lokalen Computer einrichten, um das in diesem Schnellstart verwendete Script auszuführen. So richten Sie Python ein:

  • Installieren Sie das Paketverwaltungstool Pip und Python 3.11 (oder höher).
  • Installieren Sie die Google-API-Clientbibliothek für Python.

  • Installieren Sie das google_auth_oauthlib-Paket für die Python-Clientbibliothek mit diesem Befehl. Dieses Paket bietet die Integration von oauthlib mit google-auth, der Google-Authentifizierungsbibliothek für Python.

    pip install google-auth-oauthlib google-api-python-client --upgrade

Skript ausführen

In diesem Script wird im OAuth-Ablauf eine localhost-Weiterleitung verwendet. Bei dieser Option muss die Anwendung auf einem localhost-Port lauschen und dann den Systembrowser öffnen, um den OAuth-Autorisierungsablauf zu starten.

Klicken Sie auf diesen Link, um das Script zu öffnen, oder laden Sie eine Kopie des Scripts herunter, indem Sie mit der rechten Maustaste auf den Link klicken.

Python-Kurzanleitungsskript für die Data Portability API

Geben Sie diesen Befehl ein, um das Script auszuführen und den vollständigen Datenkorpus zu exportieren:

python3 data-portability-quickstart.py

Wenn Sie verschiedene Bereiche verwenden möchten, geben Sie sie mit --resources an, z. B.:

python3 data-portability-quickstart.py --resources myactivity.shopping myactivity.play

Wenn Sie eine Zeitfilterung anwenden möchten, verwenden Sie dasselbe Script mit den Flags start_time und end_time. Beispiel:

python3 data-portability-quickstart.py --start_time 2023-01-01T12:00:00Z --end_time 2024-01-01T12:00:00Z

Die vom Script ausgeführten Aktionen werden in den Kommentaren beschrieben.