Google は、黒人コミュニティのための人種的公平の促進に取り組んでいます。詳細をご覧ください。

Translate Text

Firebase
Made by Firebase

Cloud Firestore コレクションに書き込まれた文字列を複数の言語に翻訳します(Cloud Translation API を使用)。

この拡張機能の動作

この拡張機能を使用すると、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 を参照

この拡張機能をインストールする方法

Firebase コンソールの使用

拡張機能のインストールと管理は、Firebase コンソールで行えます。

コンソールを使用してインストールする

Firebase CLI の使用

拡張機能のインストールと管理は、Firebase CLI でも行えます。

ステップ 1: 以下の npm コマンドを実行して、CLI をインストールするか、最新バージョンの CLI に更新します。

npm install -g firebase-tools
正常に機能しない場合は、Firebase CLI リファレンスを確認するか、npm のアクセス権を変更してください。

ステップ 2: 新しい Firebase プロジェクトのディレクトリを設定するか、既存のプロジェクト ディレクトリに移動します

ステップ 3: 次を実行して、この拡張機能を拡張機能のマニフェストに追加します

firebase ext:install firebase/firestore-translate-text --local --project=projectId_or_alias

ステップ 4(任意): Firebase Emulator Suite を使用して、この拡張機能をローカルでテストします

firebase emulators:start

ステップ 5: マニフェストにある拡張機能をプロジェクトにデプロイします

firebase deploy --only extensions --project=projectId_or_alias
サポート対象
Cloud Firestore
作成者
ライセンス
Apache-2.0
バージョン
0.1.8