DESCRIPTION: Translates strings written to a Cloud Firestore collection into multiple languages (uses Cloud Translation API).
Deployment location: Where should the extension be deployed? You usually want a location close to your database. For help selecting a location, refer to the location selection guide.
Target languages for translations, as a comma-separated list: Into which target languages do you want to translate new strings? The languages are identified using ISO-639-1 codes in a comma-separated list, for example: en,es,de,fr. For these codes, visit the supported languages list.
Collection path: What is the path to the collection that contains the strings that you want to translate?
Input field name: What is the name of the field that contains the string that you want to translate?
Translations output field name: What is the name of the field where you want to store your translations?
CLOUD FUNCTIONS CREATED:
- fstranslate (providers/cloud.firestore/eventTypes/document.write)
DETAILS: Use this extension to translate strings (for example, text messages) written to a Cloud Firestore collection.
This extension listens to your specified Cloud Firestore collection. If you add a string to a specified field in any document within that collection, this extension:
- Translates the string into your specified target language(s); the source language of the string is automatically detected.
- Adds the translation(s) of the string to a separate specified field in the same document.
You specify the desired target languages using ISO-639-1 codes. You can find a list of valid languages and their corresponding codes in the Cloud Translate API documentation.
If the original non-translated field of the document is updated, then the translations will be automatically updated, as well.
Before installing this extension, make sure that you've set up a Cloud Firestore database in your Firebase project.
This extension uses other Firebase or Google Cloud Platform services which may have associated charges:
- Cloud Translation API
- Cloud Firestore
- Cloud Functions
When you use Firebase Extensions, you're only charged for the underlying resources that you use. A paid-tier billing plan is only required if the extension uses a service that requires a paid-tier plan, for example calling to a Google Cloud Platform API or making outbound network requests to non-Google services. All Firebase services offer a free tier of usage. Learn more about Firebase billing.
- translate.googleapis.com (Reason: To use Google Translate to translate strings into your specified target languages.)
This extension will operate with the following project IAM roles:
- datastore.user (Reason: Allows the extension to write translated strings to Cloud Firestore.)