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

Ngoài việc truy cập vào nội dung nghe nhìn sau khi tải lên các mục đó, bạn có thể cũng thay đổi nội dung mô tả của họ.

Phạm vi uỷ quyền bắt buộc

Để thay đổi mô tả của 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 một 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à thêm nội dung mô tả mới vào của bạn.

Để 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 nội dung nghe nhì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ả có thể 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ả về 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 những thuộc tính nào đang được cập nhật bằng cách bao gồm 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"
}

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
}

PHP

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
}