Pesquisa do fluxo de tradução de produtos Shopify com IA

Escolha o caminho de tradução de que precisa

Use as ferramentas para comerciantes do Shopify quando um editor puder gerenciar traduções diretamente. Use a GraphQL Admin API quando precisar de uma fila externa de revisão repetível e um desenvolvedor puder manter a aplicação. No caminho da API, um cliente de modelo separado cria o rascunho enquanto o Shopify administra as traduções armazenadas.

Comece com uma loja de desenvolvimento e um produto. Leia seus campos traduzíveis, prepare um candidato, obtenha revisão e só então envie as alterações pretendidas. Mantenha configurações do modelo, credenciais da loja e permissões de publicação separadas para que cada etapa possa ser inspecionada e corrigida independentemente.

Escolha um fluxo de comerciante ou uma aplicação

A documentação do Translate & Adapt do Shopify descreve edição manual e tradução automática, com revisão antes da publicação. Isso pode ser suficiente quando o comerciante quer controle editorial direto sem construir uma aplicação. Uma integração personalizada só faz sentido quando uma necessidade específica, como uma fila externa de revisão, justifica possuir o conector.

Escolha conforme quem manterá a fila de revisão e o mapeamento de campos. Para um aplicativo de terceiros, inspecione sua configuração documentada, permissões e comportamento de exportação antes da instalação. Um editor voltado ao comerciante e uma aplicação com rascunho externo por modelo resolvem necessidades operacionais diferentes.

Planeje limites de autenticação e versão

A referência translatableResource exige read_translations; translationsRegister exige write_translations. Use uma loja de desenvolvimento e registre instalação da aplicação, versão da API e escopos concedidos durante os testes. Uma credencial de gateway LLM não autentica uma solicitação da Shopify Admin API, e um token do Shopify não deve ser enviado ao endpoint do modelo.

Comece com acesso de leitura para descoberta quando o desenho da aplicação permitir. Adicione somente as permissões necessárias ao fluxo autorizado posterior. Fixe uma versão de API suportada depois de conferir sua referência, em vez de publicar usando um alias latest não registrado. Mantenha tokens no servidor e exclua-os de exportações de revisão e logs de solicitações.

Leia campos traduzíveis com seus digests

A consulta documentada retorna um identificador de recurso e entradas traduzíveis com chave, valor, digest e locale. Preserve esses digests específicos de campo junto do snapshot da fonte. Eles conectam uma tradução proposta ao conteúdo que foi realmente lido, e não a um título de produto copiado de uma planilha.

A consulta abaixo foi adaptada do esquema oficial como exemplo somente de leitura. Forneça um GID de produto autorizado em um ambiente de desenvolvimento. Inspecione as chaves retornadas e use uma allowlist explícita de campos; use o locale de origem retornado em vez de inferi-lo do idioma do navegador.

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

Gere um candidato de tradução fora do Shopify

Crie um registro interno de candidato contendo ID do recurso, chave do campo, digest da fonte, locale-alvo, revisão do glossário e valor do rascunho. Envie ao modelo somente o texto e o contexto de produto necessário. Mantenha SKU, preço, moeda, estoque e identidade da variante fora do patch gerado.

Valide texto obrigatório, placeholders e terminologia aprovada antes que um revisor bilíngue veja o candidato. Peça a um revisor de produto que confira alegações e avisos contra a fonte original. Uma extensão de navegador que traduz a vitrine não cria esse registro nem comprova que o Shopify armazenou uma tradução; ela é apenas um auxílio de inspeção.

Registre somente traduções aprovadas e atuais

A mutação translationsRegister aceita campos traduzidos com translatableContentDigest. Seu resultado documentado inclui userErrors. Um conector deve inspecionar esse resultado, em vez de tratar uma resposta HTTP isolada como prova de registro bem-sucedido.

Antes de uma gravação autorizada, compare a fonte atual com o snapshot revisado. Se ela mudou, retenha o candidato e obtenha uma nova revisão. Mantenha uma lista explícita das alterações pretendidas e das traduções anteriores para recuperação. Comece com um campo na loja de desenvolvimento e leia-o novamente antes de ampliar o patch.

Verifique a vitrine separadamente

Tradução armazenada e disponibilidade na vitrine são checkpoints separados no fluxo documentado do Shopify. Planeje a configuração de locale e as verificações de tema com o comerciante. Salvar um valor traduzido não deve autorizar automaticamente a publicação de um idioma nem a alteração de configurações de mercado.

Na loja de desenvolvimento, inspecione o produto-alvo, seletor de locale, conteúdo de fallback, links e rótulos de variantes. Leia a tradução armazenada novamente e compare-a com o valor aprovado. Se um campo estiver ausente, investigue suporte do recurso ou renderização do tema antes de gerar outra tradução. Preserve as observações sem apresentar uma loja de desenvolvimento como sucesso de um comerciante ao vivo.

Evidências e limites do conector

As referências oficiais estabelecem as interfaces de tradução do Shopify. Uma aplicação conectada à APIsRouter não foi testada aqui, e as fontes revisadas não estabelecem uma configuração arbitrária de baseURL de gateway no Shopify ou no Translate & Adapt. Trate o caminho da aplicação personalizada como pesquisa de conector até haver um resultado em loja de desenvolvimento.

Para um teste completo, retenha versão da aplicação, registro de autenticação com escopo, consulta da fonte, candidato, aprovação, resultado do registro e comparação de leitura posterior. Inclua um conflito de alteração da fonte e uma solicitação rejeitada. Registre identidade e uso do modelo separadamente das operações da loja para que a alegação de compatibilidade tenha escopo claro.

Perguntas frequentes