Đă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ể đang được thực hiện đối với Google Photos API. Xem thông tin chi tiết trên trang này để nắm được cách các phương thức và phạm vi mà bạn sử dụng có thể bị ảnh hưởng. Bạn có thể đọc thêm về việc thông báo về các chính sách này những điểm thay đổi trong bài đăng trên blog có liên quan.
Library API: Tác động đối với 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ề tác động của những thay đổi sắp tới đối với hoạt động sử dụng phổ biến trường hợp.
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 sử dụng
phạm vi photoslibrary.appendonly chứ không phải phạm vi photoslibrary. Chiến lược phát hành đĩa đơn
Đang xoá photoslibrary phạm vi.
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, hãy sử dụng Google Photos Picker API mới. Điều này mang đến một giải pháp 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ẻ
Nội dung thay đổi: Album chia sẻ và các chức năng API được liên kết (chia sẻ,
thôi chia sẻ, tải, tham gia, rời khỏi và danh sách) sẽ trả về 403 PERMISSION_DENIED sau
Ngày 31 tháng 3 năm 2025.
Việc bạn có thể làm:
Chuyển người dùng đế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 của bạn để hướng dẫn họ.
Quản lý album do ứng dụng tạo: các tính năng bổ ích và nội dung trong album
Thay đổi: photoslibrary.edit.appcreatedata đ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.addEnrichmentalbums.batchAddMediaItemsalbums.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 pháp này, hãy cân nhắc áp dụng
photoslibrary.edit.appcreatedataphạm vi để đơn giản hóa ủy quyền của bạn của chúng tôi.
API thư viện: Phạm vi và phương thức bị ảnh hưởng
Trong các thay đổi đối với API Google Photos, chúng tôi đã thực hiện những thay đổi sau bản cập nhật.
Như đã trình bày trên phần Uỷ quyền được cập nhật , các phạm vi sau sẽ bị xoá khỏi API Thư viện sau ngày 31 tháng 3 năm 2025:
photoslibrary.readonlyphotoslibrary.sharingphotoslibrary
Các phạm vi sau đây sẽ vẫn tồn tại:
photoslibrary.appendonlyphotoslibrary.readonly.appcreateddataphotoslibrary.edit.appcreateddata
Bảng này trình bày chi tiết các phương thức và phạm vi cụ thể của Thư viện API bị ảnh hưởng.
| Nội dung cập nhật | Phương thức | Phạm vi |
|---|---|---|
| Các phương thức này hiện chỉ có thể được sử dụng với album và mục nội dung nghe nhìn do ứng dụng của bạn tạo. Trong đó có những mục nội dung đa phương tiện được chọn bằng API Bộ chọn và được thêm vào thư viện của người dùng bằng API Thư viện. | Phạm vi còn lại:
|
|
Phạm vi còn lại:
|
||
| Các phương thức này sẽ không dùng được nữa. | Phạm vi còn lại:
|
|
Các phương thức này sẽ được thêm photoslibrary.edit.appcreatedata. Các phương thức này hiện chỉ dùng được với album và mục nội dung nghe nhìn do ứng dụng của bạn tạo. Trong đó có những mục nội dung đa phương tiện được chọn bằng API Bộ chọn và được thêm vào thư viện của người dùng bằng API Thư viện. |
Phạm vi còn lại:
|
|
Phạm vi còn lại:
|
||
| Các phương thức này sẽ không thay đổi. | Phạm vi còn lại:
|
Nội dung cập nhật đối với chính sách về API của Photos
Chính sách sử dụng chấp nhận được hiện hành sẽ: được thay thế sau ngày 31 tháng 3 năm 2025 bằng Dữ liệu người dùng và nhà phát triển mới của API Photos Chính sách. Chính sách mới hiện đã có cho bản xem trước.
Nội dung cập nhật đối với tài liệu về API Photos
Chúng tôi đã thực hiện nhiều thay đổi quan trọng trong 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 và thuận tiện (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à thông tin chung hướng dẫn sử dụng và các kết hợp thông tin về chính sách và hỗ trợ dành cho cả API Bộ chọn và API Thư viện.
- Các 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 Bộ chọn API và Thư viện API
- Nội dung API Thư viện đã cập nhật: Tài liệu về API Thư viện đã được sửa đổi để phản ánh khả năng của ứng dụng sau thời gian ngừng cung cấp. Trong tài liệu mới cập nhật, bạn sẽ thấy các nhãn đánh dấu bất kỳ nội dung đã thay đổi hoặc bị xoá, kèm theo đường liên kết đến nội dung cũ tương ứng để tham khảo trong quá trình di chuyển.
- Tài liệu cũ được bảo tồn: Chúng tôi đã giữ lại API Thư viện gốc tài liệu dành cho các nhà phát triển bạ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 chiếu đến cả dự án cũ và dự án đã 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 có gì thay đổi?
Chúng tôi sắp ra mắt API Bộ chọn ảnh mới của Google Photos để giúp bạn chọn ảnh an toàn và cập nhật API Thư viện 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 ra.
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. Chúng tôi khuyến khích tất cả mọi người các công cụ tích hợp hiện có sử dụng API Thư viện để chọn ảnh nhằm di chuyển sang bộ chọn API ngay khi có thể.
Library API sẽ bị ảnh hưởng như thế nào?
photoslibrary.readonly, photoslibrary.sharing và photoslibrary
các phạm vi sẽ bị xóa. Lệnh gọi API chỉ dựa vào các phạm vi này sẽ trả về một
403 PERMISSION_DENIED. 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 ở đầu trang này.
Tôi nên làm gì nếu ứng dụng của tôi đ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 sử dụng các bước sau:
- Để chọn ảnh: hãy di chuyển sang API công cụ chọn 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ủa bạn có thể không còn hoạt động nữa. Có thể bạn sẽ 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.
API Công cụ chọn của Google Photos là gì?
Bộ chọn API là một cách mới, an toàn để nhà phát triển cho phép người dùng chọn ảnh và album từ Thư viện Google Photos của họ và gửi lại một cách liền mạch cho ứng dụng của bạn. API Bộ chọn mang đến các chức năng lựa chọn ảnh mạnh mẽ, bao gồm việc chọn từng mục, chọn tất cả các mục trong album và bằng cách tìm trong Thư viện Google Photos.
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 và tóm tắt tất cả cá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 về cách di chuyển ứng dụng thì sao?
Nếu bạn có thắc mắc về tài liệu dành cho nhà phát triển, hãy tham khảo trang hỗ trợ của chúng tôi để biết thêm thông tin chi tiết về cách yêu cầu trợ giúp.