[Translation] Update azure-ai-translation-document to 2026-03-01 API version

sdk/translation/azure-ai-translation-document/CHANGELOG.md

@@ -1,15 +1,43 @@
 # Release History
 
-## 1.1.1 (Unreleased)
+## 2.0.0 (2026-08-01)
 
 ### Features Added
 
+- Added support for the `2026-03-01` service API version, which is now the default.
+- Added image translation support: the `translate_text_within_image` keyword on `begin_translation`
+  for batch requests, and a `translate_text_within_image` keyword on `SingleDocumentTranslationClient.translate`
+  for single document requests. When enabled, each document's status also reports image scan usage.
+- Added the `deployment_name` property to `TranslationTarget` and the `deployment_name` keyword to
+  `begin_translation` to specify the deployment name of the custom translation model for a batch
+  translation request.
+- Added the `deployment_name` keyword to `SingleDocumentTranslationClient.translate` for single
+  document translation requests.
+- Added the `deployment_name` property to `DocumentStatus`, exposing the deployment name of the
+  custom translation model used for the translation.
+- Added image scan reporting to `DocumentStatus`: `image_characters_detected`, `images_charged`,
+  `total_image_scans_succeeded`, and `total_image_scans_failed`.
+- Added image scan totals to `TranslationStatusSummary`: `total_image_scans_succeeded`,
+  `total_image_scans_failed`, and `total_images_charged`.
+- Added the `BatchOptions` model for specifying batch translation options.
+
 ### Breaking Changes
 
-### Bugs Fixed
+- Changed the default service API version from `2024-05-01` to `2026-03-01`. To keep the previous
+  behavior, pass `api_version="2024-05-01"` when constructing the client.
+- Models are no longer re-exported from the top-level `azure.ai.translation.document` namespace and
+  must now be imported from `azure.ai.translation.document.models`. This affects `TranslationGlossary`,
+  `TranslationTarget`, `DocumentTranslationInput`, `TranslationStatus`, `DocumentStatus`,
+  `DocumentTranslationError`, `DocumentTranslationFileFormat`, and `StorageInputType`. For example,
+  replace `from azure.ai.translation.document import TranslationStatus` with
+  `from azure.ai.translation.document.models import TranslationStatus`. The clients
+  (`DocumentTranslationClient`, `SingleDocumentTranslationClient`), `DocumentTranslationApiVersion`,
+  and `DocumentTranslationLROPoller` remain available at the top level.
 
 ### Other Changes
 
+- This version and all future versions will require Python 3.9+. Python 3.8 is no longer supported.
+
 ## 1.1.0 (2024-11-15)
 
 ### Other Changes

sdk/translation/azure-ai-translation-document/MANIFEST.in

@@ -6,4 +6,3 @@ recursive-include samples *.py *.md
 include azure/__init__.py
 include azure/ai/__init__.py
 include azure/ai/translation/__init__.py
-recursive-include doc *.rst

sdk/translation/azure-ai-translation-document/README.md

@@ -30,10 +30,10 @@ _Azure SDK Python packages support for Python 2.7 has ended 01 January 2022. For
 Install the Azure Document Translation client library for Python with [pip][pip]:
 
 ```bash
-pip install --pre azure-ai-translation-document
+pip install azure-ai-translation-document
 ```
 
-> Note: This version of the client library defaults to the v2024-05-01 version of the service
+> Note: This version of the client library defaults to the `2026-03-01` version of the service.
 
 #### Create a Translator resource
 
@@ -179,7 +179,8 @@ poller = document_translation_client.begin_translation("<sas_url_to_source>", "<
 ```python
 import os
 from azure.core.credentials import AzureKeyCredential
-from azure.ai.translation.document import DocumentTranslationClient, DocumentTranslationInput, TranslationTarget
+from azure.ai.translation.document import DocumentTranslationClient
+from azure.ai.translation.document.models import DocumentTranslationInput, TranslationTarget
 
 endpoint = os.environ["AZURE_DOCUMENT_TRANSLATION_ENDPOINT"]
 key = os.environ["AZURE_DOCUMENT_TRANSLATION_KEY"]
@@ -302,7 +303,8 @@ Begin translating with documents in multiple source containers to multiple targe
 ```python
 import os
 from azure.core.credentials import AzureKeyCredential
-from azure.ai.translation.document import DocumentTranslationClient, DocumentTranslationInput, TranslationTarget
+from azure.ai.translation.document import DocumentTranslationClient
+from azure.ai.translation.document.models import DocumentTranslationInput, TranslationTarget
 
 endpoint = os.environ["AZURE_DOCUMENT_TRANSLATION_ENDPOINT"]
 key = os.environ["AZURE_DOCUMENT_TRANSLATION_KEY"]

sdk/translation/azure-ai-translation-document/_metadata.json

@@ -0,0 +1,6 @@
+{
+  "apiVersion": "2026-03-01",
+  "apiVersions": {
+    "DocumentTranslation": "2026-03-01"
+  }
+}