Nội dung cập nhật về API Google Photos

Đăng vào tháng 9 năm 2024.

Trang này cung cấp thông tin chi tiết về những thay đổi cụ thể đối với API Google Photos. Hãy xem chi tiết trên trang này để hiểu mức độ ảnh hưởng của các phương thức và phạm vi mà bạn sử dụng. Bạn có thể đọc thêm về thông báo về những thay đổi này trong bài đăng liên quan trên blog.

API thư viện: Tác động đến các trường hợp sử dụng phổ biến

Các phần sau đây trình bày chi tiết về mức tác động của những thay đổi sắp tới đối với các trường hợp sử dụng phổ biến.

Tải mục nội dung nghe nhìn lên và tạo album

Nội dung thay đổi: Không có thay đổi. Bạn có thể tiếp tục tải các mục nội dung nghe nhìn lên và tạo album bằng phạm vi photoslibrary.appendonly.

Việc bạn có thể làm:

Nếu ứng dụng của bạn đang tải các mục nội dung nghe nhìn lên hoặc tạo album, hãy đảm bảo bạn đang sử dụng phạm vi photoslibrary.appendonly chứ không phải phạm vi photoslibrary. Phạm vi photoslibrary sẽ bị xoá.

Liệt kê, tìm kiếm và truy xuất các mục nội dung đa phương tiện và đĩa nhạc

Thay đổi: Giờ đây, bạn chỉ có thể liệt kê, tìm kiếm và truy xuất các album và mục nội dung nghe nhìn do ứng dụng của bạn tạo.

Việc bạn có thể làm:

• Nếu ứng dụng của bạn cần người dùng chọn ảnh hoặc album trong toàn bộ thư viện của họ, hãy sử dụng API Công cụ chọn của Google Photos mới. Đây là cách an toàn và thân thiện với người dùng để cấp quyền truy cập vào nội dung cụ thể.
• Nếu ứng dụng của bạn dựa vào việc truy cập vào toàn bộ thư viện của người dùng, thì bạn có thể cần đánh giá lại ứng dụng hoặc cân nhắc các phương pháp thay thế.

Chia sẻ và album được chia sẻ

Thay đổi: Sau ngày 31 tháng 3 năm 2025, các album được chia sẻ và các hàm API liên quan (chia sẻ, ngừng chia sẻ, nhận, tham gia, rời và danh sách) sẽ trả về 403 PERMISSION_DENIED.

Việc bạn có thể làm:

Hướng dẫn người dùng chuyển đến ứng dụng Google Photos để tự quản lý việc chia sẻ. Bạn có thể cung cấp hướng dẫn rõ ràng hoặc đường liên kết sâu trong ứng dụng để hướng dẫn họ.

Quản lý album do ứng dụng tạo: nội dung làm phong phú và nội dung album

Thay đổi: photoslibrary.edit.appcreateddata đang được thêm vào ba phương thức sau đây để đảm bảo tính nhất quán về mặt khái niệm:

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

Việc bạn có thể làm:

• Nếu ứng dụng của bạn đã sử dụng các phương thức này, hãy cân nhắc việc sử dụng phạm vi photoslibrary.edit.appcreateddata để đơn giản hoá quy trình uỷ quyền.

API thư viện: Phạm vi và phương thức bị ảnh hưởng

Trong quá trình thay đổi API Google Photos, chúng tôi đã thực hiện các cập nhật sau.

Như hiển thị trên trang Cấp quyền mới cập nhật, các phạm vi sau đây sẽ bị xoá khỏi API Thư viện sau ngày 31 tháng 3 năm 2025:

• photoslibrary.readonly
• photoslibrary.sharing
• photoslibrary

Các phạm vi sau đây sẽ vẫn tồn tại:

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

Bảng này trình bày chi tiết các phương thức và phạm vi API Thư viện cụ thể bị ảnh hưởng.

Nội dung cập nhật	Phương thức	Phạm vi
Hiện tại, bạn chỉ có thể sử dụng các phương thức này với các đĩa nhạc và mục nội dung nghe nhìn do ứng dụng của bạn tạo.	albums.create mediaItems.batchCreate	Phạm vi còn lại: photoslibrary.appendonly Phạm vi đã xoá: photoslibrary photoslibrary.sharing
	albums.get albums.list mediaItems.batchGet mediaItems.get mediaItems.list mediaItems.search	Phạm vi còn lại: photoslibrary.readonly.appcreateddata Phạm vi đã xoá: photoslibrary photoslibrary.readonly
Các phương thức này sẽ không còn hoạt động nữa.	albums.share albums.unshare sharedAlbums.get sharedAlbums.join sharedAlbums.leave sharedAlbums.list	Phạm vi còn lại: Không có Phạm vi đã xoá: photoslibrary.sharing
Các phương thức này sẽ được thêm photoslibrary.edit.appcreateddata. Hiện tại, bạn chỉ có thể sử dụng các phương thức này với các album và mục nội dung nghe nhìn do ứng dụng của bạn tạo.	albums.addEnrichment albums.batchAddMediaItems	Phạm vi còn lại: photoslibrary.appendonly photoslibrary.edit.appcreateddata Phạm vi đã xoá: photoslibrary
	albums.batchRemoveMediaItems	Phạm vi còn lại: photoslibrary.edit.appcreateddata Phạm vi đã xoá: photoslibrary
Các phương thức này sẽ không thay đổi.	albums.patch mediaItems.patch	Phạm vi còn lại: photoslibrary.edit.appcreateddata Phạm vi đã xoá: Không có

Nội dung cập nhật đối với chính sách của Photos API

Sau ngày 31 tháng 3 năm 2025, Chính sách về việc sử dụng được chấp nhận hiện tại sẽ được thay thế bằng Chính sách mới về dữ liệu người dùng và nhà phát triển của Photos API. Bạn hiện có thể xem trước chính sách mới.

Nội dung cập nhật đối với tài liệu về Photos API

Chúng tôi đã thực hiện những thay đổi đáng kể đối với tài liệu về API Photos để phản ánh các bản cập nhật sắp tới và hỗ trợ trải nghiệm phát triển của bạn:

• Trang web API Photos hợp nhất: Chúng tôi đã hợp nhất tất cả tài nguyên API Photos vào một vị trí duy nhất (trang web này), mang đến trải nghiệm đơn giản cho nhà phát triển. Tại đây, bạn sẽ thấy:
  • Tài nguyên tập trung: Kết hợp hướng dẫn thiết lập và hướng dẫn sử dụng chung, đồng thời kết hợp thông tin hỗ trợ và chính sách cho cả API bộ chọn và API thư viện.
  • Trang web API chuyên dụng: Các trang web riêng lẻ có hướng dẫn chi tiết, tài liệu tham khảo và mã mẫu cho API bộ chọn và API thư viện
• Nội dung cập nhật về Thư viện API: Tài liệu về Thư viện API đã được sửa đổi để phản ánh các chức năng của Thư viện API sau thời gian ngừng hoạt động.
• Duy trì tài liệu cũ: Chúng tôi đã giữ lại tài liệu API Thư viện gốc cho những nhà phát triển cần di chuyển các công cụ tích hợp hiện có. Nếu bạn đang bắt đầu một dự án mới, hãy sử dụng tài liệu mới cập nhật. Nếu bạn đang cập nhật một dự án hiện có, hãy tham khảo cả tài liệu cũ và mới cập nhật nếu cần trong quá trình di chuyển.

Câu hỏi thường gặp

API Google Photos sẽ thay đổi như thế nào?

Chúng tôi sẽ ra mắt Google Photos Picker API mới để chọn ảnh một cách an toàn và cập nhật Thư viện API hiện có để tập trung vào việc quản lý ảnh và video do ứng dụng của bạn tạo.

Khi nào những thay đổi này có hiệu lực?

Những thay đổi này sẽ có hiệu lực từ ngày 31 tháng 3 năm 2025. Mọi người có các tính năng tích hợp hiện tại sử dụng API Thư viện để chọn ảnh nên chuyển sang API Bộ chọn càng sớm càng tốt.

Library API sẽ bị ảnh hưởng như thế nào?

Phạm vi photoslibrary.readonly, photoslibrary.sharing và photoslibrary sẽ bị xoá. Các lệnh gọi API chỉ dựa vào những phạm vi này sẽ trả về 403 PERMISSION_DENIED sau ngày 31 tháng 3 năm 2025. Một số lệnh gọi khác sẽ bị hạn chế chỉ hoạt động với ảnh và video do ứng dụng của bạn tạo.

Bạn có thể xem toàn bộ thay đổi trong bảng phương thức và phạm vi bị ảnh hưởng trên trang này.

Tôi nên làm gì nếu ứng dụng của tôi hiện đang sử dụng các phạm vi hoặc phương thức bị ảnh hưởng?

Nếu ứng dụng của bạn sử dụng bất kỳ phạm vi hoặc phương thức nào bị ảnh hưởng, bạn nên làm theo các bước sau:

• Đối với tính năng chọn ảnh: hãy chuyển sang API Công cụ chọn ảnh của Google Photos.
• Đối với các chức năng khác: hãy xem lại tài liệu cập nhật về API Thư viện để hiểu rõ các thay đổi và xác định những tính năng trong ứng dụng có thể không còn hoạt động nữa. Bạn có thể cần điều chỉnh chức năng của ứng dụng hoặc khám phá các giải pháp thay thế cho một số trường hợp sử dụng.

Google Photos Picker API là gì?

Picker API là một cách mới và an toàn để nhà phát triển cho phép người dùng chọn ảnh và video trong Thư viện Google Photos của họ, đồng thời gửi liền mạch các ảnh và video đó trở lại ứng dụng của bạn.

Tôi có thể tìm thêm thông tin về những thay đổi này ở đâu?

Trang bạn đang xem cung cấp thông tin tổng quan và tóm tắt về tất cả thay đổi.

Phần còn lại của tài liệu trên trang web của chúng tôi đã được cập nhật để phản ánh các API đã cập nhật.

Bài đăng trên blog này thông báo về những thay đổi này.

Nếu tôi có thêm câu hỏi hoặc cần được trợ giúp di chuyển ứng dụng thì sao?

Nếu bạn có câu hỏi về tài liệu dành cho nhà phát triển, hãy xem trang hỗ trợ của chúng tôi để biết thêm thông tin về cách yêu cầu trợ giúp.