Notice: We're retiring Works with Nest. See the home page for more information.
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.
Trang này được dịch bởi Cloud Translation API.
Switch to English

API camera

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

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

Tất cả các giá trị dưới đây được tìm thấy dưới mỗi devices/cameras/ device_id trong tài liệu JSON.

thiết bị

Nest Cam định danh duy nhất.

Chi tiết
https://developer-api.nest.com/devices/cameras/ device_id /device_id
Trả về string
Ví dụ: "awJo6rH ..."
Truy cập chỉ đọc
Có sẵn trong Má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.

Chi tiết
https://developer-api.nest.com/devices/cameras/ device_id /software_version
Trả về string
Ví dụ: "4.0"
Truy cập chỉ đọc
Có sẵn trong Má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ấu trúc_id

Cấu trúc định danh duy nhất.

Chi tiết
https://developer-api.nest.com/devices/cameras/ device_id /structure_id
Trả về string
Ví dụ: "VqFabWH21nw ..."
Truy cập chỉ đọc
Có sẵn trong Má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 đó

Một mã định danh duy nhất do Nest tạo ra đại diện cho name , tên hiển thị của thiết bị.

Tìm hiểu thêm về nơi đặt tên cho Nest Thermostats , Nest ProtectsNest Cam .

Chi tiết
https://developer-api.nest.com/devices/cameras/ device_id /where_id
Trả về string
Ví dụ: "d6reb_OZTM ..."
Truy cập chỉ đọc
Có sẵn trong Má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 đó tên

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 chúng tôi cung cấp hoặc tên tùy chỉnh. Tìm hiểu thêm về nơi đặt tên cho Nest Thermostats , Nest ProtectsNest Cam .

Chi tiết
https://developer-api.nest.com/devices/cameras/ device_id /where_name
Trả về string
Ví dụ: "Hành lang"
Truy cập chỉ đọc
Có sẵn trong Camera đọc / v3
Camera đọc + hình ảnh / v4
Camera đọc / ghi / v3
Camera đọc / ghi + hình ảnh / v4

Tên

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

Chi tiết
https://developer-api.nest.com/devices/cameras/ device_id /name
Trả về string
Ví dụ: "Hành lang"
Truy cập chỉ đọc
Có sẵn trong Má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 tùy chỉnh (nhãn), được tạo ra bởi người sử dụng, hoặc thông qua wheres .

Chi tiết
https://developer-api.nest.com/devices/cameras/ device_id /name_long
Trả về string
Ví dụ: "Hành lang Nest Cam (trên lầu)"
Truy cập chỉ đọc
Có sẵn trong Má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.

Chi tiết
https://developer-api.nest.com/devices/cameras/ device_id /is_online
Trả về boolean
Giá trị: đúng, sai
Truy cập chỉ đọc
Có sẵn trong Má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

đang truyền

Trạng thái máy ảnh, bật và chủ động truyền phát video hoặc tắt. Xem Cách máy ảnh của bạn hoạt động với Hỗ trợ Nhà / Đi để biết thêm thông tin.

Chi tiết
https://developer-api.nest.com/devices/cameras/ device_id /is_streaming
Trả về boolean
Giá trị: đúng, sai
Truy cập đọc viết
Có sẵn trong Má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_enables

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

Chi tiết
https://developer-api.nest.com/devices/cameras/ device_id /is_audio_input_enabled
Trả về boolean
Giá trị: đúng, sai
Truy cập chỉ đọc
Có sẵn trong Má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 thay đổi cuối cùng đối với trạng thái trực tuyến, ở định dạng ISO 8601 .

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ập chỉ đọc
Có sẵn trong Má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_enables

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

Chi tiết
https://developer-api.nest.com/devices/cameras/ device_id /is_video_history_enabled
Trả về boolean
Giá trị: đúng, sai
Truy cập chỉ đọc
Có sẵn trong Má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 (liên kết sâu) đến luồng video trực tiếp tại home.nest.com .

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ập chỉ đọc
Có sẵn trong Má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

ứng dụng

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

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ập chỉ đọc
Có sẵn trong Má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_enables

Người dùng có thể chọn chia sẻ video của mình và làm cho mọi người có thể xem được. Khi chia sẻ công khai được bật, bạn có thể đọc public_share_url .

Chi tiết
https://developer-api.nest.com/devices/cameras/ device_id /is_public_share_enabled
Trả về boolean
Giá trị: đúng, sai
Truy cập chỉ đọc
Có sẵn trong Máy ảnh đọc + hình ảnh / v3-v4
Máy ảnh đọc / ghi + hình ảnh / v3-v4

hoạt động_zones

Trả về một mảng của tất cả các Vùng hoạt động được xác định.

Các khu vực hoạt động được sử 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 của luồng video. Yêu cầu Nest Aware .

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à mã định danh được Nest gán khi Vùng hoạt động được tạo.
Truy cập chỉ đọc
Có sẵn trong Máy ảnh đọc + hình ảnh / v3-v4
Máy ảnh đọc / ghi + hình ảnh / v3-v4

công khai_share_url

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

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ập chỉ đọc
Có sẵn trong Máy ảnh đọc + hình ảnh / v3-v4
Máy ảnh đọc / ghi + hình ảnh / v3-v4

snapshot_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 được bật và chủ động phát trực tuyến.

Sử dụng trường này để có được một ảnh chụp 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 được bật và phát trực tiếp

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

  • tích cực xem luồng camera trong ứng dụng ( web_url )
  • tích cực 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ó đăng ký Nest Aware, API không có nguồn 1080p để lấy ảnh chụp nhanh ở độ phân giải đó và tạo ra 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 API giảm xuống dưới 1080p với phần mềm Nest Aware.

Tìm hiểu thêm về các yêu cầu băng thông cho Máy ảnh 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.

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ập chỉ đọc
Có sẵn trong Máy ảnh đọc + hình ảnh / v3-v4
Máy ảnh đọc / ghi + hình ảnh / v3-v4

sự kiện cuôi cung

Đối tượng này nắm bắt 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ố kết hợp quyền yêu cầu đăng ký Nest Aware để truy cập thông tin sự kiện cuối cùng.

Tất cả các giá trị dưới đây được tìm thấy dưới mỗi devices/cameras/ device_id /last_event trong tài liệu JSON.

has_sound

Sự kiện âm thanh - âm thanh đã được phát hiện.

Chi tiết
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_sound
Trả về boolean
Giá trị: đúng, sai
Truy cập chỉ đọc
Có sẵn trong Má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

has_motion

Sự kiện chuyển động - chuyển động đã được phát hiện.

Chi tiết
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_motion
Trả về boolean
Giá trị: đúng, sai
Truy cập chỉ đọc
Có sẵn trong Má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

has_person

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

Chi tiết
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_person
Trả về boolean
Giá trị: đúng, sai
Truy cập chỉ đọc
Có sẵn trong Má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

thời gian bắt đầu

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

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ập chỉ đọc
Có sẵn trong Má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

thời gian kết thúc

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

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ập chỉ đọc
Có sẵn trong Má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

urls_Exire_time

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

Thời gian hết hạn được tính là: 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).

Yêu cầu Nest Aware .

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ập chỉ đọc
Có sẵn trong Má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 (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 . Được sử 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 phải đăng nhập vào tài khoản.

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

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

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ập chỉ đọc
Có sẵn trong Má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

ứng dụng

URL ứng dụng Nest (liên kết sâu) đến sự kiện âm thanh hoặc chuyển động cuối cùng. Được sử 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 phải đăng nhập vào tài khoản.

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

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

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ập chỉ đọc
Có sẵn trong Má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 hình ảnh

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

Yêu cầu Nest Aware . Xem last_event/urls_expire_time để biết thông tin về thời gian hết hạn của URL này.

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ập chỉ đọc
Có sẵn trong Máy ảnh đọc + hình ảnh / v1-v4
Máy ảnh đọc / ghi + hình ảnh / v1-v4

anim_image_url

URL (liên kết) đến tệp gif được chụp cho một sự kiện âm thanh hoặc chuyển động.

Yêu cầu Nest Aware .

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ập chỉ đọc
Có sẵn trong Máy ảnh đọc + hình ảnh / v1-v4
Máy ảnh đọc / ghi + hình ảnh / v1-v4

hoạt động_zone_ids

Mã định danh cho Vùng hoạt động đã phát hiện sự kiện chuyển động.

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

Nếu last_event/has_motion

  • true = trả về id vùng hoạt động đã phát hiện sự kiện chuyển động
  • false = trả về một mảng trống
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ập chỉ đọc
Có sẵn trong Máy ảnh đọc + hình ảnh / v3-v4
Máy ảnh đọc / ghi + hình ảnh / v3-v4