Method: mediaItems.batchGet

Trả về danh sách các mục nội dung nghe nhìn cho giá trị nhận dạng mục nội dung nghe nhìn được chỉ định. Các mục được trả về theo thứ tự giống với giá trị nhận dạng được 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 nghe nhì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 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 được truy xuất. Xin lưu ý rằng ngay cả khi lệnh gọi đến mediaItems.batchGet thành công, một số mục nội dung nghe nhìn trong lô có thể vẫn không thành công. 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
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals

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 trong khi truy cập vào mục nội dung nghe nhìn này, trường này sẽ được điề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 nghe nhìn được truy xuất từ thư viện của người dùng. Thuộc tính này được điền sẵn nếu không có lỗi nào xảy ra và mục nội dung nghe nhìn được tìm nạp thành công.