REST Resource: devices

Tài nguyên: AmbientDevice

Hình minh hoạ một thiết bị theo môi trường xung quanh.

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "displayName": string,
  "mediaSources": [
    {
      object (AmbientMediaSource)
    }
  ],
  "settingsUri": string,
  "createTime": string,
  "pollingConfig": {
    object (PollingConfig)
  },
  "mediaSourcesSet": boolean
}
Trường
id

string

Chỉ có đầu ra. Giá trị nhận dạng duy nhất của thiết bị này.
displayName

string

Bắt buộc. Tên hiển thị do người dùng xác định cho thiết bị này.

Người dùng sẽ thấy thông tin này trong phần cài đặt của ứng dụng Google Photos nhưng chỉ có thể chỉnh sửa thông tin này thông qua API này.

Tên hiển thị hợp lệ phải có từ 1 đến 100 ký tự (bao gồm cả hai giá trị này).
mediaSources[]

object (AmbientMediaSource)

Chỉ có đầu ra. Các nguồn nội dung nghe nhìn được đặt cho thiết bị này.

Nguồn nội dung nghe nhìn là các album hoặc bộ sưu tập ảnh mà người dùng chọn để hiển thị trên một thiết bị.

Xin lưu ý rằng giá trị này sẽ trống nếu người dùng chưa chọn nguồn nội dung đa phương tiện nào cho thiết bị này (tức là mediaSourcesSet = false).
settingsUri

string

Chỉ có đầu ra. URI dùng để chuyển hướng người dùng đến phần cài đặt của thiết bị trong ứng dụng Google Photos.
createTime

string (Timestamp format)

Chỉ có đầu ra. Thời gian tạo thiết bị này.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
pollingConfig

object (PollingConfig)

Chỉ có đầu ra. Cấu hình đề xuất mà các ứng dụng nên sử dụng trong khi thăm dò ý kiến devices.get.
mediaSourcesSet

boolean

Chỉ có đầu ra. Nếu được đặt, các nguồn nội dung nghe nhìn đã được định cấu hình cho thiết bị này và ứng dụng có thể yêu cầu danh sách các mục nội dung nghe nhìn cho thiết bị này.

AmbientMediaSource

Biểu thị nguồn nội dung đa phương tiện mà người dùng đã chọn cho thiết bị ở chế độ môi trường xung quanh.

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "displayName": string
}
Trường
id

string

Chỉ có đầu ra. Giá trị nhận dạng của nguồn nội dung nghe nhìn môi trường xung quanh.
displayName

string

Chỉ có đầu ra. Tên hiển thị của nguồn nội dung nghe nhìn này.

PollingConfig

Cấu hình để thăm dò ý kiến API.

Biểu diễn dưới dạng JSON 
{
  "pollInterval": string
}
Trường
pollInterval

string (Duration format)

Chỉ có đầu ra. Thời gian đề xuất giữa các yêu cầu thăm dò ý kiến.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".

Phương thức

create

 Tạo một thiết bị xung quanh trong tài khoản Google Photos của người dùng.

delete

 Xoá thiết bị đã chỉ định khỏi tài khoản Google Photos của người dùng.

get

 Truy xuất thông tin về thiết bị đã chỉ định.

patch

 Cập nhật thông tin về thiết bị đã chỉ định.