Shopify AI 제품 번역 워크플로 리서치

필요한 번역 경로를 선택하세요

편집자가 직접 번역을 관리할 수 있다면 Shopify의 판매자 도구를 사용하세요. 반복 가능한 외부 검토 대기열이 필요하고 개발자가 애플리케이션을 유지할 수 있다면 GraphQL Admin API를 사용합니다. API 경로에서는 별도의 모델 클라이언트가 텍스트 초안을 만들고 Shopify가 저장된 번역을 처리합니다.

개발 스토어와 제품 하나에서 시작하세요. 번역 가능한 필드를 읽고 후보를 준비하고 검토를 받은 뒤 의도한 변경만 제출합니다. 각 단계를 독립적으로 검사하고 수정할 수 있도록 모델 설정, 스토어 자격 증명, 게시 권한을 분리하세요.

판매자 워크플로와 애플리케이션 중에서 선택하세요

Shopify의 Translate & Adapt 문서는 수동 편집 및 자동 번역과 게시 전 검토를 설명합니다. 애플리케이션을 만들지 않고 판매자가 직접 편집을 관리하려는 경우 이것으로 충분할 수 있습니다. 외부 검토 대기열 같은 구체적인 요구사항이 커넥터를 소유할 이유가 될 때만 사용자 지정 통합을 선택하세요.

검토 대기열과 필드 매핑을 누가 유지할지에 따라 선택하세요. 서드파티 앱이라면 설치 전에 문서화된 구성, 권한, 내보내기 동작을 검사합니다. 판매자용 편집기와 외부 모델 초안을 사용하는 애플리케이션은 서로 다른 운영 요구를 해결합니다.

인증과 버전 경계를 계획하세요

translatableResource 참조에는 read_translations가 필요하고 translationsRegister에는 write_translations가 필요합니다. 테스트할 때 개발 스토어를 사용하고 앱 설치, API 버전, 부여된 스코프를 기록하세요. LLM 게이트웨이 자격 증명은 Shopify Admin API 요청을 인증하지 않으며 Shopify 토큰을 모델 엔드포인트로 보내서는 안 됩니다.

애플리케이션 설계가 허용한다면 검색 단계에는 읽기 접근부터 시작하세요. 이후 승인된 워크플로에 필요한 권한만 추가합니다. 기록되지 않은 latest 별칭으로 배포하지 말고 레퍼런스를 확인한 뒤 지원되는 API 버전을 고정하세요. 토큰은 서버 측에 보관하고 검토 내보내기와 요청 로그에서 제외합니다.

다이제스트와 함께 번역 가능한 필드를 읽으세요

문서화된 쿼리는 리소스 식별자와 key, value, digest, locale이 있는 번역 가능 항목을 반환합니다. 필드별 다이제스트를 소스 스냅샷과 함께 보존하세요. 이는 스프레드시트에서 복사한 제품 제목이 아니라 실제로 읽은 콘텐츠에 제안된 번역을 연결합니다.

아래 쿼리는 공식 스키마를 바탕으로 만든 읽기 전용 예시입니다. 개발 환경에서 승인된 제품 GID를 제공하세요. 반환된 키를 검사하고 명시적인 필드 허용 목록을 사용합니다. 브라우저 언어에서 추론하지 말고 반환된 소스 로케일을 사용하세요.

query TranslationSource($resourceId: ID!) {
  translatableResource(resourceId: $resourceId) {
    resourceId
    translatableContent {
      key
      value
      digest
      locale
    }
  }
}

Shopify 외부에서 번역 후보를 생성하세요

리소스 ID, 필드 키, 소스 다이제스트, 대상 로케일, 용어집 리비전, 초안 값을 포함하는 내부 후보 기록을 만드세요. 텍스트와 필요한 제품 컨텍스트만 모델에 보내세요. SKU, 가격, 통화, 재고, 변형 식별자는 생성 패치에서 제외합니다.

이중언어 검토자가 후보를 보기 전에 필수 텍스트, 플레이스홀더, 승인된 용어를 검증하세요. 제품 검토자에게 원본 소스와 주장을 대조해 경고를 확인하게 합니다. 브라우저 확장 프로그램이 스토어프론트를 번역한다고 해서 이 기록이 만들어지거나 Shopify가 번역을 저장했다는 사실이 확인되는 것은 아닙니다. 단지 검사 보조일 뿐입니다.

승인되고 최신인 번역만 등록하세요

translationsRegister 변형은 translatableContentDigest가 있는 번역 필드를 받습니다. 문서화된 결과에는 userErrors가 포함됩니다. 커넥터는 HTTP 응답만으로 등록 성공을 판단하지 말고 이 결과를 검사해야 합니다.

승인된 쓰기 전에 현재 소스를 검토된 스냅샷과 비교하세요. 바뀌었다면 후보를 보류하고 새 검토를 받습니다. 복구를 위해 의도한 필드 변경과 이전 번역의 명시적 목록을 유지합니다. 개발 스토어에서 필드 하나로 시작하고 패치를 확장하기 전에 다시 읽어 확인하세요.

스토어프론트를 별도로 검증하세요

Shopify의 문서화된 워크플로에서 저장된 번역과 스토어프론트 노출은 별도의 확인 지점입니다. 판매자와 함께 로케일 구성과 테마 확인을 계획하세요. 번역된 값을 저장했다고 해서 언어를 게시하거나 시장 설정을 바꿀 권한이 자동으로 생기지는 않습니다.

개발 스토어에서 대상 제품, 로케일 선택기, 대체 콘텐츠, 링크, 변형 라벨을 검사하세요. 저장된 번역을 다시 읽고 승인된 값과 비교합니다. 필드가 없으면 새 번역을 생성하기 전에 리소스 지원 또는 테마 렌더링을 조사하세요. 개발 스토어를 실제 판매자 성공 사례로 제시하지 말고 관찰 결과를 보존하세요.

근거와 커넥터의 한계

공식 레퍼런스는 Shopify 번역 인터페이스를 확립합니다. APIsRouter에 연결된 애플리케이션은 여기서 테스트하지 않았으며, 검토된 출처는 Shopify 또는 Translate & Adapt에서 임의의 게이트웨이 baseURL 설정을 확립하지 않습니다. 개발 스토어 결과가 나올 때까지 사용자 지정 애플리케이션 경로를 커넥터 리서치로 취급하세요.

완전한 테스트에서는 애플리케이션 버전, 범위가 정해진 인증 기록, 소스 쿼리, 후보, 승인, 등록 결과, 다시 읽은 결과 비교를 보존하세요. 소스 변경 충돌과 거부된 요청도 포함합니다. 결과 호환성 주장이 명확한 범위를 갖도록 모델 식별자와 사용량을 스토어 작업과 별도로 기록하세요.

자주 묻는 질문