기프트 카드 데이터 가져오기

기프트 카드 데이터가 필요한 워크플로에서는 기프트 카드 데이터 가져오기 작업을 사용하여 스토어에서 기프트 카드 정보를 검색할 수 있습니다.

중요한 점은 스토어에 기프트 카드를 생성하는 데 사용되는 기프트 카드 제품과 고객이 구매에 사용할 수 있는 실제 기프트 카드 자체가 모두 있다는 것입니다. 기프트 카드 데이터 가져오기 작업은 기프트 카드 자체에 대한 정보를 검색합니다. 기프트 카드 제품에 대한 정보를 가져오려면 제품 데이터 가져오기 또는 제품 이형 데이터 가져오기 작업을 사용하세요.

구성

필드

기프트 카드 데이터 가져오기 작업에는 쿼리를 작성하는 데 사용되는 다음 필드가 포함되어 있습니다.

쿼리 문자열

다음은 지난 하루 동안 업데이트된 기프트 카드를 가져오는 쿼리의 예시입니다.

created_at:<='{{ scheduledAt }}' AND created_at:>'{{ scheduledAt | date_minus: "1 day" }}'

created_at 변수는 기프트 카드 쿼리에서 사용할 수 있는 필터이며 여러 번 사용하거나 다른 변수와 조합할 수 있습니다. scheduledAt Liquid 변수는 예약 시간 트리거를 사용하는 워크플로에서 사용할 수 있습니다. date_minus Liquid 태그는 날짜에서 시간을 뺄 수 있는 특수한 Flow 태그입니다.

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

• 사용 가능한 기프트 카드 필터 목록

• 쿼리는 특정 구문을 따라야 합니다.

• 쿼리 필드 값은 항상 문서화되어 있지는 않습니다. 경우에 따라 API 문서를 통해 값을 찾을 수 있습니다. 또는 필터링 시 관리자 패널의 URL에서 필드 값을 찾을 수도 있습니다. 예를 들어 일부 주문 쿼리 값을 찾으려면 관리자 패널에서 주문 페이지를 필터링한 다음 URL을 확인하십시오.

• Shopify GraphiQL 앱을 사용하여 스토어에서 쿼리를 실행하거나 테스트할 수 있습니다.

• 쿼리가 실패하는 경우에 유의하십시오. 종종 API는 아무 결과도 반환하지 않는 대신 모든 결과를 반환합니다.

반환된 데이터

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

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

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

{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.name }}
{% endfor %}

트리거

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

API 세부 정보

• 기프트 카드 리소스
• 기프트 카드 쿼리 필터