Ngoài việc truy cập và truy xuất các mục nội dung nghe nhìn sau khi tải lên, bạn cũng có thể thay đổi nội dung mô tả của các mục đó.
Phạm vi uỷ quyền bắt buộc
Bạn cần có phạm vi photoslibrary.edit.appcreateddata để thay đổi nội dung mô tả của nội dung do ứng dụng tạo. Để biết thêm thông tin về phạm vi, hãy xem phần Phạm vi uỷ quyền.
Thay đổi nội dung mô tả mục nội dung nghe nhìn
Để thay đổi nội dung mô tả của một mục nội dung nghe nhìn, hãy tạo một media items update
call có giá trị nhận dạng của mục nội dung nghe nhìn đó và đưa nội dung mô tả mới vào yêu cầu.
Để thay đổi nội dung mô tả của một mục nội dung nghe nhìn, ứng dụng của bạn phải tải mục nội dung nghe nhìn đó lên và người dùng hiện đã được xác thực phải là chủ sở hữu. Nội dung mô tả không được dài quá 1.000 ký tự.
REST
Dưới đây là tiêu đề yêu cầu PATCH để cập nhật nội dung mô tả của một mục nội dung nghe nhìn:
PATCH https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id?updateMask=description
Yêu cầu này xác định những thuộc tính đang được cập nhật bằng cách đưa vào một mặt nạ trường, được biểu thị bằng tham số updateMask trong URL.
Thêm nội dung mô tả mới vào nội dung yêu cầu:
{
"description": "new-media-item-description"
}
Nếu thành công, phản hồi sẽ trả về mục nội dung đa phương tiện đã cập nhật:
{
"id": "media-item-id",
"description": "new-media-item-description",
"productUrl": "media-item-product-url",
"baseUrl": "media-items-in-album",
"mimeType": "mime-type-of-media",
"mediaMetadata": {
...
},
"contributorInfo": {
...
},
"fileName": "item-filename"
}