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

Library API ช่วยให้คุณโต้ตอบกับรูปภาพ วิดีโอ และอัลบั้มภายในคลังภาพ Google Photos ของผู้ใช้ได้ แต่มีข้อจำกัดสำคัญคือคุณจะเข้าถึงและจัดการได้เฉพาะเนื้อหาที่สร้างโดยแอปพลิเคชันของคุณเท่านั้น

ก่อนจะเริ่ม

กรณีการใช้งานที่สำคัญของ Library API

Library API เหมาะสำหรับกรณีที่แอปจำเป็นต้องดำเนินการต่อไปนี้

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

เวิร์กโฟลว์ทั่วไปของ Library API

แม้ว่า Library API จะมีฟังก์ชันการทำงานที่หลากหลาย แต่เวิร์กโฟลว์ทั่วไปอาจมีขั้นตอนเหล่านี้

  1. อัปโหลดสื่อ: ใช้ปลายทางการอัปโหลดเพื่ออัปโหลดไบต์รูปภาพหรือวิดีโอไปยัง Google Photos อย่างปลอดภัย ขั้นตอนนี้จะสร้าง uploadToken

  2. สร้างรายการสื่อ: ใช้เมธอด mediaItems.batchCreate โดยระบุ uploadToken เพื่อสร้างรายการสื่อในไลบรารีของผู้ใช้

  3. สร้างอัลบั้ม (ไม่บังคับ): ใช้วิธีการ albums.create สร้างอัลบั้มภายในคลังภาพของผู้ใช้เพื่อจัดระเบียบรายการสื่อ

  4. จัดการอัลบั้ม

    • เพิ่มรายการสื่อ (ที่สร้างโดยแอปของคุณ) ลงในอัลบั้มโดยใช้ albums.batchAddMediaItems
    • นำรายการสื่อออกจากอัลบั้มโดยใช้ albums.batchRemoveMediaItems
    • เพิ่มข้อมูลให้อัลบั้ม (เช่น ชื่อหรือสถานที่ตั้ง) โดยใช้ albums.addEnrichment
    • เรียกข้อมูลเกี่ยวกับอัลบั้มที่เฉพาะเจาะจงโดยใช้ albums.get
    • แสดงรายการอัลบั้มที่สร้างโดยแอปของคุณโดยใช้ albums.list

  5. เข้าถึงสื่อที่สร้างในแอป

    • เรียกดูรายละเอียดเกี่ยวกับรายการสื่อที่เฉพาะเจาะจงโดยใช้ mediaItems.get หรือ mediaItems.batchGet
    • ค้นหารายการสื่อที่สร้างโดยแอปของคุณโดยใช้ mediaItems.search
    • แสดงรายการสื่อภายในอัลบั้มที่สร้างขึ้นโดยแอปที่เฉพาะเจาะจงโดยใช้ mediaItems.search พร้อมรหัสอัลบั้ม

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

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