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