Перейти к содержанию
ERITKOM
БизнесНовость

Shopify меняет выбор метаполей для пересекающихся рынков

При равной специфичности рынков приоритет получит их handle, а не время изменения значения. Отдельное обновление Storefront API 2027-01 уберёт зависимость поиска ключей от регистра; это пока кандидат следующей версии.

Архивная фотография ноутбука на рабочем столе в Брешии, 2017 год; тематическая иллюстрация работы с интернет-магазином, не интерфейс и не офис Shopify
Luca Bravo, Desktop after work, Брешия, 13 февраля 2017 года, CC0 1.0. Архивная тематическая фотография, не интерфейс и не офис Shopify. Пропорциональное уменьшение и JPEG→WebP.

Порядок рынков заменяет время последнего редактирования

Shopify 13 ноября объявила новое правило для покупателей, подходящих сразу нескольким одинаково специфичным рынкам. Если такие рынки задают одно метаполе, выигрывает рынок с наименьшим handle — его текстовым идентификатором. Раньше выбиралось значение, обновлённое последним. Приоритет более специфичного рынка сохраняется: новое правило разрешает только оставшуюся ничью.

Идентификаторы сравниваются побайтово, символ за символом. Для строчных латинских букв, цифр и дефисов это соответствует алфавитному порядку, где дефис предшествует цифрам, а цифры — буквам. Правило относится ко всем версиям Storefront API и Function APIs, а также к Liquid, но внедряется поэтапно. Сначала изменение получают магазины, где оно не меняет видимые покупателю значения. С остальными продавцами Shopify обещает связаться до переключения. Поэтому дата анонса не означает одновременное изменение всех витрин. Handle можно увидеть и отредактировать в панели магазина, тогда как время изменения метаполя там не показывается.

Регистр ключа изменится по отдельному расписанию

Второй анонс того же дня касается поля Market.metafields в Storefront API начиная с версии 2027-01. Оно начнёт находить ключ независимо от регистра букв — так, как уже работает одиночное Market.metafield. Например, запрос ключа Colour сможет получить сохранённое значение colour. В версиях 2026-10 и ранее списковый запрос при таком несовпадении возвращает null; их поведение этим обновлением не меняется.

Затронуты приложения и собственные витрины, которые запрашивают ключ в другом регистре либо работают с рынками, хранящими его в разных регистрах. Shopify предлагает ещё на текущей версии сравнить одиночный и списковый запросы с одинаковыми namespace и key. Различие результатов показывает, где переход способен изменить ответ. Если оно существенно для интерфейса, ключи и запросы следует привести к согласованному написанию. Это отдельная проверка от выбора рынка по handle: одинаковый регистр не устраняет пересечение рынков, а порядок рынков не исправляет ошибочный ключ.

Что именно приложение запрашивает у рынка

В справочнике Storefront API объект Market описывает аудиторию покупателей, выбранную продавцом. Она может определяться географией, местоположениями компаний или розничными точками. Рынки поддерживают локализованный опыт покупок с соответствующими языками, валютами и ценами. Метаполя добавляют к такому объекту собственные данные; их не следует смешивать с самим идентификатором рынка.

У Market есть глобально уникальный id и читаемый handle, автоматически сформированный из названия. Для одиночного метаполя нужен ключ, а namespace задаёт пространство, в котором его искать. Если пространство не передано, используется зарезервированное для приложения. Списковое поле принимает набор пар namespace и key, причём во входном списке допускается не более 250 значений. Оба варианта требуют доступа с токеном. Эти свойства помогают разделить проверку на понятные части: какой объект выбран, какое собственное поле запрошено и каким интерфейсом прочитано его значение.

Январская версия пока предназначена для проверки

На 14 ноября официальный календарь Shopify помечает 2027-01 как release candidate, а 2026-10 — как последнюю стабильную версию. Плановая дата стабильного выпуска 2027-01 — 1 января 2027 года. Кандидат может включать несовместимые изменения и не рекомендуется для рабочего магазина; наличие ноябрьской документации не превращает его в текущую стабильную основу витрины.

Версия задаётся в адресе запроса либо настройках официального клиента. Фактически использованный вариант возвращается в заголовке X-Shopify-API-Version. Если запрошенная версия уже недоступна, платформа обслуживает обращение старейшей доступной стабильной версией, а не обязательно той, которую ожидал разработчик. Поэтому при сравнении ответов важно фиксировать не только текст запроса, но и версию ответа. Обычный квартальный график и поддержка стабильных версий минимум двенадцать месяцев дают контекст для подготовки перехода, однако не отменяют отдельно объявленный поэтапный переход к новому порядку рынков.

Источники

Принципы журнала и исправления.

ERITKOM / НОВЫЙ ПРОЕКТ

Расскажите о задаче и оставьте контакты. Мы свяжемся с вами, чтобы обсудить проект.

  1. 01 Контакты
  2. 02 Ваша задача