Bạn đang xem tài liệu cũ về API Thư viện Google Photos.
Method: albums.patch
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Cập nhật album bằng id
được chỉ định. Chỉ các trường id
, title
và coverPhotoMediaItemId
của album mới được đọc. Album phải do nhà phát triển tạo thông qua API và phải thuộc quyền sở hữu của người dùng.
Yêu cầu HTTP
PATCH https://photoslibrary.googleapis.com/v1/albums/{album.id}
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Thông số |
album.id |
string
Giá trị nhận dạng cho album. Đây là giá trị nhận dạng cố định có thể dùng giữa các phiên để xác định album này.
|
Tham số truy vấn
Thông số |
updateMask |
string (FieldMask format)
Bắt buộc. Chỉ định những trường trong đĩa nhạc được cung cấp cần cập nhật. Các giá trị hợp lệ duy nhất là title và coverPhotoMediaItemId . Đây là danh sách các tên trường đủ điều kiện được phân tách bằng dấu phẩy. Ví dụ: "user.displayName,photo"
|
Nội dung yêu cầu
Nội dung yêu cầu chứa một bản sao của Album
.
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Album
.
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2024-11-07 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2024-11-07 UTC."],[[["This API updates an album with a specified ID, modifying only the title and cover photo, if provided in the request."],["The album being updated must have been created by the developer via the API and be owned by the user."],["A `PATCH` request is used, targeting the album's ID in the URL."],["An `updateMask` query parameter is required to specify which album fields (title, coverPhotoMediaItemId) are being updated."],["The request body should contain an `Album` object with the updated fields, and the response, if successful, also contains an `Album` object."]]],[]]