Picker API เป็นวิธีที่ปลอดภัยสำหรับให้ผู้ใช้เลือกรูปภาพและวิดีโอจากคลัง Google Photos และแชร์กับแอปพลิเคชันของคุณ
ก่อนจะเริ่ม
- ดูภาพรวม: เปรียบเทียบ Picker API กับ Library API เพื่อให้แน่ใจว่า Picker API เหมาะกับกรณีการใช้งานของคุณ
- กำหนดค่าแอป: เปิดใช้ API และตั้งค่าการตรวจสอบสิทธิ์ ดูขั้นตอนโดยละเอียดที่หัวข้อกำหนดค่าแอป
ขั้นตอนการเรียกใช้ Picker API
ภาพรวมของวิธีการทํางานของ Picker API มีดังนี้
ตรวจหาโทเค็น OAuth: ก่อนเริ่มขั้นตอนการใช้งาน Picker API ให้ตรวจหาโทเค็นเพื่อการเข้าถึง OAuth 2.0 ที่ถูกต้องสำหรับผู้ใช้ หากไม่มีโทเค็น ให้เริ่มโฟลว์การให้สิทธิ์ OAuth 2.0 เพื่อรับโทเค็น
สร้างเซสชัน: เริ่มกระบวนการโดยเรียกใช้ Picker API เพื่อสร้างเซสชันใหม่ การเรียกใช้นี้จะแสดงผล
pickerUri
ที่ไม่ซ้ำกันนำผู้ใช้ไปยังแอป Google Photos: ระบุ
pickerUri
ให้กับผู้ใช้ (เป็นลิงก์ที่คลิกได้หรือเป็นคิวอาร์โค้ด) URL นี้จะเปิดแอป Google Photos อย่างปลอดภัยผู้ใช้เลือกรายการสื่อ: ภายในแอป Google Photos ผู้ใช้สามารถเรียกดู คลังและเลือกรูปภาพและวิดีโอที่ต้องการแชร์กับแอปของคุณ โปรดอ่านภาพรวมประสบการณ์การเลือกของผู้ใช้
ตรวจสอบเซสชัน: แอปควรตรวจสอบเซสชันเป็นระยะๆ เพื่อดูสถานะ คุณกำลังมองหาพร็อพเพอร์ตี้
mediaItemsSet
ที่ส่งคืนเป็น "จริง" ซึ่งบ่งชี้ว่าผู้ใช้ดำเนินการเสร็จแล้วแสดงรายการรายการสื่อที่เลือก: เมื่อ
mediaItemsSet
แสดงผลเป็น "จริง" คุณจะใช้เมธอดแสดงรายการเพื่อดูรายละเอียดเกี่ยวกับรายการสื่อที่เลือกได้ดึงข้อมูลและใช้รายการสื่อ: ตอนนี้คุณมีสิทธิ์เข้าถึงรายการสื่อที่เลือกแล้ว คุณสามารถดึงข้อมูลเนื้อหา โดยใช้
baseUrl
และใช้เนื้อหาภายในแอปพลิเคชันของคุณได้
ขั้นตอนถัดไป
- อ่านเอกสารอ้างอิง: ดูเอกสารอ้างอิงเกี่ยวกับ Picker API โดยละเอียดเพื่อดูข้อมูลเกี่ยวกับเมธอดและพารามิเตอร์ทั้งหมดที่ใช้ได้
- ลองใช้ตัวอย่าง: ดูตัวอย่างเพื่อดูการทำงานของ Picker API และรับแรงบันดาลใจในการผสานรวม