feat: add updateMultilingualGlossary(), options and glossary-object overloads

Add updateMultilingualGlossary() with UpdateMultilingualGlossaryOptions,
which sends only the fields that are set. Add
CreateMultilingualGlossaryOptions, ReplaceMultilingualGlossaryDictionaryOptions
and options overloads of the create, update and replace methods whose extra
body parameters are added last. Add MultilingualGlossaryInfo overloads of
getMultilingualGlossary(), updateMultilingualGlossaryName() and the
update/replace FromCsv methods.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Author: hive-bot

CHANGELOG.md

@@ -6,6 +6,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 ### Added
+- Added `DeepLClient.updateMultilingualGlossary()` and
+  `UpdateMultilingualGlossaryOptions`, which rename a glossary and merge
+  dictionaries into it in one request, sending only the fields that are set.
+- Added `CreateMultilingualGlossaryOptions` and
+  `ReplaceMultilingualGlossaryDictionaryOptions`, and overloads of the
+  multilingual glossary create, update and replace methods that take an options
+  object whose extra body parameters are added to the request last.
+- Added `getMultilingualGlossary()`, `updateMultilingualGlossaryName()`,
+  `updateMultilingualGlossaryDictionaryFromCsv()` and
+  `replaceMultilingualGlossaryDictionaryFromCsv()` overloads that take a
+  `MultilingualGlossaryInfo` object.
 - Added `DeepLException.getHttpStatusCode()`, the HTTP status code of the
   failed response (`null` if there was none), and
   `DeepLException.getShouldRetry()`, which is `true` for HTTP 429, HTTP 5xx and

README.md

@@ -520,9 +520,9 @@ detail.
 
 Functions to get, list, and delete stored glossaries are also provided:
 
-- `getMultilingualGlossary()` takes a glossary ID and returns a
-  `MultilingualGlossaryInfo` object for a stored glossary, or raises an
-  exception if no such glossary is found.
+- `getMultilingualGlossary()` takes a glossary ID or `MultilingualGlossaryInfo`
+  object and returns a `MultilingualGlossaryInfo` object for a stored glossary,
+  or raises an exception if no such glossary is found.
 - `listMultilingualGlossaries()` returns a list of `MultilingualGlossaryInfo`
   objects corresponding to all of your stored glossaries.
 - `deleteMultilingualGlossary()` takes a glossary ID or
@@ -602,6 +602,36 @@ Functions to edit stored glossaries are also provided:
   replacing any pre-existing entries for that language pair.
 - `updateMultilingualGlossaryName()` takes a glossary ID or `MultilingualGlossaryInfo`
   object, plus the new name of the glossary.
+- `updateMultilingualGlossary()` takes a glossary ID or `MultilingualGlossaryInfo`
+  object and an `UpdateMultilingualGlossaryOptions` object, and changes the
+  name and merges the dictionaries set in it in one request; fields that are not
+  set are not sent.
+- `updateMultilingualGlossaryDictionaryFromCsv()` and
+  `replaceMultilingualGlossaryDictionaryFromCsv()` take a glossary ID or
+  `MultilingualGlossaryInfo` object, a source and target language and the CSV
+  content as a `String` or `File`.
+
+The create, update and replace functions also have overloads taking an options
+object as the last argument (`CreateMultilingualGlossaryOptions`,
+`UpdateMultilingualGlossaryOptions` and
+`ReplaceMultilingualGlossaryDictionaryOptions`; the `updateMultilingualGlossaryName()`
+and `updateMultilingualGlossaryDictionary*()` overloads accept any options object
+and read only its extra body parameters), whose `setExtraBodyParameters()`
+values are added to the request body last.
+
+```java
+class Example {  // Continuing class Example from above
+  public void updateGlossaryExample() throws Exception {
+    GlossaryEntries entries = new GlossaryEntries(Collections.singletonMap("goodbye", "Tschüss"));
+    MultilingualGlossaryInfo updatedGlossary =
+      client.updateMultilingualGlossary(myGlossary,
+        new UpdateMultilingualGlossaryOptions()
+          .setName("My renamed glossary")
+          .setDictionaries(Arrays.asList(
+            new MultilingualGlossaryDictionaryEntries("en", "de", entries))));
+  }
+}
+```
 
 ```java
 // Update glossary dictionary

deepl-java/src/main/java/com/deepl/api/CreateMultilingualGlossaryOptions.java

@@ -0,0 +1,20 @@
+// 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 file.
+package com.deepl.api;
+
+import java.util.Map;
+
+/**
+ * Options for {@link DeepLClient#createMultilingualGlossary(String, java.util.List,
+ * CreateMultilingualGlossaryOptions)} and {@code createMultilingualGlossaryFromCsv}.
+ */
+public class CreateMultilingualGlossaryOptions extends BaseRequestOptions {
+  /** {@inheritDoc} */
+  @Override
+  public CreateMultilingualGlossaryOptions setExtraBodyParameters(
+      Map<String, String> extraBodyParameters) {
+    super.setExtraBodyParameters(extraBodyParameters);
+    return this;
+  }
+}