Помощь
Войти

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

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

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

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

Поля

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

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

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

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

pickup_in_store:enabled

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

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

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

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

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

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

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

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

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

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

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

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

Триггеры

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

Справка по API

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