Philips HUE (独立発行者)

Philips HUE を使用すると、Philips が製造したライト、スイッチ、プラグなどのスマート ホーム デバイスを制御できます。

このコネクタは、次の製品および地域で利用可能です:

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 政府の地域
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate プレミアム 以下を除くすべての Power Automate 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   国防総省 (DoD)
Power Apps プレミアム 以下を除くすべての Power Apps 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
お問い合わせ先
件名 トーマス・ポズィテク
[URL] https://aka.ms/poszytek
メール tomasz@poszytek.eu
Connector Metadata
発行者 トーマス・ポズィテク
Web サイト https://www.philips-hue.com/
プライバシー ポリシー https://www.philips-hue.com/en-us/support/legal/privacy-policy
カテゴリ モノのインターネット; ライフスタイルとエンターテインメント

接続の作成

コネクタは、次の認証タイプをサポートしています。

既定 接続を作成するためのパラメーター。 すべての地域 共有不可

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

名前 タイプ 説明 必須項目
HUE アプリケーション キー securestring PUT および POST 認証呼び出しの実行後に返される API キー。 True

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒

アクション

シーンの取得

特定のシーンを取得します。

シーンを削除する

特定のシーンを削除します。

シーンを取得

すべてのシーンのリストを取得 シーンは、ライトのグループの設定を保存および呼び出すために使用されます。

デバイスの取得

特定のデバイスの詳細を取得します。

デバイスを取得する

すべてのデバイスのリストを取得します。

デバイスを実行する

特定のデバイスの実行。

ライトの取得

ライトニング機能を備えた特定のデバイスの詳細を取得します。

ライトの取得

ライトニング機能を備えたデバイスのリストを取得します。

ライトを実行する

ライトニング機能のあるデバイスを実行します。

会議室の取得

会議室のリストを取得する (グループ)。

シーンの取得

特定のシーンを取得します。

パラメーター

名前 キー 必須 説明
シーン ID
SceneId True string

詳細を表示するシーンの ID。

戻り値

名前 パス 説明
エラー
errors array of object

呼び出し中に発生したエラー。

エラーの説明
errors.description string

この問題の発生に対する人間が読み取り可能な説明。

データ
data array of object

データ​​。

アクション
data.actions array of object

シーンで実行されたアクションのリスト。

X
data.actions.action.color.xy.x float

最小: 0、最大: 1。 色域の X 位置。

Y
data.actions.action.color.xy.y float

最小: 0、最大: 1。 色域の Y 位置。

輝度
data.actions.action.dimming.brightness float

最大: 100。 輝度のパーセント。 0 を書き込むと、可能な限り低い明るさに変更されます。

オン
data.actions.action.on.on boolean

ライトのオン/オフ状態 on=true、off=false。

Mirek
data.actions.action.color_temperature.mirek integer

最小: 153、最大: 500。 明るい色が ct スペクトルにない場合は、mirek または null の色温度。

RID
data.actions.target.rid string

参照先リソースの一意の ID。

rtype
data.actions.target.rtype string

参照先リソースのタイプ。

RID
data.group.rid string

参照先リソースの一意の ID。

rtype
data.group.rtype string

参照先リソースのタイプ。

ID
data.id string

特定のリソース インスタンスを表す一意識別子。

ID v1
data.id_v1 string

クリップ v1 リソース識別子 (API v1で使用されます)。

RID
data.metadata.image.rid string

参照先リソースの一意の ID。

rtype
data.metadata.image.rtype string

参照先リソースのタイプ。

名前
data.metadata.name string

人間が読めるリソースの名前。

カラー
data.palette.color array of object
X
data.palette.color.color.xy.x float

最小: 0、最大: 1。 色域の X 位置。

Y
data.palette.color.color.xy.y float

最小: 0、最大: 1。 色域の Y 位置。

輝度
data.palette.color.dimming.brightness float

最大: 100。 輝度のパーセント。 0 を書き込むと、可能な限り低い明るさに変更されます。

色温度
data.palette.color_temperature array of object
Mirek
data.palette.color_temperature.color_temperature.mirek integer

最小: 153、最大: 500。 明るい色が ct スペクトルにない場合は、mirek または null の色温度。

輝度
data.palette.color_temperature.dimming.brightness float

最大: 100。 輝度のパーセント。 0 を書き込むと、可能な限り低い明るさに変更されます。

調光
data.palette.dimming array of object
輝度
data.palette.dimming.brightness float

最大: 100。 輝度のパーセント。 0 を書き込むと、可能な限り低い明るさに変更されます。

速度
data.speed float

このシーンのダイナミック パレットの速度。

タイプ
data.type string

サポートされたリソースの種類。

シーンを削除する

特定のシーンを削除します。

パラメーター

名前 キー 必須 説明
シーン ID
SceneId True string

削除するシーン ID。

戻り値

名前 パス 説明
データ
data array of object

シーンを更新しました。

rid
data.rid string

削除シーンの一意の ID。

rtype
data.rtype string

削除シーンのタイプ。

エラー
errors array of object

呼び出し中に発生したエラー。

エラーの説明
errors.description string

この問題の発生に対する人間が読み取り可能な説明。

シーンを取得

すべてのシーンのリストを取得 シーンは、ライトのグループの設定を保存および呼び出すために使用されます。

戻り値

名前 パス 説明
エラー
errors array of object

呼び出し中に発生したエラー。

エラーの説明
errors.description string

この問題の発生に対する人間が読み取り可能な説明。

データ
data array of object

データ​​。

アクション
data.actions array of object

シーンで実行されたアクションのリスト。

X
data.actions.action.color.xy.x float

最小: 0、最大: 1。 色域の X 位置。

Y
data.actions.action.color.xy.y float

最小: 0、最大: 1。 色域の Y 位置。

輝度
data.actions.action.dimming.brightness float

最大: 100。 輝度のパーセント。 0 を書き込むと、可能な限り低い明るさに変更されます。

オン
data.actions.action.on.on boolean

ライトのオン/オフ状態 on=true、off=false。

Mirek
data.actions.action.color_temperature.mirek integer

最小: 153、最大: 500。 明るい色が ct スペクトルにない場合は、mirek または null の色温度。

RID
data.actions.target.rid string

参照先リソースの一意の ID。

rtype
data.actions.target.rtype string

参照先リソースのタイプ。

RID
data.group.rid string

参照先リソースの一意の ID。

rtype
data.group.rtype string

参照先リソースのタイプ。

ID
data.id string

特定のリソース インスタンスを表す一意識別子。

ID v1
data.id_v1 string

クリップ v1 リソース識別子 (API v1で使用されます)。

RID
data.metadata.image.rid string

参照先リソースの一意の ID。

rtype
data.metadata.image.rtype string

参照先リソースのタイプ。

名前
data.metadata.name string

人間が読めるリソースの名前。

カラー
data.palette.color array of object
X
data.palette.color.color.xy.x float

最小: 0、最大: 1。 色域の X 位置。

Y
data.palette.color.color.xy.y float

最小: 0、最大: 1。 色域の Y 位置。

輝度
data.palette.color.dimming.brightness float

最大: 100。 輝度のパーセント。 0 を書き込むと、可能な限り低い明るさに変更されます。

色温度
data.palette.color_temperature array of object
Mirek
data.palette.color_temperature.color_temperature.mirek integer

最小: 153、最大: 500。 明るい色が ct スペクトルにない場合は、mirek または null の色温度。

輝度
data.palette.color_temperature.dimming.brightness float

最大: 100。 輝度のパーセント。 0 を書き込むと、可能な限り低い明るさに変更されます。

調光
data.palette.dimming array of object
輝度
data.palette.dimming.brightness float

最大: 100。 輝度のパーセント。 0 を書き込むと、可能な限り低い明るさに変更されます。

速度
data.speed float

このシーンのダイナミック パレットの速度。

タイプ
data.type string

サポートされたリソースの種類。

デバイスの取得

特定のデバイスの詳細を取得します。

パラメーター

名前 キー 必須 説明
デバイス ID
DeviceId True string

詳細を表示するデバイスの ID。

戻り値

名前 パス 説明
エラー
errors array of object

呼び出し中に発生したエラー。

エラーの説明
errors.description string

この問題の発生に対する人間が読み取り可能な説明。

データ
data array of object

指定された ID に一致するデバイス。

ID
data.id string

特定のリソース インスタンスを表す一意識別子。

ID v1
data.id_v1 string

クリップ v1 リソース識別子 (API v1で使用されます)。

原型
data.metadata.archetype string

製造元によって指定された既定の原型。

名前
data.metadata.name string

人間が読めるリソースの名前。

認証済み
data.product_data.certified boolean

このデバイスは HUE 認定を受けています。

製造元の名前
data.product_data.manufacturer_name string

デバイス製造元の名前。

モデル ID
data.product_data.model_id string

デバイス モデルの一意の識別。

製品の原型
data.product_data.product_archetype string

製品の原型。

製品名
data.product_data.product_name string

製品の名前です。

ソフトウェア バージョン
data.product_data.software_version string

製品のソフトウェア バージョンです。

サービス
data.services array of object

グループ内の子の制御と状態を集約するすべてのサービスを参照します。

RID
data.services.rid string

参照先リソースの一意の ID。

rtype
data.services.rtype string

参照先リソースのタイプ。

タイプ
data.type string

サポートされたリソースの種類。

デバイスを取得する

すべてのデバイスのリストを取得します。

戻り値

名前 パス 説明
エラー
errors array of object

呼び出し中に発生したエラー。

エラーの説明
errors.description string

この問題の発生に対する人間が読み取り可能な説明。

データ
data array of object

ユーザー デバイス。

ID
data.id string

特定のリソース インスタンスを表す一意識別子。

ID v1
data.id_v1 string

クリップ v1 リソース識別子 (API v1で使用されます)。

原型
data.metadata.archetype string

製造元によって指定された既定の原型。

名前
data.metadata.name string

人間が読めるリソースの名前。

認証済み
data.product_data.certified boolean

このデバイスは HUE 認定を受けています。

製造元の名前
data.product_data.manufacturer_name string

デバイス製造元の名前。

モデル ID
data.product_data.model_id string

デバイス モデルの一意の識別。

製品の原型
data.product_data.product_archetype string

製品の原型。

製品名
data.product_data.product_name string

製品の名前です。

ソフトウェア バージョン
data.product_data.software_version string

製品のソフトウェア バージョンです。

サービス
data.services array of object

グループ内の子の制御と状態を集約するすべてのサービスを参照します。

RID
data.services.rid string

参照先リソースの一意の ID。

rtype
data.services.rtype string

参照先リソースのタイプ。

タイプ
data.type string

サポートされたリソースの種類。

デバイスを実行する

特定のデバイスの実行。

パラメーター

名前 キー 必須 説明
デバイス ID
DeviceId True string

メタデータを更新するデバイス ID。

原型
archetype string

既定では、製造元によって指定された原型。

名前
name string

リソースの人間が読める形式の名前 (最大 32 文字)。

操作
action string

「identify」と入力して、識別をトリガーします。 Bridge は、Zigbee LED 識別サイクルを 5 秒間実行します。 Lights は 1 回の呼吸サイクルを実行します。 Sensors は、Zigbee LED 識別サイクルを 15 秒間実行します。

戻り値

名前 パス 説明
データ
data array of object

デバイスの更新。

RID
data.rid string

参照先リソースの一意の ID。

rtype
data.rtype string

参照先リソースのタイプ。

エラー
errors array of object

呼び出し中に発生したエラー。

エラーの説明
errors.description string

この問題の発生に対する人間が読み取り可能な説明。

ライトの取得

ライトニング機能を備えた特定のデバイスの詳細を取得します。

パラメーター

名前 キー 必須 説明
デバイス ID
DeviceId True string

詳細を表示するデバイスの ID。

戻り値

名前 パス 説明
エラー
errors array of object

呼び出し中に発生したエラー。

エラーの説明
errors.description string

この問題の発生に対する人間が読み取り可能な説明。

データ
data array of object

指定された ID に一致するライト。

アクション値
data.alert.action_values array of string

ライトがサポートするアラート効果のリスト。

ブルー X
data.color.gamut.blue.x float

色域の X 位置。

ブルー Y
data.color.gamut.blue.y float

色域の Y 位置。

グリーン X
data.color.gamut.green.x float

色域の X 位置。

グリーン Y
data.color.gamut.green.y float

色域の X 位置。

レッド X
data.color.gamut.red.x float

色域の X 位置。

レッド Y
data.color.gamut.red.y float

色域の X 位置。

色域タイプ
data.color.gamut_type string

色相でサポートされる色域: A - 初期のフィリップス カラーのみの製品の色域、B - 最初の色域製品の限定された色域、C - 色相白およびカラー アンビエンス製品のより豊かな色域、その他 - 非色相製品の色域。

X
data.color.xy.x float

色域の X 位置。

Y
data.color.xy.y float

色域の Y 位置。

Mirek
data.color_temperature.mirek integer

明るい色が ct スペクトルにない場合は、mirek または null の色温度。

Mirek 最大値
data.color_temperature.mirek_schema.mirek_maximum integer

このライトがサポートする最大色温度。

Mirek 最小値
data.color_temperature.mirek_schema.mirek_minimum integer

このライトがサポートする最小色温度。

Mirek 有効値
data.color_temperature.mirek_valid boolean

mirek で提示された値が有効かどうかの表示。

輝度
data.dimming.brightness float

輝度のパーセント。 値は 0 にできないので、0 を書き込むと最低輝度に変更されます。

最小の薄暗いレベル
data.dimming.min_dim_level float

デバイスが最小輝度で出力する最大ルーメンのパーセンテージ。

速度
data.dynamics.speed float

ダイナミック パレットまたはエフェクトの速度。 ステータスが dynamic_palette の場合、速度はダイナミック パレット、またはステータスにリストされている対応するエフェクトに対して有効です。 ステータスが none の場合、速度は無効です。

有効な速度
data.dynamics.speed_valid boolean

速度で提示された値が有効かどうかの表示。

ステータス
data.dynamics.status string

ダイナミクスを備えたランプの現在のステータス。

ステータス値
data.dynamics.status_values array of string

ダイナミクスを再生するときにランプが存在する可能性のあるステータス。

リソース ID
data.id string

特定のリソース インスタンスを表す一意識別子。

クリップ v1 リソース ID
data.id_v1 string

クリップ v1 リソース識別子 (v1 API バージョン)。

原型
data.metadata.archetype string

ライトの原型。 非推奨: デバイス レベルで原型を使用します。

デバイスの指定名
data.metadata.name string

人間が読めるリソースの名前。

モード
data.mode string

いずれか: 通常またはストリーミング。

ライトの状態
data.on.on boolean

ライトのオン/オフ状態: on=true、off=false。

RID
data.owner.rid string

参照先リソースの一意の ID。

Rtype
data.owner.rtype string

参照先リソースのタイプ。

タイプ
data.type string

サポートされたリソースの種類。

ライトの取得

ライトニング機能を備えたデバイスのリストを取得します。

戻り値

名前 パス 説明
エラー
errors array of object

呼び出し中に発生したエラー。

エラーの説明
errors.description string

この問題の発生に対する人間が読み取り可能な説明。

データ
data array of object

ユーザー ライト。

アクション値
data.alert.action_values array of string

ライトがサポートするアラート効果のリスト。

ブルー X
data.color.gamut.blue.x float

色域の X 位置。

ブルー Y
data.color.gamut.blue.y float

色域の Y 位置。

グリーン X
data.color.gamut.green.x float

色域の X 位置。

グリーン Y
data.color.gamut.green.y float

色域の X 位置。

レッド X
data.color.gamut.red.x float

色域の X 位置。

レッド Y
data.color.gamut.red.y float

色域の X 位置。

色域タイプ
data.color.gamut_type string

色相でサポートされる色域: A - 初期のフィリップス カラーのみの製品の色域、B - 最初の色域製品の限定された色域、C - 色相白およびカラー アンビエンス製品のより豊かな色域、その他 - 非色相製品の色域。

X
data.color.xy.x float

色域の X 位置。

Y
data.color.xy.y float

色域の Y 位置。

Mirek
data.color_temperature.mirek integer

明るい色が ct スペクトルにない場合は、mirek または null の色温度。

Mirek 最大値
data.color_temperature.mirek_schema.mirek_maximum integer

このライトがサポートする最大色温度。

Mirek 最小値
data.color_temperature.mirek_schema.mirek_minimum integer

このライトがサポートする最小色温度。

Mirek 有効値
data.color_temperature.mirek_valid boolean

mirek で提示された値が有効かどうかの表示。

輝度
data.dimming.brightness float

輝度のパーセント。 値は 0 にできないので、0 を書き込むと最低輝度に変更されます。

最小の薄暗いレベル
data.dimming.min_dim_level float

デバイスが最小輝度で出力する最大ルーメンのパーセンテージ。

速度
data.dynamics.speed float

ダイナミック パレットまたはエフェクトの速度。 ステータスが dynamic_palette の場合、速度はダイナミック パレット、またはステータスにリストされている対応するエフェクトに対して有効です。 ステータスが none の場合、速度は無効です。

有効な速度
data.dynamics.speed_valid boolean

速度で提示された値が有効かどうかの表示。

ステータス
data.dynamics.status string

ダイナミクスを備えたランプの現在のステータス。

ステータス値
data.dynamics.status_values array of string

ダイナミクスを再生するときにランプが存在する可能性のあるステータス。

リソース ID
data.id string

特定のリソース インスタンスを表す一意識別子。

クリップ v1 リソース ID
data.id_v1 string

クリップ v1 リソース識別子 (v1 API バージョン)。

原型
data.metadata.archetype string

ライトの原型。 非推奨: デバイス レベルで原型を使用します。

デバイスの指定名
data.metadata.name string

人間が読めるリソースの名前。

モード
data.mode string

いずれか: 通常またはストリーミング。

ライトの状態
data.on.on boolean

ライトのオン/オフ状態: on=true、off=false。

RID
data.owner.rid string

参照先リソースの一意の ID。

Rtype
data.owner.rtype string

参照先リソースのタイプ。

タイプ
data.type string

サポートされたリソースの種類。

ライトを実行する

ライトニング機能のあるデバイスを実行します。

パラメーター

名前 キー 必須 説明
デバイス ID
DeviceId True string

機能を更新するデバイスの ID。

名前
name string

MinLength: 1 - maxLength: 32。 人間が読めるリソースの名前。

オン
on boolean

ライトのオン/オフ状態 on=true、off=false。

輝度
brightness float

最大: 100。 輝度のパーセント。 0 を書き込むと、可能な限り低い明るさに変更されます。

Mirek
mirek integer

最小: 153、最大: 500。 明るい色が ct スペクトルにない場合は、mirek または null の色温度。

X
x float

最小: 0、最大: 1。 色域の X 位置。

Y
y float

最小: 0、最大: 1。 色域の Y 位置。

速度
speed float

最小: 0、最大: 1。 ダイナミック パレットの速度。 ステータスが dynamic_palette の場合、速度はダイナミック パレット、またはステータスにリストされている対応するエフェクトに対して有効です。 ステータスが none の場合、速度は無効です。

期間
duration integer

最大: 6000000。 ミリ秒単位の光遷移の持続時間。 精度は 100ms ステップです。

アクション
action string

デバイスで実行できるアクションの 1 つ。 つまり、「呼吸」します。

X
x float

最小: 0、最大: 1。 色域の X 位置。

Y
y float

最小: 0、最大: 1。 色域の Y 位置。

戻り値

名前 パス 説明
データ
data array of object

データ

RID
data.rid string

RID

rtype
data.rtype string

rtype

エラー
errors array of object

呼び出し中に発生したエラー。

エラーの説明
errors.description string

この問題の発生に対する人間が読み取り可能な説明。

会議室の取得

会議室のリストを取得する (グループ)。

戻り値

名前 パス 説明
エラー
errors array of object

呼び出し中に発生したエラー。

エラーの説明
errors.description string

この問題の発生に対する人間が読み取り可能な説明。

データ
data array of object

データ​​。

data.children array of object

部屋ごとにグループ化するデバイス。 次の子が許可されます: 「デバイス」。

RID
data.children.rid string

作成されたシーンの一意の ID。

rtype
data.children.rtype string

作成されたシーンのタイプ。

グループ化されたサービス
data.grouped_services array of object

集約された制御サービスへの参照。 非推奨: サービスを使用します。

RID
data.grouped_services.rid string

作成されたシーンの一意の ID。

rtype
data.grouped_services.rtype string

作成されたシーンのタイプ。

ID
data.id string

特定のリソース インスタンスを表す一意識別子。

ID v1
data.id_v1 string

クリップ v1 リソース識別子 (API v1で使用されます)。

原型
data.metadata.archetype string

製造元によって指定された既定の原型。

名前
data.metadata.name string

人間が読めるリソースの名前。

サービス
data.services array of object

グループ内の子の制御と状態を集約するすべてのサービスを参照します。 集約はサービス タイプごとに行われます。つまり、グループ化できるすべてのサービス タイプには、対応するグループ化タイプの定義があります。 サポートされるタイプ: 「ライト」

RID
data.services.rid string

作成されたシーンの一意の ID。

rtype
data.services.rtype string

作成されたシーンのタイプ。

タイプ
data.type string

サポートされたリソースの種類。