DoorbellChime スキーマ

Google Nest Doorbell（旧型） Google Nest Doorbell（バッテリー式） Google Nest Doorbell（電源直結型） 

sdm.devices.traits.DoorbellChime

このトレイトは、ドアホンのチャイムと関連する押下イベントをサポートするデバイスに使用します。

フィールド

この特性で使用できるフィールドはありません。

コマンド

この特性で使用できるコマンドはありません。

イベント

チャイム

更新可能 

ドアホンが押されました。

このイベントは更新可能な通知をサポートしています。このイベントから作成された既存のアプリ通知は、同じ eventThreadId を持つ後続のイベントのコンテンツを使用して更新できます。

チャイム イベント

ペイロード

{
  "eventId" : "b7ff61c1-f441-48c5-81d2-c86d4a25ad60",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.DoorbellChime.Chime" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "fnQVSVAVVZWPSP1CVsDIQ67ES-..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

チャイム イベント フィールド

フィールド 説明 データ型
eventSessionId Google Nest Doorbell（Battery Type） Google Nest Doorbell（電源直結型） 関連する一連のイベントの 1 つのセッションの一部として発生するイベントに割り当てられる ID。イベントの統合に使用される場合があります。

このイベントを CameraClipPreview トレイトの関連する ClipPreview イベントに関連付けるために使用します。

 string
例: 「CjY5Y3VKaTZwR3o4Y19YbTVfMF...」
eventId Google Nest Doorbell（旧型） イベントに関連付けられた ID。

このイベントに関連するカメラ画像をダウンロードするには、GenerateImage コマンドとともに使用します。

 string
例: 「fnQVSVAVVZWPSP1CVsDIQ67ES-...」

イベント ペイロード フィールド

フィールド 説明 データ型
eventId イベントの一意の識別子。 string
例: 「b7ff61c1-f441-48c5-81d2-c86d4a25ad60」
timestamp イベントが発生した時刻。 string
例: 「2019-01-01T00:00:01Z」
resourceUpdate リソースの更新に関する詳細情報を含むオブジェクト。 object
userId ユーザーを表す一意の難読化された識別子。 string
例: 「AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi」
eventThreadId 更新可能 イベント スレッドの一意の識別子。 string
例: 「d67cd3f7-86a7-425e-8bb3-462f92ec9f59」
eventThreadState 更新可能 イベント スレッドの状態。 string
値: 「STARTED」、「UPDATED」、「ENDED」
resourceGroup このイベントと同様の更新が行われる可能性があるリソースを示すオブジェクト。イベント自体のリソース（resourceUpdate オブジェクトから）は、常にこのオブジェクトに存在します。 object

さまざまなタイプのイベントとその仕組みについては、イベントをご覧ください。

エラー

このトレイトに関連して、次のエラーコードが返されることがあります。

エラー メッセージ RPC トラブルシューティング
カメラの画像はダウンロードできなくなりました。 DEADLINE_EXCEEDED イベント画像は、イベントの公開から 30 秒後に期限切れになります。有効期限が切れる前に必ず画像をダウンロードしてください。
イベント ID がカメラに属していません。 FAILED_PRECONDITION カメラ イベントから返された正しい eventID を使用します。

API エラーコードの一覧については、API エラーコードのリファレンスをご覧ください。