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

โพสต์เมื่อเดือนกันยายน 2024

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

หมายเหตุ: การเปลี่ยนแปลงทั้งหมดจะมีผลในเดือนมีนาคม 2025

Library API: ผลกระทบต่อกรณีการใช้งานทั่วไป

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

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

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

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

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

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

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

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

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

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

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

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

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

การจัดการอัลบั้มที่สร้างโดยแอป: การเพิ่มประสิทธิภาพและเนื้อหาของอัลบั้ม

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

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

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

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

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

เราได้ทําการอัปเดตต่อไปนี้เพื่อเป็นส่วนหนึ่งของการเปลี่ยนแปลง Google Photos API

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

• photoslibrary.readonly
• photoslibrary.sharing
• photoslibrary

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

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

ตารางนี้แสดงรายละเอียดเมธอดและขอบเขต 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.appcreateddata ขอบเขตที่ถูกนำออกมีดังนี้ photoslibrary photoslibrary.readonly
โดยวิธีการเหล่านี้จะใช้งานไม่ได้อีกต่อไป	albums.share albums.unshare sharedAlbums.get sharedAlbums.join sharedAlbums.leave sharedAlbums.list	ขอบเขตที่เหลืออยู่ ไม่มี ขอบเขตที่ถูกนําออกมีดังนี้ photoslibrary.sharing หมายเหตุ: ระบบจะนำ sharedAlbums.list ออกเนื่องจากจะไม่มีอัลบั้มที่แชร์ซึ่งสร้างโดยแอปของคุณแสดงในรายการอีกต่อไป
โดยระบบจะเพิ่ม photoslibrary.edit.appcreateddata ไว้ข้างหน้าเมธอดเหล่านี้ ตอนนี้วิธีการเหล่านี้ใช้ได้กับอัลบั้มและรายการสื่อที่สร้างโดยแอปของคุณเท่านั้น	albums.addEnrichment albums.batchAddMediaItems	ขอบเขตที่เหลือ: photoslibrary.appendonly photoslibrary.edit.appcreateddata ขอบเขตที่ถูกนำออกมีดังนี้ photoslibrary
	albums.batchRemoveMediaItems	ขอบเขตที่เหลืออยู่ photoslibrary.edit.appcreateddata ขอบเขตที่ถูกนำออกมีดังนี้ photoslibrary
โดยวิธีการเหล่านี้จะยังคงเหมือนเดิม	albums.patch mediaItems.patch	ขอบเขตที่เหลืออยู่ photoslibrary.edit.appcreateddata ขอบเขตที่ถูกนำออกมีดังนี้ ไม่มี

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

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

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

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

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

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

มีอะไรเปลี่ยนแปลงบ้างกับ Google Photos API

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

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

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

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

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

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

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

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

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

Google Photos Picker API คืออะไร

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

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

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

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

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

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

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