Memanggil Data Portability API Menggunakan Python Script

Dalam panduan memulai ini, Anda akan mendapatkan token OAuth untuk akun Anda dan mengirim permintaan ke endpoint Data Portability API menggunakan skrip Python.

Yang Anda pelajari

Dalam panduan memulai ini, Anda akan menggunakan skrip Python untuk:

  • Kirim permintaan terautentikasi ke endpoint InitiatePortabilityArchive dengan memberikan token OAuth yang valid. Responsnya adalah job_id yang valid.
  • Kirim permintaan yang diautentikasi ke endpoint GetPortabilityArchiveState dan download datanya. Respons harus berisi status tugas yang valid, dan saat tugas selesai, URL yang ditandatangani.
  • Kirim permintaan yang diautentikasi ke endpoint ResetAuthorization. Permintaan ini akan mencabut semua cakupan OAuth yang diberikan pengguna.

Prasyarat

Untuk menjalankan panduan memulai ini, Anda perlu:

  • Pastikan Data Portability API tersedia untuk Anda. Untuk mengetahui daftar negara dan wilayah yang didukung, lihat Pertanyaan Umum di halaman "Membagikan salinan data Anda kepada pihak ketiga".
  • Selesaikan langkah penyiapan untuk Data Portability API, dan pastikan Anda menggunakan project baru.
  • Mendapatkan akses ke akun yang dimiliki atau dikontrol oleh organisasi Anda. Data aktivitas penelusuran akun ini diekspor dalam panduan memulai ini.

Sebelum memulai panduan memulai ini, Anda juga perlu menyiapkan OAuth, Python, dan paket OAuth untuk library klien Python.

Menyiapkan OAuth

  • Ikuti langkah-langkah guna mengonfigurasi OAuth untuk aplikasi yang diinstal. Alur ini mirip dengan alur OAuth untuk aplikasi server web. Saat mengonfigurasi client ID OAuth:
    • Jenis aplikasi harus Aplikasi desktop.
    • Setelah Anda membuat client ID, download rahasia klien dalam format JSON, dan beri nama file: client_secrets.json.
    • Saat Anda mengonfigurasi cakupan untuk Data Portability API, perhatikan bahwa panduan memulai ini menggunakan grup resource berikut:

Menyiapkan Python

Anda harus menyiapkan Python di mesin lokal Anda untuk menjalankan skrip yang digunakan dalam panduan memulai ini. Untuk menyiapkan Python:

  • Instal alat pengelolaan paket Pip dan Python 3.9 (atau yang lebih baru).
  • Instal Library Klien Google API untuk Python.

  • Instal paket google_auth_oauthlib untuk library klien Python dengan menjalankan perintah ini. Paket ini menyediakan integrasi oauthlib dengan google-auth—library autentikasi Google untuk Python.

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

Jalankan skrip:

Skrip ini menggunakan pengalihan localhost dalam alur OAuth. Opsi ini mengharuskan aplikasi untuk memproses port localhost, lalu membuka browser sistem untuk memulai alur otorisasi OAuth.

Klik link ini untuk membuka skrip, atau download salinan skrip dengan mengklik kanan link.

Skrip panduan memulai Python Data Portability API

Untuk menjalankan skrip, masukkan perintah ini:

python3 data-portability-quickstart.py

Tindakan yang diambil oleh skrip dijelaskan dalam komentar.