Помощь
Войти

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

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

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

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

Поля

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

Поля, используемые в действиях «Получить данные».
ПолеОписание
Сортировать данные поОбязательно. Параметры, по которым сортируются данные, возвращаемые поисковым запросом.
Максимальное количество результатовОбязательно. Максимальное количество результатов, которое может вернуть выбранный вами поисковый запрос. Одновременно можно вернуть до 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 single_company in GetCompanyData %}
* {{ single_company.name }}
{% endfor %}

Триггеры

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

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