판매 플랜 그룹 데이터 얻기

판매 플랜 그룹 데이터를 필요로 하는 워크플로에서 판매 플랜 그룹 데이터 가져오기 작업을 사용하여 스토어에서 주문 정보를 검색할 수 있습니다.

구성

필드

판매 플랜 그룹 데이터 가져오기 작업에는 쿼리 작성에 사용되는 다음 필드가 포함됩니다.

데이터 가져오기 작업에 사용되는 필드입니다.

필드	설명
데이터 정렬 기준	필수 항목입니다. 검색 쿼리에서 반환된 데이터를 정렬하는 기준이 되는 매개변수입니다.
최대 결과 수	필수. 선택한 검색 쿼리로 반환될 수 있는 최대 결과 수입니다. 한 때에 100개까지 반품할 수 있습니다.
쿼리	필수. 일반 쿼리 중에서 선택하거나 고급을 선택하여 직접 만듭니다.

쿼리 문자열

마지막 날 업데이트된 판매 플랜 그룹을 가져오기 위한 쿼리 예시는 다음과 같습니다.

name='Subscribe & Save'

category 변수는 판매 플랜 그룹 쿼리에 사용할 수 있는 필터이며 판매 플랜 그룹의 특정 범주를 선택하는 데 사용할 수 있습니다.

데이터를 쿼리할 때는 다음 사항이 도움이 됩니다.

• 사용 가능한 판매 플랜 그룹 필터 목록 - 쿼리는 특정 구문을 따라야 합니다.
• 모든 쿼리의 쿼리 필드 이름은 QueryRoot 객체의 개발자 문서에서 찾을 수 있습니다.
• 쿼리 필드 값이 항상 문서화되지는 않습니다.일부 경우에는 API 문서를 확인하여 값을 찾을 수 있습니다. 또는 필터링할 때 관리자의 URL에서 필드 값을 찾을 수 있는 경우도 많습니다. 예를 들어 주문 쿼리 값을 찾으려면 관리자의 주문 페이지를 필터링하고 URL을 확인합니다.
• Shopify GraphiQL 앱을 사용해서 매장에서 쿼리를 실행하거나 테스트할 수 있습니다.
• 쿼리가 실패할 때 발생하는 결과에 주의하세요. 아무 것도 반환하지 않는 대신 API가 모든 결과를 반환하는 경우가 많습니다.

반환된 데이터

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

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

이 작업을 수행하는 단계에서 반환된 데이터에 액세스하려면 판매 플랜 그룹 목록인 판매 플랜 그룹 데이터 가져오기라는 변수를 사용합니다. 조건 및 작업에서 이 변수를 사용할 수 있습니다. 예를 들어 다음과 같은 내부 이메일 전송 작업으로 판매 플랜 그룹 목록을 전송할 수 있습니다.

{% for getSellingPlanGroupData_item in getSellingPlanGroupData %}
  {{getSellingPlanGroupData_item.name}}
{% endfor %}

참고 사항

한 워크플로 내에서 데이터 가져오기 작업이 여러 차례 사용되는 경우에는 변수 이름에 숫자가 추가됩니다. 예를 들어, 주문 데이터 가져오기 작업을 2번 사용하는 워크플로에서는 반환된 데이터의 첫 번째 변수는 getOrderData이고, 두 번째 변수는 getOrderData1입니다. 이 이름은 사용자 지정이 불가능합니다.

예

예를 들면 워크플로가 매주 일요일 오전 9시에 실행됩니다. 판매 플랜 그룹 데이터 가져오기 작업은 지난주에 생성된 판매 플랜 그룹의 데이터를 수집하는 데 사용됩니다. 판매 플랜 그룹과 연결된 제품이 베스트셀러인 경우 판매 플랜 그룹의 position은 증가할 수 있습니다.

API 참조

• 판매 플랜 그룹 리소스
• 판매 플랜 그룹 쿼리 필터