deepl-rb 3.8.0 → 3.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1e06f20b76b38eff20ef4f3f7c7863f374afe2e314438b0bc021df6c4535f991
-  data.tar.gz: 30ac12887bd80d6e81cf5c815e5bb8bc5725ea50c66edfd7f4c34c1881e5ad5d
+  metadata.gz: 35f6c08b68a4b9aa8907b543ebbfbab38e9f9f35f7e2dc60decaa4bac57340f5
+  data.tar.gz: 975d1d68cd43fec41b93252b609bc67a619d08d4fd2e6d6bc9b822ca01fd78ac
 SHA512:
-  metadata.gz: 0c5ded1350056aa468d7255ff93eb537dfcf141608a1761651530d5a1d01851bd242a1f205b14626ff8136ec103f38911731242f86e0127e00e75a6fc5c7da08
-  data.tar.gz: 570ce96a8751e4de0116b93cac78d08453df5eaf65bef669f9151b361481ab85bea83f72e8d07ffaac01c7e010d8537fd003b0ef3f762d2cc3b2c29c601bfec0
+  metadata.gz: 749cd28143798f5e08ba848bc4eaa476254ef24656e690fcb3e5ca84314eb54f68ffc7f3675ae74a0cc24c01d194d9dfebcd2d819e0982fad44aba5869e37344
+  data.tar.gz: 4a3b7ca19832725c49b0708f544f9842de7733cc8777b41f66835e4dbead815994ca6dab8b8b3052d172417240dcf5fff5934fc3959ef226001e8ad4e0769735

data/.gitlab-ci.yml

@@ -4,7 +4,7 @@ include:
   - project: '${CI_PROJECT_NAMESPACE}/ci-libs-for-client-libraries'
     file:
       - '/${CI_PROJECT_NAME}/.gitlab-ci.yml'
-  - project: 'deepl/ops/ci-cd-infrastructure/gitlab-ci-lib'
+  - project: 'deepl-org/deepl/devex/gitlab-ci-lib'
     file:
       - '/templates/.buildkit.yml'
       - '/templates/.secret-detection.yml'

data/CHANGELOG.md

@@ -5,6 +5,27 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
+
+## [3.9.0] - 2026-08-11
+### Added
+- Added support for using multiple glossaries in text and document translation
+  via the `glossary_ids` option (up to 5 glossary IDs) in `translate` and
+  document upload.
+- Added support for using a style rule in document translation via the
+  `style_id` option (the `style_rule` option) in document upload.
+- Added support for using a translation memory in document translation via the
+  `translation_memory_id` option (the `translation_memory` and
+  `translation_memory_threshold` options) in document upload.
+- Added support for translation memory management via `DeepL.translation_memories`:
+  `find()`, `segments()`, `destroy()`, `create_import()`, `upload_file()`,
+  `create_export()`, `find_job()`, `wait_until_job_done()`, `download_export()`,
+  and the convenience methods `import_from_filepath()` and `export_to_filepath()`.
+  Every method taking a translation memory accepts a string ID or a
+  `TranslationMemory` object. `wait_until_job_done()`, `import_from_filepath()`
+  and `export_to_filepath()` accept an optional `timeout_s` to stop waiting for
+  a job that does not finish. Please refer to the README for usage instructions.
+- Added the `creation_time` and `updated_time` attributes to `TranslationMemory`.
+
 ### Changed
 - Reworked the test suite to run against the `deepl-mock` server with OpenAPI
   request and response validation enabled in CI, replacing recorded VCR
@@ -134,7 +155,8 @@ The change in major version is only due to the change in maintainership, there i
 ### Fixed
 - Make RequestEntityTooLarge error message more clear
 
-[Unreleased]: https://github.com/DeepLcom/deepl-rb/compare/v3.8.0...HEAD
+[Unreleased]: https://github.com/DeepLcom/deepl-rb/compare/v3.9.0...HEAD
+[3.9.0]: https://github.com/DeepLcom/deepl-rb/compare/v3.8.0...v3.9.0
 [3.8.0]: https://github.com/DeepLcom/deepl-rb/compare/v3.7.0...v3.8.0
 [3.7.0]: https://github.com/DeepLcom/deepl-rb/compare/v3.6.1...v3.7.0
 [3.6.1]: https://github.com/DeepLcom/deepl-rb/compare/v3.6.0...v3.6.1

data/README.md

@@ -267,6 +267,25 @@ puts translation.text
 # => Ojalá tuviéramos un auto.
 ```
 
+To use more than one glossary at once, specify the `glossary_ids` option with an
+array of up to 5 glossary IDs (as strings or `DeepL::Resources::Glossary`
+objects) instead of `glossary_id`. This works for both text and document
+translation. `glossary_ids` requires `source_lang` to be set, cannot be combined
+with `glossary_id`, and raises `ArgumentError` if these rules are violated or
+more than 5 IDs are provided:
+
+```rb
+# Text translation with multiple glossaries
+translation = DeepL.translate 'Hello World', 'EN', 'ES',
+                              glossary_ids: ['aa48c7f0-0d02-413e-8a06-d5bbf0ca7a6e',
+                                             'bb59d8g1-1e13-524f-9b17-e6ccg1db8b7f']
+
+# Document translation with multiple glossaries
+handle = DeepL.document.upload 'my_document.docx', 'EN', 'ES', 'my_document.docx',
+                              glossary_ids: ['aa48c7f0-0d02-413e-8a06-d5bbf0ca7a6e',
+                                             'bb59d8g1-1e13-524f-9b17-e6ccg1db8b7f']
+```
+
 To list all the glossaries available, use the `glossaries.list` method:
 
 ```rb
@@ -457,6 +476,15 @@ style_rules = DeepL.style_rules.list
 translation = DeepL.translate 'Hello World', 'EN', 'ES', style_rule: style_rules.first
 ```
 
+The same `style_rule` option can be passed to document translation via
+`DeepL.document.upload` (or `DeepL.document.translate_document`), accepting either
+a style rule ID string or a `StyleRule` object:
+
+```rb
+handle = DeepL.document.upload 'my_document.docx', 'EN', 'ES', 'my_document.docx',
+                              style_rule: 'dca2e053-8ae5-45e6-a0d2-881156e7f4e4'
+```
+
 ### Translation Memories
 
 Translation memories allow you to store and reuse previously created translations.
@@ -464,11 +492,11 @@ They can be used in text translation requests to improve consistency by matching
 against stored segments. Multiple translation memories can be stored with your
 account, each with a source language and one or more target languages.
 
-#### Uploading and managing translation memories
+Translation memories can also be managed in the DeepL UI via
+https://www.deepl.com/translation-memory.
 
-Currently translation memories must be uploaded and managed in the DeepL UI via
-https://www.deepl.com/translation-memory. Full translation memory management via
-the API will come shortly.
+Every method that takes a translation memory accepts either a string containing
+the translation memory ID or a `TranslationMemory` object.
 
 #### Listing translation memories
 
@@ -490,6 +518,176 @@ end
 translation_memories = DeepL.translation_memories.list(page: 0, page_size: 10)
 ```
 
+#### Retrieving a single translation memory
+
+`translation_memories.find` retrieves one translation memory by ID. In addition
+to the fields returned by `list`, the resource carries the `creation_time` and
+`updated_time` timestamps.
+
+```rb
+tm = DeepL.translation_memories.find 'YOUR_TM_ID'
+
+puts tm.class
+# => DeepL::Resources::TranslationMemory
+puts tm.name
+# => 'Legal'
+puts tm.segment_count
+# => 12
+puts tm.creation_time.class
+# => Time
+```
+
+#### Listing the segments of a translation memory
+
+`translation_memories.segments` returns one page of the segments of a
+translation memory as a `TranslationMemorySegments` object. Each segment holds
+the source text and one target per target language of the translation memory.
+
+Pagination is cursor-based: omit `page_cursor` on the first call, then pass the
+`next_page_cursor` of the previous response until `next_page?` is `false`. The
+method also accepts `page_size` (1-100, defaults to 50), `filter_text` (a
+substring matched against the source and target texts, at least 2 characters)
+and `filter_case_sensitive` (defaults to `false`).
+
+Note that `segment_count` is the number of segments stored in the translation
+memory; a text filter does not reduce it.
+
+```rb
+page = DeepL.translation_memories.segments 'YOUR_TM_ID', page_size: 50
+
+puts page.class
+# => DeepL::Resources::TranslationMemorySegments
+puts page.segment_count
+# => 12
+puts page.segments.first.source_text
+# => 'Quelltext Nummer 0'
+puts page.segments.first.targets.first.target_text
+# => 'Source text number 0'
+
+# Walk through every page of segments
+while page.next_page?
+  page = DeepL.translation_memories.segments 'YOUR_TM_ID',
+                                             page_size: 50,
+                                             page_cursor: page.next_page_cursor
+end
+
+# Only the segments matching a text
+page = DeepL.translation_memories.segments 'YOUR_TM_ID',
+                                           filter_text: 'Nummer 1',
+                                           filter_case_sensitive: true
+```
+
+#### Importing a translation memory
+
+`translation_memories.import_from_filepath` creates a new translation memory
+from a TMX file. It creates the import job, uploads the file and waits for the
+processing to finish, and returns the finished `TranslationMemoryJob`. Its
+result carries the ID of the newly created translation memory.
+
+```rb
+job = DeepL.translation_memories.import_from_filepath 'legal.tmx',
+                                                      display_name: 'Legal',
+                                                      timeout_s: 300
+
+puts job.class
+# => DeepL::Resources::TranslationMemoryJob
+puts job.status
+# => 'completed'
+puts job.result.translation_memory_id
+# => 'a74d88fb-ed2a-4943-a664-a4512398b994'
+puts job.result.skipped_segment_count
+# => 0
+```
+
+The three steps can also be performed separately, for example to upload a file
+that is not available on the local file system. The upload URL is a pre-signed
+storage URL outside of the DeepL API, so no authorization header is sent with
+the upload.
+
+```rb
+content = File.binread 'legal.tmx'
+created = DeepL.translation_memories.create_import 'legal.tmx', content.bytesize,
+                                                   content_type: 'application/xml',
+                                                   display_name: 'Legal'
+
+puts created.upload_url
+# => 'https://...'
+
+DeepL.translation_memories.upload_file created, content
+job = DeepL.translation_memories.wait_until_job_done created.job_id
+```
+
+Until the file is uploaded the job stays in the `awaiting_input` status and
+`result.required_action` describes what is missing. The API detects the upload
+asynchronously, so the job keeps reporting `awaiting_input` for a while
+afterwards, typically around half a minute, before it completes.
+`wait_until_job_done` therefore polls through that status like any other
+non-terminal one. A job whose file is never uploaded does not finish on its own,
+so pass `timeout_s` when that is a possibility.
+
+#### Exporting a translation memory
+
+`translation_memories.export_to_filepath` writes a translation memory to a TMX
+file. It creates the export job, waits for it to finish and downloads the
+result, overwriting the output file if it already exists.
+
+```rb
+job = DeepL.translation_memories.export_to_filepath 'YOUR_TM_ID', 'export.tmx'
+
+puts job.status
+# => 'completed'
+```
+
+The steps can be performed separately as well. Repeating the export of an
+unchanged translation memory reuses the previously completed job instead of
+starting a new one, which `reused_existing?` reports. Just like the upload URL,
+the download URL is a pre-signed storage URL and is requested without an
+authorization header.
+
+```rb
+created = DeepL.translation_memories.create_export 'YOUR_TM_ID'
+
+puts created.reused_existing?
+# => false
+
+job = DeepL.translation_memories.wait_until_job_done created.job_id
+
+puts job.result.download_url
+# => 'https://...'
+
+DeepL.translation_memories.download_export job, 'export.tmx'
+```
+
+#### Tracking import and export jobs
+
+`translation_memories.find_job` returns the current status of an import or
+export job, and `translation_memories.wait_until_job_done` polls it every five
+seconds until it finished, raising if the job failed or expired. Pass
+`timeout_s` to give up after a number of seconds instead of waiting forever.
+
+```rb
+job = DeepL.translation_memories.find_job 'YOUR_JOB_ID'
+
+puts job.operation
+# => 'import'
+puts job.status
+# => 'processing'
+puts job.finished?
+# => false
+```
+
+The status is one of `awaiting_input`, `processing`, `completed`, `downloaded`,
+`failed` or `expired`.
+
+#### Deleting a translation memory
+
+`translation_memories.destroy` deletes a translation memory and returns its ID.
+
+```rb
+DeepL.translation_memories.destroy 'YOUR_TM_ID'
+# => 'YOUR_TM_ID'
+```
+
 #### Using a translation memory in translations
 
 Pass the `translation_memory` parameter to `translate` to use a translation
@@ -510,6 +708,17 @@ translation = DeepL.translate 'Hello, world!', 'EN', 'DE',
                               translation_memory: translation_memories.first
 ```
 
+The same `translation_memory` and `translation_memory_threshold` options can be
+passed to document translation via `DeepL.document.upload` (or
+`DeepL.document.translate_document`). The `translation_memory` option accepts
+either a translation memory ID string or a `TranslationMemory` object:
+
+```rb
+handle = DeepL.document.upload 'my_document.docx', 'EN', 'DE', 'my_document.docx',
+                              translation_memory: 'YOUR_TM_ID',
+                              translation_memory_threshold: 80
+```
+
 ### Monitor usage
 
 To check current API usage, use:

data/VERSION

@@ -1 +1 @@
-3.8.0
+3.9.0

data/deepl-rb.gemspec

@@ -2,17 +2,17 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Juwelier::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: deepl-rb 3.8.0 ruby lib
+# stub: deepl-rb 3.9.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "deepl-rb".freeze
-  s.version = "3.8.0".freeze
+  s.version = "3.9.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.metadata = { "bug_tracker_uri" => "https://github.com/DeepLcom/deepl-rb/issues", "changelog_uri" => "https://github.com/DeepLcom/deepl-rb/blob/main/CHANGELOG.md", "documentation_uri" => "https://github.com/DeepLcom/deepl-rb/blob/main/README.md", "homepage_uri" => "https://github.com/DeepLcom/deepl-rb" } if s.respond_to? :metadata=
   s.require_paths = ["lib".freeze]
   s.authors = ["DeepL SE".freeze]
-  s.date = "2026-06-18"
+  s.date = "2026-08-12"
   s.description = "Official Ruby library for the DeepL language translation API (v2). For more information, check this: https://www.deepl.com/docs/api-reference.html".freeze
   s.email = "open-source@deepl.com".freeze
   s.extra_rdoc_files = [
@@ -82,7 +82,17 @@ Gem::Specification.new do |s|
     "lib/deepl/requests/style_rule/update_configured_rules.rb",
     "lib/deepl/requests/style_rule/update_custom_instruction.rb",
     "lib/deepl/requests/translate.rb",
+    "lib/deepl/requests/translation_memory/base.rb",
+    "lib/deepl/requests/translation_memory/create_export.rb",
+    "lib/deepl/requests/translation_memory/create_import.rb",
+    "lib/deepl/requests/translation_memory/destroy.rb",
+    "lib/deepl/requests/translation_memory/download_export.rb",
+    "lib/deepl/requests/translation_memory/find.rb",
+    "lib/deepl/requests/translation_memory/find_job.rb",
     "lib/deepl/requests/translation_memory/list.rb",
+    "lib/deepl/requests/translation_memory/segments.rb",
+    "lib/deepl/requests/translation_memory/storage_base.rb",
+    "lib/deepl/requests/translation_memory/upload_file.rb",
     "lib/deepl/requests/usage.rb",
     "lib/deepl/resources/base.rb",
     "lib/deepl/resources/document_handle.rb",
@@ -93,11 +103,16 @@ Gem::Specification.new do |s|
     "lib/deepl/resources/style_rule.rb",
     "lib/deepl/resources/text.rb",
     "lib/deepl/resources/translation_memory.rb",
+    "lib/deepl/resources/translation_memory_export.rb",
+    "lib/deepl/resources/translation_memory_import.rb",
+    "lib/deepl/resources/translation_memory_job.rb",
+    "lib/deepl/resources/translation_memory_segments.rb",
     "lib/deepl/resources/usage.rb",
     "lib/deepl/style_rule_api.rb",
     "lib/deepl/translation_memory_api.rb",
     "lib/deepl/utils/backoff_timer.rb",
     "lib/deepl/utils/exception_builder.rb",
+    "lib/deepl/utils/time_parser.rb",
     "lib/http_client_options.rb",
     "lib/version.rb",
     "license_checker.sh",
@@ -123,6 +138,7 @@ Gem::Specification.new do |s|
     "spec/integration_tests/translation_memory_error_paths_spec.rb",
     "spec/integration_tests/usage_api_spec.rb",
     "spec/integration_tests/usage_error_paths_spec.rb",
+    "spec/requests/document/upload_spec.rb",
     "spec/requests/extra_body_parameters_types_spec.rb",
     "spec/requests/glossary/create_spec.rb",
     "spec/requests/glossary/destroy_spec.rb",
@@ -143,7 +159,15 @@ Gem::Specification.new do |s|
     "spec/requests/style_rule/update_custom_instruction_spec.rb",
     "spec/requests/style_rule/update_spec.rb",
     "spec/requests/translate_spec.rb",
+    "spec/requests/translation_memory/create_export_spec.rb",
+    "spec/requests/translation_memory/create_import_spec.rb",
+    "spec/requests/translation_memory/destroy_spec.rb",
+    "spec/requests/translation_memory/download_export_spec.rb",
+    "spec/requests/translation_memory/find_job_spec.rb",
+    "spec/requests/translation_memory/find_spec.rb",
     "spec/requests/translation_memory/list_spec.rb",
+    "spec/requests/translation_memory/segments_spec.rb",
+    "spec/requests/translation_memory/upload_file_spec.rb",
     "spec/requests/usage_spec.rb",
     "spec/resources/custom_instruction_spec.rb",
     "spec/resources/glossary_spec.rb",
@@ -151,6 +175,10 @@ Gem::Specification.new do |s|
     "spec/resources/language_spec.rb",
     "spec/resources/style_rule_spec.rb",
     "spec/resources/text_spec.rb",
+    "spec/resources/translation_memory_export_spec.rb",
+    "spec/resources/translation_memory_import_spec.rb",
+    "spec/resources/translation_memory_job_spec.rb",
+    "spec/resources/translation_memory_segments_spec.rb",
     "spec/resources/translation_memory_spec.rb",
     "spec/resources/usage_spec.rb",
     "spec/spec_helper.rb",
@@ -161,12 +189,12 @@ Gem::Specification.new do |s|
   ]
   s.homepage = "https://github.com/DeepLcom/deepl-rb".freeze
   s.licenses = ["MIT".freeze]
-  s.rubygems_version = "3.6.2".freeze
+  s.rubygems_version = "3.4.10".freeze
   s.summary = "Official Ruby library for the DeepL language translation API.".freeze
 
   s.specification_version = 4
 
-  s.add_development_dependency(%q<juwelier>.freeze, [">= 0".freeze])
-  s.add_development_dependency(%q<byebug>.freeze, [">= 0".freeze])
+  s.add_development_dependency(%q<juwelier>.freeze, [">= 0"])
+  s.add_development_dependency(%q<byebug>.freeze, [">= 0"])
 end
 

data/lib/deepl/document_api.rb

@@ -25,7 +25,17 @@ module DeepL
     # @param [String, nil] filename The filename of the file, including its extension. Used to open
     #                               the different kinds of documents (PDFs, etc). If nil, will use
     #                               the filename of +input_file_path+.
-    # @param [Hash] options Additional (body) options for the upload.
+    # @param [Hash] options Additional (body) options for the upload. Notable glossary options:
+    #                       +:glossary_id+ (a single glossary ID) or +:glossary_ids+ (an array of
+    #                       up to 5 glossary IDs, as strings or `DeepL::Resources::Glossary`
+    #                       objects). +:glossary_ids+ requires +source_lang+ to be set, cannot be
+    #                       combined with +:glossary_id+, and raises `ArgumentError` if these rules
+    #                       are violated or more than 5 IDs are provided. Notable style/translation
+    #                       memory options (mirroring text translation): +:style_rule+ (a style rule
+    #                       ID string or a `DeepL::Resources::StyleRule` object),
+    #                       +:translation_memory+ (a translation memory ID string or a
+    #                       `DeepL::Resources::TranslationMemory` object), and
+    #                       +:translation_memory_threshold+ (integer 0-100, recommended minimum 75).
     # @param [Hash] additional_headers Additional HTTP headers for the upload.
     # @return [DeepL::Resources::DocumentHandle] Document handle for the uploaded document.
 

data/lib/deepl/requests/base.rb

@@ -6,6 +6,9 @@
 module DeepL
   module Requests
     class Base # rubocop:disable Metrics/ClassLength
+      # Maximum number of glossaries that may be provided via the +glossary_ids+ option.
+      MAX_GLOSSARY_IDS = 5
+
       attr_reader :api, :response, :options
 
       def initialize(api, options = {}, additional_headers = {})
@@ -85,7 +88,7 @@ module DeepL
         api.configuration.logger&.info("Request to the DeepL API: #{self}")
         api.configuration.logger&.debug("Request details: #{details}")
         loop do
-          resp = api.http_client.request(req)
+          resp = http_client.request(req)
           validate_response!(resp)
           return [req, resp]
         rescue DeepL::Exceptions::Error => e
@@ -95,7 +98,7 @@ module DeepL
             api.configuration.logger&.info("Encountered a retryable exception: #{e.message}")
           end
           api.configuration.logger&.info("Starting retry #{@backoff_timer.num_retries + 1} for " \
-                                         "request #{request} after sleeping for " \
+                                         "request #{self} after sleeping for " \
                                          "#{format('%.2f', @backoff_timer.time_until_deadline)}")
           files_to_reset.each(&:rewind)
           @backoff_timer.sleep_until_deadline
@@ -106,7 +109,7 @@ module DeepL
             api.configuration.logger&.info("Encountered a retryable exception: #{e.message}")
           end
           api.configuration.logger&.info("Starting retry #{@backoff_timer.num_retries + 1} for " \
-                                         "request #{request} after sleeping for " \
+                                         "request #{self} after sleeping for " \
                                          "#{format('%.2f', @backoff_timer.time_until_deadline)}")
           files_to_reset.each(&:rewind)
           @backoff_timer.sleep_until_deadline
@@ -172,6 +175,49 @@ module DeepL
         raise Utils::ExceptionBuilder.new(response).build
       end
 
+      # Validates the +glossary_ids+ option and resolves it to an array of glossary ID strings.
+      #
+      # The +glossary_ids+ option accepts an array of up to `MAX_GLOSSARY_IDS` glossary
+      # identifiers. Each entry may be a glossary ID string or a
+      # `DeepL::Resources::Glossary` object. It:
+      # * requires +source_lang+ to be set,
+      # * cannot be combined with the singular +glossary_id+ option,
+      # * allows at most `MAX_GLOSSARY_IDS` identifiers.
+      #
+      # The API expects +glossary_ids+ as an array (a JSON array in the JSON translate body).
+      # Callers sending multipart/form-data (e.g. document upload) should join the returned
+      # array into a comma-separated string.
+      #
+      # @param [String, nil] source_lang The source language for the request.
+      # @return [Array<String>, nil] The list of glossary IDs, or nil if the +glossary_ids+
+      #                              option was not provided.
+      # @raise [ArgumentError] If any of the validation rules above are violated.
+      def build_glossary_ids_param(source_lang)
+        return nil unless option?(:glossary_ids)
+
+        ids = Array(delete_option(:glossary_ids))
+        return nil if ids.empty?
+
+        validate_glossary_ids!(ids, source_lang)
+        ids.map do |glossary|
+          glossary.is_a?(DeepL::Resources::Glossary) ? glossary.id : glossary.to_s
+        end
+      end
+
+      def validate_glossary_ids!(ids, source_lang)
+        if option?(:glossary_id)
+          raise ArgumentError,
+                'The `glossary_ids` option cannot be used together with the `glossary_id` option'
+        end
+        if source_lang.nil?
+          raise ArgumentError, 'The `glossary_ids` option requires `source_lang` to be set'
+        end
+        return unless ids.size > MAX_GLOSSARY_IDS
+
+        raise ArgumentError,
+              "A maximum of #{MAX_GLOSSARY_IDS} glossary IDs may be provided via `glossary_ids`"
+      end
+
       def path
         raise NotImplementedError
       end
@@ -189,6 +235,12 @@ module DeepL
         api.configuration.host
       end
 
+      # Subclasses that talk to a host other than the DeepL API, such as a pre-signed storage
+      # URL, override this to request through their own connection.
+      def http_client
+        api.http_client
+      end
+
       def query_params
         options
       end

data/lib/deepl/requests/document/upload.rb

@@ -49,10 +49,59 @@ module DeepL
           ]
           filename_param = filename || File.basename(input_file_path)
           form_data.push(['filename', filename_param]) unless filename_param.nil?
-          add_supported_options_to_form(form_data)
+          add_extra_options_to_form(form_data)
           form_data
         end
 
+        def add_extra_options_to_form(form_data)
+          add_supported_options_to_form(form_data)
+          add_glossary_ids_to_form(form_data)
+          add_style_rule_to_form(form_data)
+          add_translation_memory_to_form(form_data)
+          add_translation_memory_threshold_to_form(form_data)
+        end
+
+        # Validates and serializes the `glossary_ids` option (see
+        # `DeepL::Requests::Base#build_glossary_ids_param`) and appends it to the form data as a
+        # comma-separated `glossary_ids` field. Requires `source_lang`, cannot be combined with
+        # the singular `glossary_id` option, and allows at most 5 IDs.
+        def add_glossary_ids_to_form(form_data)
+          glossary_ids = build_glossary_ids_param(source_lang)
+          form_data.push(['glossary_ids', glossary_ids.join(',')]) unless glossary_ids.nil?
+        end
+
+        # Serializes the `style_rule` option and appends it to the form data as a `style_id`
+        # field. Mirrors text translation: accepts either a style rule ID string or a
+        # `DeepL::Resources::StyleRule` object.
+        def add_style_rule_to_form(form_data)
+          return unless option?(:style_rule)
+
+          rule = delete_option(:style_rule)
+          style_id = rule.is_a?(DeepL::Resources::StyleRule) ? rule.style_id : rule
+          form_data.push(['style_id', style_id.to_s])
+        end
+
+        # Serializes the `translation_memory` option and appends it to the form data as a
+        # `translation_memory_id` field. Mirrors text translation: the `translation_memory`
+        # option accepts either a translation memory ID string or a
+        # `DeepL::Resources::TranslationMemory` object.
+        def add_translation_memory_to_form(form_data)
+          return unless option?(:translation_memory)
+
+          tm = delete_option(:translation_memory)
+          tm_id = tm.is_a?(DeepL::Resources::TranslationMemory) ? tm.translation_memory_id : tm
+          form_data.push(['translation_memory_id', tm_id.to_s])
+        end
+
+        # Serializes the `translation_memory_threshold` option (integer 0-100) and appends it to
+        # the form data as a `translation_memory_threshold` field, mirroring text translation.
+        def add_translation_memory_threshold_to_form(form_data)
+          return unless option?(:translation_memory_threshold)
+
+          threshold = delete_option(:translation_memory_threshold)
+          form_data.push(['translation_memory_threshold', threshold.to_s])
+        end
+
         def add_supported_options_to_form(form_data)
           SUPPORTED_OPTIONS.each do |option_name|
             option_value = option(option_name)

data/lib/deepl/requests/translate.rb

@@ -39,7 +39,7 @@ module DeepL
         tweak_parameters!
       end
 
-      def request # rubocop:disable Metrics/AbcSize, Metrics/MethodLength, Metrics/PerceivedComplexity
+      def request # rubocop:disable Metrics/AbcSize, Metrics/MethodLength, Metrics/PerceivedComplexity, Metrics/CyclomaticComplexity
         text_arrayified = text.is_a?(Array) ? text : [text]
         payload = { text: text_arrayified, source_lang: source_lang, target_lang: target_lang }
 
@@ -65,6 +65,9 @@ module DeepL
           payload[:translation_memory_threshold] = delete_option(:translation_memory_threshold)
         end
 
+        glossary_ids = build_glossary_ids_param(source_lang)
+        payload[:glossary_ids] = glossary_ids unless glossary_ids.nil?
+
         build_texts(*execute_request_with_retries(post_request(payload)))
       end
 

data/lib/deepl/requests/translation_memory/base.rb

@@ -0,0 +1,47 @@
+# Copyright 2026 DeepL SE (https://www.deepl.com)
+# Use of this source code is governed by an MIT
+# license that can be found in the LICENSE.md file.
+# frozen_string_literal: true
+
+module DeepL
+  module Requests
+    module TranslationMemory
+      ##
+      # Common behaviour of the translation memory endpoints: they are served under the `v3`
+      # prefix instead of the configured API version, and take their parameters in the query
+      # string rather than in the request body.
+
+      class Base < DeepL::Requests::Base
+        private
+
+        def uri
+          @uri ||= begin
+            base_uri = URI("#{host}/v3/#{path}")
+            query_string = build_query_string
+            base_uri.query = query_string unless query_string.empty?
+            base_uri
+          end
+        end
+
+        def build_query_string
+          # encode_www_form encodes a space as `+`, which is correct for a form body but not for
+          # a URI query string. A literal `+` is already escaped as %2B, so every remaining `+`
+          # is a space.
+          URI.encode_www_form(query_params).gsub('+', '%20')
+        end
+
+        def query_params
+          {}
+        end
+
+        def get_request # rubocop:disable Naming/AccessorMethodName
+          Net::HTTP::Get.new(uri.request_uri, add_json_content_type(headers))
+        end
+
+        def delete_request
+          Net::HTTP::Delete.new(uri.request_uri, add_json_content_type(headers))
+        end
+      end
+    end
+  end
+end