[Translation] Update azure-ai-translation-document to 2026-03-01 API version#47837
Open
jrjrguo wants to merge 8 commits into
Open
[Translation] Update azure-ai-translation-document to 2026-03-01 API version#47837jrjrguo wants to merge 8 commits into
jrjrguo wants to merge 8 commits into
Conversation
Adds custom translation model deployment name support (deployment_name on TranslationTarget/begin_translation, DocumentStatus, and single-document translate) and image translation support (translate_text_within_image plus image-scan reporting fields). Introduces the BatchOptions model, sets the default service API version to 2026-03-01, adds samples and unit tests, and bumps the version to 1.2.0b1.
added 5 commits
July 4, 2026 17:10
… test harness Adds deployment_name and image-translation live tests (sync + async) and the image test document. Refactors the test storage helpers to authenticate to Azure Storage with a token credential (DefaultAzureCredential) and pass plain container URLs to the Document Translation service (accessed via the Translator resource's managed identity), so tests run without account-key/shared-key access.
…key preparer var Lowers operation/document counts in the list_translations and list_document_statuses tests (no tests removed, assertions unchanged) to cut live re-recording time, and removes the now-unused DOCUMENT_TRANSLATION_STORAGE_KEY requirement from the preparer (storage now uses Entra ID auth).
…it tests Removes the overloaded-inputs, overloaded-single-input, and single-input-with-kwargs live tests (which validate SDK request dispatch/serialization, not service behavior) and re-adds them as fast unit tests over the shared get_translation_input builder. Mirrors the .NET suite (DocumentTranslationMockTests) and trims live re-recording time. No SDK coverage lost.
…s skip; drop obsolete unsupported-files test - Publish re-recorded live-test sessions (assets.json -> new tag) - Fix async test_list_document_statuses_mixed_filters (skip 3->1 for docs_count=5) - Remove test_use_supported_and_unsupported_files (sync+async): .jpg is now a supported image format and unsupported files are no longer silently dropped under api-version 2026-03-01, so the scenario is obsolete
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates azure-ai-translation-document to the Document Translation 2026-03-01 service API version (now the default) and releases it as the 2.0.0 GA. It surfaces two new service capabilities — custom-model deployment name routing and image translation — across the sync/async clients, models, samples, tests, and docs. The change is applied as a targeted delta on top of the generated + _patch.py customization layer rather than a full re-emit.
Changes:
- Bumped default API version
2024-05-01→2026-03-01(breaking) and version to2.0.0; addeddeployment_name(onTranslationTarget,begin_translation,translate, andDocumentStatus) andtranslate_text_within_imagesupport plus the newBatchOptionsmodel and image-scan reporting fields. - Migrated storage-dependent tests from account-key SAS to Entra ID (
DefaultAzureCredential) plain container URLs, replaced live overload/serialization tests with offline dispatch/model tests, reduced list operation counts, and added image/deployment tests. - Added sync + async samples and README entries for the two new features.
Reviewed changes
Copilot reviewed 30 out of 31 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
.../document/_patch.py |
Adds deployment_name/translate_text_within_image to begin_translation + get_translation_input; new API-version enum value |
.../document/aio/_patch.py |
Async begin_translation keywords + api-version docstring |
.../document/_operations/_patch.py, aio/_operations/_patch.py |
translate single-doc keywords wired to request builder |
.../document/_operations/_operations.py |
Serializes new query params; default api-version bump |
.../document/models/_models.py, models/_patch.py, models/__init__.py |
BatchOptions, new DocumentStatus/TranslationTarget/TranslationStatusSummary fields + exports |
.../document/_configuration.py, aio/_configuration.py, _client.py, aio/_client.py |
Default api-version → 2026-03-01 |
.../document/_version.py, CHANGELOG.md, tsp-location.yaml, assets.json |
Version 2.0.0, changelog, spec pointer, recordings tag |
tests/testcase.py, preparer.py |
Entra-ID storage auth; drop storage-key/SAS helpers |
tests/test_translation*.py, test_model_updates.py, test_list_* |
New deployment/image tests, offline dispatch tests, reduced counts |
samples/**, samples/README.md |
New deployment + image translation samples (sync/async) |
Comment on lines
+132
to
+136
| options=( | ||
| BatchOptions(translate_text_within_image=translate_text_within_image) | ||
| if translate_text_within_image is not None | ||
| else None | ||
| ), |
| # list translations - unable to assert skip!! | ||
| all_translations = client.list_translation_statuses() | ||
| all_operations_count = 0 | ||
| all_operations_count = 2 |
added 2 commits
July 7, 2026 00:32
…r batch list inputs; fix async list-skip test counter - get_translation_input: apply BatchOptions(translate_text_within_image=...) for the List[DocumentTranslationInput] batch form (was only read on the single-URL form and silently dropped otherwise) - Add offline regression test for the batch-form image-translation option - Fix accidental all_operations_count init (2 -> 0) in async test_list_translations_with_skip
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Updates
azure-ai-translation-documentto the Document Translation2026-03-01service API version, mirroring the .NET regeneration in Azure/azure-sdk-for-net#60219. Released as the 2.0.0 GA for Python.Features Added
deployment_nameonTranslationTargetand as a keyword onbegin_translation(batch).deployment_namekeyword onSingleDocumentTranslationClient.translate(single document).deployment_nameonDocumentStatus(the deployment used).translate_text_within_imagekeyword onbegin_translationandtranslate.BatchOptionsmodel (carriestranslate_text_within_image) onStartTranslationDetails.options.DocumentStatus(image_characters_detected,images_charged,total_image_scans_succeeded,total_image_scans_failed) andTranslationStatusSummary(total_image_scans_succeeded,total_image_scans_failed,total_images_charged).Breaking Changes
2024-05-01to2026-03-01. Passapi_version="2024-05-01"to retain the previous behavior.Other
2.0.0(GA);tsp-location.yamlupdated to the 2026-03-01 spec. Note: Python follows its own version line (previous GA was 1.1.0), so this is 2.0.0 rather than matching .NET's 3.0.0.Notes for reviewers
typespec-pythonemitter restructures the client and would break this package's customizations. A follow-up full regeneration will require aligning the emitter with the customization layer.