번역 - 문서 태스크를 사용하면 Cloud Translation을 사용하여 실시간(동기식)으로 단일 문서 파일을 번역할 수 있습니다. PDF 및 DOCX 등의 형식이 지정된 문서를 직접 번역하고 원본 형식 및 레이아웃을 유지할 수 있습니다. 문서 번역에 지원되는 파일 형식에 대한 자세한 내용은 지원되는 파일 형식을 참조하세요.
Cloud Translation은 자동 언어 감지 기능을 통해 100개 이상의 언어 쌍으로 텍스트를 번역할 수 있는 Google Cloud 서비스입니다. 지원되는 모든 언어 목록은 지원되는 언어를 참조하세요.
시작하기 전에
번역 - 문서 태스크를 구성하기 전에 Google Cloud 프로젝트에서 다음 태스크를 수행해야 합니다.
Cloud Translation API(translate.googleapis.com)를 사용 설정합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[[["\u003cp\u003eThe Translate - Document task allows real-time translation of single document files, including PDF and DOCX, using Cloud Translation while preserving the original formatting.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the Translate - Document task, you must enable the Cloud Translation API and create an authentication profile in your Google Cloud project.\u003c/p\u003e\n"],["\u003cp\u003eThe task supports various document file types for translation, such as DOC, DOCX, PDF, PPT, PPTX, XLS, and XLSX, with specific input and output file type combinations.\u003c/p\u003e\n"],["\u003cp\u003eDocument file size limits vary by type, with a general limit of 20 MB, and specific page limits for native and scanned PDFs, which are supported.\u003c/p\u003e\n"],["\u003cp\u003eThe Translate-Document task requires the specification of parameters like Region, ProjectsId, and a JSON request containing the \u003ccode\u003emimeType\u003c/code\u003e field for inline translations.\u003c/p\u003e\n"]]],[],null,["# Translate - Document task\n\nSee the [supported connectors](/integration-connectors/docs/connector-reference-overview) for Application Integration.\n\nTranslate - Document task\n=========================\n\n|\n| **Preview**\n|\n|\n| This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nThe **Translate - Document** task lets you translate a single document file in real-time (synchronously) using Cloud Translation. You can directly translate formatted documents such as `PDF` and `DOCX` while preserving their original formatting and layout. For information about the supported file formats for document translation, see [Supported file formats](#formats).\n\n[Cloud Translation](/translate/docs/overview) is a Google Cloud service that allows you to translate text for more than 100 language pairs with the capability of auto language detection. For a list of all supported languages, see [Supported languages](/translate/docs/languages).\n\nBefore you begin\n----------------\n\nEnsure that you perform the following tasks in your Google Cloud project before configuring the **Translate - Document** task:\n\n1. Enable the Cloud Translation API (`translate.googleapis.com`).\n\n\n [Enable the Cloud Translation API](https://console.cloud.google.com/flows/enableapi?apiid=translate.googleapis.com)\n2. Create an [authentication profile](/application-integration/docs/configuring-auth-profile#createAuthProfile). Application Integration uses an authentication profile to connect to an authentication endpoint for the **Translate - Document** task.\n\n For information about granting additional roles or permissions to a service account, see [Granting, changing, and revoking access](/iam/docs/granting-changing-revoking-access).\n\nConfigure the Translate - Document task\n---------------------------------------\n\n1. In the Google Cloud console, go to the **Application Integration** page.\n\n [Go to Application Integration](https://console.cloud.google.com/integrations)\n2. In the navigation menu, click **Integrations** .\n\n\n The **Integrations** page appears listing all the integrations available in the Google Cloud project.\n3. Select an existing integration or click **Create integration** to create a new one.\n\n\n If you are creating a new integration:\n 1. Enter a name and description in the **Create Integration** pane.\n 2. Select a region for the integration. **Note:** The **Regions** dropdown only lists the regions provisioned in your Google Cloud project. To provision a new region, click **Enable Region** . See [Enable new region](/application-integration/docs/enable-new-region) for more information.\n 3. Select a service account for the integration. You can change or update the service account details of an integration any time from the info **Integration summary** pane in the integration toolbar. **Note:** The option to select a service account is displayed only if you have enabled integration governance for the selected region.\n 4. Click **Create** . The newly created integration opens in the *integration editor*.\n\n\n4. In the *integration editor* navigation bar, click **Tasks** to view the list of available tasks and connectors.\n5. Click and place the **Translate - Document** element in the integration editor.\n6. Click the **Translate - Document** element on the designer to view the **Translate - Document** task configuration pane.\n7. Go to **Authentication** , and select an existing authentication profile that you want to use.\n\n Optional. If you have not created an authentication profile prior to configuring the task, Click **+ New authentication profile** and follow the steps as mentioned in [Create a new authentication profile](/application-integration/docs/configuring-auth-profile#createAuthProfile).\n8. Go to **Task Input** , and configure the displayed inputs fields using the following [Task input parameters](#params) table.\n\n Changes to the inputs fields are saved automatically.\n\nTask input parameters\n---------------------\n\n\nThe following table describes the input parameters of the **Translate - Document** task:\n\nTask output\n-----------\n\nThe **Translate - Document** task returns the translated document, similar to the following sample output: \n\n```\n{\n \"documentTranslation\": {\n \"byteStreamOutputs\": [\"BYTE_STREAM\"],\n \"mimeType\": \"MIME_TYPE\"\n },\n \"model\": \"projects/[PROJECT_NUMBER]/locations/[LOCATION]/models/general/nmt\"\n}\n```\n\n\u003cbr /\u003e\n\nSupported file formats\n----------------------\n\nCloud Translation supports the following input file types and their associated output file types. For information about the document file size limits, see [Document file size limits](#limits).\n\nDocument file size limits\n-------------------------\n\nError handling strategy\n-----------------------\n\n\nAn error handling strategy for a task specifies the action to take if the task fails due to a [temporary error](/application-integration/docs/error-handling). For information about how to use an error handling strategy, and to know about the different types of error handling strategies, see [Error handling strategies](/application-integration/docs/error-handling-strategy).\n\nQuotas and limits\n-----------------\n\nFor information about quotas and limits, see [Quotas and limits](/application-integration/docs/quotas).\n\nWhat's next\n-----------\n\n- Add [edges and edge conditions](/application-integration/docs/edge-overview).\n- [Test and publish](/application-integration/docs/test-publish-integrations) your integration.\n- Configure a [trigger](/application-integration/docs/how-to-guides#configure-triggers).\n- Add a [Data Mapping task](/application-integration/docs/data-mapping-task).\n- See [all tasks for Google Cloud services](/application-integration/docs/how-to-guides#configure-tasks-for-google-cloud-services)."]]
