Shopify Flow 및 GraphQL Admin API

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

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

워크플로를 생성하는 동안 API에 기반한 필드 이름과 설명을 자주 접하게 됩니다. API에서 출력되는 내용과 Flow에서 사용되는 내용을 이해하고 워크플로에서 예상한 데이터가 출력되는지 확인하려면 데이터를 미리 보거나 API 문서를 검토해야 할 수도 있습니다.

API 버저닝

Shopify는 3개월마다 새로운 API 버전을 출시하며, Flow는 가능한 한 빠르게 새로운 버전을 채택하지만, 최신 버전보다 뒤처질 수 있습니다. 가능한 경우, 버전 간의 변경 사항은 자동으로 해결되지만, 일부 변경 사항은 간단하지 않을 수 있습니다. 예를 들어: * 필드가 제거되었지만 대체가 제공되지 않은 경우, 조건이나 Liquid가 평가되는 방식에 영향을 미칠 수 있습니다. * 필드가 nullable(널 허용)로 변경되면, 조건이나 Liquid가 평가되는 방식에 영향을 미칠 수 있습니다. * enum 값이 변경되거나 새로운 유니온 또는 인터페이스 유형이 추가되면, Liquid나 코드에 영향을 미칠 수 있습니다. * mutation 인수가 변경되면, Send Admin API 요청 작업의 구성에 영향을 미칠 수 있습니다.

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

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