Method: devices.list

Liệt kê các thiết bị môi trường xung quanh được kết nối với tài khoản của người dùng đã xác thực. Chỉ trả về các thiết bị do ứng dụng gọi tạo.

Yêu cầu HTTP

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

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

Tham số truy vấn

Tham số
pageSize

integer

Không bắt buộc. Số lượng thiết bị 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, thì hệ thống sẽ trả về tối đa 50 thiết bị. 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 devices.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 devices.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 
{
  "devices": [
    {
      object (AmbientDevice)
    }
  ],
  "nextPageToken": string
}
Trường
devices[]

object (AmbientDevice)

Một trang về các thiết bị môi trường xung quanh được kết nối với tài khoản Google Photos của người dùng.
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 devices.list.

Nếu trường này bị bỏ qua 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/photosambient.mediaitems