구독 계약 데이터 가져오기
구독 계약 데이터를 사용하는 워크플로에서 구독 계약 데이터 가져오기 작업을 사용하면 스토어에서 구독 계약 정보를 불러올 수 있습니다.
구성
필드
구독 계약 데이터 가져오기 작업에는 쿼리 작성에 사용되는 다음 필드가 포함됩니다.
| 필드 | 설명 |
|---|---|
| 데이터 정렬 기준 | 필수 항목입니다. 검색 쿼리에서 반환된 데이터를 정렬하는 기준이 되는 매개변수입니다. |
| 최대 결과 수 | 필수. 선택한 검색 쿼리로 반환될 수 있는 최대 결과 수입니다. 한 때에 100개까지 반품할 수 있습니다. |
| 쿼리 | 필수. 일반 쿼리 중에서 선택하거나 고급을 선택하여 직접 만듭니다. |
쿼리 문자열
ACTIVE 상태의 가입 계약을 가져오기 위한 쿼리 예시는 다음과 같습니다.
status: ACTIVEstatus 변수는 가입 계약 쿼리에 사용할 수 있는 필터이며 여러 번 사용하거나 사용할 수 있습니다.
데이터를 쿼리할 때는 다음 사항이 도움이 됩니다.
- 사용 가능한 필터 목록 - 쿼리는 특정 구문을 따라야 합니다.
- 모든 쿼리의 쿼리 필드 이름은 QueryRoot 객체의 개발자 문서에서 찾을 수 있습니다.
- 쿼리 필드 값이 항상 문서화되지는 않습니다.일부 경우에는 API 문서를 확인하여 값을 찾을 수 있습니다. 또는 필터링할 때 관리자의 URL에서 필드 값을 찾을 수 있는 경우도 많습니다. 예를 들어 주문 쿼리 값을 찾으려면 관리자의 주문 페이지를 필터링하고 URL을 확인합니다.
- Shopify GraphiQL 앱을 사용해서 매장에서 쿼리를 실행하거나 테스트할 수 있습니다.
- 쿼리가 실패할 때 발생하는 결과에 주의하세요. 아무 것도 반환하지 않는 대신 API가 모든 결과를 반환하는 경우가 많습니다.
반환된 데이터
모든 데이터 가져오기 작업은 0~100개 사이의 리소스 목록을 반환합니다. 사용 사례에 따라 여러 방법으로 이 데이터를 사용할 수 있습니다.
- 각 항목에 대해 태그를 추가하는 것과 같이 각 목록 항목을 개별적으로 처리해야 하는 경우 For each 작업을 사용할 수 있습니다.
- 반환된 결과 수 계산과 같이 데이터를 집계해야 하는 경우 Count 또는 Sum 작업을 사용할 수 있습니다.
- 모든 품목이 포함된 이메일 전송과 같이 목록 출력이 필요한 경우 후속 작업에서 직접 반환된 데이터를 사용할 수 있습니다.
이 작업을 수행하는 단계에서 반환된 데이터에 액세스하려면 구독 계약 목록인 구독 계약 데이터 가져오기라는 변수를 사용합니다. 조건 및 작업에서 이 변수를 사용할 수 있습니다. 예를 들어 다음과 같은 내부 이메일 전송 작업으로 주문 목록을 전송할 수 있습니다.
{% for single_contract in GetSubscriptionContractData %}
- {{ single_contract.name }}
{% endfor %}트리거
예약된 시간 트리거를 포함한 모든 워크플로에서 이 작업을 사용할 수 있습니다. 예약된 시간 트리거를 사용하면 이벤트의 결과가 아닌 지정한 시간에 따라 워크플로가 시작됩니다. 그러면 스토어나 앱에서 워크플로를 시작하는 이벤트가 없기 때문에 자동으로 포함되는 데이터도 없습니다.