Admin API 요청 보내기

Admin API 요청 보내기 작업에서는 GraphQL Admin API의 대부분의 뮤테이션을 사용하여 스토어를 변경할 수 있습니다. 여기에는 Flow에서 아직 작업으로 사용할 수 없는 뮤테이션도 포함됩니다.

필드

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

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

트리거

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

예 1: 제품에 사용된 템플릿 업데이트

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

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

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

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

예 2: 고객의 면세 상태 업데이트

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

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

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

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

예 3: 고객의 로케일 업데이트

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

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

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

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

Liquid 팁

Flow는 입력 생성에 유용할 수 있는 json liquid 필터를 지원합니다. 다음 예는 모두 customerUpdate 뮤테이션을 사용하고, 워크플로에 고객 개체를 제공하는 트리거가 있다고 가정해 보겠습니다.

문자열 사용

다음 예는 고객에 대한 참고 사항을 업데이트합니다.

{% assign revisedNote = customer.note | append: " Hello from Flow!" %}

{
  "input": {
    "id": "{{ customer.id }}",
    "note": {{ revisedNote | json }},
  }
}

json 필터는 문자열을 이스케이프하여 올바른 JSON을 보장합니다. 워크플로가 실행된 후 JSON은 다음과 같습니다.

{
  "input": {
    "id": "gid://shopify/Customer/1234",
    "note": "Had a \"great experience\" with their latest order. Hello from Flow!",
  }
}

배열 사용

배열 예

json 필터는 liquid 배열을 JSON 배열로 변환합니다. 다음 예는 liquid 배열과 함께 제공되는 경우 JSON 배열을 출력합니다.

{% assign tags = "tag1,tag2,tag3" | split: "," %}

{
  "input": {
    "id": "{{ customer.id }}",
    "tags": {{ tags | json }}
  }
}

워크플로가 실행된 후 JSON은 다음과 같습니다.

{
  "input": {
    "id": "gid://shopify/Customer/1234",
    "tags": ["tag1","tag2","tag3"]
  }
}

for 루프 예제

다음 예는 루프를 사용하여 쉼표로 구분된 배열 요소를 출력합니다.

{% assign tags = "tag1,tag2,tag3" | split: "," %}

{
  "input": {
    "id": "{{ customer.id }}",
    "tags": [
      {% for tag in tags %}
        "{{ tag }}"{% unless forloop.last %},{% endunless %}
      {% endfor %}
    ]
  }
}

워크플로가 실행되면 JSON이 다음과 같이 표현됩니다.

{
  "input": {
    "id": "gid://shopify/Customer/1234",
    "tags": [
        "tag1",
        "tag2",
        "tag3"
    ]
  }
}

지도 예

map 필터는 개체 배열에서 특정 속성의 배열을 가져올 때 사용할 수 있습니다. 다음 예에서는 city 속성의 배열이 고객 주소 배열에서 추출됩니다.

{
  "input": {
    "id": "{{ customer.id }}",
    "tags": {{ customer.addresses | map: "city" | json }}
  }
}

워크플로가 실행된 후 JSON은 다음과 같습니다.

{
  "input": {
    "id": "gid://shopify/Customer/1234",
    "tags": ["Ottawa","Toronto"]
  }
}

제한 사항

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

  • 이 작업은 Flow에서 사용되는 Admin API 버전의 MutationsMutation inputs 목록을 표시합니다.
  • 새로운 API 버전이 출시된 상태에서 변경되거나 더 이상 사용되지 않는 뮤테이션이나 필드를 사용하는 경우 이 작업이 실패할 수 있습니다.
  • 작업은 GraphQL 쿼리를 지원하지 않으며 뮤테이션에 한정됩니다.
  • 이 작업은 더 이상 사용되지 않는 뮤테이션을 지원하지 않습니다.
  • 이 작업은 일부 구독, 마케팅 활동, 할인 뮤테이션을 포함한 특정 앱에 한정되는 일부 뮤테이션을 지원하지 않습니다.
  • 작업은 비동기 뮤테이션 또는 Job 유형을 반환하는 뮤테이션을 지원하지 않습니다.
  • 이 작업은 Node 인터페이스를 구현하지 않는 뮤테이션을 지원하지 않습니다.

템플릿

새 주문에 무료(100% 할인) 품목 추가

이 템플릿은 품목 재고가 있는 경우 새 주문에 무료 할인 품목을 추가합니다. 재고를 확인하고, 100% 할인을 적용하며, 고객에게 알리지 않고 주문을 업데이트합니다. 이 자동화는 (1) 주문에 깜짝 무료 품목을 포함하여 고객 만족도를 높이는 데 유용할 수 있습니다. (2) 주문에 무료 샘플로 추가하여 신제품 또는 잘 알려지지 않은 제품을 홍보하거나 (3) 무료 품목 포함 및 할인을 자동화하여 홍보를 간소화하는 데 유용합니다. 템플릿 보기

회사 계정 요청으로 생성된 회사의 주문 허용

회사 계정 요청으로 회사가 생성되면 주문 권한을 할당합니다. 템플릿 보기

이형 상품이 품절 또는 재입고된 경우 제품 템플릿 변경

제품의 이형 상품 재고에 따라 제품 템플릿을 업데이트합니다. 워크플로를 사용하면 재고 있음(스토어의 기본 템플릿), 품절, 하나 이상의 이형 상품이 품절된 경우에 대한 템플릿 간에 전환할 수 있습니다. 템플릿 보기

주문의 디지털 품목 주문 처리

디지털 품목 등 물리적 배송이 필요하지 않은 품목이나 SKU(재고 관리 코드) 목록과 일치하는 품목을 처리합니다. 새 주문에 대해 각 주문 처리 위치('주문 처리 대상 주문')에 대해 한 번씩 실행됩니다. 템플릿 보기

적절한 답변을 찾을 수 없습니까? 언제든지 도와드리겠습니다.