Onderzoek naar een Shopify-workflow voor AI-productvertaling

Kies het vertaalpad dat je nodig hebt

Gebruik Shopify-merchanttools wanneer een editor vertalingen rechtstreeks kan beheren. Gebruik de GraphQL Admin API wanneer je een herhaalbare externe reviewqueue nodig hebt en een ontwikkelaar de applicatie kan onderhouden. In het API-pad maakt een afzonderlijke modelclient tekstconcepten terwijl Shopify de opgeslagen vertalingen beheert.

Begin met een development-store en één product. Lees de vertaalbare velden, bereid een kandidaat voor, verkrijg review en dien pas daarna de bedoelde wijzigingen in. Houd modelinstellingen, storecredentials en publicatiemachtigingen gescheiden zodat elke stap afzonderlijk kan worden geïnspecteerd en gecorrigeerd.

Kies een merchantworkflow of een applicatie

Shopify's Translate & Adapt-documentatie beschrijft handmatige bewerking en automatische vertaling, met review vóór publicatie. Dat kan genoeg zijn wanneer de merchant directe redactionele controle wil zonder een applicatie te bouwen. Een custom integratie is alleen zinvol wanneer een specifieke eis, zoals een externe reviewqueue, het eigenaarschap van de connector rechtvaardigt.

Kies op basis van wie de reviewqueue en veldmapping onderhoudt. Inspecteer voor een third-partyapp de gedocumenteerde configuratie, machtigingen en exportwerking vóór installatie. Een merchantgerichte editor en een applicatie met externe model-drafting lossen verschillende operationele behoeften op.

Plan authenticatie- en versiegrenzen

De translatableResource-referentie vereist read_translations; translationsRegister vereist write_translations. Gebruik een development-store en leg appinstallatie, API-versie en verleende scopes vast tijdens het testen. Een LLM-gatewaycredential authenticeert geen Shopify Admin API-request en een Shopify-token mag niet naar het modelendpoint worden gestuurd.

Begin waar het applicatieontwerp het toelaat met read access voor discovery. Voeg alleen de machtigingen toe die de latere geautoriseerde workflow nodig heeft. Pin een ondersteunde API-versie na controle van de referentie in plaats van tegen een ongeregistreerde latest-alias te deployen. Houd tokens server-side en sluit ze uit van reviewexports en requestlogs.

Lees vertaalbare velden met hun digests

De gedocumenteerde query retourneert een resourceidentifier en vertaalbare entries met key, value, digest en locale. Bewaar die veldspecifieke digests bij de source-snapshot. Ze koppelen een voorgestelde vertaling aan content die werkelijk is gelezen en niet aan een producttitel die uit een spreadsheet is gekopieerd.

De query hieronder is afgeleid van het officiële schema als read-only voorbeeld. Lever een geautoriseerde product-GID aan in een developmentomgeving. Inspecteer geretourneerde keys en gebruik een expliciete field allowlist; gebruik de geretourneerde sourcelocale en leid die niet af uit de browsertaal.

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

Genereer buiten Shopify een vertaalde kandidaat

Bouw een intern kandidaatrecord met resource-ID, field key, source digest, target locale, glossaryrevisie en draftwaarde. Stuur alleen tekst en noodzakelijke productcontext naar het model. Houd SKU, prijs, valuta, voorraad en variantidentiteit buiten de gegenereerde patch.

Valideer vereiste tekst, placeholders en goedgekeurde terminologie voordat een bilinguale reviewer de kandidaat ziet. Laat een productreviewer claims en waarschuwingen tegen de oorspronkelijke bron controleren. Een browserextensie die de storefront vertaalt, maakt dit record niet aan en bewijst niet dat Shopify een vertaling heeft opgeslagen; het is alleen een inspectiehulpmiddel.

Registreer alleen goedgekeurde, actuele vertalingen

De translationsRegister-mutatie accepteert vertaalde velden met translatableContentDigest. Het gedocumenteerde resultaat bevat userErrors. Een connector moet dat resultaat inspecteren en een HTTP-response niet op zichzelf als bewijs van geslaagde registratie behandelen.

Vergelijk vóór een geautoriseerde write de actuele bron met de gereviewde snapshot. Als die is veranderd, houd de kandidaat vast en vraag nieuwe review. Bewaar een expliciete lijst van bedoelde veldwijzigingen en vorige vertalingen voor herstel. Begin met één veld in de development-store en lees dat terug voordat je de patch uitbreidt.

Verifieer de storefront afzonderlijk

Opgeslagen vertaling en beschikbaarheid in de storefront zijn afzonderlijke checkpoints in Shopify's gedocumenteerde workflow. Plan localeconfiguratie en themacontroles met de merchant. Een opgeslagen vertaalwaarde autoriseert niet automatisch de publicatie van een taal of een wijziging van marktinstellingen.

Inspecteer in de development-store het doelproduct, localeselector, fallbackcontent, links en variantlabels. Lees de opgeslagen vertaling terug en vergelijk die met de goedgekeurde waarde. Onderzoek bij een ontbrekend veld resourceondersteuning of themerendering voordat je een nieuwe vertaling maakt. Bewaar de observaties zonder een development-store als live merchantsucces te presenteren.

Bewijs en grenzen van de connector

De officiële referenties stellen de Shopify-vertaalinterfaces vast. Een met APIsRouter verbonden applicatie is hier niet getest en de gereviewde bronnen stellen geen willekeurige gateway-baseURL-instelling in Shopify of Translate & Adapt vast. Behandel het aangepaste applicatiepad als connectoronderzoek totdat het een development-store-resultaat heeft.

Bewaar voor een complete test applicatieversie, scoped authenticatierecord, bronquery, kandidaat, goedkeuring, registratieresultaat en read-backvergelijking. Neem een bronwijzigingsconflict en een afgewezen request op. Registreer modelidentiteit en usage afzonderlijk van storebewerkingen zodat de compatibiliteitsclaim een duidelijke scope heeft.

Veelgestelde vragen