시장 데이터 가져오기

시장 데이터가 필요한 워크플로에서는 시장 데이터 가져오기 작업을 사용하여 Shopify 스토어에서 시장 정보를 검색할 수 있습니다. 시장은 판매 대상으로 삼는 지역 또는 위치의 그룹입니다.

구성

필드

시장 데이터 가져오기 작업에는 다음 필드가 포함됩니다.

쿼리 문자열

다음은 모든 활성 시장을 가져오기 위한 쿼리 예시입니다.

status:ACTIVE

status 변수는 시장 쿼리에서 사용할 수 있는 필터로, 여러 번 사용하거나 다른 변수와 결합할 수 있습니다.

데이터를 쿼리할 때 다음 사항을 알아두면 유용합니다.

• 사용 가능한 시장 필터 목록

• 쿼리는 특정 구문을 따라야 합니다.

• 쿼리 필드 값이 항상 문서화되어 있는 것은 아닙니다. 경우에 따라 API 문서를 확인하여 값을 찾을 수 있습니다. 또는 관리자에서 필터링할 때 URL에서 필드 값을 찾을 수 있는 경우도 많습니다. 예를 들어, 일부 주문 쿼리 값을 찾으려면 관리자에서 주문 페이지를 필터링한 다음 URL을 확인하십시오.

• Shopify GraphiQL 앱을 사용하여 샵에서 쿼리를 실행하거나 테스트할 수 있습니다.

• 쿼리가 실패할 경우 발생하는 상황에 유의하십시오. 종종 API는 아무 결과도 반환하지 않는 대신 모든 결과를 반환합니다.

반환된 데이터

모든 데이터 가져오기 작업은 0~100개의 리소스 목록을 반환합니다. 사용 사례에 따라 이 데이터를 다양한 방식으로 사용할 수 있습니다.

• 각 항목에 태그를 추가하는 등 각 목록 항목을 개별적으로 처리해야 하는 경우 각각에 대해 작업을 사용할 수 있습니다.
• 반환된 결과 수를 계산하는 등 데이터를 집계해야 하는 경우 개수 또는 합계 작업을 사용할 수 있습니다.
• 모든 항목이 포함된 이메일을 전송하는 등 목록을 출력해야 하는 경우 후속 작업에서 반환된 데이터를 직접 사용할 수 있습니다.

이 작업 이후의 단계에서 반환된 데이터에 액세스하려면 시장 목록인 시장 데이터 가져오기라는 변수를 사용하십시오. 이 변수는 조건과 작업 모두에서 사용할 수 있습니다. 예를 들어, 다음과 유사하게 내부 이메일 전송 작업에서 시장 목록을 전송할 수 있습니다.

{% for single_market in GetMarketData %}
    * {{ single_market.name }}
    {% endfor %}

트리거

예약된 시간 트리거를 포함하여 모든 워크플로에서 이 작업을 사용할 수 있습니다. 예약된 시간 트리거를 사용하는 워크플로의 경우 이벤트의 결과가 아닌 지정된 시간에 워크플로가 시작됩니다. 스토어나 앱에서 워크플로를 시작하는 특정 이벤트가 없으므로 자동으로 포함되는 데이터는 없습니다.

API 참조

이 작업에서 사용되는 API에 대한 자세한 내용은 시장 쿼리를 참조하십시오.