翻译 - 文档任务

借助翻译 - 文档任务，您可以使用 Cloud Translation 实时（同步）翻译单个文档文件。您可以直接翻译 PDF 和 DOCX 等格式的文档，同时保留其原始格式和布局。如需了解文档翻译支持的文件格式，请参阅支持的文件格式。

Cloud Translation 是一项 Google Cloud 服务，可让您使用自动语言检测功能翻译 100 多种语言对的文本。如需查看所有支持的语言列表，请参阅支持的语言。

准备工作

在配置翻译 - 文档任务之前，请确保在您的 Google Cloud 项目中执行以下任务：

启用 Cloud Translation API (translate.googleapis.com)。
启用 Cloud Translation API
创建身份验证配置文件。Apigee Integration 会使用身份验证配置文件连接到身份验证端点以完成翻译 - 文档任务。
如需了解如何向服务账号授予其他角色或权限，请参阅授予、更改和撤消访问权限。

配置翻译 - 文档任务

在 Apigee 界面中，选择您的 Apigee 组织。
点击开发 > 集成。
选择现有集成，或通过点击创建集成来创建新集成。
要创建新的集成，请执行以下操作：
1. 在创建 Integrations对话框中输入名称和说明。
2. 从支持的区域列表中选择集成的区域。
3. 点击创建。
这将在集成设计器中打开集成。
在集成设计器导航栏中，点击 + 添加任务/触发器 > 任务以查看可用任务列表。
点击 Translate - Document（翻译 - 文档）元素，并将其放置到集成设计器中。
点击设计器上的 Translate - Document（翻译 - 文档）元素以查看 Translate - Document（翻译 - 文档）任务配置窗格。
前往身份验证，然后选择您要使用的现有身份验证配置文件。
可选。如果您在配置此任务之前未创建身份验证配置文件，请点击 + New authentication profile（+ 新建身份验证配置文件），然后按照创建新的身份验证配置文件中所述的步骤操作。
前往 Task Input（任务输入），然后使用以下任务输入参数表配置显示的输入字段。
系统会自动保存对输入字段的更改。

任务输入参数

下表介绍了翻译 - 文档任务的输入参数：

属性	数据类型	说明
区域	字符串	您要在其中运行翻译操作的区域。例如 `us-central1`。
ProjectsId	字符串	您的 Google Cloud 项目 ID。
请求	JSON	请参阅请求 JSON 结构。您必须为内嵌文档翻译指定请求 JSON 的 `mimeType` 字段。

任务输出

翻译 - 文档任务会返回翻译后的文档，类似于以下示例输出：

{
    "documentTranslation": {
        "byteStreamOutputs": ["BYTE_STREAM"],
        "mimeType": "MIME_TYPE"
    },
    "model": "projects/[PROJECT_NUMBER]/locations/[LOCATION]/models/general/nmt"
}

支持的文件格式

Cloud Translation 支持以下输入文件类型及其关联的输出文件类型。如需了解文档文件大小限制，请参阅文档文件大小限制。

输入	MIME 类型文档	输出
DOC	application/msword	DOC、DOCX
DOCX	application/vnd.openxmlformats-officedocument.wordprocessingml.document	DOCX
PDF	application/pdf	PDF、DOCX
PPT	application/vnd.ms-powerpoint	PPT、PPTX
PPTX	application/vnd.openxmlformats-officedocument.presentationml.presentation	PPTX
XLS	application/vnd.ms-excel	XLS、XLSX
XLSX	application/vnd.openxmlformats-officedocument.spreadsheetml.sheet	XLSX

文档文件大小限制

File type	大小限制
PDF	不超过 20 MB
原生 PDF （`isTranslateNativePdfOnly` 字段必须设置为 `true`）	不超过 20 MB，上限为 300 页
扫描的 PDF	不超过 20 MB，上限为 20 页
其他文件类型	不超过 20 MB，无页面限制

错误处理策略

任务的错误处理策略指定当任务因暂时性错误而失败时要执行的操作。如需了解如何使用错误处理策略，以及了解不同类型的错误处理策略，请参阅错误处理策略。