Application Integration에 지원되는 커넥터를 참조하세요.

번역 - 문서 태스크

번역 - 문서 태스크를 사용하면 Cloud Translation을 사용하여 실시간(동기식)으로 단일 문서 파일을 번역할 수 있습니다. PDF 및 DOCX 등의 형식이 지정된 문서를 직접 번역하고 원본 형식 및 레이아웃을 유지할 수 있습니다. 문서 번역에 지원되는 파일 형식에 대한 자세한 내용은 지원되는 파일 형식을 참조하세요.

Cloud Translation은 자동 언어 감지 기능을 통해 100개 이상의 언어 쌍으로 텍스트를 번역할 수 있는 Google Cloud 서비스입니다. 지원되는 모든 언어 목록은 지원되는 언어를 참조하세요.

시작하기 전에

번역 - 문서 태스크를 구성하기 전에 Google Cloud 프로젝트에서 다음 태스크를 수행해야 합니다.

Cloud Translation API(translate.googleapis.com)를 사용 설정합니다.
Cloud Translation API 사용 설정
인증 프로필을 만듭니다. Application Integration은 인증 프로필을 사용하여 번역 - 문서 태스크의 인증 엔드포인트에 연결합니다.
서비스 계정에 추가 역할 또는 권한을 부여하려면 액세스 권한 부여, 변경, 취소를 참조하세요.

번역 - 문서 태스크 구성

Google Cloud 콘솔에서 Application Integration 페이지로 이동합니다.
Application Integration으로 이동
탐색 메뉴에서 통합을 클릭합니다.
Google Cloud 프로젝트에서 사용할 수 있는 모든 통합이 나열된 통합 페이지가 나타납니다.
기존 통합을 선택하거나 통합 만들기를 클릭하여 새 통합을 만듭니다.
새 통합을 만드는 경우:
1. 통합 만들기 창에 이름과 설명을 입력합니다.
2. 통합 리전을 선택합니다.
  참고: 리전 드롭다운에는 Google Cloud 프로젝트에 프로비저닝된 리전만 나열됩니다. 새 리전을 프로비저닝하려면 리전 사용 설정을 클릭합니다. 자세한 내용은 새 리전 사용 설정을 참조하세요.
3. 통합을 위한 서비스 계정을 선택합니다. 통합 툴바의 통합 요약 창에서 언제든지 통합에 대한 서비스 계정 세부정보를 변경하거나 업데이트할 수 있습니다.
  참고: 서비스 계정 선택 옵션은 선택한 리전에 대해 통합 거버넌스를 사용 설정한 경우에만 표시됩니다.
4. 만들기를 클릭합니다.
통합 편집기 페이지에서 통합이 열립니다.
통합 편집기 탐색 메뉴에서 태스크를 클릭하여 사용 가능한 태스크 목록을 확인합니다.
번역 - 문서 요소를 클릭하여 통합 편집기에 배치합니다.
디자이너에서 번역 - 문서 요소를 클릭하여 번역 - 문서 태스크 구성 창을 표시합니다.
인증으로 이동하고 사용하려는 기존 인증 프로필을 선택합니다.
(선택사항) 태스크를 구성하기 전에 인증 프로필을 만들지 않았으면 + 새 인증 프로필을 클릭하고 새 인증 프로필 만들기에 설명된 단계를 따릅니다.
태스크 입력으로 이동하고 다음 태스크 입력 매개변수 표를 사용해 표시된 입력 필드를 구성합니다.
입력 필드의 변경사항은 자동으로 저장됩니다.

태스크 입력 매개변수

다음 표에서는 번역 - 문서 태스크의 입력 매개변수를 설명합니다.

속성	데이터 유형	설명
리전	문자열	번역 작업을 실행할 리전입니다. 예를 들면 `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

문서 파일 크기 한도

파일 형식	크기 제한
PDF	최대 25MB
기본 PDF (`isTranslateNativePdfOnly` 필드가 `true`로 설정되어야 함)	최대 20MB(300페이지 제한)
스캔한 PDF	최대 20MB(20페이지 제한)
기타 파일 형식	최대 20MB(페이지 제한 없음)

오류 처리 전략

태스크의 오류 처리 전략은 일시적인 오류로 인해 태스크가 실패할 경우 수행할 태스크를 지정합니다. 오류 처리 전략을 사용하는 방법과 다양한 유형의 오류 처리 전략에 대한 자세한 내용은 오류 처리 전략을 참조하세요.