Method: mediaItems.list

Trả về danh sách các mục nội dung đa phương tiện do người dùng chọn trong phiên được chỉ định.

Lỗi FAILED_PRECONDITION sẽ được trả về nếu phiên chưa có mục nội dung đa phương tiện nào đã chọn và do đó không thể trả về nội dung đa phương tiện. Trong trường hợp này, các ứng dụng chạy trên thiết bị có đầu vào hạn chế sẽ hiển thị một mã QR mã hoá pickerUri của phiên, nhắc người dùng quét mã và chọn các mục nội dung đa phương tiện trong giao diện người dùng của Bộ chọn Google Photos. Trong khi đợi người dùng chọn mặt hàng, khách hàng nên thăm dò ý kiến sessions.get một lần mỗi pollingConfig.pollInterval cho đến pickedItemsSet = true trong phản hồi sessions.get. Khi đó, khách hàng có thể tiếp tục gọi mediaItems.list và muốn nhận được phản hồi thành công.

Yêu cầu HTTP

GET https://photospicker.googleapis.com/v1/mediaItems

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

Tham số truy vấn

Tham số
sessionId

string

Bắt buộc. Giá trị nhận dạng do Google tạo cho phiên này.
pageSize

integer

Không bắt buộc. Số lượng mục nội dung nghe nhìn tối đa cần trả về.

Dịch vụ có thể trả về ít hơn giá trị này (kể cả không có kết quả). Nếu bạn không chỉ định hoặc đặt thành 0, hệ thống sẽ trả về tối đa 50 mục nội dung đa phương tiện. Giá trị tối đa là 100; các giá trị lớn hơn 100 sẽ bị buộc thành 100. Giá trị âm sẽ dẫn đến lỗi INVALID_ARGUMENT.
pageToken

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi mediaItems.list trước đó. Cung cấp mã này để truy xuất trang tiếp theo.

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 cho RPC mediaItems.list.

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 
{
  "mediaItems": [
    {
      object (PickedMediaItem)
    }
  ],
  "nextPageToken": string
}
Trường
mediaItems[]

object (PickedMediaItem)

Một trang gồm các mục nội dung nghe nhìn đã chọn.
nextPageToken

string

Mã thông báo có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo trong yêu cầu mediaItems.list.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/photospicker.mediaitems.readonly