Ghi chú phát hành

Đăng ký nhận các ghi chú phát hành này.

Trang này được cập nhật mỗi khi có bản phát hành mới của API Google Photos. Nhật ký thay đổi liệt kê các bản phát hành theo ngày và bao gồm mọi tính năng mới, bản sửa lỗi và các thay đổi khác.

Tài liệu và hướng dẫn sẽ hướng đến phiên bản mới nhất để sử dụng.

Ngày 1 tháng 4 năm 2025

Ghi chú

Bản phát hành này triển khai các thay đổi đã thông báo trước đó đối với API Photos.

• Xoá một số phạm vi khỏi API Thư viện.
• Hạn chế một số phương thức chỉ hoạt động với nội dung do ứng dụng tạo.
• Chính sách mới về dữ liệu người dùng và nhà phát triển đối với API của Photos sẽ có hiệu lực thay cho Chính sách sử dụng được chấp nhận cũ.

Để biết thông tin chi tiết đầy đủ, hãy đọc bài viết Thông tin cập nhật về API Google Photos.

Ngày 16 tháng 9 năm 2024

Tính năng

• Ra mắt Picker API mới để chọn ảnh một cách an toàn và thân thiện với người dùng.

Ghi chú

Trong bản phát hành này, chúng tôi đã thông báo về những thay đổi chính đối với Library API (có hiệu lực từ ngày 31 tháng 3 năm 2025).

• Library API sẽ chỉ quản lý ảnh và video do ứng dụng của bạn tạo.
• Xoá phạm vi photoslibrary.readonly, photoslibrary.sharing và photoslibrary.
• Chỉ hạn chế một số phương thức đối với nội dung do ứng dụng tạo.

Bạn có thể xem toàn bộ thông tin chi tiết trên trang Các bản cập nhật đối với API của Google Photos.

Ngày 27 tháng 10 năm 2022

Ghi chú

• Lớp học lập trình "Tạo ứng dụng chia sẻ ảnh bằng Google Photos và Flutter" không còn hoạt động nữa. Xem lại các mẫu khác và tham khảo mã mẫu trong hướng dẫn của chúng tôi.

Ngày 1 tháng 6 năm 2022

Ghi chú

• Thêm các phương pháp hay nhất để tải lên để giúp làm rõ quy trình tải lên, nêu các lỗi thường gặp và cách tránh các lỗi đó, đồng thời cung cấp các mẹo để cải thiện hiệu quả tải lên.

Ngày 27 tháng 10 năm 2021

Tính năng

• Chương trình Đối tác của Google Photos: ra mắt cấp cao nhất. Cấp cao cấp là một bộ tính năng API nâng cao tận dụng trí tuệ nhân tạo mạnh mẽ của Google Photos.

Ngày 29 tháng 9 năm 2021

Tính năng

• Tuỳ chọn mới để sắp xếp các kết quả tìm kiếm dựa trên bộ lọc ngày. Bạn có thể sắp xếp kết quả theo thứ tự mới nhất hoặc cũ nhất. Điều này giúp việc tìm kiếm trở nên dễ dàng hơn và cải thiện hiệu quả bằng cách cung cấp kết quả tìm kiếm được nhắm mục tiêu tốt hơn.

Ngày 21 tháng 7 năm 2021

Tính năng

• Thông số -no mới cho URL cơ sở của video để tải hình thu nhỏ mà không có lớp phủ nút phát. Theo mặc định, hình thu nhỏ video sẽ tải cùng với lớp phủ nút phát. Tham số mới này cho phép bạn kiểm soát việc ẩn nút phát trên hình thu nhỏ video.

Vấn đề đã giải quyết

• Vấn đề 181282432: Hình thu nhỏ video luôn xuất hiện cùng với lớp phủ nút phát.

Ngày 25 tháng 5 năm 2021

Các vấn đề đã giải quyết

• Thuộc tính exposureTime không được điền sẵn cho siêu dữ liệu photo trong các mục nội dung nghe nhìn.

Ngày 19 tháng 5 năm 2021

Ghi chú

• Chúng tôi đã cập nhật tài liệu về URL cơ sở cho ảnh động để làm rõ hành vi của tham số =dv cho ảnh động trên Android và ảnh động trên iOS.

Ngày 11 tháng 2 năm 2021

Ghi chú

• Chúng tôi đã cập nhật Chính sách sử dụng, bổ sung nội dung về quảng cáo và giảm thiểu việc sử dụng dữ liệu.

Ngày 7 tháng 7 năm 2020

Tính năng

• API này đã được cập nhật để hỗ trợ các chế độ kiểm soát mới về việc chia sẻ trong Google Photos. Giờ đây, một trường mới, isJoinable, sẽ được trả về trong thuộc tính shareInfo cho các album chia sẻ. API này có thể kết nối người dùng với một album chia sẻ khi isJoinable là true. Nếu chủ sở hữu đã tắt tính năng chia sẻ đường liên kết trên một album trong Google Photos, thì isJoinable sẽ là false và API sẽ không thể thêm người dùng vào album đó.
• Vấn đề 111405623, 116379853, 117685011: Giờ đây, bạn có thể thay đổi tên đĩa nhạc và ảnh bìa, và thay đổi nội dung mô tả cho các mục nội dung nghe nhìn mà ứng dụng của bạn đã tạo. Yêu cầu phạm vi uỷ quyền photoslibrary.edit.appcreateddata mới để có quyền cập nhật.

Ngày 17 tháng 2 năm 2020

Tính năng

• Kích thước tệp tải lên tối đa của một ảnh đã tăng từ 75 MB lên 200 MB.
• Giờ đây, khi tải tệp lên, bạn phải chỉ định loại MIME trong giai đoạn tải lên theo byte.
• Giờ đây, bạn chỉ định tên tệp khi tạo một mục nội dung nghe nhìn, thay vì khi tải các byte nội dung nghe nhìn lên. Thuộc tính fileName mới trong simpleMediaItem hỗ trợ chuỗi UTF-8. Bạn vẫn có thể chỉ định tên tệp của mục nội dung nghe nhìn khi tải lên các byte nội dung nghe nhìn. Tuy nhiên, bạn nên cập nhật cách triển khai.

Ghi chú

• Chúng tôi đã cập nhật Chính sách sử dụng được chấp nhận, trong đó có một số thông tin chi tiết bổ sung tập trung vào việc giảm thiểu mức sử dụng và lưu trữ dữ liệu.
• Tài liệu về URL cơ sở đã được cập nhật để bao gồm cả ảnh chuyển động.

Ngày 16 tháng 8 năm 2019

Tính năng

• Vấn đề 131874809: Thuộc tính mới isOwned trong shareInfo để xác định xem người dùng có phải là chủ sở hữu của album chia sẻ hay không. Bạn có thể xem thêm thông tin chi tiết trong hướng dẫn dành cho nhà phát triển về cách chia sẻ nội dung nghe nhìn.

Vấn đề đã giải quyết

• Vấn đề 131711405: Thiếu thuộc tính shareableUrl trong phản hồi albums.list.
• Vấn đề 113870729: mediaItems.list đôi khi trả về các mục nội dung nghe nhìn trùng lặp ở ranh giới trang.
• Vấn đề 93428763: Trường status cho siêu dữ liệu video hiện trả về chính xác VideoProcessingStatus của video có chất lượng cao nhất hiện có.

Ngày 12 tháng 6 năm 2019

Tính năng

• Vấn đề 110188560: Bộ lọc tìm kiếm mới để chọn các mục nội dung nghe nhìn đã được đánh dấu là mục yêu thích: FeatureFilter.
• Danh mục nội dung mới cho ContentFilter để lọc các mục nội dung nghe nhìn khớp với các danh mục cụ thể: ARTS, CRAFTS, FASHION, HOUSES, GARDENS, FLOWERS, HOLIDAYS.

Ghi chú

• Cập nhật Nguyên tắc về trải nghiệm người dùng để cung cấp thêm hướng dẫn về cách đặt tên cho dự án và đĩa nhạc.

Ngày 7 tháng 5 năm 2019

Lớp học lập trình

• Lớp học lập trình mới: Tạo ứng dụng Chia sẻ ảnh bằng Google Photos và Flutter. Tìm hiểu cách tạo ứng dụng chia sẻ ảnh bằng API Thư viện Google Photos trong Flutter. Hãy xem hướng dẫn về mẫu để biết thông tin chi tiết.

Ngày 29 tháng 4 năm 2019

Tính năng

• Vấn đề 109505022: Lệnh gọi mới để thêm và xoá các mục nội dung nghe nhìn hiện có vào một album:

  • albums.batchAddMediaItems
  • albums.batchRemoveMediaItems

  Các lệnh gọi này hỗ trợ các mục nội dung nghe nhìn và album do ứng dụng của bạn tạo. Bạn có thể xem thêm thông tin chi tiết trong hướng dẫn quản lý đĩa nhạc dành cho nhà phát triển.

• Giờ đây, lệnh gọi REST để tạo mục nội dung đa phương tiện mediaItems.batchCreate sẽ trả về trạng thái HTTP 207 MULTI-STATUS cho một phần thành công nếu không thể tạo một số mục nội dung đa phương tiện. Bạn có thể xem thêm thông tin chi tiết trong hướng dẫn dành cho nhà phát triển về Tải nội dung nghe nhìn lên.

Ghi chú

• Các phiên bản mới nhất của thư viện ứng dụng có một thay đổi có thể gây lỗi. Các lớp liên quan đến MediaItem, Album và DateRange đã chuyển sang một gói chuyên dụng mới. Chức năng của các lớp này không thay đổi, chỉ thay đổi vị trí của các lớp này trong thư viện ứng dụng. Hãy tham khảo ghi chú phát hành của thư viện ứng dụng Java (1.2.0) và thư viện ứng dụng PHP (1.2.0).

Ngày 14 tháng 2 năm 2019

Ghi chú

• Áp dụng hạn mức mới cho việc truy cập vào các byte nội dung nghe nhìn từ URL cơ sở. Bạn có thể theo dõi hạn mức này trong Google API Console.

Các vấn đề đã giải quyết

• Vấn đề 124355983: Lỗi 500 khi gọi mediaItems.get cho một số mục nội dung đa phương tiện được chia sẻ.

Ngày 21 tháng 1 năm 2019

Các vấn đề đã giải quyết

• Vấn đề 121998358: Thiếu thuộc tính isWriteable trong phản hồi albums.create.

Ngày 7 tháng 1 năm 2019

Vấn đề đã giải quyết

• Vấn đề 118464845: mediaItems.list trả về quá nhiều trang trống.
• Vấn đề 111714379: mediaItems.search trả về một nửa pageSize.

Ngày 30 tháng 11 năm 2018

Tính năng

• Lệnh gọi mới mediaItems.batchGet để truy xuất nhiều mục nội dung nghe nhìn theo giá trị nhận dạng của các mục đó.
• Vấn đề 111279349: Lệnh gọi mới sharedAlbums.leave để rời khỏi một album đã tham gia.
• Vấn đề 111279347: Lệnh gọi mới albums.unshare để đánh dấu một album chia sẻ là riêng tư.

Các vấn đề đã giải quyết

• Vấn đề 113978705: Nội dung mô tả được đặt trong mediaItems.batchCreate đã được chuyển đổi thành thực thể HTML.
• Vấn đề 114462217: Không thể đặt tên tệp cho các tệp video trong mediaItems.batchCreate.
• Vấn đề 118475587: URL sản phẩm không hợp lệ được trả về cho các mục nội dung nghe nhìn.
• Vấn đề 111862704: Lỗi 403 khi truy cập vào các URL cơ sở.
• Vấn đề 115932469: Không tải lên được do lỗi hạn mức.

Ngày 6 tháng 9 năm 2018

Tính năng

• Thư viện ứng dụng Java và PHP hiện đã có.

Ghi chú

• Google Photos Library API đã được cung cấp rộng rãi. Cảm ơn bạn đã gửi ý kiến phản hồi và yêu cầu về tính năng trong thời gian dùng thử API Thư viện dành cho nhà phát triển.
• Hãy xem các hướng dẫn mới để bắt đầu sử dụng thư viện ứng dụng Java và PHP.
• Các đoạn mã Java và PHP mẫu đã được thêm vào hướng dẫn để minh hoạ cách sử dụng thư viện ứng dụng.

Ngày 5 tháng 9 năm 2018

Tính năng

• Lệnh gọi mới sharedAlbums.get để lấy một album bằng shareToken.
• Thuộc tính mới isJoined trong shareInfo để xác định xem người dùng đã tham gia album chia sẻ hay chưa.

Vấn đề đã giải quyết

• Vấn đề 79321120: Thiếu thuộc tính mimeType trong phản hồi mediaItems.batchCreate cho các mục nội dung nghe nhìn dạng video.
• Vấn đề 79319272: Các thuộc tính như mediaMetadata, contributorInfo bị thiếu trong phản hồi mediaItems.batchCreate.
• Vấn đề 110237685: Khắc phục vấn đề tải tệp liên quan đến CORS lên.
• Vấn đề 79318118: Không duy trì được thứ tự nhất quán khi tải nhiều mục lên một album trong lệnh gọi mediaItems.batchCreate.

Ghi chú

• Nếu bạn đã lưu trữ mã nhận dạng (chẳng hạn như mã nhận dạng cho album, mục nội dung nghe nhìn hoặc mục làm phong phú) trước ngày 5 tháng 9 năm 2018, thì các mã nhận dạng đó sẽ không còn hoạt động nữa vì định dạng đã thay đổi. Bạn sẽ cần phải lấy mã nhận dạng mới để sử dụng trong ứng dụng.
• Thuộc tính totalMediaItems của tài nguyên album (album) đã được đổi tên thành mediaItemsCount.
• Giá trị tối đa của thông số pageSize trong các lệnh gọi mediaItems.list và mediaItems.search đã được thay đổi thành 100. Số lượng mục nội dung nghe nhìn mặc định được trả về khi không chỉ định tham số pageSize đã được thay đổi thành 25.
• Chúng tôi đã cập nhật hướng dẫn về cách Liệt kê nội dung trong thư viện, Chia sẻ nội dung nghe nhìn và Truy cập vào các mục nội dung nghe nhìn bằng tính năng bộ lọc excludeNonAppCreatedData](/photos/library/guides/apply-filters#nonapp-created) được phát hành vào ngày 31 tháng 7 năm 2018.

Ngày 31 tháng 7 năm 2018

Tính năng

• Lệnh gọi mới mediaItems.list để liệt kê các mục nội dung nghe nhìn.
• Bộ lọc mới excludeNonAppCreatedData để tìm kiếm các mục hoặc danh sách đĩa nhạc do ứng dụng của bạn tạo.
• Các thông số mới để truy cập vào hình ảnh:
  • Vấn đề 79871479: Thông số cắt c, để cắt hình ảnh theo kích thước chính xác.
  • Vấn đề 110343547, Vấn đề 111228390: Tham số tải xuống d, để tải hình ảnh gốc xuống.
• Lệnh gọi sharedAlbums.join hiện trả về một album.
• Vấn đề 109655786: album hiện chứa mã mục nội dung nghe nhìn của ảnh bìa, coverPhotoMediaItemId.
• Vấn đề 79656863: mediaItem hiện chứa tên tệp của mục nội dung nghe nhìn, filename.

Vấn đề đã giải quyết

• Vấn đề 79757390: Tên tệp không được đặt trong các yêu cầu tải lên. Xem các trường X-Goog-Upload-File-Namefile và X-Goog-Upload-Protocol trong hướng dẫn Tải nội dung nghe nhìn lên.
• Vấn đề 80182372: Tính năng tải lên tiếp nối trả về lỗi. Hãy xem hướng dẫn mới về Tải lên có thể tiếp tục để biết giao thức mới.
• Vấn đề 79497397: Thuộc tính isWriteable bị thiếu trong phản hồi albums.list.
• Vấn đề 111143493: Bộ lọc danh mục nội dung PEOPLE đang trả về kết quả không chính xác.
• Vấn đề 111056278: Bộ lọc danh mục nội dung BIRTHDAYS đang trả về lỗi.

Bản dùng thử – Ngày 8 tháng 5 năm 2018

Bản phát hành đầu tiên của API Thư viện.

Vấn đề đã biết

• GET mediaItem sẽ gửi lỗi nếu mục nội dung đa phương tiện id mà ứng dụng nhận được là của một mục nội dung đa phương tiện trong một album chia sẻ và không thuộc quyền sở hữu của người dùng.
• Phản hồi từ lệnh gọi batchCreate sẽ không trả về mediaMetadata hoặc contributorInfo.
• Nếu mục nội dung nghe nhìn là video, lệnh gọi batchCreate sẽ không trả về mimeType.
• batchCreate không duy trì thứ tự nhất quán khi tải nhiều mục lên.
• batchCreate không hỗ trợ việc sắp xếp (thêm vào position) khi tạo mục nội dung nghe nhìn trong một album chia sẻ với tư cách là chủ sở hữu của album chia sẻ đó. Giá trị này mặc định là cuối album.