Einführung: Anwendungen mit der Data Portability API entwickeln

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

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

Voraussetzungen

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

Außerdem sollten Sie prüfen, ob die Data Portability API für Nutzer an Ihrem 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

So erstellen Sie eine Anwendung, die die Data Portability API verwendet:

1. Implementieren Sie den OAuth-Einwilligungsablauf 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 App leitet den Nutzer an eine OAuth-Einwilligungs-URL weiter. Diese Beispiel-URL ist vereinfacht und enthält einige fehlende 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 Weitergabe seiner Daten zu und gewährt Kontozugriff.

   4. Der Nutzer wird zur App weitergeleitet.

   5. Der Entwickler ruft ein OAuth-Token für den Nutzer ab.

2. Ihre App 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 das Erstellen des Datenarchivs gestartet. Sie sollten das Portabilitätsarchiv innerhalb von 24 Stunden nach der Nutzerautorisierung initiieren.

3. Ihre App 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 Status des Jobs zurück. Wenn der Status „VOLLSTÄNDIG“ lautet, ist das Archiv bereit und es werden signierte Cloud Storage-URLs bereitgestellt. Die Dauer der Archivierungsanfrage kann je nach Größe der Daten zwischen Minuten und Stunden liegen.

4. Laden Sie das Datenarchiv mit den 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 zur Verwendung der Data Portability API-Methoden finden Sie unter Data Portability API-Methoden aufrufen.

Interaktion von Nutzern mit einer Data Portability API-App

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

1. Zuerst wird dem Nutzer die Möglichkeit zum Abrufen seiner Daten angezeigt.

2. Als Nächstes meldet sich der Nutzer in seinem Google-Konto an.

3. Anschließend klickt der Nutzer auf Weiter, wenn er aufgefordert wird, seine Daten freizugeben, und auf Verstanden, wenn er aufgefordert wird, die Datenschutzerklärung zu akzeptieren.

4. Anschließend wird dem Nutzer ein OAuth-Zustimmungsbildschirm angezeigt, über den die Anwendung Zugriff auf seine Daten erhält. Die Optionen hier entsprechen den von Ihnen konfigurierten OAuth-Bereichen.

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