Помощь
Войти

Получить данные рынка

В рабочих процессах, где требуются данные о рынках, вы можете использовать действие Получить данные рынка, чтобы извлечь информацию о рынке из вашего магазина Shopify. Рынки — это группы регионов или мест расположения, на которые ориентированы ваши продажи.

На этой странице

Конфигурация

Поля

Действие Получить данные рынка содержит следующие поля:

Поля, используемые в действиях «Получить данные».
ПолеОписание
Сортировать данные поОбязательно. Параметры, по которым сортируются данные, возвращаемые поисковым запросом.
Максимальное количество результатовОбязательно. Максимальное количество результатов, которое может быть возвращено выбранным поисковым запросом. За один раз можно вернуть до 100 результатов.
ЗапросОбязательно. Выберите один из стандартных запросов или выберите Расширенные, чтобы создать свой собственный.

Строка запроса

Пример запроса для получения всех активных рынков:

status:ACTIVE

Переменная status является фильтром, доступным в запросе Markets, и может использоваться несколько раз или в комбинации с другими переменными.

При запросе данных полезно знать следующее:

  • Список доступных фильтров для рынков

  • Запросы должны соответствовать определённому синтаксису

  • Значения полей запроса не всегда задокументированы. В некоторых случаях их можно найти в документации по API. Кроме того, значения полей часто можно найти в URL в панели администратора при использовании фильтров. Например, чтобы найти некоторые значения для запроса к заказам, отфильтруйте страницу «Заказы» в панели администратора, а затем проверьте URL.

  • Вы можете запустить или протестировать запрос в своём магазине с помощью приложения Shopify GraphiQL.

  • Учитывайте, что произойдёт в случае сбоя запроса. Часто API возвращает все результаты (вместо того, чтобы не возвращать ничего).

Возвращаемые данные

Все действия Получить данные возвращают список, содержащий от 0 до 100 ресурсов. В зависимости от вашей задачи, вы можете использовать эти данные различными способами:

  • Если вам нужно обработать каждый элемент списка отдельно, например, чтобы добавить тег для каждого из них, вы можете использовать действие Для каждого.
  • Если вам нужно агрегировать данные, например, подсчитать количество возвращённых результатов, вы можете использовать действия Количество или Сумма.
  • Если вам нужно вывести список, например, отправить все элементы по электронной почте, вы можете использовать возвращаемые данные напрямую в последующих действиях.

Для получения доступа к возвращённым данным в шагах, следующих за этим действием, используйте переменную Получить данные рынка, которая представляет собой список рынков. Эту переменную можно использовать как в условиях, так и в действиях. Например, вы можете отправить список рынков в действии Отправить внутреннее электронное письмо примерно так:

{% for single_market in GetMarketData %}
    * {{ single_market.name }}
    {% endfor %}

Триггеры

Это действие можно использовать в любом рабочем процессе, в том числе с триггером Запланированное время. В рабочем процессе с триггером Запланированное время рабочий процесс запускается в указанное вами время, а не в результате какого-либо события. Поскольку нет конкретного события в вашем магазине или приложении, которое запускает рабочий процесс, данные не включаются автоматически.

Справочник по API

Для получения дополнительной информации об API, используемом в этом действии, см. запрос Markets.