도움말
로그인

Shopify Flow 및 GraphQL Admin API

Flow는 Shopify GraphQL Admin API를 사용하여 Shopify 관리자를 확장하고 개선하는 자동화 및 통합을 구축합니다. Flow는 API의 2026-01 버전을 사용하여 워크플로에서 조건 및 변수를 평가하고 Shopify 스토어에서 작업을 수행합니다. Flow가 API를 호출하여 스토어 데이터에 액세스하므로 Flow에서 API에 사용 가능한 거의 모든 필드에 액세스할 수 있습니다.

Shopify는 3개월마다 새로운 API 버전을 출시하므로 필드가 변경되거나 지원이 중단될 때 일부 워크플로를 업데이트해야 할 수 있습니다.

이 페이지의 내용

워크플로에서 GraphQL Admin API 사용

Flow의 대부분의 작업은 GraphQL Admin API를 사용하여 Shopify 스토어를 변경합니다. 예를 들어 주문 태그 추가 작업은 tagsAdd 뮤테이션을 사용합니다. Admin API 요청 보내기 작업은 Flow에서 아직 작업으로 사용할 수 없는 뮤테이션을 포함하여 대부분의 뮤테이션을 사용할 수 있습니다.

워크플로를 생성할 때 GraphQL Admin API 구문을 기반으로 하는 필드 이름과 설명을 자주 접하게 됩니다. 예를 들어 워크플로에서 이형 상품의 총 판매 가능 수량을 확인하려면 variants_item.inventoryQuantity 변수를 사용합니다. 또 다른 예로 고객이 이메일 뉴스레터를 구독한 위치를 확인하려면 emailSubscriptionMethod 변수를 사용합니다.

Flow 앱으로 워크플로를 생성하기 위해 API에 능숙할 필요는 없지만, 변수 이름과 해당 정의에 대해 약간 이해하면 원하는 특정 워크플로 논리를 구축하는 데 도움이 될 수 있습니다. 예를 들어 고객의 displayName과 firstName의 차이점을 알면 사용 목적에 따라 워크플로가 올바른 데이터에 액세스하는 데 도움이 될 수 있습니다. 워크플로를 구축할 때 각 변수에 정의가 포함되며, 정보 아이콘을 클릭하여 변수 또는 정의에 대해 자세히 알아볼 수 있습니다.

스토어 데이터 및 GraphQL Admin API

워크플로는 조건과 작업에서 스토어의 데이터를 사용합니다. Flow는 GraphQL Admin API를 사용하여 스토어 데이터에 액세스하므로 API의 거의 모든 필드에 액세스할 수 있습니다. 작업에 트리거나 데이터 가져오기 작업에서 제공하는 필수 데이터가 없는 경우 워크플로는 실행되지 않으며 오류 메시지가 표시됩니다.

예를 들어 워크플로가 고객 생성됨 트리거로 시작되고 고객 데이터를 워크플로로 가져옵니다. 해당 트리거 다음에 고객 데이터가 아닌 주문 데이터가 필요한 주문 태그 추가 작업이 이어지면 워크플로에 데이터 누락 오류가 발생합니다.

API에서 출력되어 Flow에서 사용되는 항목을 이해하고 워크플로가 예상한 데이터를 출력하는지 확인하려면 데이터를 미리 보거나 API 문서를 검토해야 할 수 있습니다.

필드 인수 및 GraphQL Admin API

일부 GraphQL Admin API 필드에는 반환되는 데이터를 좁히는 추가 매개변수인 인수가 필요합니다. 예를 들어 product.inCollection 필드에서 확인할 컬렉션을 파악하려면 컬렉션 id 인수가 필요합니다. 인수가 없으면 이 필드는 결과를 반환할 수 없습니다.

Flow에서는 필요한 인수 값을 제공하여 이러한 필드에서 변수를 생성할 수 있으며, 이 변수는 워크플로에서 사용할 수 있습니다. 또한 변수에 사용자 지정 이름을 할당하여 다음 단계에서 더 쉽게 참조할 수도 있습니다. 예를 들어 product.inCollection(id: "gid://shopify/Collection/123456")의 이름을 product.inSummerBestsellers로 지정할 수 있습니다.

인수가 포함된 필드에서 변수 생성에 대해 자세히 알아보십시오.

메타 필드에서 변수를 생성하려면 Flow에 추가 정보가 필요합니다. 각 메타 필드의 네임스페이스와 키를 직접 정의해야 하므로 인수는 항상 스토어에 고유하기 때문입니다. Flow의 메타 필드에 대해 자세히 알아보십시오.

API 버전 관리

Shopify는 3개월마다 새로운 API 버전을 출시하며 Flow는 가능한 한 빨리 새 버전을 채택하지만 최신 버전보다 뒤처질 수 있습니다. 가능한 경우 버전 간의 변경 사항은 자동으로 해결되지만, 다음과 같은 상황을 포함하여 일부 변경 사항은 간단하지 않을 수 있습니다.

  • 필드는 제거되었지만 대체 필드가 제공되지 않아 조건 또는 Liquid의 평가 방식에 영향을 미칠 수 있는 경우
  • 필드가 null을 허용하게 되어 조건 또는 Liquid의 평가 방식에 영향을 미칠 수 있는 경우
  • enum 값이 변경되거나 새로운 union 또는 interface 유형이 추가되어 Liquid 또는 코드에 영향을 미칠 수 있는 경우
  • 뮤테이션 인수가 변경되어 Admin API 요청 보내기 작업의 구성에 영향을 미칠 수 있는 경우

일부 워크플로는 수동으로 업데이트해야 할 수 있습니다. 이 경우 워크플로에 업데이트 필요 또는 지원되지 않는 API 오류가 표시되고 관련 API 문서로 안내하여 워크플로 편집기에서 필요한 변경 작업을 수행하도록 할 수 있습니다. 이러한 업데이트가 완료되고 저장되면 워크플로는 Flow에서 사용할 수 있는 최신 API 버전을 사용하도록 자동으로 업데이트됩니다.

API 버전 호환성 오류가 있는 워크플로를 긴급하게 변경해야 하는 경우 일시적으로 문제를 무시하도록 선택할 수 있습니다. 이러한 문제가 해결되지 않으면 Shopify에서 이전 API 버전을 더 이상 지원하지 않을 때 워크플로 실행이 중지되거나 오류가 발생할 수 있습니다.