บทนำ: พัฒนาแอปโดยใช้ 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 ได้ที่เมธอดของ Call Data Portability API

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

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

1. ลำดับแรก ระบบจะแสดงตัวเลือกให้ผู้ใช้เรียกข้อมูลของตน

2. จากนั้นผู้ใช้ก็จะลงชื่อเข้าใช้บัญชี Google ของตนเอง

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

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

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