このドキュメントでは、Cloud Natural Language に適用される割り当てとシステムの上限を示します。割り当ては、使用できるカウント可能な共有リソースの量を指定します。割り当ては、Cloud Natural Language などの Google Cloud サービスによって定義されます。システムの上限は、変更できない固定値です。
Google Cloud では、割り当てを使用して公平性を確保し、リソースの使用量と可用性の急増を抑えます。割り当ては、Google Cloud プロジェクトで使用できる Google Cloud リソースの量を制限します。割り当ては、ハードウェア、ソフトウェア、ネットワーク コンポーネントなど、さまざまなリソースタイプに適用されます。たとえば、割り当てによって、サービスへの API 呼び出しの数、プロジェクトで同時に使用されるロードバランサの数、作成可能なプロジェクトの数を制限できます。割り当てを適用することで、サービスの過負荷を防ぎ、Google Cloud ユーザーのコミュニティを保護します。割り当ては、自組織で使用している Google Cloud リソースの管理にも役立ちます。
Cloud Quotas システムは次のことを行います。
- Google Cloud のプロダクトとサービスの消費量をモニタリングする
- これらのリソースの消費量を制限する
- 割り当て値の変更をリクエストする方法を提供する
ほとんどの場合、割り当ての許容量を超えるリソースを消費しようとすると、システムによってリソースへのアクセスがブロックされ、実行しようとしているタスクは失敗します。
割り当ては通常、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 |