Помощь
Войти

Получение данных о коллекции

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

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

Настройка

Поля

Действие «Получение данных о коллекции» содержит следующие поля.

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

Триггеры

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

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