구독 청구 시도 데이터 가져오기

구독 청구 시도 데이터가 필요한 워크플로에서는 구독 청구 시도 데이터 가져오기 작업을 사용하여 스토어에서 주문 정보를 검색할 수 있습니다.

구성

필드

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

쿼리 문자열

다음은 지난 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시에 실행되도록 예약되어 있습니다. 구독 청구 시도 데이터 가져오기 작업은 지난주에 생성된 구독 청구 시도에 대한 데이터를 수집하는 데 사용됩니다. 오류 메시지가 있는 경우 청구 시도에 대한 이메일을 보냅니다.

API 참조

• 구독 청구 시도 리소스
• 구독 청구 시도 쿼리 필터