บันทึกประจำรุ่น

ติดตามบันทึกประจำรุ่นเหล่านี้

หน้านี้จะอัปเดตข้อมูล Google Photos API เวอร์ชันใหม่แต่ละเวอร์ชัน บันทึกการเปลี่ยนแปลงจะแสดงรายการรุ่นตามวันที่ รวมถึงฟีเจอร์ใหม่ การแก้ไขข้อบกพร่อง และการเปลี่ยนแปลงอื่นๆ

เอกสารประกอบและคำแนะนำจะระบุเวอร์ชันล่าสุดที่ควรใช้

1 เมษายน 2025

หมายเหตุ

รุ่นนี้ใช้การเปลี่ยนแปลงที่ประกาศไว้ก่อนหน้านี้กับ Photos API

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

อ่านรายละเอียดทั้งหมดได้ที่การอัปเดต Google Photos API

16 กันยายน 2024

ฟีเจอร์

• เปิดตัว Picker API ใหม่สำหรับการเลือกรูปภาพที่ปลอดภัยและใช้งานง่าย

หมายเหตุ

ในการเผยแพร่ครั้งนี้ เราได้ประกาศการเปลี่ยนแปลงที่สำคัญใน Library API (มีผลตั้งแต่วันที่ 31 มีนาคม 2025)

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

ดูรายละเอียดทั้งหมดได้ในหน้าการอัปเดต Google Photos API

27 ตุลาคม 2022

หมายเหตุ

• โค้ดแล็บ "สร้างแอปการแชร์รูปภาพด้วย Google Photos และ Flutter" ไม่มีให้บริการแล้ว โปรดดูตัวอย่างอื่นๆ และดูโค้ดตัวอย่างในคู่มือ

1 มิถุนายน 2022

หมายเหตุ

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

27 ตุลาคม 2021

ฟีเจอร์

• โปรแกรมพาร์ทเนอร์ Google Photos: การเปิดตัวระดับพรีเมียม ระดับพรีเมียร์คือชุดฟีเจอร์ API ที่มีประสิทธิภาพมากขึ้นซึ่งใช้ประโยชน์จากปัญญาประดิษฐ์ (AI) อันทรงพลังของ Google Photos

29 กันยายน 2021

ฟีเจอร์

• ตัวเลือกใหม่ในการจัดเรียงการค้นหาตามตัวกรองวันที่ ผลลัพธ์จะจัดเรียงจากใหม่สุดหรือเก่าสุดก่อนก็ได้ ซึ่งช่วยให้ค้นหาได้ง่ายขึ้นและมีประสิทธิภาพมากขึ้นด้วยการแสดงผลการค้นหาที่ตรงเป้าหมายมากขึ้น

21 กรกฎาคม 2021

ฟีเจอร์

• -no พารามิเตอร์ใหม่สำหรับ URL พื้นฐานของวิดีโอเพื่อโหลดภาพปกโดยไม่มีปุ่มเล่นที่วางซ้อน โดยค่าเริ่มต้น ภาพปกวิดีโอจะโหลดพร้อมกับปุ่มเล่นที่วางซ้อนกัน พารามิเตอร์ใหม่นี้จะช่วยให้คุณควบคุมการซ่อนปุ่มเล่นในภาพปกวิดีโอได้

ปัญหาที่แก้ไขแล้ว

• ปัญหา 181282432: ภาพปกวิดีโอแสดงพร้อมกับปุ่มเล่นที่วางซ้อนอยู่เสมอ

25 พฤษภาคม 2021

ปัญหาที่แก้ไขแล้ว

• ระบบไม่ได้ป้อนข้อมูลพร็อพเพอร์ตี้ exposureTime สำหรับข้อมูลเมตา photo ในรายการสื่อ

19 พฤษภาคม 2021

หมายเหตุ

• เราได้อัปเดตเอกสารประกอบเกี่ยวกับ URL ฐานสำหรับรูปภาพเคลื่อนไหวเพื่อชี้แจงลักษณะการทำงานของพารามิเตอร์ =dv สำหรับรูปภาพเคลื่อนไหวของ Android และ Live Photos ของ iOS

11 กุมภาพันธ์ 2021

หมายเหตุ

• เราได้ปรับปรุงนโยบายการใช้งานที่ยอมรับได้ โดยเพิ่มเนื้อหาเกี่ยวกับการโฆษณาและการใช้ข้อมูลให้น้อยที่สุด

7 กรกฎาคม 2020

ฟีเจอร์

• API ได้รับการอัปเดตให้รองรับการควบคุมการแชร์แบบใหม่ใน Google Photos ตอนนี้ระบบจะแสดงฟิลด์ใหม่ isJoinable เป็นส่วนหนึ่งของพร็อพเพอร์ตี้ shareInfo สำหรับอัลบั้มที่แชร์ API จะเข้าร่วมอัลบั้มที่แชร์กับผู้ใช้ได้เมื่อ isJoinable เป็น true หากเจ้าของปิดใช้การแชร์ลิงก์ในอัลบั้มใน Google Photos isJoinable จะเท่ากับ false และ API จะเข้าร่วมผู้ใช้ในอัลบั้มนั้นไม่ได้
• ปัญหา 111405623, 116379853, 117685011: ตอนนี้คุณสามารถเปลี่ยนชื่ออัลบั้มและภาพปก รวมถึงเปลี่ยนคำอธิบายสำหรับรายการสื่อที่แอปของคุณสร้างขึ้นได้แล้ว ขอphotoslibrary.edit.appcreateddata ขอบเขตการอนุญาตใหม่เพื่อเข้าถึงการอัปเดต

17 กุมภาพันธ์ 2020

ฟีเจอร์

• ขนาดไฟล์สูงสุดที่อัปโหลดได้ของรูปภาพเพิ่มขึ้นจาก 75 MB เป็น 200 MB
• เมื่ออัปโหลดไฟล์ คุณต้องระบุประเภท MIME ในระยะการอัปโหลดไบต์
• ตอนนี้คุณระบุชื่อไฟล์เมื่อสร้างรายการสื่อแทนที่จะระบุเมื่ออัปโหลดไบต์สื่อ พร็อพเพอร์ตี้ fileName ใหม่ใน simpleMediaItem รองรับสตริง UTF-8 คุณยังคงระบุชื่อไฟล์ของรายการสื่อได้เมื่ออัปโหลดไบต์สื่อ แต่เราขอแนะนําอย่างยิ่งให้อัปเดตการใช้งาน

หมายเหตุ

• เราได้ปรับปรุงนโยบายการใช้งานที่ยอมรับได้พร้อมรายละเอียดเพิ่มเติมที่มุ่งเน้นที่การลดการใช้และพื้นที่เก็บข้อมูล
• เอกสารประกอบเกี่ยวกับ URL หลักได้รับการอัปเดตให้รวมรูปภาพเคลื่อนไหว

16 สิงหาคม 2019

ฟีเจอร์

• ปัญหา 131874809: พร็อพเพอร์ตี้ใหม่ isOwned ใน shareInfo เพื่อระบุว่าผู้ใช้เป็นเจ้าของอัลบั้มที่แชร์หรือไม่ ดูรายละเอียดเพิ่มเติมได้ในคู่มือนักพัฒนาแอปแชร์สื่อ

ปัญหาที่แก้ไขแล้ว

• ปัญหา 131711405: ไม่มีพร็อพเพอร์ตี้ shareableUrl ในคำตอบ albums.list
• ปัญหา 113870729: mediaItems.list บางครั้งแสดงรายการสื่อที่ซ้ำกันตรงขอบหน้า
• ปัญหา 93428763: ตอนนี้ช่อง status สำหรับข้อมูลเมตาของวิดีโอจะแสดงVideoProcessingStatusของวิดีโอที่มีคุณภาพสูงสุดอย่างถูกต้องแล้ว

12 มิถุนายน 2019

ฟีเจอร์

• ปัญหา 110188560: ตัวกรองการค้นหาใหม่เพื่อเลือกรายการสื่อที่ทำเครื่องหมายว่าชื่นชอบ FeatureFilter
• หมวดหมู่เนื้อหาใหม่สำหรับ ContentFilter เพื่อกรองรายการสื่อที่ตรงกับหมวดหมู่ที่เฉพาะเจาะจง ได้แก่ ARTS, CRAFTS, FASHION, HOUSES, GARDENS, FLOWERS, HOLIDAYS

หมายเหตุ

• หลักเกณฑ์ UX ฉบับปรับปรุงที่ให้คำแนะนำเพิ่มเติมเกี่ยวกับการตั้งชื่อโปรเจ็กต์และอัลบั้ม

7 พฤษภาคม 2019

Codelabs

• Codelab ใหม่: สร้างแอปการแชร์รูปภาพด้วย Google Photos และ Flutter ดูวิธีสร้างแอปการแชร์รูปภาพโดยใช้ Google Photos Library API ใน Flutter ดูรายละเอียดได้ในคู่มือตัวอย่างเพลง

29 เมษายน 2019

ฟีเจอร์

• ปัญหา 109505022: การเรียกใช้ใหม่เพื่อเพิ่มและนำรายการสื่อที่มีอยู่ออกจากอัลบั้ม

  • albums.batchAddMediaItems
  • albums.batchRemoveMediaItems

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

• ตอนนี้การเรียก REST เพื่อสร้างรายการสื่อ mediaItems.batchCreate จะแสดงสถานะ HTTP 207 MULTI-STATUS สำหรับความสำเร็จบางส่วนหากสร้างรายการสื่อบางรายการไม่ได้ ดูรายละเอียดเพิ่มเติมได้ในคู่มือการอัปโหลดสื่อสำหรับนักพัฒนาแอป

หมายเหตุ

• ไลบรารีไคลเอ็นต์เวอร์ชันล่าสุดมีการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ เราได้ย้ายชั้นเรียนที่เกี่ยวข้องกับ MediaItem, Album และ DateRange ไปยังแพ็กเกจใหม่โดยเฉพาะแล้ว ฟังก์ชันการทำงานไม่มีการเปลี่ยนแปลง มีเพียงตำแหน่งในคลังไลบรารีไคลเอ็นต์เท่านั้น โปรดดูบันทึกประจำรุ่นของไลบรารีของไคลเอ็นต์ Java (1.2.0) และไลบรารีของไคลเอ็นต์ PHP (1.2.0)

14 กุมภาพันธ์ 2019

หมายเหตุ

• ขีดจำกัดโควต้าใหม่สำหรับการเข้าถึงไบต์สื่อจาก URL พื้นฐานจะมีผล คุณสามารถตรวจสอบโควต้านี้ในคอนโซล Google API

ปัญหาที่แก้ไขแล้ว

• ปัญหา 124355983: ข้อผิดพลาด 500 เมื่อเรียกใช้ mediaItems.get สำหรับรายการสื่อที่แชร์บางรายการ

21 มกราคม 2019

ปัญหาที่แก้ไขแล้ว

• ปัญหา 121998358: ไม่มีพร็อพเพอร์ตี้ isWriteable ในคําตอบ albums.create

7 มกราคม 2019

ปัญหาที่แก้ไขแล้ว

• ปัญหา 118464845: mediaItems.list แสดงหน้าว่างมากเกินไป
• ปัญหา 111714379: mediaItems.search แสดงผลแค่ครึ่งหนึ่งของ pageSize

30 พฤศจิกายน 2018

ฟีเจอร์

• การเรียกใช้ใหม่ mediaItems.batchGet เพื่อดึงข้อมูลรายการสื่อหลายรายการตามตัวระบุ
• ปัญหา 111279349: การเรียกใช้ใหม่ sharedAlbums.leave เพื่อออกจากอัลบั้มที่แชร์
• ปัญหา 111279347: การเรียกใช้ใหม่ albums.unshare เพื่อทําเครื่องหมายอัลบั้มที่แชร์เป็นส่วนตัว

ปัญหาที่แก้ไขแล้ว

• ปัญหา 113978705: คำอธิบายที่ตั้งค่าใน mediaItems.batchCreate ได้รับการแปลงเป็นเอนทิตี HTML
• ปัญหา 114462217: ตั้งชื่อไฟล์วิดีโอใน mediaItems.batchCreate ไม่ได้
• ปัญหา 118475587: ระบบแสดง URL ผลิตภัณฑ์ที่ไม่ถูกต้องสำหรับรายการสื่อ
• ปัญหา 111862704: ข้อผิดพลาด 403 เมื่อเข้าถึง URL พื้นฐาน
• ปัญหา 115932469: การอัปโหลดล้มเหลวเนื่องจากข้อผิดพลาดเกี่ยวกับโควต้า

6 กันยายน 2018

ฟีเจอร์

• ไลบรารีของไคลเอ็นต์ Java และ PHP พร้อมใช้งานแล้ว

หมายเหตุ

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

5 กันยายน 2018

ฟีเจอร์

• คําเรียกใหม่ sharedAlbums.get เพื่อรับอัลบั้ม โดยใช้ shareToken
• พร็อพเพอร์ตี้ใหม่ isJoined ใน shareInfo เพื่อระบุว่าผู้ใช้เข้าร่วมอัลบั้มที่แชร์หรือไม่

ปัญหาที่แก้ไขแล้ว

• ปัญหา 79321120: ไม่มีพร็อพเพอร์ตี้ mimeType ในคําตอบของ mediaItems.batchCreate สำหรับรายการสื่อวิดีโอ
• ปัญหา 79319272: ไม่มีพร็อพเพอร์ตี้ เช่น mediaMetadata, contributorInfo ในคําตอบจาก mediaItems.batchCreate
• ปัญหา 110237685: แก้ไขปัญหาการอัปโหลดไฟล์ที่เกี่ยวข้องกับ CORS
• ปัญหา 79318118: ระบบไม่รักษาลําดับที่สอดคล้องกันเมื่ออัปโหลดหลายรายการไปยังอัลบั้มในmediaItems.batchCreatecall

หมายเหตุ

• หากคุณจัดเก็บรหัส (เช่น รหัสสำหรับอัลบั้ม รายการสื่อ หรือรายการการเพิ่มประสิทธิภาพ) ก่อนวันที่ 5 กันยายน 2018 รหัสเหล่านั้นจะใช้ไม่ได้อีกต่อไปเนื่องจากรูปแบบมีการเปลี่ยนแปลง คุณจะต้องขอบัตรประจำตัวใหม่เพื่อใช้ในใบสมัคร
• เปลี่ยนชื่อพร็อพเพอร์ตี้ totalMediaItems ของทรัพยากรอัลบั้มเป็น mediaItemsCount แล้ว
• ค่าสูงสุดของพารามิเตอร์ pageSize ในสายเรียก mediaItems.list และ mediaItems.search เปลี่ยนเป็น 100 แล้ว เราได้เปลี่ยนจำนวนรายการสื่อเริ่มต้นที่แสดงผลเมื่อไม่ได้ระบุพารามิเตอร์ pageSize เป็น 25
• อัปเดตคำแนะนำแสดงเนื้อหาในคลัง, แชร์สื่อ และเข้าถึงรายการสื่อด้วยฟีเจอร์ตัวกรอง excludeNonAppCreatedData](/photos/library/guides/apply-filters#nonapp-created) ที่เปิดตัวไปเมื่อวันที่ 31 กรกฎาคม 2018

31 กรกฎาคม 2018

ฟีเจอร์

• การเรียกใช้ใหม่ mediaItems.list เพื่อแสดงรายการสื่อ
• ตัวกรองใหม่ excludeNonAppCreatedData เพื่อค้นหารายการหรือแสดงรายการอัลบั้มที่สร้างโดยแอปของคุณ
• พารามิเตอร์ใหม่เพื่อเข้าถึงรูปภาพ
  • ปัญหา 79871479: พารามิเตอร์ครอบตัด c เพื่อครอบตัดรูปภาพให้มีมิติข้อมูลที่ต้องการ
  • ปัญหา 110343547, ปัญหา 111228390: พารามิเตอร์การดาวน์โหลด d เพื่อดาวน์โหลดรูปภาพต้นฉบับ
• ตอนนี้การเรียกใช้ sharedAlbums.join จะแสดงอัลบั้ม
• ปัญหา 109655786: ตอนนี้ album มีรหัสรายการสื่อของรูปภาพปก coverPhotoMediaItemId แล้ว
• ปัญหา 79656863: mediaItem ตอนนี้มีชื่อไฟล์ของรายการสื่อ filename

ปัญหาที่แก้ไขแล้ว

• ปัญหา 79757390: ระบบไม่ได้ตั้งค่าชื่อไฟล์ขณะส่งคำขออัปโหลด ดูช่อง X-Goog-Upload-File-Namefile และ X-Goog-Upload-Protocol ในคู่มือการอัปโหลดสื่อ
• ปัญหา 80182372: การอัปโหลดที่ดำเนินการต่อได้แสดงข้อผิดพลาด ดูคู่มือการอัปโหลดแบบพักกลางคันได้ใหม่สำหรับโปรโตคอลที่อัปเดตแล้ว
• ปัญหา 79497397: ไม่มีพร็อพเพอร์ตี้ isWriteable ในคำตอบ albums.list
• ปัญหา 111143493: ตัวกรองหมวดหมู่เนื้อหา PEOPLE แสดงผลลัพธ์ที่ไม่ถูกต้อง
• ปัญหา 111056278: ตัวกรองหมวดหมู่เนื้อหา BIRTHDAYS แสดงข้อผิดพลาด

เวอร์ชันตัวอย่าง - 8 พฤษภาคม 2018

การเปิดตัว Library API ครั้งแรก

ปัญหาที่ทราบ

• GET mediaItem จะแสดงข้อผิดพลาดหากรายการสื่อ id ที่ได้รับเป็นรายการสื่อจากอัลบั้มที่แชร์และผู้ใช้ไม่ได้เป็นเจ้าของ
• การตอบกลับจากคําเรียก batchCreate จะไม่แสดง mediaMetadata หรือ contributorInfo
• หากรายการสื่อเป็นวิดีโอ การเรียกใช้ batchCreate จะไม่แสดงผล mimeType
• batchCreate ไม่รักษาลําดับที่สอดคล้องกันเมื่ออัปโหลดหลายรายการ
• batchCreate ไม่รองรับการจัดเรียง (การเพิ่ม position) เมื่อสร้างรายการสื่อในอัลบั้มที่แชร์ในฐานะเจ้าของอัลบั้มที่แชร์ โดยค่าเริ่มต้นจะเป็นตอนท้ายของอัลบั้ม