Recherche zum KI-Produktübersetzungsworkflow für Shopify

Wählen Sie den benötigten Übersetzungsweg

Verwenden Sie Shopifys Händler-Tools, wenn ein Redakteur Übersetzungen direkt verwalten kann. Verwenden Sie die GraphQL Admin API, wenn Sie eine wiederholbare externe Prüfwarteschlange benötigen und ein Entwickler die Anwendung pflegen kann. Im API-Weg erstellt ein separater Modellclient Textentwürfe, während Shopify die gespeicherten Übersetzungen verarbeitet.

Beginnen Sie mit einem Development Store und einem Produkt. Lesen Sie seine übersetzbaren Felder, bereiten Sie einen Kandidaten vor, holen Sie eine Freigabe ein und übermitteln Sie erst dann die vorgesehenen Änderungen. Halten Sie Modelleinstellungen, Shop-Zugangsdaten und Veröffentlichungsberechtigungen getrennt, damit jeder Schritt unabhängig geprüft und korrigiert werden kann.

Wählen Sie einen Händlerworkflow oder eine Anwendung

Shopifys Translate-&-Adapt-Dokumentation beschreibt manuelle Bearbeitung und automatische Übersetzung mit Prüfung vor der Veröffentlichung. Das kann ausreichen, wenn der Händler direkte redaktionelle Kontrolle ohne Anwendungsentwicklung möchte. Eine benutzerdefinierte Integration ist nur dann sinnvoll, wenn eine konkrete Anforderung wie eine externe Prüfwarteschlange den Besitz des Connectors rechtfertigt.

Wählen Sie danach, wer Prüfwarteschlange und Feldzuordnung pflegt. Prüfen Sie bei einer Drittanbieter-App vor der Installation dokumentierte Konfiguration, Berechtigungen und Exportverhalten. Ein händlerorientierter Editor und eine Anwendung mit externem Modell-Entwurf lösen unterschiedliche betriebliche Anforderungen.

Planen Sie Authentifizierung und Versionsgrenzen

Die Referenz translatableResource benötigt read_translations; translationsRegister benötigt write_translations. Verwenden Sie zum Testen einen Development Store und erfassen Sie App-Installation, API-Version und erteilte Scopes. Ein LLM-Gateway-Schlüssel authentifiziert keine Shopify-Admin-API-Anfrage und ein Shopify-Token darf nicht an den Modellendpunkt gesendet werden.

Beginnen Sie, sofern das Anwendungsdesign dies erlaubt, mit Lesezugriff zur Erkundung. Fügen Sie für den später autorisierten Workflow nur erforderliche Berechtigungen hinzu. Fixieren Sie eine unterstützte API-Version nach Prüfung ihrer Referenz, statt gegen ein nicht aufgezeichnetes Latest-Alias zu deployen. Halten Sie Tokens serverseitig und schließen Sie sie aus Prüfexporten und Anfrage-Logs aus.

Lesen Sie übersetzbare Felder mit ihren Digests

Die dokumentierte Abfrage gibt eine Ressourcenkennung und übersetzbare Einträge mit Schlüssel, Wert, Digest und Locale zurück. Bewahren Sie diese feldspezifischen Digests mit dem Quellensnapshot auf. Sie verbinden eine vorgeschlagene Übersetzung mit dem tatsächlich gelesenen Inhalt und nicht mit einem aus einer Tabelle kopierten Produkttitel.

Die folgende Abfrage ist als schreibgeschütztes Beispiel aus dem offiziellen Schema abgeleitet. Verwenden Sie in einer Entwicklungsumgebung eine autorisierte Produkt-GID. Prüfen Sie die zurückgegebenen Schlüssel und verwenden Sie eine explizite Feld-Allowlist. Verwenden Sie das zurückgegebene Quell-Locale und leiten Sie es nicht aus der Browsersprache ab.

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

Erstellen Sie einen Übersetzungskandidaten außerhalb von Shopify

Erstellen Sie intern einen Kandidatendatensatz mit Ressourcen-ID, Feldschlüssel, Quellen-Digest, Ziel-Locale, Glossarrevision und Entwurfswert. Senden Sie nur Text und den erforderlichen Produktkontext an das Modell. Halten Sie SKU, Preis, Währung, Bestand und Variantenidentität aus dem generierten Patch heraus.

Validieren Sie erforderlichen Text, Platzhalter und freigegebene Terminologie, bevor ein zweisprachiger Prüfer den Kandidaten sieht. Lassen Sie einen Produktprüfer Aussagen und Warnungen gegen die Originalquelle prüfen. Eine Browsererweiterung, die den Shop übersetzt, erstellt diesen Datensatz nicht und belegt nicht, dass Shopify eine Übersetzung gespeichert hat; sie ist nur eine Inspektionshilfe.

Registrieren Sie nur freigegebene, aktuelle Übersetzungen

Die Mutation translationsRegister akzeptiert übersetzte Felder mit translatableContentDigest. Ihr dokumentiertes Ergebnis enthält userErrors. Ein Connector muss dieses Ergebnis prüfen, statt allein eine HTTP-Antwort als Beleg erfolgreicher Registrierung zu behandeln.

Vergleichen Sie vor einem autorisierten Schreibvorgang aktuelle Quelle und geprüften Snapshot. Wenn sie sich geändert hat, halten Sie den Kandidaten an und holen Sie eine neue Prüfung ein. Bewahren Sie eine ausdrückliche Liste vorgesehener Feldänderungen und frühere Übersetzungen zur Wiederherstellung auf. Beginnen Sie im Development Store mit einem Feld und lesen Sie es zurück, bevor Sie den Patch erweitern.

Prüfen Sie den Shop separat

Gespeicherte Übersetzung und Sichtbarkeit im Shop sind in Shopifys dokumentiertem Workflow getrennte Prüfpunkte. Planen Sie Locale-Konfiguration und Theme-Prüfungen gemeinsam mit dem Händler. Das Speichern eines übersetzten Werts sollte nicht automatisch die Veröffentlichung einer Sprache oder die Änderung von Markteinstellungen autorisieren.

Prüfen Sie im Development Store Zielprodukt, Locale-Auswahl, Fallback-Inhalt, Links und Variantenlabels. Lesen Sie die gespeicherte Übersetzung zurück und vergleichen Sie sie mit dem freigegebenen Wert. Wenn ein Feld fehlt, untersuchen Sie Ressourcenunterstützung oder Theme-Rendering, bevor Sie eine weitere Übersetzung erzeugen. Bewahren Sie Beobachtungen auf, ohne einen Development Store als Live-Erfolg eines Händlers darzustellen.

Belege und Grenzen des Connectors

Die offiziellen Referenzen belegen die Shopify-Übersetzungsschnittstellen. Eine mit APIsRouter verbundene Anwendung wurde hier nicht getestet, und die geprüften Quellen belegen keine beliebige Gateway-baseURL-Einstellung in Shopify oder Translate & Adapt. Behandeln Sie den benutzerdefinierten Anwendungsweg als Connector-Recherche, bis ein Ergebnis aus einem Development Store vorliegt.

Bewahren Sie für einen vollständigen Test Anwendungsversion, Authentifizierungsdatensatz mit Scopes, Quellabfrage, Kandidat, Freigabe, Registrierungsergebnis und Rücklesevergleich auf. Nehmen Sie einen Quellenänderungskonflikt und eine abgelehnte Anfrage auf. Erfassen Sie Modellidentität und Nutzung getrennt von Shopvorgängen, damit die Kompatibilitätsaussage klar begrenzt ist.

Häufige Fragen