割り当て管理

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

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

割り当てを超過した

Home APIs のレート上限を超えると、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 ドキュメントの割り当ての調整をリクエストするをご覧ください。