Помощь
Войти

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

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

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

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

Поля

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{% for single_article in GetArticleData %}
    * {{ single_article.title }}
    {% endfor %}

Триггеры

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

Справочник API

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