Google フォーム API は共有サービスであるため、すべてのユーザーが公平に使用できるように、また Google Workspace システム全体の健全性を保護するために、割り当てと上限が適用されます。
割り当てを超えると、通常は 429: Too many requests HTTP ステータス コード レスポンスが返されます。この場合は、指数バックオフ アルゴリズムを使用して、後でもう一度試してください。以下の 1 分あたりの割り当ての範囲内であれば、1 日に送信できるリクエスト数に制限はありません。
注: フォームのウォッチには追加の制限があります。詳細については、プッシュ通知を設定して受信するをご覧ください。
次の表に、リクエストの上限の詳細を示します。
| 割り当て | |||||||
|---|---|---|---|---|---|---|---|
| 読み取りリクエスト |
|
||||||
|
コストの高い読み取りリクエスト
( |
|
||||||
| 書き込みリクエスト |
|
||||||
時間ベースの割り当てエラーを解決する
時間ベースのエラー(X 分あたり最大 N 件のリクエスト)については、コードで例外をキャッチし、指数バックオフを使用してデバイスが過剰な負荷を生成しないようにすることをおすすめします。
指数バックオフは、ネットワーク アプリケーションの標準的なエラー処理方法です。指数バックオフのアルゴリズムは、リクエスト間の待ち時間の間隔を最大バックオフ時間まで増加させながら、指数関数的にリクエストを再試行します。それでもリクエストが失敗する場合は、リクエストが成功するまで、リクエスト間の遅延を徐々に長くすることが重要です。
アルゴリズムの例
指数バックオフのアルゴリズムは、再試行の待ち時間の間隔を最大バックオフ時間まで増加させながら、指数関数的にリクエストを再試行します。次に例を示します。
- Google フォーム API にリクエストを送信します。
- リクエストが失敗した場合、1 +
random_number_milliseconds秒待ってから、リクエストを再試行します。 - リクエストが失敗した場合、2 +
random_number_milliseconds秒待ってから、リクエストを再試行します。 - リクエストが失敗した場合、4 +
random_number_milliseconds秒待ってから、リクエストを再試行します。 - このようにして、最大
maximum_backoff時間まで繰り返します。 - 再試行の最大回数に達するまで待機と再試行を続けるが、再試行の間の待ち時間は増加させない。
ここで
- 待ち時間は
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 秒ごとに再試行できます。いずれかの時点で、クライアントが無限に再試行を行わないようにする必要があります。
適切な再試行間の待ち時間と再試行回数は、ユースケースとネットワークの状態により異なります。
料金
Google フォーム API の標準的な使用はすべて追加料金なしでご利用いただけます。割り当てリクエストの上限を超えると、2026 年後半に Google Cloud 請求先アカウントに料金が発生する予定です。詳細については、エージェント ツールと API の Google Workspace 標準化モデルをご覧ください。
割り当ての増加をリクエストする
プロジェクトのリソース使用量に応じて、割り当ての調整をリクエストできます。サービス アカウントによる API 呼び出しは、単一のアカウントを使用していると見なされます。割り当ての調整を申請しても、必ずしも承認されるとは限りません。割り当て値を大幅に増やす割り当て調整リクエストは、承認に時間がかかることがあります。
割り当て量はすべてのプロジェクトで同じとは限りません。Google Cloud の使用量が多くなるに伴い、割り当て値を増やすことが必要になる場合があります。使用量の大幅な増加が見込まれる場合は、事前に Google Cloud コンソールの [割り当てとシステム上限] ページから割り当ての調整をリクエストできます。
詳細については、次のリソースをご覧ください。