Quản lý các mục nội dung nghe nhìn

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 đa phương tiện, hãy tạo media items update call bằng giá trị nhận dạng của mục nội dung đa phương tiệ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 nghe nhì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"
}