上限と割り当てにより、Google インフラストラクチャは、 Groups Settings API を不適切な方法で使用しないでください。API からの過剰なリクエストは、 無害な入力ミスや、不必要な API 呼び出しを行う非効率な設計のシステムなどです。 原因にかかわらず、特定のソースからのトラフィックが一定のレベルに達したらブロックすると、 Google Workspace システム全体の健全性を維持するために必要な措置です。
API リクエストの失敗
万が一 API リクエストが失敗した場合、アプリケーションは HTTP ステータス コードを受け取ります。
レスポンスが返されます。HTTP ステータス コード 403 には、API 割り当てを示すエラー情報が含まれています。
を超えています。レスポンスにより、カスタム アプリケーションでエラーを検出し、
できます。
時間的制約のあるリクエスト
リクエストを一定の時間内に完了する必要がある場合は、リクエストを並行して送信します Java や C# のアプリケーションで複数のスレッドを使用したい場合です。たとえば、リクエストを月別や 表示されます。スレッドの場合は、リクエストごとに 1 つのスレッド、10 スレッドから始めてみてください。 スレッドの推奨事項にはトレードオフがあり、すべての API 状況に役立つわけではありません。ラベルの数が 過剰な数に達すると、割り当てエラーが発生します。
時間ベースのエラー
時間ベースのすべてのエラー（スレッドあたり X 秒間の最大 N 個のエラー）、特に
503 ステータス コードのエラーが発生した場合は、コードで例外をキャッチすることをおすすめします。
指数バックオフ
少し遅延してから失敗した呼び出しを再試行します。Groups Settings API の例については、
5 秒待ってから失敗した呼び出しを再試行しますリクエストが成功した場合は、これを繰り返します
他のスレッドが実行します。2 番目のリクエストが成功しなかった場合、アプリケーションは
呼び出しが成功するまでリクエストの頻度をスケールダウンする。たとえば、
最初の 5 秒の遅延から 10 秒に変更され、失敗した通話をもう一度利用できます。再試行も決定する
できます。たとえば、アプリケーションの前に、異なる遅延時間でリクエストを 5 ～ 7 回再試行する
ユーザーにエラーが返されます。
割り当て
| API 割り当てのカテゴリ | 割り当て |
|---|---|
| クエリ/日 | 1 日あたり最大 100,000 件のクエリを作成できます。必要な容量が この上限を超える場合は、 Google Cloud コンソールの [割り当て] ページ |
| グループの説明、最大サイズ | グループの説明は 4,096 文字以内で入力できます。 |
| グループ名、最大サイズ | グループ名は半角 60 文字（全角 30 文字）以内で指定できます。 |
defaultMessageDenyNotificationText |
通知テキストの最大文字数は 10,000 文字です。詳しくは、
defaultMessageDenyNotificationText プロパティの詳細については、
API リファレンス。
|
maxMessageBytes |
デフォルトのメッセージの最大サイズは 1 MB です。maxMessageBytes について詳しくは、
API リファレンスをご覧ください。
|
上限
| 上限の種類 | 制限事項とガイドライン |
|---|---|
| データ形式、デフォルト |
デフォルトのデータ形式は JSON です。API は Atom 形式もサポートしています。JSON と Atom は、 完全な読み取り / 書き込み機能をサポートしています。詳細については、次をご覧ください: JSON と Atom のデータ形式。 |
| Groups Settings API、有効化 | Groups Settings API を呼び出す前に Directory API を有効にする必要があります。詳細については、 詳しくは、Google Workspace API を有効にするをご覧ください。 |