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（非同期モード） | Cloud-to-cloud 統合ごとに 60 秒あたり 6,000 件のリクエストというデフォルトの上限。 | ○ |
| クエリ | Cloud-to-cloud 統合ごとに 60 秒あたり 6,000 件のリクエストというデフォルトの上限。 | ○ |
| 同期 | Cloud-to-cloud 統合ごとに 60 秒あたり 6,000 件のリクエストというデフォルトの上限。 | ○ |
| 削除 | Cloud-to-cloud 統合ごとに 60 秒あたり 6,000 件のリクエストというデフォルトの上限。 | ○ |
| ReportStateAndNotification | Cloud-to-cloud 統合ごとに 60 秒あたり 6,000 件のリクエストというデフォルトの上限。 | ○ |
割り当ての問題をデバッグする
統合でレート制限が発生した場合は、次のガイドラインに沿って割り当ての問題を診断して解決します。
Google は、割り当てを超えた API 呼び出しをレート制限します。これは、状態の不一致を引き起こし、統合に悪影響を及ぼします。たとえば、レート制限が原因で
ReportStateAndNotificationリクエストがドロップされると、実機のステータスが同期されず、Google Home app (GHA) に古い情報が残ります。RequestSyncがエラーが発生しているプライマリ API である場合は、サービスがagentUserIdごとに複数の同時呼び出しを試行していないことを確認します。トラフィックの推移を確認します。この増加が、デバイス数の増加、新しいデバイスタイプのリリース、またはその他の予想されるリリースと一致している場合は、割り当ての増加をリクエストします。この増加が予期しないものである場合は、統合を確認して、予期しない変更によって Home Graph API に送信されるトラフィックが増加しているかどうかを判断します。