번역 - 텍스트 태스크

번역 - 텍스트 태스크를 사용하면 Cloud Translation을 사용하여 입력 텍스트를 번역할 수 있습니다. 입력 텍스트는 일반 텍스트 또는 HTML일 수 있습니다.

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

시작하기 전에

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

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

번역 - 텍스트 태스크 구성

Apigee UI에서 Apigee 조직을 선택합니다.
개발 > 통합을 클릭합니다.
기존 통합을 선택하거나 통합 만들기를 클릭하여 새 통합을 만듭니다.
새 통합을 만드는 경우:
1. 통합 만들기 대화상자에 이름과 설명을 입력합니다.
2. 지원되는 리전 목록에서 통합에 대한 리전을 선택합니다.
3. 만들기를 클릭합니다.
통합 디자이너 페이지에서 통합이 열립니다.
통합 설계자 탐색 메뉴에서 +태스크/트리거 추가 > 태스크를 클릭하여 사용 가능한 태스크 목록을 봅니다.
번역 - 텍스트 요소를 클릭하여 통합 디자이너에 배치합니다.
디자이너에서 번역 - 텍스트 요소를 클릭하여 번역 - 텍스트 태스크 구성 창을 표시합니다.
인증으로 이동하고 사용하려는 기존 인증 프로필을 선택합니다.
선택사항입니다. 태스크를 구성하기 전에 인증 프로필을 만들지 않았으면 + 새 인증 프로필을 클릭하고 새 인증 프로필 만들기에 설명된 단계를 따릅니다.
태스크 입력으로 이동하고 다음 태스크 입력 매개변수 표를 사용해 표시된 입력 필드를 구성합니다.
입력 필드의 변경사항은 자동으로 저장됩니다.

태스크 입력 매개변수

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

속성	데이터 유형	설명
리전	문자열	번역 작업을 실행할 리전입니다. 예를 들면 `us-central1`입니다.
ProjectsId	문자열	Google Cloud 프로젝트 ID입니다.
요청	JSON	JSON 구조 요청을 참조하세요. 여러 입력 텍스트를 번역하려면 요청 본문의 `contents` 필드에 문자열을 지정합니다. 예를 들면 `"contents": ["Hello World", "This is an example text"]`입니다.

태스크 출력

번역 - 텍스트 태스크는 다음 샘플 출력과 유사한 번역된 출력 텍스트를 반환합니다.

{
    "translations": [
        {
        "translatedText": "Bonjour le monde",
        },
        {
        "translatedText": "Ceci est un exemple de texte",
        }
    ]
}

오류 처리 전략

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