割り当て管理

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

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

割り当てを超過した

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

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

モニタリング

Google Cloud コンソールを使用して、使用状況をリアルタイムでモニタリングし、 Home API の割り当てに近づいたときに事前通知するアラートを構成します。

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

アラートを設定する

割り当てられた割り当てのしきい値(80% など)を超えた場合にアラートを設定することをおすすめします。Google Cloud のアラート機能は非常に 豊富で、高度な構成が可能です。

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

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

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

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

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

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

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

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