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 無効なデバイス名が指定されているか、デバイス名が指定されていません。有効なデバイスを指定します。

関連情報:
  接続 特性
企業が見つかりません。 404 NOT_FOUND 無効な ID が指定されているか、 Project ID が指定されていません。有効な Project ID を指定します。
イベント ID がカメラに属していない。 400 FAILED_PRECONDITION カメラ アクティビティから返された正しい eventID を使用します。

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

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

関連情報:
Offer SDP の m-line が無効です。 400 INVALID_ARGUMENT オファーの SDP には、音声、動画、アプリケーションの 3 つの m-line を順番に含める必要があります。

関連情報:
Offer SDP が無効です。 400 INVALID_ARGUMENT Offer SDP のオーディオは a=recvonly(受信のみ)に設定する必要があります。

関連情報:
権限が拒否されました。 403 PERMISSION_DENIED user developerに、コマンドの実行に必要な Partner Connections Manager(PCM)の適切なデバイスレベルの権限が付与されていません。

WebRTC ライブ配信を生成するときにこのエラーが発生する場合は、offerSdp の音声設定が正しくないことも考えられます。

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

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

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

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