Ricerca sul workflow di traduzione AI dei prodotti Shopify

Scegli il percorso di traduzione necessario

Usa gli strumenti merchant Shopify quando un editor può gestire direttamente le traduzioni. Usa la GraphQL Admin API quando ti serve una coda di revisione esterna ripetibile e uno sviluppatore può mantenere l'applicazione. Nel percorso API, un client modello separato redige il testo mentre Shopify gestisce le traduzioni memorizzate.

Inizia con uno store di sviluppo e un prodotto. Leggi i suoi campi traducibili, prepara un candidato, ottieni la revisione e solo dopo invia le modifiche previste. Mantieni separati impostazioni del modello, credenziali store e permessi di pubblicazione, così ogni passaggio può essere ispezionato e corretto indipendentemente.

Scegli un workflow merchant o un'applicazione

La documentazione Translate & Adapt di Shopify descrive editing manuale e traduzione automatica con revisione prima della pubblicazione. Può bastare quando il merchant vuole controllo editoriale diretto senza costruire un'applicazione. Un'integrazione personalizzata ha senso solo quando un requisito specifico, come una coda di revisione esterna, giustifica la responsabilità sul connettore.

Scegli in base a chi manterrà coda di revisione e mapping dei campi. Per un'app di terze parti, ispeziona configurazione documentata, permessi e comportamento dell'export prima dell'installazione. Un editor rivolto al merchant e un'applicazione con redazione da modello esterno risolvono esigenze operative diverse.

Pianifica confini di autenticazione e versione

Il riferimento translatableResource richiede read_translations; translationsRegister richiede write_translations. Usa uno store di sviluppo e registra installazione dell'app, versione API e scope concessi durante il test. Una credenziale gateway LLM non autentica una richiesta Shopify Admin API e un token Shopify non deve essere inviato all'endpoint del modello.

Inizia con accesso in lettura per la discovery quando il design dell'app lo consente. Aggiungi solo i permessi necessari al workflow autorizzato successivo. Fissa una versione API supportata dopo averne controllato il riferimento invece di usare un alias latest non registrato. Mantieni i token lato server ed escludili da export di revisione e log delle richieste.

Leggi i campi traducibili con i relativi digest

La query documentata restituisce un identificatore della risorsa e voci traducibili con key, value, digest e locale. Conserva questi digest specifici del campo insieme allo snapshot della fonte. Collegano la traduzione proposta al contenuto effettivamente letto e non a un titolo prodotto copiato da un foglio di calcolo.

La query seguente è adattata dallo schema ufficiale come esempio read-only. Fornisci un product GID autorizzato in ambiente di sviluppo. Ispeziona le key restituite e usa un'allowlist esplicita dei campi; usa la locale sorgente restituita invece di dedurla dalla lingua del browser.

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

Genera un candidato di traduzione fuori da Shopify

Costruisci un record candidato interno con resource ID, field key, source digest, locale target, revisione del glossario e valore di bozza. Invia al modello solo testo e contesto prodotto necessario. Mantieni SKU, prezzo, valuta, inventario e identità della variante fuori dalla patch generata.

Valida testo richiesto, placeholder e terminologia approvata prima che il candidato arrivi a un revisore bilingue. Fai controllare a un revisore prodotto claim e avvertenze rispetto alla fonte originale. Un'estensione browser che traduce la vetrina non crea questo record e non dimostra che Shopify abbia memorizzato una traduzione: è solo un aiuto d'ispezione.

Registra solo traduzioni approvate e correnti

La mutation translationsRegister accetta campi tradotti con translatableContentDigest. Il risultato documentato include userErrors. Un connettore deve ispezionare quel risultato invece di trattare una risposta HTTP da sola come prova di registrazione riuscita.

Prima di una scrittura autorizzata, confronta la fonte corrente con lo snapshot revisionato. Se è cambiata, sospendi il candidato e ottieni una nuova revisione. Conserva un elenco esplicito dei cambiamenti previsti e delle traduzioni precedenti per il recupero. Inizia con un campo nello store di sviluppo e rileggilo prima di ampliare la patch.

Verifica separatamente la vetrina

Traduzione memorizzata e disponibilità nella vetrina sono checkpoint separati nel workflow documentato Shopify. Pianifica configurazione locale e controlli del tema con il merchant. Salvare un valore tradotto non dovrebbe autorizzare automaticamente la pubblicazione di una lingua o il cambio delle impostazioni di mercato.

Nello store di sviluppo, ispeziona prodotto target, selettore della locale, contenuto fallback, link ed etichette delle varianti. Rileggi la traduzione salvata e confrontala con il valore approvato. Se manca un campo, indaga supporto della risorsa o rendering del tema prima di generare un'altra traduzione. Conserva le osservazioni senza presentare uno store di sviluppo come successo live del merchant.

Prove e limiti del connettore

I riferimenti ufficiali stabiliscono le interfacce di traduzione Shopify. Un'applicazione collegata ad APIsRouter non è stata testata qui e le fonti revisionate non stabiliscono un'impostazione generica di baseURL gateway in Shopify o Translate & Adapt. Tratta il percorso dell'app personalizzata come ricerca di connettore finché non esiste un risultato nello store di sviluppo.

Per un test completo conserva versione dell'applicazione, record di autenticazione con scope, query sorgente, candidato, approvazione, risultato della registrazione e confronto di rilettura. Includi un conflitto per cambiamento della fonte e una richiesta rifiutata. Registra identità e utilizzo del modello separatamente dalle operazioni dello store, così la dichiarazione di compatibilità ha un perimetro chiaro.

Domande frequenti