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

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

ก่อนจะเริ่ม

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

ขั้นตอนของ 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 ของผู้ใช้ได้อย่างปลอดภัย สำหรับแอปพลิเคชันบนเว็บ คุณสามารถ ต่อท้าย /autoclose ไปยัง URI นี้เพื่อปิดหน้าต่าง Google Photos โดยอัตโนมัติ หลังจากที่ผู้ใช้เลือกเสร็จแล้ว

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

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

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

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

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

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