Method: mediaItems.list

Trả về danh sách các mục nội dung nghe nhìn xung quanh từ các nguồn nội dung nghe nhìn do người dùng định cấu hình cho thiết bị đã chỉ định.

Theo mặc định, listMediaItems cung cấp trải nghiệm Ambient, trả về một tập hợp các mục nội dung đa phương tiện được tuyển chọn từ tất cả các nguồn do người dùng định cấu hình.

Bạn có thể đưa mediaSourceId vào yêu cầu để truy xuất danh sách các mục được phân trang từ một nguồn nội dung nghe nhìn cụ thể, cho phép lọc theo cách truyền thống hơn.

Ứng dụng khách bị giới hạn ở mức 240 yêu cầu mỗi thiết bị mỗi ngày.

Lỗi FAILED_PRECONDITION sẽ xảy ra nếu người dùng chưa định cấu hình nguồn nội dung nghe nhìn nào.

Yêu cầu HTTP

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

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

Tham số truy vấn

Thông số
deviceId

string

Bắt buộc. Giá trị nhận dạng duy nhất của thiết bị này.
mediaSourceId

string

Không bắt buộc. Đối với trải nghiệm Ambient, hãy bỏ qua trường này. Thao tác này sẽ trả về một tập hợp các mục nội dung nghe nhìn được tuyển chọn từ tất cả các nguồn đã định cấu hình. Số lượng mục được trả về sẽ tuân theo yêu cầu pageSize của bạn, tối đa là 100 mục. Nếu bạn chỉ định, hệ thống sẽ chỉ trả về các mục từ nguồn nội dung nghe nhìn được chỉ định.

id phải là nguồn do người dùng chọn cho thiết bị được chỉ định (tức là một trong các AmbientDevice.media_sources.id).

Xin lưu ý rằng highlights không được hỗ trợ ngay cả khi đó là nguồn mà người dùng đã chọn cho thiết bị này. Việc đặt trường này thành highlights sẽ trả về lỗi INVALID_ARGUMENT.
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ụ sẽ thực hiện yêu cầu pageSize của bạn, mặc dù có thể trả về ít mục hơn so với chỉ định (bao gồm cả kết quả rỗng).

Nếu bạn không chỉ định hoặc đặt pageSize thành 0, thì hệ thống sẽ trả về tối đa 50 mục nội dung nghe nhìn. Các giá trị lớn hơn 100 sẽ bị ép xuống giá trị tối đa được phép là 100. Việc cung cấp 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 (AmbientMediaItem)
    }
  ],
  "nextPageToken": string
}
Trường
mediaItems[]

object (AmbientMediaItem)

Một trang gồm các mục nội dung nghe nhìn theo môi trường xung quanh để thiết bị hiển thị.
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ếu bạn bỏ qua trường này, thì điều đó không nhất thiết có nghĩa là không có nội dung nào khác để tìm nạp, mà có nghĩa là trang nội dung tiếp theo có thể chứa các mục nội dung đa phương tiện đã được trả về trong các trang trước.

Phạm vi uỷ quyền

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

  • https://www.googleapis.com/auth/photosambient.mediaitems