使用制限

Google Chat API は共有サービスであるため、すべてのユーザーが公平に使用できるように、また Google Workspace の全体的なパフォーマンスを保護できるように、割り当てと上限が適用されます。

割り当てを超えると、429: Too many requests HTTP ステータス コード レスポンスが返されます。Chat バックエンドでの追加のレート制限チェックでも、同じエラー レスポンスが生成される可能性があります。このエラーが発生した場合は、指数バックオフアルゴリズムを使用して、後で再試行する必要があります。次の表に記載されている 1 分あたりの割り当て内であれば、1 日に送信できるリクエスト数に制限はありません。

Chat API メソッドには、プロジェクトごと、スペースごと、ユーザーごとの割り当てなど、複数の割り当てタイプが適用される場合があります。

プロジェクトごとの割り当て

プロジェクトごとの割り当ては、Google Cloud プロジェクトのクエリレートを制限するため、割り当てごとに指定された Chat API メソッドを呼び出す単一の Chat アプリに適用されます。

次の表に、プロジェクトごとのクエリ上限を示します。これらの上限は、[割り当て] ページでも 確認できます。

プロジェクトごとの割り当て	Chat API メソッド	上限（60 秒あたり）
1 分あたりのメッセージの書き込み数	spaces.messages.create spaces.messages.patch spaces.messages.delete	3000
1 分あたりのメッセージの読み取り数	spaces.messages.get spaces.messages.list	3000
1 分あたりのメンバーシップの書き込み数	spaces.members.create spaces.members.delete	300
1 分あたりのメンバーシップの読み取り数	spaces.members.get spaces.members.list	3000
1 分あたりのスペースの書き込み数	spaces.setup spaces.create spaces.patch spaces.delete	60
1 分あたりのスペースの読み取り数	spaces.get spaces.list spaces.findDirectMessage	3000
1 分あたりの添付ファイルの書き込み数	media.upload	600
1 分あたりの添付ファイルの読み取り数	spaces.messages.attachments.get media.download	3000
1 分あたりのリアクションの書き込み数	spaces.messages.reactions.create spaces.messages.reactions.delete	600
1 分あたりのリアクションの読み取り数	spaces.messages.reactions.list	3000
1 分あたりの CustomEmoji の書き込み数	customEmojis.create customEmojis.delete	600
1 分あたりの CustomEmoji の読み取り数	customEmojis.get customEmojis.list	3000
1 分あたりのセクションの書き込み数	users.sections.create users.sections.delete users.sections.patch users.sections.position users.sections.items.move	600
1 分あたりのセクションの読み取り数	users.sections.list users.sections.items.list	3000

スペースごとの割り当て

スペースごとの割り当ては、特定のスペースのクエリレートを制限し、そのスペースで動作するすべての Chat アプリ間で共有されます。割り当てごとに、リストされている Chat API メソッドを呼び出します。

次の表に、スペースごとのクエリ上限を示します。

スペースごとの割り当て	Chat API メソッド	上限（1 秒あたり）
1 秒あたりの読み取り数	media.download spaces.get spaces.members.get spaces.members.list spaces.messages.get spaces.messages.list spaces.messages.attachments.get spaces.messages.reactions.list	15
1 秒あたりの書き込み数	media.upload spaces.delete spaces.patch spaces.messages.create（受信ウェブフックには追加の上限が適用されます） spaces.messages.delete spaces.messages.patch spaces.messages.reactions.delete	1
1 秒あたりのリアクションの作成の書き込み数	spaces.messages.reactions.create	5
Google Chat にデータをインポートする際の 1 秒あたりのメッセージの書き込み数	spaces.messages.create	10

ユーザーあたりの割り当て

ユーザーあたりの割り当ては、Google Chat ユーザーのクエリレートを制限します。クエリは、ユーザーに代わって（ユーザー認証を使用して）Chat API メソッドを呼び出すすべての Chat アプリに関連します。

次の表に、ユーザーごとのクエリ上限を示します。

ユーザーあたりの割り当て	Chat API メソッド	上限（1 秒あたり）
1 秒あたりの CustomEmoji の書き込み数	customEmojis.create customEmojis.delete	1
1 秒あたりの CustomEmoji の読み取り数	customEmojis.get customEmojis.list	15
1 秒あたりのセクションの書き込み数	users.sections.create users.sections.delete users.sections.patch users.sections.position users.sections.items.move	1
1 秒あたりのセクションの読み取り数	users.sections.list users.sections.items.list	15

その他の使用量上限

同じスペースをターゲットとする API トラフィックが多いと、 追加の内部上限がトリガーされる可能性があります。これは [割り当て] ページには表示されません。

時間ベースの割り当てエラーを解決する

時間ベースのエラー（X 分あたり最大 N リクエスト）については、 デバイスが過剰な負荷を生成しないように、コードで例外をキャッチして切り捨て指数バックオフを使用することをおすすめします。

指数バックオフは、ネットワーク アプリケーションに使われる標準的なエラー処理方法です。 指数バックオフのアルゴリズムは、リクエスト間の待ち時間の間隔を最大バックオフ時間まで増加させながら、指数関数的にリクエストを再試行します。 リクエストがまだ成功しない場合は、 リクエストが成功するまでリクエスト間の遅延を徐々に増やすことが重要です。

アルゴリズムの例

指数バックオフのアルゴリズムは、再試行の待ち時間の間隔を最大バックオフ時間まで増加させながら、指数関数的にリクエストを再試行します。次に例を示します。

1. Google Chat API にリクエストを送信します。
2. リクエストが失敗した場合は、1 + random_number_milliseconds 待ってからリクエストを再試行します 。
3. リクエストが失敗した場合は、2 + random_number_milliseconds 待ってからリクエストを再試行します 。
4. リクエストが失敗した場合は、4 + random_number_milliseconds 待ってからリクエストを再試行します 。
5. このようにして、最大 maximum_backoff 時間まで繰り返します。
6. 最大再試行回数まで待機と再試行を繰り返しますが、再試行間の待機時間 は増やしません。

ここで

• 待機時間は min(((2^n)+random_number_milliseconds), maximum_backoff), で、n は反復（リクエスト）ごとに 1 ずつ増加します。
• random_number_milliseconds は、1,000 以下のランダムなミリ秒数です。これにより、ある状況で、多数のクライアントが同期して再試行を一度に実行し、リクエストが同時に次々と送信されるような状況を避けることができます。random_number_milliseconds の値は、再試行リクエストごとに再計算されます。
• 通常、maximum_backoff は 32 秒または 64 秒です。適切な値 はユースケースによって異なります。

クライアントは、maximum_backoff 時間に達した後も再試行を続けることができます。 この時点より後の再試行では、バックオフ時間を増加させ続ける必要はありません。たとえば、クライアントが maximum_backoff 時間として 64 秒を使用している場合、この値に達すると、クライアントは 64 秒ごとに再試行できます。ある時点で、 クライアントが無期限に再試行しないようにする必要があります。

適切な再試行間の待ち時間と再試行回数は、ユースケース とネットワークの状態により異なります。

プロジェクトごとの割り当ての引き上げをリクエストする

プロジェクトのリソース使用量に応じて、割り当ての調整をリクエストできます。 サービス アカウントによる API 呼び出しは、 単一のアカウントを使用しているとみなされます。割り当ての調整を申請しても、必ずしも承認されるとは限りません。割り当て値を大幅に増やす割り当て調整 リクエストは、承認に時間がかかることがあります。

割り当て量はすべてのプロジェクトで同じとは限りません。Google Cloud の使用量が増えるにつれて、割り当て値を増やす必要がある場合があります。使用量の大幅な増加が見込まれる場合は、事前に [割り当ての調整] を Google Cloud コンソールの[割り当て] ページ からリクエストできます。

詳細については、次のリソースをご覧ください。

• 割り当ての調整について
• 現在の割り当ての使用量と上限を確認する
• 割り当て上限の引き上げをリクエストする