เรียกใช้ Data Portability API โดยใช้สคริปต์ Python

ในการเริ่มต้นอย่างรวดเร็วนี้ คุณจะได้รับโทเค็น OAuth สำหรับบัญชีของคุณและส่งคำขอไปยังปลายทาง Data Portability API โดยใช้สคริปต์ Python

สิ่งที่คุณเรียนรู้

ในการเริ่มต้นอย่างรวดเร็วนี้ คุณจะใช้สคริปต์ Python เพื่อทำสิ่งต่อไปนี้

  • ส่งคำขอที่ผ่านการตรวจสอบสิทธิ์ไปยังปลายทาง InitiatePortabilityArchive โดยระบุโทเค็น OAuth ที่ถูกต้อง การตอบกลับเป็น job_id ที่ถูกต้อง
  • ส่งคำขอที่ผ่านการตรวจสอบสิทธิ์ไปยังปลายทาง GetPortabilityArchiveState และดาวน์โหลดข้อมูล การตอบกลับควรมีสถานะงานที่ถูกต้อง และ URL ที่ลงนามเมื่องานเสร็จสมบูรณ์แล้ว
  • ส่งคำขอที่ผ่านการตรวจสอบสิทธิ์แล้วไปยังปลายทาง ResetAuthorization คําขอนี้จะเพิกถอนขอบเขต OAuth ทั้งหมดที่ได้จากผู้ใช้

ข้อกำหนดเบื้องต้น

หากต้องการเรียกใช้การเริ่มต้นอย่างรวดเร็วนี้ คุณจะต้องมีคุณสมบัติต่อไปนี้

  • ยืนยันว่าคุณสามารถใช้ Data Portability API ได้ โปรดดูรายชื่อประเทศและภูมิภาคที่รองรับที่หัวข้อคำถามที่พบบ่อยในหน้า "แชร์สำเนาข้อมูลของคุณกับบุคคลที่สาม"
  • ทำตามขั้นตอนการตั้งค่าสำหรับ Data Portability API ให้เสร็จสมบูรณ์และตรวจสอบว่าคุณกำลังใช้โปรเจ็กต์ใหม่
  • รับสิทธิ์เข้าถึงบัญชีที่องค์กรของคุณเป็นเจ้าของหรือควบคุม ระบบจะส่งออกข้อมูลกิจกรรมการค้นหาของบัญชีนี้ในการเริ่มต้นอย่างรวดเร็วนี้

ก่อนเริ่มต้นการเริ่มต้นใช้งานอย่างรวดเร็วนี้ คุณต้องตั้งค่า OAuth, Python และแพ็กเกจ OAuth สำหรับไลบรารีของไคลเอ็นต์ Python ด้วย

ตั้งค่า OAuth

  • ทำตามขั้นตอนเพื่อกำหนดค่า OAuth สำหรับแอปพลิเคชันที่ติดตั้งไว้ ขั้นตอนนี้คล้ายกับขั้นตอน OAuth สำหรับแอปพลิเคชันเว็บเซิร์ฟเวอร์ สิ่งที่จะเกิดขึ้นเมื่อกำหนดค่ารหัสไคลเอ็นต์ OAuth มีดังนี้
    • ประเภทแอปพลิเคชันควรเป็นแอปบนเดสก์ท็อป
    • หลังจากที่สร้างรหัสไคลเอ็นต์แล้ว ให้ดาวน์โหลดรหัสลับไคลเอ็นต์ในรูปแบบ JSON แล้วตั้งชื่อไฟล์เป็น client_secrets.json
    • เมื่อคุณกำหนดค่าขอบเขตสำหรับ Data Portability API โปรดทราบว่าการเริ่มต้นอย่างรวดเร็วนี้จะใช้กลุ่มทรัพยากรต่อไปนี้

ตั้งค่า Python

คุณต้องตั้งค่า Python ในเครื่องของคุณเพื่อเรียกใช้สคริปต์ที่ใช้ในการเริ่มต้นอย่างรวดเร็วนี้ วิธีตั้งค่า Python

  • ติดตั้งเครื่องมือการจัดการแพ็กเกจ Pip และ Python 3.9 (หรือใหม่กว่า)
  • ติดตั้งไลบรารีของไคลเอ็นต์ Google API สำหรับ Python

  • ติดตั้งแพ็กเกจ google_auth_oauthlib สำหรับไลบรารีของไคลเอ็นต์ Python โดยเรียกใช้คำสั่งนี้ แพ็กเกจนี้มีการผสานรวม oauthlib กับ google-auth ซึ่งเป็นไลบรารีการตรวจสอบสิทธิ์ของ Google สำหรับ Python

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

เรียกใช้สคริปต์

สคริปต์นี้ใช้การเปลี่ยนเส้นทาง localhost ในขั้นตอน OAuth ตัวเลือกนี้ต้องใช้แอปพลิเคชันเพื่อรับฟังพอร์ต localhost จากนั้นเปิดเบราว์เซอร์ของระบบเพื่อเริ่มขั้นตอนการให้สิทธิ์ OAuth

คลิกลิงก์นี้เพื่อเปิดสคริปต์ หรือดาวน์โหลดสำเนาของสคริปต์โดยคลิกขวาที่ลิงก์

สคริปต์เริ่มต้นใช้งาน Python สำหรับ Data Portability API อย่างรวดเร็ว

ป้อนคำสั่งนี้เพื่อเรียกใช้สคริปต์

python3 data-portability-quickstart.py

รายละเอียดการดำเนินการของสคริปต์จะอยู่ในความคิดเห็น