Govee (独立系発行元) (プレビュー)
Govee Developer API を使用して、Govee スマート照明デバイスをアプリケーションに統合します。 照明を制御し、色の変更、明るさの調整、タイマーの設定を行います。 リアルタイムのデバイスの状態にアクセスして、高度なアプリケーション開発を実現します。
このコネクタは、次の製品および地域で利用可能です:
| サービス | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | Richard Wilson |
| [URL] | https://www.richardawilson.com/ |
| メール | richard.a.wilson@microsoft.com |
| コネクタ メタデータ | |
|---|---|
| 発行者 | Richard Wilson |
| Web サイト | https://us.govee.com/ |
| プライバシー ポリシー | https://us.govee.com/policies/privacy-policy |
| カテゴリー | モノのインターネット |
Govee
Govee の スマート ライト システムとのシームレスな統合を提供し、ユーザーがデバイスを簡単に制御したり管理したりできるようにします。 これにより、照明設定の調整、色の変更、明るさの変更、リアルタイムのデバイスの状態へのアクセスなど、幅広い機能が可能になります。
このコネクタは、照明設定を自動化およびカスタマイズできるため、スマート ホームの雰囲気を改善し、さまざまな場面でダイナミックな照明シーンを生み出すので、特にスマート照明をより広範なホーム オートメーション システムに統合するのに役立ちます。 便利で直感的な方法を提供するので、ユーザーは照明体験をパーソナライズし、Govee のスマート照明テクノロジの機能を最大限に活用することができます。
発行元: Richard Wilson
前提条件
Govee コネクタを使用する前に、Govee Developer API キーを取得する必要があります。 キーを取得するには、次の手順を実行します。
Govee 開発者 API キーを取得する
Govee ホーム アプリをダウンロードする:
- iOS の場合: App Store の Govee ホーム
- Android の場合: Google Play の Govee ホーム
自分のプロファイルにアクセスする:
- Govee ホーム アプリを開き、プロフィール アイコン (??) をタップして [マイ プロフィール] ページに移動します。
[設定] に移動します:
- 右上隅にある設定アイコン (⚙️) をクリックして、[設定] メニューにアクセスします。
API キーに適用する:
- [設定] メニュー内で [API キーの適用] を選択します。
アプリケーション フォームを完了させる:
- [氏名] および [アプリケーションの目的] の必須項目フィールドに記入してください。
- 目的の例には、ホーム オートメーション、サードパーティの統合、教育目的などがあります。
- [氏名] および [アプリケーションの目的] の必須項目フィールドに記入してください。
サービス使用条件に同意する:
- Govee 開発者 API のサービス使用条件をよくお読みください。 ご契約条件を理解したら、同意することを示すボックスにチェックを入れてください。
アプリケーションの送信:
- [送信] をクリックしてアプリケーションを送信し、API キーを取得します。 承認されると、このコネクタを使用するために必要な Govee API キーを受け取ります。
API キーの承認プロセスには時間がかかる場合があり、承認は Govee の裁量によって行われることにご注意ください。 承認の可能性を高めるために、API キーを要求する有効かつ明確な理由がアプリケーションに含まれていることを確認してください。
サポートされている操作
1. デバイスでコマンドを実行する
この操作により、Govee デバイスを制御するためのさまざまなコマンドを送信できるようになります。
- 入力プロパティ:
- デバイス MAC アドレス: 制御される Govee デバイスの一意の MAC アドレス。
- デバイス モデル: Govee デバイスのモデル番号。
- コマンドの詳細: 実行するコマンドを含むオブジェクト。 これには次のものが含まれます。
- 名前: コマンド名 (例: "turn"、"brightness"、"color"、"colorTem")。
- 追加パラメータ (コマンドに基づく):
- Turn: (オプション) "オン" または "オフ" - コマンドが "turn" の場合に使用されます。
- 明るさ: (オプション) 数値 (0 ～ 100) - コマンドが "brightness" の場合に使用されます。
- 色: (オプション) "r"、"g"、"b" 値を持つオブジェクト - コマンドが "color" の場合に使用されます。
- 色の温度: (オプション) 色の温度の数値 - コマンドが "colorTem" の場合に使用されます。
2. デバイス情報を入手する
特定の Govee デバイス、またはアカウントに関連付けられているすべてのデバイスに関する情報を取得します。
- 入力プロパティ:
- デバイス MAC アドレス: (オプション) 情報が要求されている特定の Govee デバイスの MAC アドレス。 省略した場合は、すべてのデバイスの情報が返されます。
- デバイス モデル: (オプション) Govee デバイスのモデル。 MAC アドレスとともに指定すると、クエリがその特定のデバイスに絞り込まれます。
API ドキュメント
機能、エンドポイント、パラメーター、応答など、Govee 照明開発者 API の詳細については、公式 Govee API ドキュメントを参照してください。 このドキュメントでは、アプリケーションやワークフロー内で API を効果的に統合して利用するのに役立つ包括的なガイダンスと例を提供します。
既知の問題と制限事項
現在は、既知の問題や制限はありません。 最新情報については、常にこのセクションを参照してください。
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | プロパティ | 必須 |
|---|---|---|---|
| Govee API キー | securestring | Govee モバイル アプリ内で要求できる Govee API キー。 | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| デバイスでコマンドを実行する |
Govee デバイスで特定のコマンドを実行します。 このエンドポイントを使用すると、電力の状態、明るさ、色、色温度など、デバイスのさまざまな点を制御できます。 デバイスの MAC アドレスとモデルをコマンドの詳細とともに提供します。 サポートされているコマンドには、電力制御の "turn"、明るさレベルの調整の "brightness"、RGB カラー値の設定の "color"、色温度の調整の "colorTem" が含まれます。 |
| デバイス情報を入手する |
Govee デバイスに関する詳細情報にアクセスします。 このエンドポイントは、MAC アドレスとモデルが指定されている場合、特定のデバイスのデータを取得します。 特定のデバイスが指定されていない場合、エンドポイントはアカウントに関連付けられているすべてのデバイスの情報を返します。 応答には、デバイス名、制御性、取得可能性、サポートされているコマンド、追加のプロパティなどのデバイスの詳細が含まれます。 これは、Govee デバイスの機能と現在の構成を理解するのに役立ちます。 |
デバイスでコマンドを実行する
Govee デバイスで特定のコマンドを実行します。 このエンドポイントを使用すると、電力の状態、明るさ、色、色温度など、デバイスのさまざまな点を制御できます。 デバイスの MAC アドレスとモデルをコマンドの詳細とともに提供します。 サポートされているコマンドには、電力制御の "turn"、明るさレベルの調整の "brightness"、RGB カラー値の設定の "color"、色温度の調整の "colorTem" が含まれます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
デバイス MAC アドレス
|
device | True | string |
Govee デバイスの一意の MAC アドレス。 この識別子は、制御するデバイスを指定するために使用されます。 |
|
デバイス モデル
|
model | True | string |
Govee デバイスのモデル番号。 この情報を活用して、デバイスで利用可能な特定の機能を特定することができます。 |
|
コマンド名
|
name | True | string |
デバイスで実行するコマンド。 このオブジェクトには、コマンド名 ("turn"、"brightness"、"color"、"colorTem" など) とそれに関連付けられた値が含まれます。 コマンド名は、デバイスで実行されるアクションのタイプを決定します。 |
|
ターン
|
turn | string |
このパラメーターは、デバイスをオンまたはオフにするために使用されます。 これは、"turn" コマンドが選択されている場合にのみ使用します。 有効な値は "on" か "off" です。 |
|
|
輝度
|
brightness | integer |
デバイスに設定する明るさのレベル。 このパラメーターを使用して、"brightness" コマンドが選択されている場合にのみ使用します。 0 (最小の明るさ) ～ 100 (最大の明るさ) の値を入力します。 |
|
|
色 - 赤
|
r | integer |
このパラメーターは、デバイスの RGB カラー値の赤コンポーネントを表します。 これは "color" コマンドの一部です。 0 ～ 255 の範囲の整数値を指定します。0 は赤がないことを意味し、255 は赤の最大強度を表します。 |
|
|
色 - 緑
|
g | integer |
このパラメーターは、デバイスの RGB カラー値の緑コンポーネントを定義します。 "color" コマンドと組み合わせて使用されます。 0 ～ 255 の整数値を指定します。0 は緑がないことを示し、255 は緑の強度が最も高いことを示します。 |
|
|
色 - 青
|
b | integer |
デバイスに設定する RGB カラー値の青コンポーネント。 このパラメーターは "color" コマンドの一部です。 値は 0 ～ 255 の範囲の整数である必要があります。0 は青がないことを示し、255 は最も明るい青を示します。 |
|
|
色温度
|
colorTem | integer |
デバイスに設定する色温度の値。 このパラメーターを使用して、"colorTem" コマンドが選択されている場合にのみ使用します。 デバイスに必要な色温度値を入力します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
状態コード
|
code | integer |
応答の HTTP 状態コード |
|
メッセージ
|
message | string |
操作の結果を説明するメッセージ |
|
データ
|
data | object |
応答とともにデータが返されました。 |
デバイス情報を入手する
Govee デバイスに関する詳細情報にアクセスします。 このエンドポイントは、MAC アドレスとモデルが指定されている場合、特定のデバイスのデータを取得します。 特定のデバイスが指定されていない場合、エンドポイントはアカウントに関連付けられているすべてのデバイスの情報を返します。 応答には、デバイス名、制御性、取得可能性、サポートされているコマンド、追加のプロパティなどのデバイスの詳細が含まれます。 これは、Govee デバイスの機能と現在の構成を理解するのに役立ちます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
デバイス MAC アドレス
|
device | string |
情報が要求されている Govee デバイスの MAC アドレスを表すパラメーター (オプション)。 指定した場合、API はこのデバイス専用の詳細を返します。 アカウントに関連付けられているすべてのデバイスの情報を取得するには、このパラメーターを空のままにします。 |
|
|
デバイス モデル
|
model | string |
Govee デバイスのモデルを示すパラメーター (オプション)。 指定した場合、API はこのモデルに一致するデバイスの情報を返します。 このパラメーターは、デバイスの MAC アドレスと組み合わせて使用できます。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
デバイス
|
data.devices | array of object |
アカウントに関連付けられているデバイスのリスト。 特定のデバイスが要求された場合、リストにはデバイスが 1 つだけ含まれます。 |
|
デバイス MAC アドレス
|
data.devices.device | string |
デバイスの一意の MAC アドレス |
|
デバイス モデル
|
data.devices.model | string |
デバイスのモデル番号 |
|
デバイス名
|
data.devices.deviceName | string |
デバイスの名前です |
|
制御可能
|
data.devices.controllable | boolean |
デバイスが制御可能かどうかを示します |
|
最小
|
data.devices.properties.colorTem.range.min | integer |
色温度の最小値 |
|
最大値
|
data.devices.properties.colorTem.range.max | integer |
色温度の最大値 |
|
取得可能
|
data.devices.retrievable | boolean |
デバイスが取得可能かどうかを示します |
|
サポートされているコマンド
|
data.devices.supportCmds | array of string |
デバイスでサポートされているコマンド |
|
メッセージ
|
message | string |
操作の結果を説明するメッセージ |
|
状態コード
|
code | integer |
応答の HTTP 状態コード |