Помощь
Войти

Получить данные о местонахождении компании

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

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

Настройка

Поля

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

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

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

Это пример запроса для получения местонахождений компаний, которые были обновлены за последний день:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

Переменная updated_at — это фильтр, доступный в запросе местоположений компаний. Его можно использовать несколько раз или в сочетании с другими переменными. Переменная Liquid scheduledAt доступна в рабочих процессах, которые используют триггер «Запланированное время». Тег Liquid date_minus — это специальный тег Flow, который позволяет вычитать время из даты.

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

  • Список доступных фильтров местонахождений компаний
  • Запросы должны соответствовать определенному синтаксису
  • Значения полей запроса не всегда документированы. В некоторых случаях их можно найти в документации по API. Кроме того, значения полей часто можно найти в URL-адресах в панели администратора при использовании фильтров. Например, чтобы найти некоторые значения для запроса заказов, отфильтруйте страницу «Заказы» в панели администратора, а затем проверьте URL-адрес.
  • Вы можете запустить или протестировать запрос в своем магазине с помощью приложения Shopify GraphiQL.
  • Помните, что произойдет, если ваш запрос не будет выполнен. Часто API возвращает все результаты (а не ноль).

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

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

  • Если вам нужно обработать каждый элемент списка по отдельности, например добавить к каждому тег, используйте действие «Для каждого» (For each).
  • Если вам нужно агрегировать данные, например посчитать количество возвращенных результатов, можно использовать действия «Подсчитать» (Count) или «Суммировать» (Sum).
  • Если вам нужно вывести список, например отправить электронное письмо со всеми элементами, то возвращенные данные можно использовать непосредственно в последующих действиях.

Чтобы получить доступ к возвращенным данным на последующих шагах, используйте переменную Get company location data, которая представляет собой список местонахождений компаний. Эту переменную можно использовать как в условиях, так и в действиях. Например, можно отправить список местонахождений с помощью действия «Отправить внутреннее электронное письмо» следующим образом:

{% for single_company in GetCompanyLocationData %}
* {{ single_company.name }}
{% endfor %}

Триггеры

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

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