Admin API 요청 보내기

이 페이지는 Jul 01, 2024에 인쇄되었습니다. 최신 버전은 https://help.shopify.com/ko/manual/shopify-flow/reference/actions/send-admin-api-request에서 확인하십시오.

Admin API 요청 보내기 작업은 Shopify GraphQL Admin API에 뮤테이션을 전송합니다. 이렇게 하면 Flow를 사용하여 API가 허용하는 거의 모든 작업을 수행 할 수 있습니다.

이 페이지의 정보

Admin API 요청 보내기 작업에는 다음 필드가 포함됩니다.

Admin API 요청 보내기 작업에서 사용되는 필드입니다.
필드	설명
뮤테이션	필수입니다. 호출하려는 Shopify GraphQL Admin 뮤테이션입니다. 뮤테이션 은 작업을 수행하거나 데이터를 업데이트하는 API입니다.
뮤테이션 입력	필수입니다. 뮤테이션 요청의 일환으로 전송해야 하는 데이터(JSON 형식)입니다. 각 뮤테이션에는 각 변경에 대해 제공된 링크에 문서화되는 다른 데이터 세트가 필요합니다. 필요한 JSON을 생성하기 위해 Liquid 또는 Run 코드 작업을 사용할 수 있습니다.

워크플로에서 뮤테이션 입력을 생성하는 데 필요한 데이터를 제공하는 한 모든 워크플로에서 Admin API 요청 보내기 작업을 사용할 수 있습니다.

이 예에서 제품에 사용된 템플릿을 업데이트하기 위해 Admin API 요청 보내기 작업을 사용하여 productUpdate 뮤테이션을 호출할 것입니다.

id 필드가 필요하며 유효한 제품 GID여야 합니다. 여기에서 이 필드를 {{product.id}} Liquid 변수와 함께 설정합니다. 워크플로에 제품 개체를 제공하는 트리거가 있다고 가정해 보겠습니다.

templateSuffix는 제품에 적용할 템플릿의 이름입니다. 예를 들어, pre-order 템플릿을 적용하려면 templateSuffix를 pre-order로 설정합니다.

{
  "input": {
    "templateSuffix": "pre-order",
    "id": "{{product.id}}"
  }
}

이 예에서 고객의 면세 상태를 업데이트하기 위해 Admin API 요청 보내기 작업을 사용하여 customerUpdate 뮤테이션을 호출할 것입니다.

id 필드가 필요하며 유효한 고객 GID여야 합니다. 여기에서 이 필드를 {{order.customer.id}} Liquid 변수와 함께 설정합니다. 워크플로에 주문 개체를 제공하는 트리거가 있다고 가정해 보겠습니다.

taxExempt 필드는 고객의 면세 여부를 나타내는 부울입니다. 이 예에서는 이를 true로 설정합니다.

{
  "input": {
    "id": "{{order.customer.id}}",
    "taxExempt": true
  }
}

이 예제에서 고객의 로케일을 업데이트하기 위해 Admin API 요청 보내기 작업을 사용하여 customerUpdate 뮤테이션을 호출할 것입니다.

id 필드가 필요하며 유효한 고객 GID여야 합니다. 여기에서 이 필드를 {{customer.id}} Liquid 변수와 함께 설정합니다. 워크플로에 고객 개체를 제공하는 트리거가 있다고 가정해 보겠습니다.

locale 필드는 고객의 로케일을 나타내는 문자열입니다. 이 예에서는 이를 en로 설정합니다.

{
  "input": {
    "id": "{{customer.id}}",
    "locale": "en"
  }
}

Admin API 요청 보내기 작업에는 다음과 같은 제한 사항이 있습니다.

이 작업은 뮤테이션으로 인해 Flow 환경에 데이터를 반환하지 않습니다.
작업은 GraphQL 쿼리를 지원하지 않으며 뮤테이션에 한정됩니다.
작업은 비동기 뮤테이션 또는 Job 유형을 반환하는 뮤테이션을 지원하지 않습니다.
해당 작업은 가입 및 할인 뮤테이션 포함하여 특정 앱에 한정되는 뮤테이션을 지원하지 않습니다.
이 작업은 현재 2024-01인 단일 Shopify API 버전에서 Mutation inputs 및 Mutations 목록을 표시합니다.
API 버전이 업그레이드되고 브레이킹 체인지가 포함되어 있을 때 해당 필드를 사용하는 경우 이 작업이 실패할 수 있습니다.