아티클 데이터 가져오기

블로그 아티클 데이터가 필요한 워크플로에서는 아티클 데이터 가져오기 작업을 사용하여 Shopify 스토어에서 아티클 정보를 검색할 수 있습니다.

이 페이지의 내용

구성

필드

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

데이터 가져오기 작업에 사용되는 필드입니다.
필드	설명
데이터 정렬 기준	필수 사항입니다. 검색 쿼리에서 반환된 데이터를 정렬하는 매개변수입니다.
최대 결과 수	필수 사항입니다. 선택한 검색 쿼리에서 반환할 수 있는 최대 결과 수입니다. 한 번에 최대 100개까지 반환할 수 있습니다.
쿼리	필수 사항입니다. 일반 쿼리 중에서 선택하거나 고급을 선택하여 직접 생성하십시오.

쿼리 문자열

지난 하루 동안 게시된 아티클을 가져오기 위한 쿼리의 예는 다음과 같습니다.

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

published_at 변수는 아티클 쿼리에서 사용할 수 있는 필터이며 여러 번 사용하거나 다른 변수와 결합할 수 있습니다. scheduledAt Liquid 변수는 예약된 시간 트리거를 사용하는 워크플로에서 사용할 수 있습니다. date_minus Liquid 태그는 날짜에서 시간을 뺄 수 있는 특수 Flow 태그입니다.

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

사용 가능한 아티클 필터 목록
쿼리는 특정 구문을 따라야 합니다.
쿼리 필드 값이 항상 문서화되어 있는 것은 아닙니다. 경우에 따라 API 문서를 확인하여 값을 찾을 수 있습니다. 또는 관리자에서 필터링할 때 URL에서 필드 값을 찾을 수 있는 경우도 많습니다. 예를 들어 일부 주문 쿼리 값을 찾으려면 관리자의 주문 페이지를 필터링한 다음 URL을 확인하십시오.
Shopify GraphiQL 앱을 사용하여 스토어에서 쿼리를 실행하거나 테스트할 수 있습니다.
쿼리에 실패할 경우 발생하는 상황에 유의하십시오. API가 결과가 없음을 반환하는 대신 모든 결과를 반환하는 경우가 많습니다.

반환된 데이터

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

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

이 작업 이후의 단계에서 반환된 데이터에 액세스하려면 아티클 목록인 아티클 데이터 가져오기라는 이름의 변수를 사용하십시오. 이 변수는 조건과 작업 모두에서 사용할 수 있습니다. 예를 들어 다음과 같이 내부 이메일 보내기 작업으로 아티클 목록을 보낼 수 있습니다.

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

트리거

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

API 참조

이 작업에 사용된 API에 대한 자세한 내용은 아티클 쿼리를 참조하십시오.