API エラーコード リファレンス

Smart Device Management API は、標準の gRPC エラーコードを使用します。これらのコードの詳細については、エラー処理をご覧ください。

API のエラー レスポンスは次のような形式で表示されます。

{
  "error": {
    "code": 404,
    "message": "Device enterprises/project-id/devices/device-id not found.",
    "status": "NOT_FOUND"
  }
}

[エラーコード] テーブルの検索ボックスを使用すると、API エラー、トラブルシューティングのヒント、関連するトレイトやガイドを検索できます。テーブル内の任意のフィールドでコンテンツを検索できます。

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

こちらもご覧ください:
  {/1{1/2} {/1{1/2} {/1{1/2}{1/2.com{1/2}{1/2}{1/5 / 2 {1/2]








ドアホンではコマンドを使用できません。 400 FAILED_PRECONDITION バッテリー式のドアホンの場合、WebRTC ストリームを拡張することはできません。ドアホンのストリームを最初のセッション継続時間を超えて視聴する必要がある場合は、既存のストリームを停止し、新しいストリームを生成します。

こちらもご覧ください:
  ライブ ストリームを拡張するタスク
  ExtendWebRtcStream コマンド
現在のサーモスタット モードではコマンドを使用できません。 400 FAILED_PRECONDITION 一部のサーモスタットでは、 ThermostatMode トレイトに応じて、サーモスタット モードがオフのときにエコモードを変更できません。エコモードを変更する前に、サーモスタット モードを HEAT、COOL、HEATCOOL のいずれかに変更する必要があります。
詳細:
  モードの変更タスク
  SetMode コマンド
  ThermostatMode trait


サーモスタットが MANUAL_ECO モードのときは使用できません。 400 FAILED_PRECONDITION サーモスタットが手動エコモードになっている場合は、温度設定値を設定できません。

詳細:
  設定温度を変更するタスク
  ThermostatEco トレイト
  ThermostatTemperatureSetpoint
コマンドが指定されていません。 404 NOT_FOUND リクエスト本文に有効なコマンド名がないコマンドが実行されました。有効なコマンドを入力してください。
コマンドはサポートされていません。 400 INVALID_ARGUMENT WebRTC に対応したカメラに対して RTSP ライブ ストリーム コマンドを使用したか、RTSP をサポートするカメラに対して WebRTC ライブストリーム コマンドを使用しました。

関連情報:
  カメラ画像をダウンロードするタスク
無効な値が含まれています。 400 INVALID_ARGUMENT 引数に無効な値を指定してコマンドが送信されました。有効な値を送信してください。
冷房の値は暖房の値よりも大きくする必要があります。 400 INVALID_ARGUMENT heatCelsius フィールドがコマンドの coolCelsius フィールドよりも小さいことを確認してください。

関連情報:
  温度設定値を変更するタスク
  ThermostatTemperatureSetpoint トレイト
デバイスが見つかりません。 404 NOT_FOUND デバイス名が無効であるか存在しません。有効なデバイスを指定してください。

こちらもご覧ください:
  接続 トレイト
企業が見つかりません。 404 NOT_FOUND Project ID が無効であるか存在しません。有効な Project ID を指定してください。
アクティビティ ID がカメラに属していません。 400 FAILED_PRECONDITION カメラ アクティビティで返された正しい eventID を使用できます。

以下もご覧ください。
  {44{4 / 4 / 4 (4 担当チーム向け)








タイムアウトにより回答 SDP を取得できませんでした。 504 DEADLINE_EXCEEDED WebRTC ライブ ストリームを再度生成してみてください。

関連情報:
フィールドがトレイトに含まれていません。 400 INVALID_ARGUMENT サポートされていないコマンドがトレイトに送信されました。
無効なオファー SDP に CRLF がありません。 400 INVALID_ARGUMENT WebRTC ストリームを生成しようとしたときに、offerSdp 文字列の末尾に改行文字がありません。offerSdp 文字列が \r\n または \n で終わることを確認して、もう一度ストリームを生成します。

関連情報:
特典の SDP m 行が無効です。 400 INVALID_ARGUMENT オファー SDP には、音声、動画、アプリケーションの 3 本すべての回線が、この順序で含まれている必要があります。

関連情報:
特典の SDP が無効です。 400 INVALID_ARGUMENT 特典の SDP 音声は a=recvonly に設定する必要があります(受信のみ)。

関連情報:
権限が拒否されました。 403 PERMISSION_DENIED user コマンドの実行に必要なパートナー コネクション マネージャー(PCM)の適切なデバイスレベルの権限が developerに付与されていません。

WebRTC ライブ ストリームを生成するときに、offerSdp の音声設定が正しくない場合にも、このエラーが発生することがあります。

アカウントをリンクするタスク
  GenerateWebRtcStream コマンド

レート制限。 429 RESOURCE_EXHAUSTED デベロッパーごとに、実行できる呼び出し数に上限があります。割り当てを超える通話を行うと、レート制限のメッセージが表示されます。この問題を解決するには、割り当ての有効期限が切れてから通話を再送信します。

関連情報:
  サンドボックスのレート制限の概念
会議室が見つかりません。 404 NOT_FOUND 部屋がストラクチャに存在しません。room ID を確認するために、rooms リソースのリスト呼び出しを行います。
ストラクチャが見つかりません。 404 NOT_FOUND 構造が Projectに存在しません。ストラクチャ リソースのリスト呼び出しを行い、ストラクチャ ID を検証します。
サーモスタットのファンを使用できません。 400 FAILED_PRECONDITION サーモスタットにファン機能がありません。このデバイスでは、ファンに関連するトレイトとコマンドを使用できません。

関連情報:
  ファンのオン / オフを切り替えるタスク
  ファン トレイト