Method: mediaItems.batchGet

Trả về danh sách các 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 đã chỉ định. Các mặt hàng được trả lại theo cùng thứ tự với giá trị nhận dạng mà bạn 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

Tham số
mediaItemIds[]

string

Bắt buộc. Giá trị nhận dạng của 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. Bạn có thể truy xuất tối đa 50 mục nội dung nghe nhìn trong một lệnh gọi.

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 các 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. Xin lưu ý rằng ngay cả khi lệnh gọi đến mediaItems.batchGet thành công, có thể đã xảy ra lỗi đối với một số mục nội dung nghe nhìn trong lô. Những lỗi này được biểu thị 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 đây:

  • 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 nghe nhì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 mục nội dung đa phương tiện này, thì trường này sẽ được điền sẵn thông tin liên quan đến lỗi. Để 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 đã truy xuất từ thư viện của người dùng. Trường này được điền sẵn nếu không xảy ra lỗi và đã tìm nạp thành công mục nội dung đa phương tiện.