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

Ngoài việc accessing vào 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

Để thay đổi nội dung mô tả các mục nội dung đa phương tiện sau khi tạo, hãy sử dụng phạm vi photoslibrary.edit.appcreateddata.

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 với 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 đa phương tiện, ứng dụng của bạn phải tải mục nội dung đa phương tiện đó lên và người dùng hiện đã 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ự.

Kiến trúc chuyển trạng thái đại diện (REST)

Dưới đây là tiêu đề của yêu cầu PATCH để cập nhật nội dung mô tả mục nội dung đa phương tiện:

PATCH https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id?updateMask=description

Yêu cầu này xác định các thuộc tính đang được cập nhật bằng cách bao gồm một mặt nạ trường (field mask) đượ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 của 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"
}

Java

try {
  // Update the description of the media item.
  // The new description must not be null.
  MediaItem updatedItem = photosLibraryClient.updateMediaItemDescription(mediaItem, "new-media-item-description");
} catch (ApiException e) {
  // Handle error
}

1.199

try {

    // ID of the media item to update.
    $mediaItemId = "MEDIA_ITEM_ID";

    // New description of the media item.
    $newDescription = "new-media-item-description";

    // Update the description of the media item identified.
    $mediaItem = $photosLibraryClient->updateMediaItemDescription($mediaItemId, $newDescription);

} catch (\Google\ApiCore\ApiException $e) {
    // Handle error
}