구독 계약 데이터 가져오기

구독 계약 데이터를 사용하는 워크플로에서 구독 계약 데이터 가져오기 작업을 사용하여 스토어의 구독 계약 정보를 검색할 수 있습니다.

이 페이지의 내용

구성

필드

구독 계약 데이터 가져오기 작업에는 쿼리를 빌드하는 데 사용되는 다음 필드가 포함되어 있습니다.

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

쿼리 문자열

다음은 상태가 ACTIVE인 구독 계약을 가져오는 예제 쿼리입니다.

status: ACTIVE

status 변수는 구독 계약 쿼리에서 사용할 수 있는 필터이며 여러 번 사용할 수 있습니다.

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

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

반환된 데이터

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

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

이 작업 다음 단계에서 반환된 데이터에 액세스하려면 구독 연락처 데이터 가져오기라는 이름의 변수를 사용하십시오. 이 변수는 구독 계약 목록입니다. 이 변수는 조건과 작업 모두에서 사용할 수 있습니다. 예를 들어 다음과 같이 내부 이메일 보내기 작업에서 주문 목록을 보낼 수 있습니다.

{% for single_contract in GetSubscriptionContractData %}
* {{ single_contract.name }}
{% endfor %}

트리거

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