割り当て管理

Home API には、サービスの信頼性を確保し、デベロッパーがトラフィック量を効果的に管理できるように、割り当てシステムが実装されています。Home API の割り当ては Google Cloud プロジェクト レベルです。

Home API のレート制限は、プロジェクトごとに 30,000 QPM(1 分あたりのクエリ数)です。この上限には、Home API を介して送信されるすべてのクエリが含まれます。

割り当てを超過しました

Google Home API のレート制限を超えると、resourceExhaused HomeException がスローされます。後続のリクエストは、「割り当てを超過しました」というメッセージとともにすぐに拒否されます。

割り当てを超過した場合、アプリは指数バックオフを実装し、アクションが一時的に制限されていることをユーザーに通知する必要があります。

モニタリング

Google Cloud コンソールを使用して使用状況をリアルタイムでモニタリングし、Home APIs の割り当てに近づいたときにプロアクティブなアラートを構成します。

現在の指標を表示するには、Google Home Developer Console でのアプリの登録に関連付けられている Google Cloud プロジェクトの Home API サービスの [指標] セクションに移動します。

アラートを設定する

パートナー様は、割り当てられた数量に基づく割り当てのしきい値(80% など)を超えた場合にアラートを設定することをおすすめします。Google Cloud のアラート サポートは非常に広範で、高度な構成が可能です。

割り当てのアラートを作成する場合は、ポリシー ビルダーの [Consumer Quota] > [Quota] で次の指標を使用します。

  • 数量に基づく割り当ての使用量 - serviceruntime.googleapis.com/quota/allocation/usage
  • 割り当て上限 - serviceruntime.googleapis.com/quota/limit

パートナーは、割り当てアラートを受信するための通知チャンネル(メールなど)も設定する必要があります。

アラートと通知、および Google Cloud でそれらを構成する方法については、次のリソースをご覧ください。

割り当ての増加をリクエストする

アプリに、デフォルトのレート制限よりも高い制限を必要とする正当なトラフィックがある場合は、引き上げをリクエストできます。

使用量と上限を確認するには、Developer Console でのアプリの登録に関連付けられている Google Cloud プロジェクトの Home API サービスの [割り当てとシステム上限] セクションに移動します。

増加をリクエストするには、特定の割り当てを編集します。手順については、Google Cloud ドキュメントの割り当ての調整をリクエストするをご覧ください。