Einführung: Anwendungen mit der Data Portability API entwickeln

Mit der Data Portability API können Sie Anwendungen erstellen, die eine Autorisierung von einem Nutzer anfordern, um eine Kopie der Daten aus Google-Diensten in Ihre Anwendung zu verschieben. Dies ermöglicht die Übertragbarkeit von Daten und erleichtert den Wechsel von Diensten.

Informationen dazu, wie Nutzer Daten weitergeben, finden Sie unter Kopie Ihrer Daten mit Dritten teilen.

Voraussetzungen

Bevor Sie Ihre App veröffentlichen, muss sie von Google genehmigt werden.

Außerdem solltest du prüfen, ob die Data Portability API für Nutzer an deinem Standort 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“.

Workflow für Entwickler

Mit den folgenden Schritten erstellen Sie eine Anwendung, die die Data Portability API verwendet.

1. Implementieren Sie den OAuth-Zustimmungsvorgang für den Nutzer. In diesem Beispiel gewährt der Nutzer Zugriff auf YouTube-Videodaten.

   1. Der Nutzer klickt auf YouTube-Videos importieren und meldet sich in seinem Google-Konto an.

   2. Die Anwendung leitet den Nutzer an eine OAuth-Einwilligungs-URL weiter. Diese Beispiel-URL ist vereinfacht und enthält einige Parameter:

      https://accounts.google.com/o/oauth2/v2/auth?scope=https://www.googleapis.com/auth/dataportability.myactivity.youtube

   3. Der Nutzer klickt auf dem OAuth-Zustimmungsbildschirm auf Weiter, stimmt der Freigabe seiner Daten zu und gewährt Kontozugriff.

   4. Der Nutzer wird zur App weitergeleitet.

   5. Der Entwickler erhält ein OAuth-Token für den Nutzer.

2. Ihre Anwendung ruft InitiatePortabilityArchive(resources = ["myactivity.youtube"]) mit einem angehängten OAuth-Token auf, das diesen OAuth-Bereich enthält:

   https://www.googleapis.com/auth/dataportability.myactivity.youtube

   Mit diesem Aufruf wird der Prozess zum Erstellen des Datenarchivs gestartet. Sie sollten das Portabilitätsarchiv innerhalb von 24 Stunden nach der Nutzerautorisierung initiieren.

3. Ihre Anwendung ruft GetPortabilityArchiveState(job_id) mit einem angehängten OAuth-Token auf, das diesen OAuth-Bereich enthält:

   https://www.googleapis.com/auth/dataportability.myactivity.youtube

   Sie können diese Methode mehrmals aufrufen, um den Status des Archivierungsjobs abzurufen. Die Methode gibt den Jobstatus zurück. Wenn der Status ABGESCHLOSSEN ist, ist das Archiv bereit und signierte Cloud Storage-URLs werden bereitgestellt. Beachten Sie, dass die Verarbeitungszeit der Archivierungsanfrage je nach Größe der Daten Minuten oder Stunden dauern kann.

4. Laden Sie das Datenarchiv unter Verwendung der signierten URLs herunter.

5. Rufen Sie ResetAuthorization() mit einem angehängten OAuth-Token auf, um aufgebrauchte Ressourcen zurückzusetzen und alle OAuth-Einwilligungen zu entfernen.

Weitere Informationen zum Verwenden der Data Portability API-Methoden finden Sie unter Call Data Portability API-Methoden.

So interagieren Nutzer mit einer Data Portability API-Anwendung

Dieses Diagramm zeigt, wie Nutzer mit einer Anwendung interagieren, die in die Data Portability API eingebunden ist.

1. Zuerst wird dem Nutzer eine Option angezeigt, um seine Daten abzurufen.

2. Anschließend meldet sich der Nutzer in seinem Google-Konto an.

3. Wenn der Nutzer aufgefordert wird, seine Daten freizugeben, klickt er auf Weiter. Wenn er aufgefordert wird, die Datenschutzerklärung zu akzeptieren, klickt er auf Ok.

4. Dann wird dem Nutzer ein OAuth-Zustimmungsbildschirm angezeigt, mit dem die Anwendung auf seine Daten zugreifen kann. Die Optionen hier stimmen mit den von Ihnen konfigurierten OAuth-Bereichen überein.

5. Nachdem Sie den Zugriff gewährt haben, wird der Datenimport gestartet. Je nach Größe der Daten kann die Verarbeitung der Anfrage einige Minuten bis mehrere Stunden dauern.