Shopify Flow에서 사용되는 API 데이터 미리 보기

대부분의 워크플로는 스토어의 데이터에 액세스하여 조건과 작업에서 사용할 수 있습니다. Shopify Flow는 GraphQL Admin API를 호출하여 스토어 데이터에 액세스하며 이를 통해 API의 거의 모든 필드에 액세스할 수 있습니다.

워크플로를 빌드할 때 API 기반의 필드 이름과 설명을 자주 접하게 되지만, 해당 데이터의 값을 알아야 할 수도 있습니다. 예를 들어, 발주 주문에서 생성된 주문의 앱 이름을 알고 싶을 수 있습니다. 또한 워크플로가 예상하는 데이터 또는 예상하는 형식의 데이터를 출력하는지 확인하고 싶을 수도 있습니다.

데이터 값을 검토하기 위해 Shopify Flow에서 사용할 수 있는 몇 가지 옵션이 있습니다.

페이지 내용

Shopify 관리자에서 필드 찾기

대부분의 경우 Shopify 관리자를 확인하여 데이터를 찾을 수 있습니다. 예를 들어, product.title은 제품 페이지에 나열되어 있습니다.

샘플 데이터 가져오기

워크플로를 빌드할 때 Flow 편집기에서 직접 샘플 데이터를 가져올 수 있습니다. Flow의 데이터는 이벤트에서 가져오므로 정확한 샘플 데이터를 얻으려면 관련 이벤트 선택부터 시작해야 합니다.

Flow 편집기에서 데이터를 사용하려는 작업을 열고 변수 추가를 클릭하십시오. 또는 상태에서 기준 추가를 클릭하십시오.
샘플 데이터 구성을 클릭하십시오.
Flow는 워크플로의 트리거를 기반으로 이전 이벤트를 표시합니다. 이벤트 새로 고침을 클릭하여 최근 실행에서 이벤트를 가져오거나, 라이브 이벤트 수신 시작을 클릭한 다음 관리자 또는 관련 앱(앱 기반 트리거의 경우)에서 이벤트를 수동으로 트리거하십시오.
이벤트가 발생하면 Flow가 이벤트에 대한 세부 정보를 표시합니다. 샘플 데이터를 가져오는 데 사용할 이벤트를 선택하십시오. 이 트리거 이벤트 사용을 클릭하십시오.
이제 이벤트를 탐색하면 각 변수에 대한 샘플 데이터가 표시됩니다.

제한 사항:

공간 제약으로 인해 목록의 데이터에 대해 Flow는 목록의 첫 번째 품목 데이터만 표시합니다.
Flow는 워크플로당 한 번에 최대 5개의 이벤트를 저장합니다.
Flow는 예정된 시간, 메타 객체 항목 생성됨, 고객이 세그먼트에 합류 또는 고객이 세그먼트에서 나감과 같은 일부 트리거의 최근 실행에서 이벤트를 가져올 수 없습니다.

라이브 워크플로에서 필드 사용하기

로그 출력 작업을 사용하여 워크플로에서 필드를 안전하게 사용할 수 있습니다. 워크플로를 실행하면 로그 출력 작업에서 모든 변수와 텍스트의 출력을 실행 기록 페이지에 인쇄합니다. 내부 이메일 보내기와 같은 알림 작업을 사용할 수도 있습니다.

로그 출력 사용 단계:

수동으로 트리거할 수 있는 트리거를 선택하십시오.
로그 출력 작업을 워크플로에 추가하고 트리거에 연결하십시오.
로그 출력 구성에서 변수 추가를 클릭하여 검사하려는 변수를 출력 섹션에 추가하십시오.
완료되면 워크플로 켜기를 클릭하십시오.
수동으로 실행하거나 트리거가 실행되도록 하여 워크플로를 트리거하십시오. 예를 들어, 주문 생성됨 트리거를 사용하는 경우 테스트 주문을 생성하십시오.
워크플로가 실행된 후 활동 로그에서 변수를 확인하십시오.

리소스 JSON 페이지 참조하기

주문, 제품 또는 고객 페이지와 같은 Shopify 관리자의 대부분의 리소스 페이지에서는 페이지에 제공되는 데이터를 볼 수 있습니다. 이 데이터는 Shopify Flow에서 사용하는 이름 및 형식과 정확히 동일하지는 않지만 값은 GraphQL Admin API에 있는 것과 일치합니다. 데이터를 검토하려면 URL에 .json을 추가하십시오.

예를 들어, Shopify 관리자에서 주문 페이지로 이동하여 주문을 클릭해 주문으로 이동합니다. 브라우저의 주소 표시줄에 있는 페이지 주소에서 주소를 다음에서 변경합니다.

https://https://admin.shopify.com/store/<shopname>/orders/3804849891234

다음으로:

https://https://admin.shopify.com/store/<shopname>/orders/3804849891234.json

GraphiQL 또는 타사 API 도구 사용하기

Postman과 같은 타사 API 도구나 Shopify에서 무료로 제공하는 도구인 GraphiQL을 사용하여 API를 직접 쿼리할 수 있습니다. 이 옵션은 가장 정확한 결과를 제공하지만 GraphQL 쿼리 생성에 대한 약간의 지식이 필요합니다.

GraphiQL의 경우 Shopify는 일반 데이터가 포함된 웹 기반 GraphiQL 탐색기와 GraphiQL 앱을 모두 제공합니다. GraphiQL을 사용하면 Shopify Flow의 필드 이름과 정확히 일치하는 GraphQL 쿼리를 빌드할 수 있습니다. 앱을 사용하는 경우 값도 스토어와 정확히 일치합니다.

이 도구를 사용하면 실제 스토어 데이터로 Shopify Flow가 어떤 데이터를 사용하는지 정확히 확인할 수 있습니다. 예를 들어, 다음과 같은 쿼리를 생성합니다.

{
  orders(first:5, reverse:true) {
    nodes {
      createdAt
      app {
        name
      }
      channelInformation {
        app {
          title
        }
      }
    }
  }
}

다음 결과에서 order / app / name 변수는 주문의 앱 이름을 표시합니다. 이 경우 주문이 발주 주문 앱에서 생성되었으므로 값은 Draft Orders입니다. 채널 정보는 Point of Sale 앱에서만 사용할 수 있습니다.

{
  "data": {
    "orders": {
      "nodes": [
        {
          "createdAt": "2023-04-10T12:32:41Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-04-10T12:29:12Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T20:23:10Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T20:20:53Z",
          "app": {
            "name": "Draft Orders"
          },
          "channelInformation": null
        },
        {
          "createdAt": "2023-03-17T15:45:15Z",
          "app": {
            "name": "Point of Sale"
          },
          "channelInformation": {
            "app": {
              "title": "Point of Sale"
            }
          }
        }
      ]
    }
  }