3 minute read
Key Concepts
Terms
Provider
A translation provider provides translation services. It is an entity that Provider API users can create, as a target for Content API users to submit jobs for translation or processing.
Job
A job is a container of translation asset tasks that is sent as a single unit to the provider.
AssetTask
Asset tasks are translation tasks for source files. An asset task specifies the necessary information for file transfer, as well as the source language it is in and the target language it needs to be translated into.
SupportAsset
Supporting documents and their metadata. Support assets are not translated by the translation provider, but they provide helpful context for the translator
FileTransfer
An object containing information for transferring source or translated (target) files between the Connector and the translation provider, using the Lionbridge File Management Service (FMS). For more information, please visit the ContentAPI v2 developer page on file transfer.
Listener
Webhook for notifying provider about jobs and asset tasks changes.
TranslationMemory
Updates for previously translated material stored on the provider or TMS.
Status
Jobs
Translation jobs can have the following statuses:
| Status | Description |
|---|---|
| SENDING | The ContentAPI Connector is sending out the translation job to the translation provider. |
| SENDING_READY_FOR_RETRIEVE | The ContentAPI Connector has sent the translation job to the translation provider, but provider has not confirmed translation work has started yet. |
| IN_TRANSLATION | The translation provider has received the translation job and has started working on it. |
| SENT_TO_TRANSLATOR | The provider has started working on the job. |
| COMPLETED | The ContentAPI Connector user has marked the translation job as completed. No new translation will be processed afterwards. |
| CANCELLED | The job was cancelled and the untranslated requests will not be translated. |
Note that the statuses listed are for ProviderAPI. ContentAPI has a its own list of Job statuses.
AssetTasks
Asset tasks can have the following statuses:
| Status | Description |
|---|---|
| SENDING | The ContentAPI Connector is sending out the translation requests to the translation provider as part of translation job. |
| SENDING_READY_FOR_RETRIEVE | The ContentAPI Connector has sent the translation request to the translation provider as part of translation job, but provider has not confirmed translation work has started yet. |
| SENT_TO_PROVIDER | (Reserved for future use) |
| IN_TRANSLATION | The translation provider has received the translation request and has started working on it. |
| TRANSLATION_SUBMITTED | The translation request has been translated by the provider, and is ready for retrieval and review |
| TRANSLATION_ACKNOWLEDGED | (Reserved for future use) |
| TRANSLATION_REJECTED | The ContentAPI Connector user has reviewed and rejected the translated request. |
| TRANSLATION_APPROVED | The ContentAPI Connector user has reviewed and approved the translated request. |
| CANCELLED | The translation request has been canceled. |
Note that the statuses listed are for ProviderAPI. ContentAPI has a its own list of Request statuses.