레거시 커넥터 사용 중단

컨텐츠는 영어 텍스트를 Phrase Language AI를 이용해 기계 번역한 것입니다.

중요 사항

Google Drive(레거시), Braze(레거시), Contentful(엔트리 레벨) 및 Contentful(필드 레벨) 커넥터는 2026년 11월 30일에 사용 중단됩니다. 각 커넥터는 플랫폼 수준의 커넥터 버전으로 대체되었습니다.

레거시 커넥터는 2026년 8월 17일까지 생성할 수 있습니다.

마이그레이션 가이드

참고

연속 APC를 레거시 커넥터에서 새 커넥터로 전환하는 것은 마이그레이션이 아닙니다. Phrase는 이를 새로운 커넥터 구성으로 처리하므로, APC는 기존 작업을 업데이트하는 대신 소스 파일을 새 작업으로 다시 가져옵니다. 파일이 새로운 콘텐츠로 처리되므로 이전에 처리된 단어와 기계 번역 단위(MTU)는 새 작업으로 이월되지 않습니다. 프로젝트 도중에 커넥터를 전환하면 영향을 받는 파일의 단어 수와 MTU/크레딧 사용량에 파일을 완전히 다시 가져온 결과가 반영됩니다.

Google Drive(레거시)에서 Google Drive로

인증

Google 계정으로 다시 인증하십시오.

설정으로 이동하여 통합 섹션으로 스크롤한 다음 커넥터를 클릭하십시오.
새 커넥터를 클릭하십시오.
유형을 Google Drive로 변경하고 커넥터 이름을 입력하십시오.
OAuth 절차를 완료하십시오.

기존 Google 계정 자격 증명은 새 커넥터에서도 유효합니다. 새로운 권한은 필요하지 않습니다.

기능 동등성

모든 기능이 동일합니다. 작동 방식에는 차이가 없습니다.

중요 사항

Google 계정당 동시에 유효한 인증을 유지할 수 있는 커넥터는 하나뿐입니다. 동일한 Google 계정으로 이전 Google Drive(레거시) 커넥터를 이미 인증했다면 연결 테스트가 성공하더라도 새 커넥터가 저장되지 않습니다. 이 문제를 해결하려면:

https://myaccount.google.com/permissions로 이동하여 Phrase Connector를 선택하고 Delete all을 선택하여 기존 인증을 제거하십시오.
Phrase TMS에서 이 계정을 사용한 각 Google Drive 커넥터를 열고 다시 인증하십시오.
새 Google Drive 커넥터를 생성하고 저장을 클릭하십시오.

Braze(레거시)에서 Braze로

인증

이전 커넥터용으로 생성된 API 키는 새 커넥터와 호환되지 않습니다. 새 키가 필요합니다.

새 API 키를 생성하려면:

Braze에서 Settings > Developer Console > APIs and Identifiers로 이동하십시오.
Templates, Canvases, and Campaigns.에 대한 권한을 가진 새 REST API 키를 생성하십시오.
REST Endpoint URL을 복사하십시오.

Phrase TMS에서 새 커넥터를 구성하려면:

설정으로 이동하여 통합 섹션으로 스크롤한 다음 커넥터를 클릭하십시오.
새 커넥터를 클릭하십시오.
유형을 Braze로 변경하고 커넥터 이름을 입력하십시오.
새 API 키와 REST Endpoint URL을 입력하십시오.

참고

Braze 로케일 코드는 하이픈이 아닌 밑줄(예: en_US)을 사용해야 합니다. 하이픈은 작업 생성 오류를 유발합니다. 마이그레이션을 완료하기 전에 Braze의 Workspace Settings > Multi-Language Locale Settings에서 로케일 코드를 확인하십시오.

기능 차이점

새 Braze 커넥터에는 다음 기능이 추가되었습니다:

HTML 이메일 템플릿뿐 아니라 캠페인과 캔버스도 직접 현지화할 수 있습니다.
드래그 앤 드롭 템플릿은 캠페인 또는 캔버스를 통해 액세스할 때 지원됩니다.
로케일 코드 변형(de-DE 대 de-de, 밑줄 대 하이픈)은 통합 언어 매핑을 통해 자동으로 해결됩니다.
사용자 지정 로케일 매핑은 커넥터별로 구성할 수 있습니다.

Contentful(엔트리 레벨) 레거시 및 Contentful(필드 레벨) 레거시에서 Contentful 2.0으로 전환

인증

Contentful 2.0 커넥터 설정에서 Contentful 자격 증명을 다시 입력하십시오: Space ID, Content Delivery API 토큰 및 Content Management API 토큰.

EU 호스팅 Contentful 고객은 설정 중에 EU 인증 엔드포인트를 선택해야 합니다. 레거시 커넥터는 US 엔드포인트로만 하드코딩되었습니다.

기능 차이점

Contentful 2.0에는 다음 기능이 추가되었습니다:

임베디드 인라인 항목(가격 책정 토큰, 재사용 가능한 문자열, 서식 있는 텍스트의 인라인 링크)은 눈에 보이고 이동할 수 있는 자리 표시자로 나타납니다. 이 항목들은 Contentful(레거시)의 번역 페이로드에서 완전히 제외되었습니다.
Markdown 링크의 URL은 구성된 경우 표시되고 편집할 수 있습니다.
JSON 객체 필드를 현지화할 수 있습니다.
EU 데이터 센터 인증이 지원됩니다.

자동화된 프로젝트 생성 마이그레이션

자동화된 프로젝트 생성(APC) 마이그레이션 흐름은 세 가지 커넥터 모두 동일합니다. APC는 하나씩 마이그레이션해야 합니다.

APC를 마이그레이션하려면:

설정으로 이동하여 자동화 섹션으로 스크롤한 다음 자동화된 프로젝트 생성을 클릭하십시오.
마이그레이션할 APC를 선택하고 복제를 클릭하여 복제하십시오.
복제본에서 새 커넥터 폴더를 선택하십시오.
저장 시 신규 및 업데이트된 파일만을 선택하십시오.
원래(이전) APC를 마지막으로 한 번 트리거하여 의도한 모든 작업이 생성되었는지 확인하십시오.
이전 APC를 비활성화하십시오.

참고

5단계에서 프로젝트가 생성된 경우 평소와 같이 해당 프로젝트의 번역을 완료한 다음 이전 APC를 삭제하십시오.

APC를 복제하면 새로운 독립적인 연속 프로젝트가 생성됩니다. 새 프로젝트의 연속 분석과 재무 탭은 0부터 시작합니다. 처리 기록은 이전 프로젝트에 남으므로 보고에 필요한 분석 자료는 이전 APC를 삭제하기 전에 다운로드하십시오.

이전 연속 프로젝트는 6단계에서 APC가 비활성화될 때까지 계속 작동합니다. 비활성화되면 프로젝트는 소스로부터 업데이트를 받지 않지만, 진행 중인 작업은 평소와 같이 완료하고 내보낼 수 있습니다. 활성 프로젝트에 연결된 APC는 삭제할 수 없으므로, 프로젝트가 완료된 후에만 이전 APC를 삭제하십시오.