Device Access プロジェクトがユーザー、構造、レート制限によって制限されている 環境と商用オファーの種類によって異なります
Google はデベロッパーに魅力的なユーザー エクスペリエンスを提供したいと考えていますが、 お客様が Google Nest のサービスとデバイスを常に利用できる状態にする。統合によって 一定の期間に多数のリクエストを行うと、 SDM API がレート制限を適用します。 レート制限によって、一定期間における API 呼び出しの回数が制限され、 リソースの過剰使用を防ぐことができます。
環境別の上限
すべてのプロジェクトは サンドボックス 環境で始まります。サンドボックスは SDM API および個人使用の評価を目的としている それに応じて上限が制限されますユーザーベースが大きい環境: 商用開発 には異なる制限が適用されます。
サンドボックス ユーザー数の上限
サンドボックスのデベロッパー アカウントは 5 ユーザーで 25 ユーザーに制限されています すべてのプロジェクトで同じ構造を使用します。アカウントごとに 3 つのプロジェクトという上限があります。
ストラクチャはそれぞれ 5 人のユーザーに制限されているため、ユーザー数の上限に達することはありません 5 つのストラクチャがすべて 5 ユーザーで上限に達した場合。デベロッパー アカウント （プロジェクトを所有する）は、 構成します。
逆に、プロジェクトに 5 つのストラクチャにわたる 15 人のユーザーが存在する場合、 ストラクチャの上限があるため、既存の 5 つのストラクチャにのみ追加できます リーチできます
サンドボックスのレート制限
サンドボックスは 3 つの異なるレベルでレート制限されています。上限は次の値に設定されます: 特に明記されていない限り、1 分あたりのクエリ数（QPM）を基準としています。
API レベル
API 呼び出しは、プロジェクトごと、ユーザーごとに制限されています。API 個別のリソースに関する詳細については、 あります。
| API メソッド | レート制限 |
|---|---|
devices.executeCommand |
10 QPM |
devices.get |
10 QPM |
devices.list |
5 QPM |
structures.get |
5 QPM |
structures.list |
5 QPM |
structures.rooms.get |
5 QPM |
structures.rooms.list |
5 QPM |
コマンドレベル
各トレイト コマンド（devices.executeCommand）は、プロジェクトごとに 5 QPM に制限されています。
です。
つまり、プロジェクトに 2 人のユーザーがいて、それぞれに 2 台のデバイス（合計 4 台のデバイス）がある場合、 4 つのデバイスそれぞれに対して、同じコマンドを 1 分間に 5 回呼び出すことができます。
ただし、2 人のユーザーが 2 人で、3 台のデバイスをそれぞれ合計 6 台使用している場合、
6 つのコマンドのそれぞれについて、同じコマンドを 1 分間に 5 回呼び出すことはできません。
できます。この場合、ユーザーごとに 15 QPM になります。
devices.executeCommand プロジェクトのユーザーに対する API レベルのレート制限は 10 QPM です。
デバイスのインスタンス レベル
さらに、デバイスのインスタンス レベル制限は複数のプロジェクトにわたって実装され、
デバイスのバッテリー保護のコマンド（devices.executeCommand）これらの上限
QPM と 1 時間あたりのクエリ数（QPH）の両方で適用されます。
get と list の API メソッドに追加します。
たとえば、プロジェクト A とプロジェクト B の両方が同じリソースに対して （ユーザーはおそらく、2 つの異なる商用デバイスの認証を 同じデバイスを使用する統合など）が含まれます。プロジェクト A から 4 つのコマンドが デバイス A が 1 分以内にデバイス A に送信される場合、プロジェクト B はデバイス A に 1 つのコマンドしか送信できません。 同じ時間内にデバイス インスタンス レベルのレート制限に達します。その時点で 両方のプロジェクトからデバイス A へのコマンドは、 デバイス A への最初のコマンドから始まる分。
以下のリストに記載されていないデバイスタイプには、デバイス インスタンス レベルがありません。 使用しないでください。
| デバイスの種類 | デバイス インスタンスのレート制限 |
|---|---|
| サーモスタット | 5 QPM または 100 QPH |
| カメラ | 30 QPM または 100 QPH |
| DOORBELL | 30 QPM または 100 QPH |
エラー
このガイドに関連して、次のエラーコードが返される場合があります。
| エラー メッセージ | RPC | トラブルシューティング |
|---|---|---|
| レート制限あり。 | RESOURCE_EXHAUSTED |
デベロッパーごとに割り当てがあり、呼び出し回数に上限があります。割り当て数を超える呼び出しを行うと、レート制限に関するメッセージが表示されます。この問題を解決するには、割り当ての期限が切れた後に呼び出しを再送信します。 |
詳しくは、API エラーコード リファレンスをご覧ください。 API エラーコードの完全なリスト。