このドキュメントでは、Cloud Natural Language に適用される割り当てと上限を示します。
割り当ては、Google Cloud プロジェクトで使用できる共有 Google Cloud リソース（ハードウェア、ソフトウェア、ネットワーク コンポーネントなど）の量を制限します。つまり、割り当てはシステムの一部で、次の機能があります。
- Google Cloud のプロダクトとサービスの使用量や消費量をモニタリングする。
- 公平性の確保や使用量急増の抑制などのため、これらのリソースの消費量を制限する。
- 規定の制限を自動的に適用する構成を維持する。
- 割り当てをリクエストまたは変更する手段を提供する。
ほとんどの場合、割り当てを超過すると、システムは関連する Google リソースへのアクセスをすぐにブロックするため、ユーザーが試行しているタスクは失敗します。ほとんどの場合、割り当ては各 Google Cloud プロジェクトに適用され、その Google Cloud プロジェクトを使用するすべてのアプリケーションと IP アドレスで共有されます。
ほどんどの場合、割り当ての増減を行うには Google Cloud コンソールを使用します。詳細については、割り当ての増加をリクエストするをご覧ください。
Natural Language のリソースにも上限があります。これらの上限は、割り当てシステムとは無関係です。上限は、特に明記されていない限り、変更できません。
言語に関する制限事項
現在、Natural Language API では言語のサポートに記載された言語のみがサポートされています。
コンテンツの割り当て
Natural Language API に対するコンテンツはテキスト文字列として提供されます。Natural Language API では、このテキストを一連のトークン（単語の境界とおおむね一致）とする処理を行います。これらのトークンは、Natural Language API のすべての機能（感情分析、エンティティ抽出、構文解析）で、指定したテキストに対して分析を実行するための構成要素として使用されます。
この API では、各リクエストのコンテンツのサイズに次の割り当てが適用されます。
| コンテンツの割り当て | 値 | オーバーフローの結果 |
|---|---|---|
| テキスト コンテンツ | 1,000,000 バイト | API エラー |
| トークンの割り当て | 100,000 個 | 無視される |
| エンティティへの言及数 | 5,000* | 無視される |
テキスト コンテンツの割り当てを超えるコンテンツを処理しようとすると、エラーが生成されます。トークンの割り当てを超える数のトークンを処理しようとすると、エラーは生成されませんが、その割り当てを超えるトークンは無視されます。
テキスト コンテンツ内で使用されているエンコーディングによっては、バイト数が文字数を反映しない場合があります。
* エンティティの言及数の割り当てには、返されるドキュメント内での言及だけでなく、代名詞を含むこれらのエンティティへの名詞参照も含まれます。このような代名詞は mentions フィールドには直接返されませんが、割り当ての対象としてカウントされます。
リクエストの割り当て
Cloud Natural Language API の現在の使用量の割り当ては次のとおりです（変更される場合があります）。
| 割り当てのタイプ | 使用量の割り当て |
|---|---|
| 1 分あたりのリクエスト数 | 600 |
| 1 日あたりのリクエスト数 | 800,000 |