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

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

Примечание

Это тип действия Получить данные. Чтобы узнать, как использовать этот тип действия с триггером Запланированное время и циклами Для каждого, см. раздел Расписания, получение данных и циклические рабочие процессы в Shopify Flow.

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

Поля

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

Поля, используемые в действиях «Получить данные».

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

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

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

status:ACTIVE

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

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

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

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

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

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

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

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

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

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

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

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% endfor %}

Примечание

Если действие Получить данные используется в одном рабочем процессе несколько раз, к имени переменной добавляется цифра. Например, в рабочем процессе, где действие Получить данные заказа используется дважды, первой переменной для возвращенных данных будет getOrderData, а второй — getOrderData1. Это имя нельзя изменить.

Триггеры

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

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

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