Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

Camera API

API Nest hoạt động với tất cả các mẫu Nest CamTM.

Người dùng có thể thêm nhiều Nest Cam vào nhóm devices/cameras, tối đa theo cấu trúc tối đa. Khi gọi đến vị trí dữ liệu này, bạn có thể truy cập vào dữ liệu Nest Cam (giá trị dữ liệu cho các thiết bị trong cấu trúc).

Bạn có thể tìm thấy tất cả các giá trị bên dưới dưới mỗi devices/cameras/device_id trong tài liệu JSON.

mã_thiết_bị

Giá trị nhận dạng duy nhất của Nest Cam.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/device_id
Trả vềstring
Ví dụ: "awJo6rH..."
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc / v1-v3
Máy ảnh đọc + hình ảnh / v1-v4
Máy ảnh đọc/ghi / v1-v3
Máy ảnh đọc/ghi +hình ảnh / v1-v4

phiên bản phần mềm

Phiên bản phần mềm.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/software_version
Trả vềstring
Ví dụ: "4.0"
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc / v1-v3
Máy ảnh đọc + hình ảnh / v1-v4
Máy ảnh đọc/ghi/v1-v3
Máy ảnh đọc/ghi +hình ảnh/v1-v4

có_cấu_ trúc

Cấu trúc giá trị nhận dạng duy nhất.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/structure_id
Trả vềstring
Ví dụ: "VqFabWH21nw..."
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc / v1-v3
Máy ảnh đọc + hình ảnh / v1-v4
Máy ảnh đọc/ghi/v1-v3
Máy ảnh đọc/ghi +hình ảnh/v1-v4

trong_đây

Giá trị nhận dạng duy nhất do Nest tạo, đại diện cho name, tên hiển thị của thiết bị.

Tìm hiểu thêm về tên của Nest Thermostat, Nest ProtectsNest Cams.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/where_id
Trả vềstring
Ví dụ: "d6reb_OZTM..."
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc / v1-v3
Máy ảnh đọc + hình ảnh / v1-v4
Máy ảnh đọc/ghi / v1-v3
Máy ảnh đọc/ghi +hình ảnh / v1-v4

trong_đây

Tên hiển thị của thiết bị. Liên kết với Nest Cam where_id. Có thể là bất kỳ tên phòng nào từ danh sách mà chúng tôi cung cấp hoặc tên tùy chỉnh. Tìm hiểu thêm về tên của Nest Thermostat, Nest ProtectsNest Cams.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/where_name
Trả vềstring
Ví dụ: "Hallway"
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc / v3
Máy ảnh đọc + hình ảnh / v4
Máy ảnh đọc/ghi/v3
Máy ảnh đọc/ghi + hình ảnh/v4

tên

Tên hiển thị của thiết bị; có thể là tên phòng bất kỳ trong danh sách mà chúng tôi cung cấp hoặc một tên tùy chỉnh.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/name
Trả vềstring
Ví dụ: "Hallway"
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc / v1-v3
Máy ảnh đọc + hình ảnh / v1-v4
Máy ảnh đọc/ghi/v1-v3
Máy ảnh đọc/ghi +hình ảnh/v1-v4

tên_dài

Tên hiển thị dài của thiết bị. Bao gồm một nhãn (nhãn) tùy chỉnh, do người dùng tạo, hoặc thông qua wheres.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/name_long
Trả vềstring
Ví dụ: "Hallway Nest Cam (lên tầng trên)"
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc / v1-v3
Máy ảnh đọc + hình ảnh / v1-v4
Máy ảnh đọc/ghi / v1-v3
Máy ảnh đọc/ghi +hình ảnh / v1-v4

is_online

Trạng thái kết nối thiết bị với dịch vụ Nest.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/is_online
Trả vềboolean
Giá trị: true, false
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc / v1-v3
Máy ảnh đọc + hình ảnh / v1-v4
Máy ảnh đọc/ghi/v1-v3
Máy ảnh đọc/ghi +hình ảnh/v1-v4

is_streaming

Trạng thái máy ảnh, đang bật và chủ động phát trực tuyến hoặc tắt video. Hãy xem phần Cách camera hoạt động với dịch vụ Hỗ trợ tại nhà/vắng nhà để biết thêm thông tin.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/is_streaming
Trả vềboolean
Giá trị: true, false
Truy cậpđọc/ghi
Đã có tạiMáy ảnh đọc / v1-v3
Máy ảnh đọc + hình ảnh / v1-v4
Máy ảnh đọc/ghi/v1-v3
Máy ảnh đọc/ghi +hình ảnh/v1-v4

is_audio_input_Enabled

Trạng thái micrô của camera, đang bật và đang nghe hoặc đang tắt. Tìm hiểu thêm về chế độ cài đặt âm thanh Nest Cam.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/is_audio_input_enabled
Trả vềboolean
Giá trị: true, false
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc / v1-v3
Máy ảnh đọc + hình ảnh / v1-v4
Máy ảnh đọc/ghi/v1-v3
Máy ảnh đọc/ghi +hình ảnh/v1-v4

Last_is_online_change

Dấu thời gian xác định sự thay đổi gần đây nhất đối với trạng thái trực tuyến, ở định dạng ISO 8601.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/last_is_online_change
Trả vềstring
Ví dụ: "2016-12-29T18:42:00.000Z"
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc / v1-v3
Máy ảnh đọc + hình ảnh / v1-v4
Máy ảnh đọc/ghi / v1-v3
Máy ảnh đọc/ghi +hình ảnh / v1-v4

is_video_history_Enabled

Trạng thái gói đăng ký Nest Aware (gói đăng ký đang hoạt động hoặc không).

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/is_video_history_enabled
Trả vềboolean
Giá trị: true, false
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc / v1-v3
Máy ảnh đọc + hình ảnh / v1-v4
Máy ảnh đọc/ghi/v1-v3
Máy ảnh đọc/ghi +hình ảnh/v1-v4

web_url

URL của trang web (đường liên kết sâu) đến luồng video trực tiếp tại home.nest.com.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/web_url
Trả vềstring
Ví dụ: "https://home.nest.com/cameras/device_id?auth=camera_token"
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc / v1-v3
Máy ảnh đọc + hình ảnh / v1-v4
Máy ảnh đọc/ghi / v1-v3
Máy ảnh đọc/ghi +hình ảnh / v1-v4

app_url [url_ứng_dụng]

URL ứng dụng (đường liên kết sâu) đến luồng video trực tiếp trong ứng dụng Nest.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/app_url
Trả vềstring
Ví dụ: "nestmobile://cameras/device_id?auth=camera_token"
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc / v1-v3
Máy ảnh đọc + hình ảnh / v1-v4
Máy ảnh đọc/ghi / v1-v3
Máy ảnh đọc/ghi +hình ảnh / v1-v4

is_public_share_Enabled

Người dùng có thể chọn chia sẻ video và cho phép mọi người xem video đó. Khi bật tính năng chia sẻ công khai, bạn có thể đọc public_share_url.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/is_public_share_enabled
Trả vềboolean
Giá trị: true, false
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc + hình ảnh / v3-v4
Máy ảnh đọc/ghi + hình ảnh / v3-v4

vùng_hoạt_động

Trả về một mảng gồm tất cả các Vùng hoạt động đã xác định.

Vùng hoạt động được dùng để theo dõi các sự kiện chuyển động trong các khu vực do người dùng xác định trong luồng video. Cần có Nest Aware.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/activity_zones
Trả vềarray
Ví dụ: [ {"name" : "string1", "id" : "string2"},... ]

string1 là tên vùng, do người dùng xác định hoặc được tạo tự động khi vùng được tạo.
string2 là giá trị nhận dạng do Nest chỉ định khi tạo Khu vực hoạt động.
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc + hình ảnh / v3-v4
Máy ảnh đọc/ghi + hình ảnh / v3-v4

public_share_url

Bạn có thể truy cập URL này khi người dùng đặt luồng video công khai của họ.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/public_share_url
Trả vềstring
Ví dụ: "https://video.nest.com/live/string1?string2"

string1 là tên luồng video do người dùng xác định hoặc được tạo tự động khi luồng được đặt thành công khai.
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc + hình ảnh / v3-v4
Máy ảnh đọc/ghi + hình ảnh / v3-v4

trang_Tổng_ảnh_url

Chụp ảnh theo yêu cầu. Trả về URL của hình ảnh được chụp từ luồng video trực tiếp. Yêu cầu máy ảnh đang bật và đang phát trực tiếp.

Dùng trường này để xem thông tin tổng quan nhanh từ luồng video trực tiếp.

  • snapshot_url – trả về URL của hình ảnh được chụp từ luồng video trực tiếp
  • Yêu cầu máy ảnh phải đang bật và chủ động phát trực tuyến

Chất lượng ảnh chụp nhanh từ API chỉ là thông lượng 1080p nếu bạn:

  • đang chủ động xem luồng camera trong ứng dụng (web_url)
  • đang chủ động xem luồng công khai (app_url)
  • đã đăng ký Nest Aware

Nếu bạn không chủ động xem luồng hoặc không có gói đăng ký Nest Aware, thì API không có nguồn 1080p để truy xuất ảnh chụp nhanh ở độ phân giải đó và tạo hình ảnh chất lượng thấp hơn. Ngoài ra, băng thông mạng cục bộ thấp có thể khiến độ phân giải ảnh chụp nhanh API giảm xuống dưới 1080p khi có Nest Aware.

Tìm hiểu thêm về các yêu cầu về băng thông cho camera Nest.

Giới hạn giá áp dụng cho cuộc gọi này, tùy thuộc vào trạng thái đăng ký Nest Aware.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/snapshot_url
Trả vềstring
Ví dụ: "string1/device_id/string2?auth=camera_token"
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc + hình ảnh / v3-v4
Máy ảnh đọc/ghi + hình ảnh / v3-v4

sự kiện cuối cùng

Đối tượng này thu thập thông tin về sự kiện cuối cùng đã kích hoạt thông báo.

Một số trường và một số kiểu kết hợp quyền sẽ yêu cầu đăng ký Nest Aware để truy cập vào thông tin về sự kiện gần nhất.

Bạn có thể tìm thấy tất cả các giá trị bên dưới dưới mỗi devices/cameras/device_id/last_event trong tài liệu JSON.

có_âm thanh

Sự kiện âm thanh – đã phát hiện âm thanh.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/last_event/has_sound
Trả vềboolean
Giá trị: true, false
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc / v1-v3
Máy ảnh đọc + hình ảnh / v1-v4
Máy ảnh đọc/ghi / v1-v3
Máy ảnh đọc/ghi +hình ảnh / v1-v4

có_chuyển_động

Sự kiện chuyển động - đã phát hiện thấy chuyển động.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/last_event/has_motion
Trả vềboolean
Giá trị: true, false
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc / v1-v3
Máy ảnh đọc + hình ảnh / v1-v4
Máy ảnh đọc/ghi / v1-v3
Máy ảnh đọc/ghi +hình ảnh / v1-v4

có_người

Sự kiện người - đã phát hiện một người.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/last_event/has_person
Trả vềboolean
Giá trị: true, false
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc / v1-v3
Máy ảnh đọc + hình ảnh / v1-v4
Máy ảnh đọc/ghi / v1-v3
Máy ảnh đọc/ghi +hình ảnh / v1-v4

start_time [thời_gian_bắt_đầu]

Thời gian bắt đầu sự kiện, ở định dạng ISO 8601.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/last_event/start_time
Trả vềstring
Ví dụ: "2016-12-29T00:00:00.000Z"
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc / v1-v3
Máy ảnh đọc + hình ảnh / v1-v4
Máy ảnh đọc/ghi / v1-v3
Máy ảnh đọc/ghi +hình ảnh / v1-v4

end_time [thời_gian_kết_thúc]

Thời gian kết thúc sự kiện, ở định dạng ISO 8601.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/last_event/end_time
Trả vềstring
Ví dụ: "2016-12-29T00:00:00.000Z"
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc / v1-v3
Máy ảnh đọc + hình ảnh / v1-v4
Máy ảnh đọc/ghi/v1-v3
Máy ảnh đọc/ghi +hình ảnh/v1-v4

url_expire_time

Dấu thời gian, ở định dạng ISO 8601, cho biết thời điểm hết hạn các URL liên quan đến sự kiện sau đây:

Thời gian hết hạn được tính như sau: last_event/start_time + n ngày (trong đó n = 10 hoặc 30 ngày, tùy thuộc vào gói đăng ký Nest Aware).

Cần có Nest Aware.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/last_event/urls_expire_time
Trả vềstring
Ví dụ: "2016-12-29T00:00:00.000Z"
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc / v1-v3
Máy ảnh đọc + hình ảnh / v1-v4
Máy ảnh đọc/ghi / v1-v3
Máy ảnh đọc/ghi +hình ảnh / v1-v4

web_url

URL web (đường liên kết sâu) đến sự kiện âm thanh hoặc chuyển động cuối cùng tại home.nest.com. Dùng để hiển thị sự kiện được ghi lại gần đây nhất và yêu cầu người dùng đăng nhập vào tài khoản.

Cần có Nest Aware. Nếu URL sự kiện đã hết hạn hoặc thiết bị không có gói đăng ký đang hoạt động, thì giá trị này không được đưa vào tải trọng.

Hãy xem last_event/urls_expire_time để biết thông tin về thời gian hết hạn của URL này.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/last_event/web_url
Trả vềstring
Ví dụ: "https://home.nest.com/cameras/device_id/cuepoints/string?auth=camera_token"
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc / v1-v3
Máy ảnh đọc + hình ảnh / v1-v4
Máy ảnh đọc/ghi / v1-v3
Máy ảnh đọc/ghi +hình ảnh / v1-v4

app_url [url_ứng_dụng]

URL ứng dụng Nest (đường liên kết sâu) đến âm thanh hoặc sự kiện chuyển động gần đây nhất. Dùng để hiển thị sự kiện được ghi lại gần đây nhất và yêu cầu người dùng đăng nhập vào tài khoản.

Cần có Nest Aware. Nếu URL sự kiện đã hết hạn hoặc thiết bị không có gói đăng ký đang hoạt động, thì giá trị này không được đưa vào tải trọng.

Hãy xem last_event/urls_expire_time để biết thông tin về thời gian hết hạn của URL này.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/last_event/app_url
Trả vềstring
Ví dụ: "nestmobile://cameras/device_id/cuepoints/string?auth=camera_token"
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc / v1-v3
Máy ảnh đọc + hình ảnh / v1-v4
Máy ảnh đọc/ghi / v1-v3
Máy ảnh đọc/ghi +hình ảnh / v1-v4

image_url [url_hình_ảnh]

URL (đường liên kết) đến tệp hình ảnh được ghi lại cho một sự kiện âm thanh hoặc chuyển động.

Cần có Nest Aware. Hãy xem last_event/urls_expire_time để biết thông tin về thời gian hết hạn của URL này.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/last_event/image_url
Trả vềstring
Ví dụ: "https://www.dropcam.com/api/wwn.get_image/string1/device_id/string2?auth=camera_token"
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc + hình ảnh / v1-v4
Máy ảnh đọc/ghi + hình ảnh / v1-v4

hoạt_động_url_hình_ảnh

URL (đường liên kết) đến tệp gif đã ghi lại cho một sự kiện âm thanh hoặc chuyển động.

Cần có Nest Aware.

Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/last_event/animated_image_url
Trả vềstring
Ví dụ: "https://www.dropcam.com/api/wwn.get_image/string1/device_id/string2?auth=camera_token"
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc + hình ảnh / v1-v4
Máy ảnh đọc/ghi + hình ảnh / v1-v4

mã_khu_hoạt_động

Giá trị nhận dạng cho các Khu vực hoạt động đã phát hiện một sự kiện chuyển động.

Cần có Nest Aware. Khi được sử dụng với mảng activity_zones, bạn có thể lấy tên khu vực từ các mã này.

Nếu last_event/has_motion

  • true = trả về mã nhận dạng vùng hoạt động đã phát hiện một sự kiện chuyển động
  • false = trả về một mảng trống
Thông tin chi tiết
https://developer-api.nest.com/devices/cameras/device_id/last_event/activity_zone_ids
Trả vềarray
Ví dụ: [ string1, string2,... ]
Truy cậpchỉ có thể đọc
Đã có tạiMáy ảnh đọc + hình ảnh / v3-v4
Máy ảnh đọc/ghi + hình ảnh / v3-v4