v2
endpoints, you can create, delete, and retrieve information on monolingual glossaries - glossaries that map one language to another.
The v3
endpoints include all the functionality of v2
endpoints, plus:
v3
lets you edit glossariesv3
lets you work with multilingual glossaries - a collection of mappings for a set of language pairs.v3
. v2
is kept for backward compatibility. If you already use v2
endpoints, moving to v3
will give you additional functionality, but there is no need to migrate your glossaries. You can simply start using v3
endpoints with any glossary.
We strongly discourage using both v2
and v3
endpoints in your code. If you use v3
endpoints to edit a glossary, v2
endpoints may return unexpected results for that glossary, and v2
endpoints will no longer be able to delete it.
Glossaries from either endpoint can be used in all translation endpoints - which includes both /translate
and /document
.
Going forward, we will continue to add features and functionality to v3
.
v2
lets you work with monolingual glossaries - glossaries that contain a list of mappings from source phrases in one language to target phrases in another. For example, a short glossary containing translations from English to German could look like this:
v3
works with multlingual glossaries - a collection of dictionaries each of which contain mappings from source phrases in one language to target phrases in another. We could use v3
to add to the glossary above a dictionary that maps phrases from German to English, like this:
v3
.