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 行が無効です。	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	部屋がストラクチャに存在しません。会議室リソースに対して list 呼び出しを行い、会議室 ID を確認します。
ストラクチャが見つかりません。	404	NOT_FOUND	構造が Projectに存在しない。構造リソースに対してリスト呼び出しを行い、構造 ID を確認します。
カメラをストリーミングに使用できません。	400	FAILED_PRECONDITION	カメラがオフラインであるか、技術的な問題によりストリーミングできません。 関連情報:   カメラデバイス   カメラ（バッテリー式）デバイス   カメラ（電源直結型）デバイス   ドアホン（電源直結型）デバイス   ドアホン（電源直結型） デバイス   GenerateWebRtcStream
サーモスタット ファンを使用できません。	400	FAILED_PRECONDITION	サーモスタットにファン機能はありません。このデバイスでは、ファン関連の特徴とコマンドを使用できません。 関連情報:   ファンのオン / オフを切り替えるタスク   ファン の特徴