Method: mediaItems.batchGet

Trả về danh sách mục nội dung đa phương tiện cho giá trị nhận dạng mục nội dung đa phương tiện được chỉ định. Các mặt hàng được trả lại theo thứ tự giống với giá trị nhận dạng đã cung cấp.

Yêu cầu HTTP

GET https://photoslibrary.googleapis.com/v1/mediaItems:batchGet

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số truy vấn

Thông số
mediaItemIds[]

string

Bắt buộc. Giá trị nhận dạng của các mục nội dung đa phương tiện cần yêu cầu. Không được chứa giá trị nhận dạng lặp lại và không được để trống. Số lượng mục nội dung nghe nhìn tối đa có thể truy xuất trong một lệnh gọi là 50.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Phản hồi để truy xuất danh sách mục nội dung nghe nhìn.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "mediaItemResults": [
    {
      object (MediaItemResult)
    }
  ]
}
Trường
mediaItemResults[]

object (MediaItemResult)

Chỉ có đầu ra. Danh sách các mục nội dung nghe nhìn đã truy xuất. Lưu ý rằng ngay cả khi lệnh gọi đến mediaItems.batchGet thành công, vẫn có thể đã có lỗi đối với một số mục nội dung đa phương tiện trong lô đó. Những lỗi này được nêu rõ trong từng MediaItemResult.status.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.readonly
  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata

MediaItemResult

Kết quả truy xuất một mục nội dung đa phương tiện.

Biểu diễn dưới dạng JSON 
{
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
Trường
status

object (Status)

Nếu đã xảy ra lỗi khi truy cập vào mục nội dung đa phương tiện này, thì hệ thống sẽ điền thông tin liên quan đến lỗi vào trường này. Để biết thông tin chi tiết về trường này, hãy xem Status.
mediaItem

object (MediaItem)

Mục nội dung đa phương tiện được truy xuất từ thư viện của người dùng. Hệ thống sẽ điền giá trị này nếu không có lỗi nào xảy ra và mục nội dung đa phương tiện đã được tìm nạp thành công.