Method: mediaItems.list

Liệt kê tất cả các mục nội dung nghe nhìn trong thư viện Google Photos của người dùng.

Yêu cầu HTTP

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

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

Tham số truy vấn

Thông số
pageSize

integer

Số mục nội dung đa phương tiện tối đa cần trả về trong phản hồi. Số lượng mục nội dung nghe nhìn được trả về có thể ít hơn số lượng đã chỉ định. pageSize mặc định là 25, tối đa là 100.
pageToken

string

Mã thông báo tiếp tục để nhận trang tiếp theo của kết quả. Việc thêm thông tin này vào yêu cầu sẽ trả về các hàng sau pageToken. pageToken phải là giá trị được trả về trong tham số nextPageToken khi phản hồi yêu cầu listMediaItems.

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

Danh sách tất cả các mục nội dung nghe nhìn trong thư viện Google Photos của người dùng.

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

object (MediaItem)

Chỉ có đầu ra. Danh sách các mục nội dung nghe nhìn trong thư viện của người dùng.
nextPageToken

string

Chỉ có đầu ra. Mã thông báo cần dùng để lấy tập hợp mục nội dung nghe nhìn tiếp theo. Sự hiện diện của thuộc tính này là chỉ báo đáng tin cậy duy nhất cho biết có thêm các mục nội dung nghe nhìn trong yêu cầu tiếp theo.

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