Camera API

Nest API ทำงานร่วมกับ Nest Cam ™ทุกรุ่น

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

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

device_id

ตัวระบุเฉพาะของ Nest Cam

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

software_version

เวอร์ชันซอฟต์แวร์

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

โครงสร้าง _id

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

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

where_id

ตัวระบุเฉพาะที่สร้างขึ้นโดย Nest ซึ่งแสดงถึง name ซึ่งเป็น name ที่แสดงของอุปกรณ์

เรียนรู้เพิ่มเติมเกี่ยวกับตำแหน่งของชื่อ Nest Thermostats ,Nest Protects และ Nest Cams

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

where_name

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

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

ชื่อ

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

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

name_long

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

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

is_online

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

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

is_streaming

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

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

is_audio_input_enabled

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

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

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.0 กล้องอ่าน + ภาพ / v1-v4.0 กล้องอ่าน / เขียน / v1-v3.0 กล้องอ่าน / เขียน + ภาพ / v1-v4.0

is_video_history_enabled

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

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

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.0 กล้องอ่าน + ภาพ / v1-v4.0 กล้องอ่าน / เขียน / v1-v3.0 กล้องอ่าน / เขียน + ภาพ / v1-v4.0

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.0 กล้องอ่าน + ภาพ / v1-v4.0 กล้องอ่าน / เขียน / v1-v3.0 กล้องอ่าน / เขียน + ภาพ / v1-v4.0

is_public_share_enabled

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

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

activity_zones

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

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

รายละเอียด
https://developer-api.nest.com/devices/cameras/ device_id /activity_zones
ผลตอบแทน	array ตัวอย่าง: [ {"name" : " string1 ", "id" : " string2 "},... ] • string1 คือชื่อโซนที่ผู้ใช้กำหนดเองหรือสร้างขึ้นโดยอัตโนมัติเมื่อสร้างโซน • string2 คือตัวระบุที่ Nest กำหนดให้เมื่อสร้างโซนกิจกรรม
เข้าไป	อ่านเท่านั้น
มีจำหน่ายใน	กล้องอ่าน + ภาพ / v3-v4.0 กล้องอ่าน / เขียน + ภาพ / v3-v4.0

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.0 กล้องอ่าน / เขียน + ภาพ / v3-v4.0

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.0 กล้องอ่าน / เขียน + ภาพ / v3-v4.0

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.0 กล้องอ่าน + ภาพ / v1-v4.0 กล้องอ่าน / เขียน / v1-v3.0 กล้องอ่าน / เขียน + ภาพ / v1-v4.0

has_motion

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

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

has_person

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

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

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

เวลาเริ่มต้นของกิจกรรมในรูปแบบ ISO 8601

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

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.0 กล้องอ่าน + ภาพ / v1-v4.0 กล้องอ่าน / เขียน / v1-v3.0 กล้องอ่าน / เขียน + ภาพ / v1-v4.0

urls_expire_time

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

• last_event/web_url
• last_event/app_url
• last_event/image_url
• last_event/animated_image_url

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

ต้องใช้ 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.0 กล้องอ่าน + ภาพ / v1-v4.0 กล้องอ่าน / เขียน / v1-v3.0 กล้องอ่าน / เขียน + ภาพ / v1-v4.0

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.0 กล้องอ่าน + ภาพ / v1-v4.0 กล้องอ่าน / เขียน / v1-v3.0 กล้องอ่าน / เขียน + ภาพ / v1-v4.0

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.0 กล้องอ่าน + ภาพ / v1-v4.0 กล้องอ่าน / เขียน / v1-v3.0 กล้องอ่าน / เขียน + ภาพ / v1-v4.0

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.0 กล้องอ่าน / เขียน + ภาพ / v1-v4.0

animated_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.0 กล้องอ่าน / เขียน + ภาพ / v1-v4.0

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.0 กล้องอ่าน / เขียน + ภาพ / v3-v4.0