Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
หน้านี้ได้รับการแปลโดย Cloud Translation API
Switch to English

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/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