บทนำ: พัฒนาแอปโดยใช้ 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. ผู้ใช้เลือกข้อมูลที่จะแชร์และระยะเวลาที่แอปจะเข้าถึงข้อมูลนั้นได้ (สิทธิ์เข้าถึงแบบครั้งเดียวหรือสิทธิ์เข้าถึงตามเวลาเป็นเวลา 30 หรือ 180 วัน) จากนั้นคลิกต่อไป

      หมายเหตุ: ผู้ใช้มีตัวเลือกในการต่ออายุสิทธิ์เข้าถึงข้อมูลของตนก่อนที่โทเค็น OAuth จะหมดอายุได้สูงสุด 90 วัน ปุ่มต่ออายุจะไม่ปรากฏขึ้นหากผู้ใช้ไม่มีขอบเขตที่กำลังจะหมดอายุภายใน 90 วัน

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

   6. นักพัฒนาแอปจะได้รับโทเค็น OAuth สำหรับผู้ใช้

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

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

   การเรียกใช้นี้จะเริ่มต้นกระบวนการสร้างที่เก็บถาวรของข้อมูลและตอบกลับด้วยรหัสงาน และระบุว่าผู้ใช้ให้สิทธิ์เข้าถึงแบบครั้งเดียวหรือแบบตามเวลา

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

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

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

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

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

5. หากผู้ใช้ให้สิทธิ์เข้าถึงแบบครั้งเดียว คุณจะเรียกใช้ ResetAuthorization() พร้อมโทเค็น OAuth ที่แนบมาเพื่อรีเซ็ตทรัพยากรที่ใช้จนหมดและนำความยินยอม OAuth ทั้งหมดออก

6. หากผู้ใช้ให้สิทธิ์เข้าถึงตามเวลา คุณจะส่งออกทรัพยากรได้ทุก 24 ชั่วโมงจนกว่าความยินยอมจะหมดอายุ

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

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

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

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

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

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

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

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