Method: mediaItems.list

Trả về danh sách các mục nội dung nghe nhìn do người dùng chọn trong phiên đã chỉ định.

Lỗi FAILED_PRECONDITION sẽ được trả về nếu người dùng chưa chọn xong các mục nội dung nghe nhìn cho phiên đã chỉ định. Trong trường hợp này, ứng dụng của bạn sẽ thăm dò ý kiến sessions.get cho đến khi phiên sẵn sàng trước khi thử lại phương thức này.

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 (bao gồm cả kết quả không có). Nếu không được chỉ định hoặc được đặt thành 0, hệ thống sẽ trả về tối đa 50 mục nội dung nghe nhìn. Giá trị tối đa là 100; các giá trị trên 100 sẽ được chuyển đổi 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 giá trị 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 phương thức 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)

Trang chứa các mục nội dung nghe nhìn đã chọn.

nextPageToken

string

Nếu được đặt, trường này có thể được dùng làm pageToken trong lệnh gọi mediaItems.list tiếp theo để truy xuất trang tiếp theo của các mục nội dung nghe nhìn đã chọn.

Nếu bạn bỏ qua trường này, thì sẽ không có trang tiếp theo.

Phạm vi uỷ quyền

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

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