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 máy ảnh

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

Người dùng có thể thêm nhiều Nest Cam vào nhóm devices/cameras , tối đa cho mỗi cấu trúc . Khi 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 trong mỗi devices/cameras/ device_id trong tài liệu JSON.

device_id

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

Chi tiết
https://developer-api.nest.com/devices/cameras/ device_id /device_id
Lợi nhuận string
Ví dụ: "awJo6rH ..."
Truy cập chỉ đọc
Có sẵn trong Camera đọc / v1-v3
Camera đọc + hình ảnh / v1-v4
Camera đọc / ghi / v1-v3
Camera đọ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
Lợi nhuận string
Ví dụ: "4.0"
Truy cập chỉ đọc
Có sẵn trong Camera đọc / v1-v3
Camera đọc + hình ảnh / v1-v4
Camera đọc / ghi / v1-v3
Camera đọc / ghi + hình ảnh / v1-v4

cấu_tục

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

Chi tiết
https://developer-api.nest.com/devices/cameras/ device_id /structure_id
Lợi nhuận string
Ví dụ: "VqFabWH21nw ..."
Truy cập chỉ đọc
Có sẵn trong Camera đọc / v1-v3
Camera đọc + hình ảnh / v1-v4
Camera đọc / ghi / v1-v3
Camera đọc / ghi + hình ảnh / v1-v4

where_id

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ề vị trí đặt tên cho Nest Thermostat ,Nest ProtectNest Cam .

Chi tiết
https://developer-api.nest.com/devices/cameras/ device_id /where_id
Lợi nhuận string
Ví dụ: "d6reb_OZTM ..."
Truy cập chỉ đọc
Có sẵn trong Camera đọc / v1-v3
Camera đọc + hình ảnh / v1-v4
Camera đọc / ghi / v1-v3
Camera đọc / ghi + hình ảnh / v1-v4

where_name

Tên hiển thị của thiết bị. Được liên kết với where_id của Nest Cam. 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ề vị trí đặt tên cho Nest Thermostat ,Nest ProtectNest Cam .

Chi tiết
https://developer-api.nest.com/devices/cameras/ device_id /where_name
Lợi nhuận 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 từ danh sách chúng tôi cung cấp hoặc một tên tùy chỉnh.

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

name_long

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

Chi tiết
https://developer-api.nest.com/devices/cameras/ device_id /name_long
Lợi nhuận string
Ví dụ: "Hallway Nest Cam (trên lầu)"
Truy cập chỉ đọc
Có sẵn trong Camera đọc / v1-v3
Camera đọc + hình ảnh / v1-v4
Camera đọc / ghi / v1-v3
Camera đọ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
Lợi nhuận boolean
Giá trị: true, false
Truy cập chỉ đọc
Có sẵn trong Camera đọc / v1-v3
Camera đọc + hình ảnh / v1-v4
Camera đọc / ghi / v1-v3
Camera đọc / ghi + hình ảnh / v1-v4

is_streaming

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

Chi tiết
https://developer-api.nest.com/devices/cameras/ device_id /is_streaming
Lợi nhuận boolean
Giá trị: true, false
Truy cập đọc viết
Có sẵn trong Camera đọc / v1-v3
Camera đọc + hình ảnh / v1-v4
Camera đọc / ghi / v1-v3
Camera đọc / ghi + hình ảnh / v1-v4

is_audio_input_enabled

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
Lợi nhuận boolean
Giá trị: true, false
Truy cập chỉ đọc
Có sẵn trong Camera đọc / v1-v3
Camera đọc + hình ảnh / v1-v4
Camera đọc / ghi / v1-v3
Camera đọ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
Lợi nhuận string
Ví dụ: "2016-12-29T18: 42: 00.000Z"
Truy cập chỉ đọc
Có sẵn trong Camera đọc / v1-v3
Camera đọc + hình ảnh / v1-v4
Camera đọc / ghi / v1-v3
Camera đọc / ghi + hình ảnh / v1-v4

is_video_history_enabled

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
Lợi nhuận boolean
Giá trị: true, false
Truy cập chỉ đọc
Có sẵn trong Camera đọc / v1-v3
Camera đọc + hình ảnh / v1-v4
Camera đọc / ghi / v1-v3
Camera đọc / ghi + hình ảnh / v1-v4

web_url

URL web (liên kết sâu) tới 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
Lợi nhuận string
Ví dụ: " https://home.nest.com/cameras/ device_id ?auth= camera_token "
Truy cập chỉ đọc
Có sẵn trong Camera đọc / v1-v3
Camera đọc + hình ảnh / v1-v4
Camera đọc / ghi / v1-v3
Camera đọc / ghi + hình ảnh / v1-v4

app_url

URL ứng dụng (liên kết sâu) tới 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
Lợi nhuận string
Ví dụ: " nestmobile://cameras/ device_id ?auth= camera_token "
Truy cập chỉ đọc
Có sẵn trong Camera đọc / v1-v3
Camera đọc + hình ảnh / v1-v4
Camera đọc / ghi / v1-v3
Camera đọc / ghi + hình ảnh / v1-v4

is_public_share_enabled

Người dùng có thể chọn chia sẻ video của họ và làm cho video đó có thể xem được bởi bất kỳ ai. 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
Lợi nhuận boolean
Giá trị: true, false
Truy cập chỉ đọc
Có sẵn trong Camera đọc + hình ảnh / v3-v4
Camera đọc / ghi + hình ảnh / v3-v4

Activity_zones

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

Vùng 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
Lợi nhuận 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à số nhận dạng được Nest gán khi Vùng hoạt động được tạo.
Truy cập chỉ đọc
Có sẵn trong Camera đọc + hình ảnh / v3-v4
Camera đọ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ủa họ ở chế độ công khai .

Chi tiết
https://developer-api.nest.com/devices/cameras/ device_id /public_share_url
Lợi nhuận 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 Camera đọc + hình ảnh / v3-v4
Camera đọ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 đang bật và đang phát trực tiếp.

Sử dụng trường này để có ả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 bật camera và phát trực tuyến tích cực

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

  • 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, thì API không có nguồn 1080p để lấy ả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ề yêu cầu băng thông đối với Nest Camera .

Giới hạn cước á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
Lợi nhuận string
Ví dụ: " string1 / device_id / string2 ?auth= camera_token "
Truy cập chỉ đọc
Có sẵn trong Camera đọc + hình ảnh / v3-v4
Camera đọ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ố 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 trong 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
Lợi nhuận boolean
Giá trị: true, false
Truy cập chỉ đọc
Có sẵn trong Camera đọc / v1-v3
Camera đọc + hình ảnh / v1-v4
Camera đọc / ghi / v1-v3
Camera đọ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
Lợi nhuận boolean
Giá trị: true, false
Truy cập chỉ đọc
Có sẵn trong Camera đọc / v1-v3
Camera đọc + hình ảnh / v1-v4
Camera đọc / ghi / v1-v3
Camera đọc / ghi + hình ảnh / v1-v4

has_ person

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

Chi tiết
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_person
Lợi nhuận boolean
Giá trị: true, false
Truy cập chỉ đọc
Có sẵn trong Camera đọc / v1-v3
Camera đọc + hình ảnh / v1-v4
Camera đọc / ghi / v1-v3
Camera đọ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
Lợi nhuận string
Ví dụ: "2016-12-29T00: 00: 00.000Z"
Truy cập chỉ đọc
Có sẵn trong Camera đọc / v1-v3
Camera đọc + hình ảnh / v1-v4
Camera đọc / ghi / v1-v3
Camera đọ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
Lợi nhuận string
Ví dụ: "2016-12-29T00: 00: 00.000Z"
Truy cập chỉ đọc
Có sẵn trong Camera đọc / v1-v3
Camera đọc + hình ảnh / v1-v4
Camera đọc / ghi / v1-v3
Camera đọc / ghi + hình ảnh / v1-v4

urls_expire_time

Dấu thời gian, ở định dạng ISO 8601 , xác định thời hạn của 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
Lợi nhuận string
Ví dụ: "2016-12-29T00: 00: 00.000Z"
Truy cập chỉ đọc
Có sẵn trong Camera đọc / v1-v3
Camera đọc + hình ảnh / v1-v4
Camera đọc / ghi / v1-v3
Camera đọ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 đă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ý đang 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
Lợi nhuận string
Ví dụ: " https://home.nest.com/cameras/ device_id /cuepoints/ string ?auth= camera_token "
Truy cập chỉ đọc
Có sẵn trong Camera đọc / v1-v3
Camera đọc + hình ảnh / v1-v4
Camera đọc / ghi / v1-v3
Camera đọc / ghi + hình ảnh / v1-v4

app_url

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 đă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ý đang 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
Lợi nhuận string
Ví dụ: " nestmobile://cameras/ device_id /cuepoints/ string ?auth= camera_token "
Truy cập chỉ đọc
Có sẵn trong Camera đọc / v1-v3
Camera đọc + hình ảnh / v1-v4
Camera đọc / ghi / v1-v3
Camera đọ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
Lợi nhuận 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 Camera đọc + hình ảnh / v1-v4
Camera đọc / ghi + hình ảnh / v1-v4

animation_image_url

URL (liên kết) tới tệp gif được ghi lại 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
Lợi nhuận 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 Camera đọc + hình ảnh / v1-v4
Camera đọc / ghi + hình ảnh / v1-v4

activity_zone_ids

Số nhận dạng cho Vùng hoạt động đã phát hiện một 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 một 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
Lợi nhuận array
Ví dụ: [ string1 , string2 ,... ]
Truy cập chỉ đọc
Có sẵn trong Camera đọc + hình ảnh / v3-v4
Camera đọc / ghi + hình ảnh / v3-v4