บทนำ: พัฒนาแอปโดยใช้ Data Portability API

Data Portability API ช่วยให้คุณสร้างแอปพลิเคชันที่ขอสิทธิ์จากผู้ใช้เพื่อย้ายสําเนาข้อมูลจากบริการของ Google ไปยังแอปพลิเคชันของคุณ การทำเช่นนี้ช่วยให้ถ่ายโอนข้อมูลได้และอำนวยความสะดวกในการเปลี่ยนบริการ

หากกำลังมองหาข้อมูลเกี่ยวกับวิธีที่ผู้ใช้แชร์ข้อมูล โปรดดูแชร์สำเนาข้อมูลของคุณกับบุคคลที่สาม

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

แอปต้องได้รับอนุมัติจาก Google ก่อนจึงจะเผยแพร่ได้

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

เวิร์กโฟลว์ของนักพัฒนาแอป

ขั้นตอนต่อไปนี้เป็นขั้นตอนในการสร้างแอปพลิเคชันที่ใช้ Data Portability API

1. ใช้ขั้นตอนความยินยอม OAuth สำหรับผู้ใช้ ในตัวอย่างนี้ ผู้ใช้ให้สิทธิ์เข้าถึงข้อมูลวิดีโอ YouTube

   1. ผู้ใช้คลิกนําเข้าวิดีโอ YouTube และลงชื่อเข้าใช้บัญชี Google

   2. แอปจะส่งต่อผู้ใช้ไปยัง URL แสดงความยินยอม OAuth โปรดทราบว่า URL ตัวอย่างนี้เป็นแบบง่ายและไม่มีพารามิเตอร์บางรายการ

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

   3. ผู้ใช้คลิกถัดไปในหน้าจอขอความยินยอม OAuth ตกลงที่จะแชร์ข้อมูลของตนและให้สิทธิ์เข้าถึงบัญชี

   4. ระบบจะเปลี่ยนเส้นทางผู้ใช้ไปยังแอป

   5. นักพัฒนาซอฟต์แวร์ได้รับโทเค็น OAuth สำหรับผู้ใช้

2. แอปของคุณเรียกใช้ InitiatePortabilityArchive(resources = ["myactivity.youtube"]) ด้วยโทเค็น OAuth ที่แนบมาซึ่งมีขอบเขต OAuth นี้:

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

   การเรียกใช้นี้จะเริ่มต้นกระบวนการสร้างที่เก็บถาวรของข้อมูล คุณควรเริ่มเก็บถาวรสำหรับการย้ายข้อมูลภายใน 24 ชั่วโมงหลังจากการให้สิทธิ์ของผู้ใช้

3. แอปของคุณเรียกใช้ GetPortabilityArchiveState(job_id) ด้วยโทเค็น OAuth ที่แนบมาซึ่งมีขอบเขต OAuth นี้

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

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

4. ดาวน์โหลดไฟล์เก็บถาวรของข้อมูลโดยใช้ URL ที่ลงนาม

5. เรียกใช้ ResetAuthorization() พร้อมโทเค็น OAuth ที่แนบมาเพื่อรีเซ็ตทรัพยากรที่ใช้จนหมดและนำความยินยอม OAuth ทั้งหมดออก

ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้เมธอด Data Portability API ได้ที่เรียกใช้เมธอด Data Portability API

วิธีที่ผู้ใช้โต้ตอบกับแอป Data Portability API

แผนภาพนี้แสดงวิธีที่ผู้ใช้โต้ตอบกับแอปที่ผสานรวมกับ Data Portability API

1. ขั้นแรก ผู้ใช้จะเห็นตัวเลือกในการเรียกข้อมูล

2. ถัดไป ผู้ใช้ลงชื่อเข้าใช้บัญชี Google

3. จากนั้นผู้ใช้คลิกถัดไปเมื่อได้รับแจ้งให้แชร์ข้อมูล และคลิกรับทราบเมื่อระบบแจ้งให้ยอมรับนโยบายความเป็นส่วนตัว

4. จากนั้นระบบจะแสดงหน้าจอขอความยินยอม OAuth แก่ผู้ใช้เพื่ออนุญาตให้แอปพลิเคชันเข้าถึงข้อมูลของผู้ใช้ ตัวเลือกที่นี่จะตรงกับขอบเขต OAuth ที่คุณกําหนดค่าไว้

5. หลังจากให้สิทธิ์เข้าถึงแล้ว การนําเข้าข้อมูลจะเริ่มขึ้น คำขออาจใช้เวลาหลายนาทีถึงหลายชั่วโมงจึงจะเสร็จสมบูรณ์ ทั้งนี้ขึ้นอยู่กับขนาดของข้อมูล