Translate Text

この拡張機能の動作

この拡張機能を使用すると、Cloud Firestore コレクションに書き込まれた文字列（テキスト メッセージなど）を翻訳できます。

この拡張機能は、指定された Cloud Firestore コレクションをリッスンします。そのコレクションのいずれかのドキュメントに含まれる指定のフィールドに文字列を追加すると、この拡張機能によって次の処理が行われます。

• 文字列が指定したターゲット言語に翻訳されます。文字列のソース言語は自動的に検出されます。
• 文字列の翻訳結果が、同じドキュメント内にある別の指定されたフィールドに追加されます。

目的のターゲット言語は、ISO-639-1 コードを使用して指定します。有効な言語とそれに対応するコードのリストについては、Cloud Translation API ドキュメントをご覧ください。

ドキュメントの元（翻訳前）のフィールドが更新されると、翻訳も自動的に更新されます。

複数のコレクションの翻訳

複数のコレクションを翻訳するには、この拡張機能を複数回インストールして、毎回異なる コレクション パスを指定します。現時点では、インストールできる拡張機能のインスタンス数に制限はありません。

複数のフィールドの翻訳

複数のフィールドを翻訳するには、入力フィールドに入力文字列のマップを保存します。

admin.firestore().collection('translations').add({
  first: "My name is Bob",
  second: "Hello, friend"
})

複数の言語

テキストを複数の言語に翻訳するには、languages パラメータに言語のカンマ区切りのリスト（例: en,fr,de）を設定します。 サポートされる言語のリストをご覧ください。

追加の設定

この拡張機能をインストールする前に、Firebase プロジェクトで Cloud Firestore データベースを設定していることを確認してください。

料金

拡張機能をインストールするには、プロジェクトを Blaze（従量課金制）プランに含める必要があります。

• この拡張機能に必要な Firebase リソースに対しては、使用しない場合でも、小額の料金（通常は約 $0.01/月）が請求されます。
• この拡張機能は、次のような他の Firebase サービスや Google Cloud Platform サービスを使用するため、こうしたサービスの無料枠を超えた場合には関連する料金が発生します。
• Cloud Translation API
• Cloud Firestore
• Cloud Functions（Node.js 10 を超えるランタイム。FAQ を参照）