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

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

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

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

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

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

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

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

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

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

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

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

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

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

สิ่งที่จะเปลี่ยนแปลง: อัลบั้มที่แชร์และฟังก์ชัน API ที่เกี่ยวข้อง (share, unshare, get, join, leave และ list) จะแสดงผลเป็น 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
โดยระบบจะเพิ่ม 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 หลังจากสิ้นสุดระยะเวลาการหยุดให้บริการ
• เอกสารประกอบเดิมที่เก็บรักษาไว้: เราได้เก็บเอกสารประกอบของ 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 บางรายการ

API เครื่องมือเลือกรูปภาพของ Google Photos คืออะไร

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

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

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

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

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

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

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