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 秒後に期限切れになります。有効期限が切れる前に画像をダウンロードしてください。

関連情報:
  カメラ画像をダウンロードするタスク
  ディスプレイ デバイス
  ドアホン デバイス
  イベント ガイド
  GenerateImage コマンド
  CameraMotion トレイト
  CameraPerson トレイト
  CameraSound トレイト
  DoorbellChime トレイト
このコマンドはドアホンではサポートされていません。 400 FAILED_PRECONDITION バッテリー駆動のドアホンでは、WebRTC ストリームを延長できません。ドアベルのストリームを最初のセッションの長さを超えて表示する必要がある場合は、既存のストリームを停止して新しいストリームを生成します。

関連情報:
  ライブ ストリームを延長するタスク
  ExtendWebRtcStream コマンド
現在のサーモスタット モードではコマンドが許可されていません。 400 FAILED_PRECONDITION ThermostatMode トレイトによると、サーモスタットのモードがオフの場合、一部のサーモスタット モデルではエコモードの変更がサポートされていません。エコモードを変更する前に、サーモスタットのモードを HEAT、COOL、HEATCOOL に変更する必要があります。

関連情報:
  モードを変更するタスク
  SetMode コマンド
  ThermostatMode トレイト
  ThermostatTemperatureSetpoint トレイト
サーモスタットが 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 無効なデバイス名が指定されたか、デバイス名が指定されていません。有効なデバイスを指定します。

関連情報:
  Connectivity trait
エンタープライズが見つかりません。 404 NOT_FOUND 無効な Project ID が指定されているか、指定されていません。有効な Project ID を指定します。
イベント ID がカメラに属していません。 400 FAILED_PRECONDITION カメラ イベントから返された正しい eventID を使用します。

関連情報:
  カメラ イベントを処理するタスク
  ディスプレイ デバイス
  ドアホンとカメラのイベントを処理するタスク
  イベント ガイド
  CameraEventImage トレイト
  CameraMotion トレイト
  CameraPerson トレイト
  CameraSound トレイト
  DoorbellChime トレイト
タイムアウトのため、回答 SDP を取得できませんでした。 504 DEADLINE_EXCEEDED WebRTC ライブ ストリームをもう一度生成してみてください。

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

関連項目:
Offer SDP の m 行が無効です。 400 INVALID_ARGUMENT Offer SDP には、音声、動画、アプリケーションの 3 つの m-line がすべてこの順序で含まれている必要があります。

参照:
Offer SDP が無効です。 400 INVALID_ARGUMENT Offer SDP の音声は a=recvonly(受信のみ)に設定する必要があります。

参照:
権限が拒否されました。 403 PERMISSION_DENIED user が、コマンドの実行に必要な適切なデバイスレベルの権限をパートナー接続マネージャー(PCM)で developerに付与していません。

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

関連情報:
  アカウントをリンクするタスク
  GenerateWebRtcStream コマンド
レート制限されています。 429 RESOURCE_EXHAUSTED 各デベロッパーには、呼び出し数を制限する割り当てがあります。割り当てを超える呼び出しを行うと、「レート制限」メッセージが表示されます。この問題を解決するには、割り当ての有効期限が切れたら呼び出しを再送信します。

関連情報:
  サンドボックスのレート制限のコンセプト
会議室が見つかりません。 404 NOT_FOUND このストラクチャには部屋がありません。rooms リソースにリスト呼び出しを行い、Room ID を確認します。
構造が見つかりません。 404 NOT_FOUND この構造は Projectに存在しません。構造リソースに対してリスト呼び出しを行い、構造 ID を確認します。
カメラはストリーミングには使用できません。 400 FAILED_PRECONDITION カメラがオフラインになっているか、技術的な問題によりストリーミングを利用できない状態です。

関連情報:
  カメラ デバイス
  カメラ(バッテリー式)デバイス
  カメラ(電源直結型)デバイス
  ドアホン(バッテリー式)デバイス
  ドアホン(電源直結型)デバイス
  GenerateWebRtcStream コマンド
サーモスタットのファンを使用できません。 400 FAILED_PRECONDITION サーモスタットに送風機能がありません。このデバイスでは、ファン関連のトレイトとコマンドを使用できません。

関連情報:
  ファンをオンまたはオフにするタスク
  ファン トレイト