Дослідження процесу перекладу товарів Shopify за допомогою AI

Оберіть потрібний шлях перекладу

Використовуйте інструменти продавця Shopify, коли редактор може безпосередньо керувати перекладами. Використовуйте GraphQL Admin API, коли потрібна повторювана зовнішня черга перевірки й розробник може підтримувати програму. У шляху API окремий клієнт моделі готує текст, а Shopify обробляє збережені переклади.

Почніть із тестового магазину та одного товару. Прочитайте його перекладні поля, підготуйте кандидата, отримайте схвалення й лише після цього надішліть передбачені зміни. Зберігайте налаштування моделі, облікові дані магазину та дозволи публікації окремо, щоб кожен крок можна було незалежно перевірити й виправити.

Оберіть процес продавця або програму

Документація Shopify Translate & Adapt описує ручне редагування й автоматичний переклад із перевіркою до публікації. Цього може бути достатньо, коли продавцю потрібен прямий редакційний контроль без створення програми. Користувацька інтеграція має сенс лише тоді, коли конкретна вимога, наприклад зовнішня черга перевірки, виправдовує володіння конектором.

Обирайте за тим, хто підтримуватиме чергу перевірки та мапування полів. Для сторонньої програми до встановлення перевірте її документовану конфігурацію, дозволи й поведінку експорту. Редактор для продавця та програма із зовнішньою підготовкою моделлю розв’язують різні операційні потреби.

Плануйте межі автентифікації та версій

Посилання translatableResource потребує read_translations; translationsRegister потребує write_translations. Для тестів використовуйте тестовий магазин і запишіть установку програми, версію API та надані області. Облікові дані шлюзу LLM не автентифікують запит Shopify Admin API, а токен Shopify не можна надсилати до кінцевої точки моделі.

Починайте з доступу на читання для виявлення, коли це дозволяє дизайн програми. Додавайте лише дозволи, потрібні подальшому авторизованому процесу. Зафіксуйте підтримувану версію API після перевірки її довідки, а не розгортайтеся на незаписаному псевдонімі latest. Токени зберігайте на сервері та виключайте з експортів перевірки й журналів запитів.

Читайте перекладні поля разом із їхніми дайджестами

Документований запит повертає ідентифікатор ресурсу та перекладні записи з 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. Плануйте конфігурацію локалі та перевірки теми разом із продавцем. Збереження перекладеного значення не має автоматично дозволяти публікацію мови або зміну параметрів ринку.

У тестовому магазині перевірте цільовий товар, вибір локалі, fallback-контент, посилання та ярлики варіантів. Прочитайте збережений переклад назад і порівняйте його зі схваленим значенням. Якщо поле відсутнє, дослідіть підтримку ресурсу або рендеринг теми до генерації іншого перекладу. Зберігайте спостереження, не видаючи тестовий магазин за успіх живого продавця.

Докази та межі конектора

Офіційні посилання встановлюють інтерфейси перекладу Shopify. Програму, підключену до APIsRouter, тут не тестували, а перевірені джерела не встановлюють довільне налаштування baseURL шлюзу в Shopify або Translate & Adapt. Розглядайте шлях користувацької програми як дослідження конектора, доки не буде результату в тестовому магазині.

Для повного тесту збережіть версію програми, запис автентифікації з областями, запит джерела, кандидата, схвалення, результат реєстрації та порівняння зворотного читання. Додайте конфлікт зміни джерела та відхилений запит. Ідентичність моделі й використання записуйте окремо від операцій магазину, щоб твердження про сумісність мало чітке охоплення.

Поширені запитання