เริ่มต้นใช้งาน Picker API

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

ก่อนจะเริ่ม

ขั้นตอนการเรียกใช้ Picker API

ภาพรวมของวิธีการทํางานของ Picker API มีดังนี้

  1. ตรวจหาโทเค็น OAuth: ก่อนเริ่มขั้นตอนการใช้งาน Picker API ให้ตรวจหาโทเค็นเพื่อการเข้าถึง OAuth 2.0 ที่ถูกต้องสำหรับผู้ใช้ หากไม่มีโทเค็น ให้เริ่มโฟลว์การให้สิทธิ์ OAuth 2.0 เพื่อรับโทเค็น

  2. สร้างเซสชัน: เริ่มกระบวนการโดยเรียกใช้ Picker API เพื่อสร้างเซสชันใหม่ การเรียกใช้นี้จะแสดงผล pickerUri ที่ไม่ซ้ำกัน

  3. นำผู้ใช้ไปยังแอป Google Photos: ระบุ pickerUriให้กับผู้ใช้ (เป็นลิงก์ที่คลิกได้หรือเป็นคิวอาร์โค้ด) URL นี้จะเปิดแอป Google Photos อย่างปลอดภัย

  4. ผู้ใช้เลือกรายการสื่อ: ภายในแอป Google Photos ผู้ใช้สามารถเรียกดู คลังและเลือกรูปภาพและวิดีโอที่ต้องการแชร์กับแอปของคุณ โปรดอ่านภาพรวมประสบการณ์การเลือกของผู้ใช้

  5. ตรวจสอบเซสชัน: แอปควรตรวจสอบเซสชันเป็นระยะๆ เพื่อดูสถานะ คุณกำลังมองหาพร็อพเพอร์ตี้ mediaItemsSet ที่ส่งคืนเป็น "จริง" ซึ่งบ่งชี้ว่าผู้ใช้ดำเนินการเสร็จแล้ว

  6. แสดงรายการรายการสื่อที่เลือก: เมื่อ mediaItemsSet แสดงผลเป็น "จริง" คุณจะใช้เมธอดแสดงรายการเพื่อดูรายละเอียดเกี่ยวกับรายการสื่อที่เลือกได้

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

ขั้นตอนถัดไป

  • อ่านเอกสารอ้างอิง: ดูเอกสารอ้างอิงเกี่ยวกับ Picker API โดยละเอียดเพื่อดูข้อมูลเกี่ยวกับเมธอดและพารามิเตอร์ทั้งหมดที่ใช้ได้
  • ลองใช้ตัวอย่าง: ดูตัวอย่างเพื่อดูการทำงานของ Picker API และรับแรงบันดาลใจในการผสานรวม