Google is committed to advancing racial equity for Black communities. See how.

Camera API Camera

Nest API ใช้งานได้กับ Nest Cam™ ทุกรุ่น

ผู้ใช้สามารถเพิ่มกล้อง Nest หลายกับ devices/cameras กลุ่มขึ้นไป สูงสุดต่อโครงสร้าง เมื่อคุณโทรไปยังตำแหน่งข้อมูลนี้ คุณจะเข้าถึงข้อมูล Nest Cam ได้ (ค่าข้อมูลสำหรับอุปกรณ์ในโครงสร้าง)

ทั้งหมดที่อยู่ด้านล่างค่าที่พบในแต่ละ devices/cameras/ device_id ในเอกสาร JSON

อุปกรณ์_id

ตัวระบุที่ไม่ซ้ำของ Nest Cam

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /device_id
คืนสินค้า string
ตัวอย่าง: "awJo6rH..."
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน / v1-v3
กล้องอ่าน + ภาพ / v1-v4
อ่าน/เขียนกล้อง / v1-v3
อ่าน/เขียนกล้อง + ภาพ / v1-v4

software_version

รุ่นซอฟต์แวร์

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /software_version
คืนสินค้า string
ตัวอย่าง: "4.0"
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน / v1-v3
กล้องอ่าน + ภาพ / v1-v4
อ่าน/เขียนกล้อง / v1-v3
อ่าน/เขียนกล้อง + ภาพ / v1-v4

โครงสร้าง_id

โครงสร้างตัวระบุที่ไม่ซ้ำ

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /structure_id
คืนสินค้า string
ตัวอย่าง: "VqFabWH21nw..."
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน / v1-v3
กล้องอ่าน + ภาพ / v1-v4
อ่าน/เขียนกล้อง / v1-v3
อ่าน/เขียนกล้อง + ภาพ / v1-v4

where_id

ที่ไม่ซ้ำกันระบุ Nest สร้างที่แสดงถึง name ชื่อที่แสดงของอุปกรณ์

เรียนรู้เพิ่มเติมเกี่ยวกับการที่ชื่อ Thermostats Nest ,Nest ปกป้อง และ กล้อง Nest

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /where_id
คืนสินค้า string
ตัวอย่าง: "d6reb_OZTM..."
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน / v1-v3
กล้องอ่าน + ภาพ / v1-v4
อ่าน/เขียนกล้อง / v1-v3
อ่าน/เขียนกล้อง + ภาพ / v1-v4

where_name

ชื่อที่แสดงของอุปกรณ์ ที่เกี่ยวข้องกับบแคมรัง where_id อาจเป็นชื่อห้องใดก็ได้จากรายการที่เราให้ไว้ หรือชื่อที่กำหนดเองก็ได้ เรียนรู้เพิ่มเติมเกี่ยวกับการที่ชื่อ Thermostats Nest ,Nest ปกป้อง และ กล้อง Nest

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /where_name
คืนสินค้า string
ตัวอย่าง: "โถงทางเดิน"
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน / v3
กล้องอ่าน + ภาพ / v4
อ่าน/เขียนกล้อง / v3
กล้องอ่าน/เขียน + ภาพ / v4

ชื่อ

ชื่อที่แสดงของอุปกรณ์; อาจเป็นชื่อห้องใดก็ได้จากรายการที่เราให้ไว้ หรือชื่อที่กำหนดเองก็ได้

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /name
คืนสินค้า string
ตัวอย่าง: "โถงทางเดิน"
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน / v1-v3
กล้องอ่าน + ภาพ / v1-v4
อ่าน/เขียนกล้อง / v1-v3
อ่าน/เขียนกล้อง + ภาพ / v1-v4

name_long

ชื่อที่แสดงแบบยาวของอุปกรณ์ รวมถึงการกำหนดเอง (ฉลาก) สร้างโดยผู้ใช้หรือผ่านทาง wheres

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /name_long
คืนสินค้า string
ตัวอย่าง: "Hallway Nest Cam (ชั้นบน)"
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน / v1-v3
กล้องอ่าน + ภาพ / v1-v4
อ่าน/เขียนกล้อง / v1-v3
อ่าน/เขียนกล้อง + ภาพ / v1-v4

is_online

สถานะการเชื่อมต่ออุปกรณ์กับบริการ Nest

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /is_online
คืนสินค้า boolean
ค่า: จริงเท็จ
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน / v1-v3
กล้องอ่าน + ภาพ / v1-v4
อ่าน/เขียนกล้อง / v1-v3
อ่าน/เขียนกล้อง + ภาพ / v1-v4

is_streaming

สถานะของกล้อง ไม่ว่าจะเปิดหรือปิดการสตรีมวิดีโอ ดู วิธีกล้องของคุณทำงานร่วมกับเจ้าบ้าน / ทีมเยือน Assist สำหรับข้อมูลเพิ่มเติม

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /is_streaming
คืนสินค้า boolean
ค่า: จริงเท็จ
เข้าไป อ่านเขียน
มีจำหน่ายใน กล้องอ่าน / v1-v3
กล้องอ่าน + ภาพ / v1-v4
อ่าน/เขียนกล้อง / v1-v3
อ่าน/เขียนกล้อง + ภาพ / v1-v4

is_audio_input_enabled

สถานะไมโครโฟนของกล้องไม่ว่าจะเปิดและฟังหรือปิด เรียนรู้เพิ่มเติมเกี่ยวกับ การตั้งค่าเสียง Nest Cam

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /is_audio_input_enabled
คืนสินค้า boolean
ค่า: จริงเท็จ
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน / v1-v3
กล้องอ่าน + ภาพ / v1-v4
อ่าน/เขียนกล้อง / v1-v3
อ่าน/เขียนกล้อง + ภาพ / v1-v4

last_is_online_change

การประทับเวลาที่ระบุการเปลี่ยนแปลงล่าสุดกับสถานะการออนไลน์ใน มาตรฐาน ISO 8601 รูปแบบ

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /last_is_online_change
คืนสินค้า string
ตัวอย่าง: "2016-12-29T18:42:00.000Z"
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน / v1-v3
กล้องอ่าน + ภาพ / v1-v4
อ่าน/เขียนกล้อง / v1-v3
อ่าน/เขียนกล้อง + ภาพ / v1-v4

is_video_history_enabled

Nest Aware สถานะการสมัครสมาชิก (สมัครสมาชิกใช้งานหรือไม่)

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /is_video_history_enabled
คืนสินค้า boolean
ค่า: จริงเท็จ
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน / v1-v3
กล้องอ่าน + ภาพ / v1-v4
อ่าน/เขียนกล้อง / v1-v3
อ่าน/เขียนกล้อง + ภาพ / v1-v4

web_url

URL เว็บ (ลิงก์) เพื่อวิดีโอสตรีมสดที่ home.nest.com

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /web_url
คืนสินค้า string
ตัวอย่าง: " https://home.nest.com/cameras/ device_id ?auth= camera_token "
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน / v1-v3
กล้องอ่าน + ภาพ / v1-v4
อ่าน/เขียนกล้อง / v1-v3
อ่าน/เขียนกล้อง + ภาพ / v1-v4

app_url

URL ของแอป (ลิงก์ในรายละเอียด) ไปยังสตรีมวิดีโอสดในแอป Nest

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /app_url
คืนสินค้า string
ตัวอย่าง: " nestmobile://cameras/ device_id ?auth= camera_token "
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน / v1-v3
กล้องอ่าน + ภาพ / v1-v4
อ่าน/เขียนกล้อง / v1-v3
อ่าน/เขียนกล้อง + ภาพ / v1-v4

is_public_share_enabled

ผู้ใช้สามารถเลือกที่จะ แบ่งปันวิดีโอของพวกเขา และทำให้มันดูได้โดยทุกคน เมื่อหุ้นของประชาชนถูกเปิดใช้งานคุณสามารถอ่าน public_share_url

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /is_public_share_enabled
คืนสินค้า boolean
ค่า: จริงเท็จ
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน + ภาพ / v3-v4
อ่าน/เขียนกล้อง + ภาพ / v3-v4

activity_zones

ส่งกลับอาร์เรย์ของโซนกิจกรรมที่กำหนดไว้ทั้งหมด

โซนกิจกรรม ที่ใช้ในการตรวจสอบเหตุการณ์การเคลื่อนไหวภายในพื้นที่ที่ผู้ใช้กำหนดสตรีมวิดีโอ ต้อง Nest Aware

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /activity_zones
คืนสินค้า array
ตัวอย่าง: [ {"name" : " string1 ", "id" : " string2 "},... ]

string1 เป็นชื่อโซนอย่างใดอย่างหนึ่งที่ผู้ใช้กำหนดหรือสร้างขึ้นโดยอัตโนมัติเมื่อโซนจะถูกสร้างขึ้น
string2 เป็นตัวระบุได้รับมอบหมายจากรังเมื่อกิจกรรมโซนจะถูกสร้างขึ้น
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน + ภาพ / v3-v4
อ่าน/เขียนกล้อง + ภาพ / v3-v4

public_share_url

คุณสามารถเข้าถึง URL นี้เมื่อผู้ใช้ของพวกเขาทำให้ ประชาชนวิดีโอสตรีม

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /public_share_url
คืนสินค้า string
ตัวอย่าง: " https://video.nest.com/live/ string1 ? string2 "

string1 เป็นชื่อวิดีโอสตรีมทั้งที่ผู้ใช้กำหนดหรือสร้างขึ้นโดยอัตโนมัติเมื่อกระแสถูกตั้งค่าให้กับประชาชน
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน + ภาพ / v3-v4
อ่าน/เขียนกล้อง + ภาพ / v3-v4

snapshot_url

จับภาพตามความต้องการ ส่งกลับ URL ของภาพที่ถ่ายจากสตรีมวิดีโอสด กำหนดให้กล้องเปิดอยู่และกำลังสตรีมอยู่

ใช้ฟิลด์นี้เพื่อรับสแน็ปช็อตจากสตรีมวิดีโอสด

  • snapshot_url - ส่งกลับ URL ของภาพที่บันทึกจากวิดีโอสตรีมสด
  • กำหนดให้กล้องเปิดอยู่และกำลังสตรีมอยู่

คุณภาพสแนปชอตจาก API มีปริมาณงานเพียง 1080p หากคุณ:

  • แข็งขันดูกระแสกล้องในการประยุกต์ใช้ ( web_url )
  • แข็งขันดูกระแสประชาชน ( app_url )
  • สมัครรับข้อมูล Nest Aware

หากคุณไม่ได้กำลังดูสตรีมอยู่หรือไม่ได้สมัครใช้บริการ Nest Aware API นั้นไม่มีแหล่งที่มา 1080p ที่จะดึงสแนปชอตที่ความละเอียดนั้นและสร้างภาพที่มีคุณภาพต่ำกว่า นอกจากนี้ แบนด์วิดท์เครือข่ายภายในที่ต่ำอาจทำให้ความละเอียดของสแนปชอต API ลดลงต่ำกว่า 1080p โดยมี Nest Aware อยู่

เรียนรู้เพิ่มเติมเกี่ยวกับ ความต้องการแบนด์วิดธ์สำหรับกล้อง Nest

ขีด จำกัด ของอัตรา นำไปใช้กับสายนี้ขึ้นอยู่กับ Nest Aware สถานะการสมัครสมาชิก

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /snapshot_url
คืนสินค้า string
ตัวอย่าง: " string1 / device_id / string2 ?auth= camera_token "
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน + ภาพ / v3-v4
อ่าน/เขียนกล้อง + ภาพ / v3-v4

last_event

ออบเจ็กต์นี้รวบรวมข้อมูลเกี่ยวกับเหตุการณ์ล่าสุดที่ทริกเกอร์การแจ้งเตือน

สาขาบางส่วนและบางชุดที่ได้รับอนุญาตต้องมี Nest Aware สมัครสมาชิกเพื่อเข้าถึงข้อมูลเหตุการณ์ที่ผ่านมา

ทั้งหมดที่อยู่ด้านล่างค่าที่พบในแต่ละ devices/cameras/ device_id /last_event ในเอกสาร JSON

has_sound

เหตุการณ์เสียง - ตรวจพบเสียง

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_sound
คืนสินค้า boolean
ค่า: จริงเท็จ
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน / v1-v3
กล้องอ่าน + ภาพ / v1-v4
อ่าน/เขียนกล้อง / v1-v3
อ่าน/เขียนกล้อง + ภาพ / v1-v4

has_motion

เหตุการณ์การเคลื่อนไหว - ตรวจพบการเคลื่อนไหว

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_motion
คืนสินค้า boolean
ค่า: จริงเท็จ
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน / v1-v3
กล้องอ่าน + ภาพ / v1-v4
อ่าน/เขียนกล้อง / v1-v3
อ่าน/เขียนกล้อง + ภาพ / v1-v4

has_person

เหตุการณ์บุคคล - ตรวจพบบุคคล

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_person
คืนสินค้า boolean
ค่า: จริงเท็จ
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน / v1-v3
กล้องอ่าน + ภาพ / v1-v4
อ่าน/เขียนกล้อง / v1-v3
อ่าน/เขียนกล้อง + ภาพ / v1-v4

เวลาเริ่มต้น

เวลาเริ่มต้นของเหตุการณ์ใน มาตรฐาน ISO 8601 รูปแบบ

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /last_event/start_time
คืนสินค้า string
ตัวอย่าง: "2016-12-29T00:00:00.000Z"
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน / v1-v3
กล้องอ่าน + ภาพ / v1-v4
อ่าน/เขียนกล้อง / v1-v3
อ่าน/เขียนกล้อง + ภาพ / v1-v4

end_time

เวลาสิ้นสุดเหตุการณ์ใน มาตรฐาน ISO 8601 รูปแบบ

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /last_event/end_time
คืนสินค้า string
ตัวอย่าง: "2016-12-29T00:00:00.000Z"
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน / v1-v3
กล้องอ่าน + ภาพ / v1-v4
อ่าน/เขียนกล้อง / v1-v3
อ่าน/เขียนกล้อง + ภาพ / v1-v4

urls_expire_time

การประทับเวลาใน การรับรองมาตรฐาน ISO 8601 รูปแบบที่ระบุวันหมดอายุของ URL ที่เกี่ยวข้องกับเหตุการณ์เหล่านี้:

เวลาหมดอายุจะถูกคำนวณเป็น: last_event/start_time n + วัน (ที่ n = 10 หรือ 30 วันขึ้นอยู่กับ Nest ทราบ แผนการสมัครสมาชิก )

ต้อง Nest Aware

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /last_event/urls_expire_time
คืนสินค้า string
ตัวอย่าง: "2016-12-29T00:00:00.000Z"
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน / v1-v3
กล้องอ่าน + ภาพ / v1-v4
อ่าน/เขียนกล้อง / v1-v3
อ่าน/เขียนกล้อง + ภาพ / v1-v4

web_url

URL เว็บ (ลิงก์) เพื่อเสียงที่ผ่านมาหรือเหตุการณ์การเคลื่อนไหวที่ home.nest.com ใช้เพื่อแสดงเหตุการณ์ที่บันทึกไว้ล่าสุด และกำหนดให้ผู้ใช้ลงชื่อเข้าใช้บัญชี

ต้อง Nest Aware หาก URL เหตุการณ์หมดอายุหรืออุปกรณ์ไม่มีการสมัครใช้งาน ค่านี้จะไม่รวมอยู่ในเพย์โหลด

ดู last_event/urls_expire_time สำหรับข้อมูลเกี่ยวกับเวลาหมดอายุของ URL นี้

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /last_event/web_url
คืนสินค้า string
ตัวอย่าง: " https://home.nest.com/cameras/ device_id /cuepoints/ string ?auth= camera_token "
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน / v1-v3
กล้องอ่าน + ภาพ / v1-v4
อ่าน/เขียนกล้อง / v1-v3
อ่าน/เขียนกล้อง + ภาพ / v1-v4

app_url

URL ของแอป Nest (ลิงก์ในรายละเอียด) ไปยังเหตุการณ์เสียงหรือการเคลื่อนไหวล่าสุด ใช้เพื่อแสดงเหตุการณ์ที่บันทึกไว้ล่าสุด และกำหนดให้ผู้ใช้ลงชื่อเข้าใช้บัญชี

ต้อง Nest Aware หาก URL เหตุการณ์หมดอายุหรืออุปกรณ์ไม่มีการสมัครใช้งาน ค่านี้จะไม่รวมอยู่ในเพย์โหลด

ดู last_event/urls_expire_time สำหรับข้อมูลเกี่ยวกับเวลาหมดอายุของ URL นี้

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /last_event/app_url
คืนสินค้า string
ตัวอย่าง: " nestmobile://cameras/ device_id /cuepoints/ string ?auth= camera_token "
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน / v1-v3
กล้องอ่าน + ภาพ / v1-v4
อ่าน/เขียนกล้อง / v1-v3
อ่าน/เขียนกล้อง + ภาพ / v1-v4

image_url

URL (ลิงก์) ไปยังไฟล์ภาพที่บันทึกสำหรับเหตุการณ์เสียงหรือการเคลื่อนไหว

ต้อง Nest Aware ดู last_event/urls_expire_time สำหรับข้อมูลเกี่ยวกับเวลาหมดอายุของ URL นี้

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /last_event/image_url
คืนสินค้า string
ตัวอย่าง: " https://www.dropcam.com/api/wwn.get_image/ string1 / device_id / string2 ?auth= camera_token "
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน + ภาพ / v1-v4
อ่าน/เขียนกล้อง + ภาพ / v1-v4

animation_image_url

URL (ลิงก์) ไปยังไฟล์ gif ที่บันทึกสำหรับเหตุการณ์เสียงหรือการเคลื่อนไหว

ต้อง Nest Aware

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /last_event/animated_image_url
คืนสินค้า string
ตัวอย่าง: " https://www.dropcam.com/api/wwn.get_image/ string1 / device_id / string2 ?auth= camera_token "
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน + ภาพ / v1-v4
อ่าน/เขียนกล้อง + ภาพ / v1-v4

activity_zone_ids

ตัวระบุสำหรับโซนกิจกรรมที่ตรวจพบเหตุการณ์การเคลื่อนไหว

ต้อง Nest Aware เมื่อใช้กับ activity_zones อาร์เรย์คุณจะได้รับชื่อโซนจากรหัสเหล่านี้

หาก last_event/has_motion มี

  • true = ส่งกลับรหัสโซนกิจกรรมที่ตรวจพบเหตุการณ์การเคลื่อนไหว
  • false = ส่งกลับอาร์เรย์ที่ว่างเปล่า
รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /last_event/activity_zone_ids
คืนสินค้า array
ตัวอย่าง: [ string1 , string2 ,... ]
เข้าไป อ่านเท่านั้น
มีจำหน่ายใน กล้องอ่าน + ภาพ / v3-v4
อ่าน/เขียนกล้อง + ภาพ / v3-v4