อัปเดตเกี่ยวกับ Google Photos API

ประกาศในเดือนกันยายน 2024

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

Library API: ผลกระทบต่อ Use Case ทั่วไป

ส่วนต่อไปนี้แสดงรายละเอียดเกี่ยวกับผลกระทบของการเปลี่ยนแปลงที่กำลังจะเกิดขึ้นที่มีต่อการใช้งานทั่วไป กรณี

การอัปโหลดรายการสื่อและการสร้างอัลบั้ม

มีอะไรเปลี่ยนแปลงบ้าง: ไม่มีการเปลี่ยนแปลง คุณยังสามารถอัปโหลดรายการสื่อและ สร้างอัลบั้มโดยใช้ขอบเขต photoslibrary.appendonly

สิ่งที่คุณทำได้มีดังนี้

หากแอปของคุณกำลังอัปโหลดรายการสื่อหรือสร้างอัลบั้ม โปรดตรวจสอบว่า ขอบเขต photoslibrary.appendonly ไม่ใช่ photoslibrary กำลังนำขอบเขต photoslibrary รายการออก

การแสดงรายการ การค้นหา และการเรียกข้อมูลรายการสื่อและอัลบั้ม

สิ่งที่เปลี่ยนแปลง: ขณะนี้คุณสามารถแสดงรายการ ค้นหา และเรียกอัลบั้ม และ รายการสื่อที่แอปของคุณสร้างขึ้น

สิ่งที่คุณทำได้

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

การแชร์และอัลบั้มที่แชร์

มีอะไรเปลี่ยนแปลง: อัลบั้มที่แชร์และฟังก์ชัน API ที่เกี่ยวข้อง (แชร์, โปรดยกเลิกการแชร์ รับ เข้าร่วม ออก และแสดงรายการ) จะส่ง 403 PERMISSION_DENIED กลับมาหลังจาก 31 มีนาคม 2025

สิ่งที่คุณทำได้

นำผู้ใช้ไปยังแอป Google Photos เพื่อจัดการการแชร์ด้วยตนเอง คุณสามารถ ให้วิธีการที่ชัดเจนหรือลิงก์ Deep Link ภายในแอปเพื่อเป็นแนวทางให้พวกเขา

การจัดการอัลบั้มที่แอปสร้างขึ้น: ความสมบูรณ์และเนื้อหาของอัลบั้ม

สิ่งที่เปลี่ยนแปลง: จะเพิ่ม photoslibrary.edit.appcreatedata ลงใน วิธีการ 3 วิธีต่อไปนี้เพื่อความสอดคล้องเชิงแนวคิด

• albums.addEnrichment
• albums.batchAddMediaItems
• albums.batchRemoveMediaItems

สิ่งที่คุณทำได้

• หากแอปใช้วิธีการเหล่านี้อยู่แล้ว ให้พิจารณาใช้ ขอบเขต photoslibrary.edit.appcreatedata เพื่อลดความซับซ้อนของการให้สิทธิ์ ขั้นตอนได้

Library API: ขอบเขตและวิธีการที่ได้รับผลกระทบ

ในการเปลี่ยนแปลงเกี่ยวกับ Google Photos API เราได้ดำเนินการดังต่อไปนี้ อัปเดต

ตามที่แสดงในการให้สิทธิ์ที่อัปเดตแล้ว ขอบเขตต่อไปนี้ จะถูกนำออกจาก Library API หลังจากวันที่ 31 มีนาคม 2025

• photoslibrary.readonly
• photoslibrary.sharing
• photoslibrary

ขอบเขตต่อไปนี้จะยังคงอยู่

• photoslibrary.appendonly
• photoslibrary.readonly.appcreateddata
• photoslibrary.edit.appcreateddata

ตารางนี้แสดงรายละเอียดเมธอด Library API ที่เฉพาะเจาะจงและขอบเขตที่ได้รับผลกระทบ

อัปเดต	เมธอด	ขอบเขต
ตอนนี้วิธีการเหล่านี้ใช้ได้กับอัลบั้มและรายการสื่อที่สร้างโดยแอปของคุณเท่านั้น ซึ่งรวมถึงรายการสื่อที่เลือกด้วย Picker API และเพิ่มลงในคลังภาพของผู้ใช้ด้วย Library API	albums.create mediaItems.batchCreate	ขอบเขตที่เหลือ: photoslibrary.appendonly นำขอบเขตออกแล้ว: photoslibrary photoslibrary.sharing
	albums.get albums.list mediaItems.batchGet mediaItems.get mediaItems.list mediaItems.search	ขอบเขตที่เหลือ: photoslibrary.readonly.appcreatedata นำขอบเขตออกแล้ว: photoslibrary photoslibrary.readonly
โดยวิธีการเหล่านี้จะใช้งานไม่ได้อีกต่อไป	albums.share albums.unshare sharedAlbums.get sharedAlbums.join sharedAlbums.leave sharedAlbums.list	ขอบเขตที่เหลือ: ไม่มี นำขอบเขตออกแล้ว: photoslibrary.sharing
วิธีการเหล่านี้จะเพิ่ม photoslibrary.edit.appcreatedata ไว้ ตอนนี้วิธีการเหล่านี้สามารถใช้กับอัลบั้มและรายการสื่อที่แอปของคุณสร้างขึ้นเท่านั้น ซึ่งรวมถึงรายการสื่อที่เลือกด้วย Picker API และเพิ่มลงในไลบรารีของผู้ใช้ด้วย Library API	albums.addEnrichment albums.batchAddMediaItems	ขอบเขตที่เหลือ: photoslibrary.appendonly photoslibrary.edit.appcreatedata นำขอบเขตออกแล้ว: photoslibrary
	albums.batchRemoveMediaItems	ขอบเขตที่เหลือ: photoslibrary.edit.appcreatedata นำขอบเขตออกแล้ว: photoslibrary
โดยวิธีการเหล่านี้จะยังคงเหมือนเดิม	albums.patch mediaItems.patch	ขอบเขตที่เหลือ: photoslibrary.edit.appcreatedata ขอบเขตที่นําออกแล้ว ไม่มี

การปรับปรุงนโยบาย Photos API

นโยบายการใช้งานที่ยอมรับได้ปัจจุบันจะเป็น ซึ่งเปลี่ยนมาใช้ข้อมูลผู้ใช้และนักพัฒนา Photos API ใหม่หลังจากวันที่ 31 มีนาคม 2025 นโยบาย นโยบายใหม่พร้อมใช้งานแล้วสำหรับ เวอร์ชันตัวอย่าง

การอัปเดตเอกสารประกอบของ Photos API

เราได้ทำการเปลี่ยนแปลงที่สำคัญกับเอกสารประกอบของ Photos API เพื่อให้สอดคล้องกับ การอัปเดตที่กำลังจะมาถึงและสนับสนุนประสบการณ์ในการพัฒนาของคุณ:

• เว็บไซต์ Unified Photos API: เราได้รวมทรัพยากร Photos API ทั้งหมด ให้เป็นตำแหน่งเดียวที่สะดวก (เว็บไซต์นี้) ทำให้ สำหรับนักพัฒนาซอฟต์แวร์ โดยคุณจะพบข้อมูลต่อไปนี้
  • ทรัพยากรแบบรวมศูนย์: คำแนะนำการตั้งค่าและทั่วไปที่ผสานรวมกัน หลักเกณฑ์การใช้งาน ข้อมูลการสนับสนุนและนโยบายสำหรับ ทั้ง Picker API และ Library API
  • เว็บไซต์สำหรับ API โดยเฉพาะ: เว็บไซต์แต่ละแห่งที่มีคำแนะนำโดยละเอียด เอกสารอ้างอิง และตัวอย่างโค้ดสำหรับเครื่องมือเลือก API และไลบรารี API
• เนื้อหา Library API ที่อัปเดตแล้ว: เอกสารประกอบเกี่ยวกับ Library API ได้รับการแก้ไขเพื่อให้สอดคล้องกับขีดความสามารถหลังการหยุดให้บริการ ในเอกสารฉบับอัปเดต คุณจะเห็นป้ายกำกับที่ไฮไลต์ เนื้อหามีการเปลี่ยนแปลงหรือถูกนำออก พร้อมลิงก์ไปยังเนื้อหาเดิมที่เกี่ยวข้อง เพื่อใช้อ้างอิงระหว่างการย้ายข้อมูล
• เอกสารฉบับเดิมที่สงวนไว้: เรายังคงเก็บ Library API เดิมไว้ เอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ที่ ต้องย้ายข้อมูลการผสานรวมที่มีอยู่ หากกำลังเริ่มโปรเจ็กต์ใหม่ ให้ใช้เอกสารประกอบที่อัปเดตแล้ว ถ้า คุณกำลังอัปเดตโปรเจ็กต์ที่มีอยู่ โปรดดูทั้งโปรเจ็กต์เดิมและอัปเดตแล้ว เอกสารที่ต้องใช้ระหว่างการย้ายข้อมูล

คำถามที่พบบ่อย

มีอะไรเปลี่ยนแปลงใน Google Photos API

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

การเปลี่ยนแปลงเหล่านี้จะมีผลเมื่อใด

การเปลี่ยนแปลงเหล่านี้จะมีผลในวันที่ 31 มีนาคม 2025 เราขอแนะนำให้ทุกคนที่มี การผสานรวมที่มีอยู่ซึ่งใช้ Library API สำหรับการเลือกรูปภาพที่จะย้ายข้อมูลไป Picker API ได้โดยเร็วที่สุด

Library API จะได้รับผลกระทบอย่างไร

ระบบจะนำขอบเขต photoslibrary.readonly, photoslibrary.sharing และ photoslibrary ออก การเรียก API ที่อาศัยเฉพาะขอบเขตเหล่านี้จะแสดงผล 403 PERMISSION_DENIED การโทรอื่นๆ อีกหลายรายการจะถูกจำกัดให้ใช้ได้อย่างเดียว ด้วยรูปภาพและวิดีโอที่แอปของคุณสร้างขึ้น

คุณสามารถตรวจสอบชุดการเปลี่ยนแปลงทั้งหมดได้ในตารางที่ด้านบนของหน้านี้

ฉันควรทำอย่างไรหากแอปของฉันใช้ขอบเขตหรือเมธอดที่ได้รับผลกระทบอยู่

หากแอปใช้ขอบเขตหรือเมธอดที่ได้รับผลกระทบ เราขอแนะนำให้คุณดำเนินการ ขั้นตอนต่อไปนี้

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

Google Photos Picker API คืออะไร

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

ฉันจะหาข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงเหล่านี้ได้จากที่ใด

หน้านี้ที่คุณกำลังดูอยู่จะแสดง ภาพรวมและสรุปการเปลี่ยนแปลงทั้งหมด

เราได้อัปเดตส่วนที่เหลือของเอกสารในเว็บไซต์เพื่อให้เป็นไปตาม API ที่อัปเดต

บล็อกโพสต์นี้ โดยประกาศการเปลี่ยนแปลง

ฉันควรทำอย่างไรหากมีข้อสงสัยเพิ่มเติมหรือต้องการความช่วยเหลือในการย้ายข้อมูลแอปพลิเคชัน

หากมีคำถามเกี่ยวกับเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ โปรดดูหน้าการสนับสนุนเพื่อดูรายละเอียดเพิ่มเติมเกี่ยวกับการรับความช่วยเหลือ