Pengantar: Mengembangkan aplikasi menggunakan Data Portability API

Dengan Data Portability API, Anda dapat membuat aplikasi yang meminta otorisasi dari pengguna untuk memindahkan salinan data dari layanan Google ke aplikasi Anda. Hal ini memungkinkan portabilitas data dan memfasilitasi layanan pengalihan.

Jika Anda mencari informasi tentang cara pengguna berbagi data, lihat Membagikan salinan data Anda kepada pihak ketiga.

Prasyarat

Sebelum dirilis, aplikasi Anda harus disetujui oleh Google.

Anda juga harus memverifikasi bahwa Data Portability API tersedia untuk pengguna di lokasi Anda. Untuk mengetahui daftar negara dan wilayah yang didukung, lihat Pertanyaan Umum di halaman "Membagikan salinan data Anda kepada pihak ketiga".

Alur kerja developer

Berikut adalah langkah-langkah yang harus Anda ikuti untuk membuat aplikasi yang menggunakan Data Portability API.

1. Terapkan alur izin OAuth untuk pengguna. Dalam contoh ini, pengguna memberikan akses ke data video YouTube.

   1. Pengguna mengklik Impor Video YouTube dan login ke Akun Google-nya.

   2. Aplikasi meneruskan pengguna ke URL izin OAuth. Perhatikan bahwa contoh URL ini disederhanakan dan tidak memiliki beberapa parameter:

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

   3. Pengguna mengklik Berikutnya di layar izin OAuth, menyetujui untuk membagikan datanya, dan memberikan akses akun.

   4. Pengguna dialihkan ke aplikasi.

   5. Developer mendapatkan token OAuth untuk pengguna.

2. Aplikasi Anda memanggil InitiatePortabilityArchive(resources = ["myactivity.youtube"]) dengan token OAuth terlampir yang berisi cakupan OAuth ini:

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

   Panggilan ini memulai proses pembuatan arsip data. Anda harus memulai arsip portabilitas dalam waktu 24 jam setelah otorisasi pengguna.

3. Aplikasi Anda memanggil GetPortabilityArchiveState(job_id) dengan token OAuth terlampir yang berisi cakupan OAuth ini:

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

   Anda dapat memanggil metode ini beberapa kali untuk mengambil status tugas pengarsipan. Metode ini menampilkan status tugas. Jika statusnya LENGKAP, arsip sudah siap, dan URL Cloud Storage yang ditandatangani akan diberikan. Perhatikan bahwa waktu yang diperlukan untuk menyelesaikan permintaan pengarsipan dapat bervariasi dari beberapa menit hingga beberapa jam, bergantung pada ukuran data.

4. Download arsip data menggunakan URL yang ditandatangani.

5. Panggil ResetAuthorization() dengan token OAuth yang terlampir untuk mereset resource yang habis dan menghapus semua izin OAuth.

Untuk informasi selengkapnya tentang penggunaan metode Data Portability API, lihat Memanggil metode Data Portability API.

Cara pengguna berinteraksi dengan aplikasi Data Portability API

Diagram ini menunjukkan cara pengguna berinteraksi dengan aplikasi yang terintegrasi dengan Data Portability API.

1. Pertama, pengguna akan melihat opsi untuk mengambil datanya.

2. Selanjutnya, pengguna login ke Akun Google-nya.

3. Kemudian, pengguna mengklik Berikutnya saat diminta untuk membagikan datanya, dan mengklik Oke saat diminta untuk menyetujui kebijakan privasi.

4. Kemudian, pengguna akan melihat layar izin OAuth yang digunakan untuk mengizinkan aplikasi mengakses data mereka. Opsi di sini cocok dengan cakupan OAuth yang Anda konfigurasi.

5. Setelah mengizinkan akses, impor data dimulai. Bergantung pada ukuran data, permintaan dapat memerlukan waktu beberapa menit hingga beberapa jam.

Catatan: Data Portability API tidak mendukung akses oleh akun pengguna yang berusia di bawah 18 tahun. Jika pengguna yang berusia di bawah 18 tahun mencoba mengakses fitur Data Portability API, dia akan melihat pesan error bahwa dia tidak diizinkan untuk melanjutkan.