Untuk mengonfigurasi OAuth bagi aplikasi, Anda menyiapkan alur kerja OAuth, dan mengaktifkan cakupan OAuth Data Portability API.
Menyiapkan alur kerja OAuth
Untuk menyiapkan alur OAuth bagi aplikasi Anda, ikuti langkah-langkah dasar dalam dokumentasi Google Identity.
Sebagian besar developer menggunakan alur Aplikasi Web Sisi Server untuk mendapatkan izin OAuth, tetapi Anda juga dapat menggunakan alur Aplikasi Web JavaScript atau alur Aplikasi Seluler dan Desktop.
Cakupan OAuth Data Portability API
Saat Anda mengonfigurasi aplikasi Data Portability API untuk OAuth, aktifkan cakupan OAuth Data Portability API yang relevan dengan aplikasi Anda. Beberapa cakupan
adalah sensitive dan restricted serta tunduk pada persyaratan tambahan.
Saat Anda menambahkan cakupan Data Portability API ke alur OAuth, mungkin ada kasus saat pengguna memberikan izin ke beberapa, tetapi tidak semua cakupan. Aplikasi Anda harus dapat menangani kasus ini dengan:
- Mengizinkan ekspor data sebagian
- Memberi tahu pengguna bahwa mereka tidak memilih semua cakupan yang diperlukan (dan gagal dengan baik)
- Meminta izin yang tersisa kepada pengguna
Anda harus memperhatikan bahwa izin pengguna memungkinkan Anda melakukan satu ekspor data untuk izin tertentu tersebut. Untuk mendownload data lagi, Anda memerlukan izin baru dari pengguna.
Anda juga harus memperhatikan bahwa selama alur OAuth, aplikasi Anda tidak mengetahui Akun Google mana yang digunakan untuk memberikan izin. Token OAuth yang diterima aplikasi Anda adalah tersembunyi.
Jika Anda mencari informasi tentang cara pengguna membagikan data, lihat Membagikan salinan data Anda kepada pihak ketiga.
Pembatasan cakupan
Bagian ini membahas batasan dalam cakupan yang menyebabkan error.
Cakupan campuran
Permintaan untuk cakupan Data Portability API (seperti, https://www.googleapis.com/auth/dataportability.*) tidak dapat digabungkan dengan cakupan lain (seperti, https://www.googleapis.com/auth/userinfo.email). Berikut adalah contoh permintaan buruk, dengan bagian yang dibatasi dicetak tebal:
https://accounts.google.com/o/oauth2/v2/auth?
client_id=client_id&
redirect_uri=redirect_uri&
response_type=token&
scope=https://www.googleapis.com/auth/dataportability.myactivity.search+https://www.googleapis.com/auth/userinfo.email&
include_granted_scopes=false
Cakupan yang sebelumnya diberikan
Anda tidak boleh menetapkan include_granted_scopes=true saat meminta cakupan DPAPI.
Berikut adalah contoh permintaan yang buruk, dengan bagian yang dibatasi dicetak tebal:
https://accounts.google.com/o/oauth2/v2/auth?
client_id=client_id&
redirect_uri=redirect_uri&
response_type=token&
scope=https://www.googleapis.com/auth/dataportability.myactivity.search&
include_granted_scopes=true
Kategori cakupan
Untuk daftar semua cakupan OAuth yang didukung oleh Data Portability API dan kategorinya, lihat Cakupan OAuth yang tersedia. Untuk daftar semua grup resource dan cakupan OAuth yang didukung oleh layanan tertentu, lihat halaman referensi skema untuk layanan tersebut.