Ghi chú phát hành

Đăng ký 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 Thư viện Google Photos. Nhật ký thay đổi danh sách 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à thay đổi.

Tài liệu và hướng dẫn này đề cập đến phiên bản mới nhất mà bạn có thể sử dụng.

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 đã công bố những thay đổi quan trọng đối với API Thư viện (có hiệu lực từ ngày 31 tháng 3 năm 2025).

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

Thông tin đầy đủ được trình bày trong bài viết Nội dung cập nhật cho API Google Photos .

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

Ghi chú

• "Tạo ứng dụng Chia sẻ ảnh bằng Google Photos và Flutter" lớp học lập trình không còn hiệu lực. Xem các mẫu khác của chúng tôi và tham khảo đến 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 video 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 chúng và 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 Google Photos: ra mắt giải pháp hàng đầu. Cấp cao cấp là bộ tính năng API nâng cao tận dụng trí tuệ máy móc 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 nội dung tìm kiếm dựa trên bộ lọc ngày của Google. Kết quả có thể được sắp xếp theo thứ tự mới nhất hoặc cũ nhất xếp trước. Điều này cho phép tìm kiếm 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.

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

Tính năng

• Tham số -no mới cho URL cơ sở của video để tải hình thu nhỏ mà không cần lớp phủ nút phát. Video theo mặc định thì hình thu nhỏ sẽ tải cùng với một lớp phủ nút phát. Thông số mới này cung cấp cho bạn để ẩn nút phát trên hình thu nhỏ video.

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

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

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

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

• exposureTime tài sản chưa được điền sẵn Siêu dữ liệu photo trong các mục nội dung đa phương tiện.

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

Ghi chú

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

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

Ghi chú

• Chính sách sử dụng đã được mới cập nhật, thêm nội dung về quảng cáo và giảm thiểu mứ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. Một trường mới, isJoinable, là hiện được trả về như một phần của thuộc tính shareInfo cho album chia sẻ. API này có thể kết nối người dùng với một album dùng chung 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 album trong Google Photos, isJoinable sẽ là false và API sẽ không được có thể tham gia người dùng vào anbom đó.
• Vấn đề 111405623, 116379853, 117685011: Giờ đây, bạn có thể thay đổi tiêu đề và ảnh bìa album, và thay đổi nội dung mô tả cho các mục nội dung đa phương tiện mà ứng dụng của bạn tạo ra. 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 ảnh đã được 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. Tài sản fileName mới trong simpleMediaItem hỗ trợ các chuỗi UTF-8. Bạn vẫn có thể chỉ định tên tệp của một mục nội dung đa phương tiện khi đang tải lên các byte nội dung đa phương tiện, tuy nhiên, bạn nên cập nhật quá trình triển khai của bạn.

Ghi chú

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

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

Tính năng

• Vấn đề 131874809: Tài sản mới isOwned trong shareInfo để xác định xem người dùng có phải là chủ sở hữu của album được 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.

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

• Vấn đề 131711405: Tài sản shareableUrl là bị thiếu trong albums.list của bạn.
• 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 video siêu dữ liệu trả về một cách chính xác VideoProcessingStatus 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: Mới bộ lọc tìm kiếm để chọn các mục nội dung đa phương tiện đã được đánh dấu là yêu thích: FeatureFilter.
• 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. Xem hướng dẫn 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 cần thêm và xóa các mục nội dung nghe nhìn hiện có khỏi album:

  • albums.batchAddMediaItems
  • albums.batchRemoveMediaItems

  Các cuộc gọi này hỗ trợ các mục nội dung nghe nhìn và album do người dùng tạo . 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 quản lý đĩa nhạc.

• Lệnh gọi REST để tạo các mục nội dung đa phương tiện mediaItems.batchCreate hiện sẽ trả về trạng thái HTTP 207 MULTI-STATUS nếu thành công một phần nếu một số nội dung đa phương tiện Không thể tạo mục. Bạn có thể xem thêm thông tin chi tiết trong phần Tải lên nhà phát triển nội dung đa phương tiện của chúng tôi.

Ghi chú

• Phiên bản mới nhất của ứng dụng khách thư viện có chứa 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 giao diện mới Google Cloud. 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ú

• Giới hạn mới đối với việc truy cập vào các byte nội dung nghe nhìn từ cơ sở sẽ áp dụng. Bạn có thể theo dõi hạn mức này trong Bảng điều khiển API của Google.

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

• Vấn đề 124355983: 500 lỗi khi gọi mediaItems.get cho một số mục nội dung nghe nhìn được chia sẻ.

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

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

• Vấn đề 121998358: Tài sản isWriteable là bị thiếu trong albums.create phản hồi.

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

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

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

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

Tính năng

• Cuộc gọi mới mediaItems.batchGet để truy xuất nhiều mục nội dung đa phương tiện theo giá trị nhận dạng.
• Vấn đề 111279349: Cuộc gọi mới sharedAlbums.leave để rời khỏi album đã tham gia.
• Vấn đề 111279347: Cuộc gọi mới albums.unshare để đánh dấu album chia sẻ ở chế độ 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ú

• API Thư viện Google Photos đã được phát hành rộng rãi. Cảm ơn bạn đã phản hồi và yêu cầu tính năng trong khoảng 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.
• Chúng tôi đã thêm các đoạn mã Java và PHP mẫu vào hướng dẫn để minh hoạ việc sử dụng thư viện ứng dụng.

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

Tính năng

• Cuộc gọi mới sharedAlbums.get đến tải album bằng shareToken.
• Tài sản mới isJoined trong shareInfo để xác định xem người dùng đã tham gia album chia sẻ hay chưa.

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

• Vấn đề 79321120: Thiếu tài sản mimeType trong mediaItems.batchCreate cho các mục nội dung đa phương tiện 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 tệp liên quan đến CORS vấn đề tải 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 của album, mục nội dung đa phương tiện hoặc các mục bổ sung) trước ngày 5 tháng 9 năm 2018, thì các mã này sẽ không hoạt động nữa do định dạng đã thay đổi. Bạn sẽ cần lấy mã nhận dạng mới để sử dụng trong đơn đăng ký của mình.
• Thuộc tính totalMediaItems của tài nguyên album (album) đã được đổi tên thành mediaItemsCount.
• Giá trị lớn nhất của tham số pageSize trong mediaItems.list và Số lệnh gọi 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.
• Liệt kê nội dung trong thư viện, Chia sẻ nội dung nghe nhìn và Đã cập nhật hướng dẫn về Truy cập vào các mục nội dung đa phương tiện với excludeNonAppCreatedData](/photos/library/guides/apply-filters#nonapp-created) phát hành tính năng bộ lọc 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 liệt kê album do ứng dụng của bạn tạo.
• Tham số mới cho 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: Thông số tải xuống d, để tải hình ảnh gốc xuống.
• sharedAlbums.join hàm gọi trả về một giá trị anbom.
• Vấn đề 109655786: album ngay bây giờ chứa mã mục nội dung đa phương tiệ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 đa phương tiện là filename.

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

• Vấn đề 79757390: Chưa đặt tên tệp trong khi yêu cầu tải lên. Xem X-Goog-Upload-File-Namefile và X-Goog-Upload-Protocol trường trong phần Tải lên nội dung đa phương tiện.
• Vấn đề 80182372: Tính năng tải lên tiếp nối trả về lỗi. Xem phần Resumable (Có thể tiếp tục) mới video đã tải lên hướng dẫn cho phiên bản cập nhật giao thức.
• Vấn đề 79497397: Thiếu isWriteable tài sản trong phản hồi albums.list.
• Vấn đề 111143493: Danh mục nội dung của PEOPLE bộ lọc trả về các kết quả không chính xác.
• Vấn đề 111056278: Danh mục nội dung của BIRTHDAYS bộ lọc trả về một lỗi.

Bản xem trước – 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 ra lỗi nếu mục nội dung đa phương tiện id nhận được là dành cho mục nội dung nghe nhìn thuộc 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 đa phương tiện là video, thì 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ợ đặt hàng (thêm position) khi tạo mục nội dung nghe nhìn trong album chia sẻ với tư cách là chủ sở hữu của album chia sẻ. Nó đặt mặc định ở cuối anbom.