Google Home では、リソースの割り当てと使用量に上限が設定され、プロジェクトごとに割り当てが適用されます。具体的なポリシーは、リソースの可用性、ユーザー プロフィール、サーバー使用量の履歴などの要因に応じて異なり、予告なく変更される場合があります。
HomeGraph API の制限
このセクションでは、Google Home Graph API のレート制限を示します。これらの制限は、REST API と RPC API の両方に適用されます。
Google では、Cloud-to-cloud 統合単位で、クエリ、同期、削除、Report State、非同期リクエストの同期 API 呼び出しの合計に対し、60 秒あたりのリクエスト数を 6,000 件とするデフォルト上限を適用しています。
割り当ての増加をリクエストするには、次の情報を添えて ha-certification@google.com までご連絡ください。
- メールの件名: ReportState API の割り当て増加のリクエスト
- メールの内容:
- プロジェクト ID
- 会社名
- 現在の割り当て
- 割り当ての引き上げを希望する理由
| 割り当て | 上限 | 上限引き上げ可否 |
|---|---|---|
| RequestSync（非同期モード） | agentUserId あたりの同時リクエスト数の上限: 1 件。
|
× |
| RequestSync（非同期モード） | 60 秒あたりのリクエスト数のデフォルト上限（Cloud-to-cloud インテグレーション単位）: 6,000 件。 | ○ |
| クエリ | 60 秒あたりのリクエスト数のデフォルト上限（Cloud-to-cloud インテグレーション単位）: 6,000 件。 | ○ |
| 同期 | 60 秒あたりのリクエスト数のデフォルト上限（Cloud-to-cloud インテグレーション単位）: 6,000 件。 | ○ |
| 削除 | 60 秒あたりのリクエスト数のデフォルト上限（Cloud-to-cloud インテグレーション単位）: 6,000 件。 | ○ |
| ReportStateAndNotification | 60 秒あたりのリクエスト数のデフォルト上限（Cloud-to-cloud インテグレーション単位）: 6,000 件。 | ○ |
割り当ての問題をデバッグする
統合でレート制限が発生した場合は、次のガイドラインに沿って割り当ての問題を診断し、解決してください。
割り当てを超えた API 呼び出しはレート制限されます。これにより、状態の不一致が発生し、統合に悪影響が及びます。たとえば、レート制限のために
ReportStateAndNotificationリクエストがドロップされると、実機のステータスの同期が失敗し、Google Home app (GHA) に古い情報が残ります。RequestSyncがエラーが発生しているプライマリ API の場合は、サービスがagentUserIdあたり 1 つ以上の同時呼び出しを試みていないことを確認します。トラフィックの経時的な増加を確認します。この増加がデバイス数の増加、新しいデバイスタイプのリリース、その他の予想されるリリースと一致する場合は、割り当ての増加をリクエストします。この増加が予想外の場合は、統合を見直して、予期しない変更によってホームグラフ API に送信されるトラフィックが増加していないか確認します。