Notice: We're retiring Works with Nest. See the home page for more information.
Google は、黒人コミュニティのための人種的公平の促進に取り組んでいます。詳細をご覧ください。
このページは Cloud Translation API によって翻訳されました。
Switch to English

カメラAPI

Nest APIは、すべてのNestCam™モデルで動作します。

ユーザーは、 構造ごと最大数まで、複数のNestCamをdevices/camerasグループに追加できます。このデータの場所に電話をかけると、Nest Camデータ(構造内のデバイスのデータ値)にアクセスできます。

以下のすべての値は、JSONドキュメントの各devices/cameras/ device_idにあります。

デバイスID

NestCamの一意の識別子。

詳細
https://developer-api.nest.com/devices/cameras/ device_id /device_id
戻り値string
例:「awJo6rH ...」
アクセス読み取り専用
で利用可能カメラ読み取り/ v1-v3
カメラ読み取り+画像/ v1-v4
カメラの読み取り/書き込み/ v1-v3
カメラの読み取り/書き込み+画像/ v1-v4

ソフトウェアバージョン

ソフトウェアバージョン。

詳細
https://developer-api.nest.com/devices/cameras/ device_id /software_version
戻り値string
例:「4.0」
アクセス読み取り専用
で利用可能カメラ読み取り/ v1-v3
カメラ読み取り+画像/ v1-v4
カメラの読み取り/書き込み/ v1-v3
カメラの読み取り/書き込み+画像/ v1-v4

structure_id

構造体の一意の識別子。

詳細
https://developer-api.nest.com/devices/cameras/ device_id /structure_id
戻り値string
例:「VqFabWH21nw ...」
アクセス読み取り専用
で利用可能カメラ読み取り/ v1-v3
カメラ読み取り+画像/ v1-v4
カメラの読み取り/書き込み/ v1-v3
カメラの読み取り/書き込み+画像/ v1-v4

where_id

表すユニークな、ネスト、生成された識別子name 、デバイスの表示名。

名前場所についての詳細はこちら 巣のサーモスタット巣を保護し、巣カム

詳細
https://developer-api.nest.com/devices/cameras/ device_id /where_id
戻り値string
例:「d6reb_OZTM ...」
アクセス読み取り専用
で利用可能カメラ読み取り/ v1-v3
カメラ読み取り+画像/ v1-v4
カメラの読み取り/書き込み/ v1-v3
カメラの読み取り/書き込み+画像/ v1-v4

where_name

デバイスの表示名。 Nest where_idます。私たちが提供するリストからの任意の部屋名、またはカスタム名にすることができます。名前場所についての詳細はこちら 巣のサーモスタット巣を保護し、巣カム

詳細
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
例:「HallwayNest Cam(2階)」
アクセス読み取り専用
で利用可能カメラ読み取り/ v1-v3
カメラ読み取り+画像/ v1-v4
カメラの読み取り/書き込み/ v1-v3
カメラの読み取り/書き込み+画像/ v1-v4

オンラインです

Nestサービスとのデバイス接続ステータス。

詳細
https://developer-api.nest.com/devices/cameras/ device_id /is_online
戻り値boolean
値:true、false
アクセス読み取り専用
で利用可能カメラ読み取り/ v1-v3
カメラ読み取り+画像/ v1-v4
カメラの読み取り/書き込み/ v1-v3
カメラの読み取り/書き込み+画像/ v1-v4

is_streaming

オンでアクティブにストリーミングしているビデオ、またはオフのカメラステータス。詳細については、カメラがホーム/アウェイアシストどのように機能するかを参照してください。

詳細
https://developer-api.nest.com/devices/cameras/ device_id /is_streaming
戻り値boolean
値:true、false
アクセス読み書き
で利用可能カメラ読み取り/ v1-v3
カメラ読み取り+画像/ v1-v4
カメラの読み取り/書き込み/ v1-v3
カメラの読み取り/書き込み+画像/ v1-v4

is_audio_input_enabled

カメラのマイクのステータス(オンとリスニング、またはオフ)。 NestCamオーディオ設定の詳細をご覧ください。

詳細
https://developer-api.nest.com/devices/cameras/ device_id /is_audio_input_enabled
戻り値boolean
値:true、false
アクセス読み取り専用
で利用可能カメラ読み取り/ 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
値:true、false
アクセス読み取り専用
で利用可能カメラ読み取り/ v1-v3
カメラ読み取り+画像/ v1-v4
カメラの読み取り/書き込み/ v1-v3
カメラの読み取り/書き込み+画像/ v1-v4

web_url

home.nest.comのライブビデオストリームへのWebURL (ディープリンク)。

詳細
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

NestアプリのライブビデオストリームへのアプリのURL(ディープリンク)。

詳細
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
値:true、false
アクセス読み取り専用
で利用可能カメラ読み取り+画像/ v3-v4
カメラの読み取り/書き込み+画像/ v3-v4

activity_zones

定義されたすべてのアクティビティゾーンの配列を返します。

アクティビティゾーンは、ビデオストリームのユーザー定義領域内のモーションイベントを監視するために使用されます。必要で巣を意識

詳細
https://developer-api.nest.com/devices/cameras/ device_id /activity_zones
戻り値array
例: [ {"name" : " string1 ", "id" : " string2 "},... ]

string1はゾーン名であり、ユーザー定義であるか、ゾーンの作成時に自動的に生成されます。
string2は、アクティビティゾーンの作成時にNestによって割り当てられた識別子です。
アクセス読み取り専用
で利用可能カメラ読み取り+画像/ 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
  • NestAwareに登録しました

ストリームをアクティブに表示していない場合、またはNest Awareサブスクリプションがない場合、APIにはその解像度でスナップショットを取得するための1080pソースがなく、低品質の画像が生成されます。また、ローカルネットワークの帯域幅が低いと、NestAwareが存在する場合にAPIスナップショットの解像度が1080pを下回る可能性があります。

NestCameraの帯域幅要件の詳細をご覧ください。

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

このオブジェクトは、通知をトリガーした最後のイベントに関する情報をキャプチャします。

一部のフィールドと一部の権限の組み合わせでは、最後のイベント情報にアクセスするためにNestAwareサブスクリプションが必要です。

以下のすべての値は、JSONドキュメントの各devices/cameras/ device_id /last_eventにあります。

has_sound

サウンドイベント-サウンドが検出されました。

詳細
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_sound
戻り値boolean
値:true、false
アクセス読み取り専用
で利用可能カメラ読み取り/ v1-v3
カメラ読み取り+画像/ v1-v4
カメラの読み取り/書き込み/ v1-v3
カメラの読み取り/書き込み+画像/ v1-v4

has_motion

モーションイベント-モーションが検出されました。

詳細
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_motion
戻り値boolean
値:true、false
アクセス読み取り専用
で利用可能カメラ読み取り/ v1-v3
カメラ読み取り+画像/ v1-v4
カメラの読み取り/書き込み/ v1-v3
カメラの読み取り/書き込み+画像/ v1-v4

has_person

人物イベント-人物が検出されました。

詳細
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_person
戻り値boolean
値:true、false
アクセス読み取り専用
で利用可能カメラ読み取り/ 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

終了時間

ISO8601形式のイベント終了時刻。

詳細
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

これらのイベント関連URLの有効期限を識別するISO8601形式のタイムスタンプ:

有効期限は、 last_event/start_time + n日(Nest Awareサブスクリプションプランに応じて、n = 10日または30日)として計算されます。

必要で巣を意識

詳細
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

home.nest.comでの最後のサウンドまたはモーションイベントへのWebURL (ディープリンク)。最後に記録されたイベントを表示するために使用され、ユーザーはアカウントにサインインする必要があります。

必要で巣を意識。イベントURLの有効期限が切れているか、デバイスにアクティブなサブスクリプションがない場合、この値はペイロードに含まれません。

このURLの有効期限については、 last_event/urls_expire_timeを参照してください。

詳細
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

最後のサウンドまたはモーションイベントへのNestアプリのURL(ディープリンク)。最後に記録されたイベントを表示するために使用され、ユーザーはアカウントにサインインする必要があります。

必要で巣を意識。イベントURLの有効期限が切れているか、デバイスにアクティブなサブスクリプションがない場合、この値はペイロードに含まれません。

このURLの有効期限については、 last_event/urls_expire_timeを参照してください。

詳細
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(リンク)。

必要で巣を意識。このURLの有効期限については、 last_event/urls_expire_timeを参照してください。

詳細
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

animated_image_url

サウンドまたはモーションイベント用にキャプチャされたgifファイルへのURL(リンク)。

必要で巣を意識

詳細
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

モーションイベントを検出したアクティビティゾーンの識別子。

必要で巣を意識activity_zones配列とともに使用すると、これらのIDからゾーン名を取得できます。

last_event/has_motion

  • true =モーションイベントを検出したアクティビティゾーンIDを返します
  • false =空の配列を返します
詳細
https://developer-api.nest.com/devices/cameras/ device_id /last_event/activity_zone_ids
戻り値array
例: [ string1 , string2 ,... ]
アクセス読み取り専用
で利用可能カメラ読み取り+画像/ v3-v4
カメラの読み取り/書き込み+画像/ v3-v4