도움말
로그인

JSON을 사용하여 Shopify 관리자에서 세부 데이터에 액세스하기

JSON은 JavaScript Object Notation의 약자로, 서버에서 웹 페이지로 데이터를 전송할 때 자주 사용되는 데이터 저장 및 전송 형식입니다. Shopify 관리자의 주문, 제품 또는 고객 페이지와 같은 대부분의 리소스 페이지에서 JSON을 사용하여 더 자세한 데이터에 액세스할 수 있습니다.

JSON을 사용하여 고급 개발 작업을 수행할 필요는 없지만 Shopify 관리자에서 특정 리소스의 JSON 파일에 액세스하면 더 자세한 정보를 수집하거나 문제를 직접 해결하고 조사하는 데 도움이 될 수 있습니다. 예를 들어, 특정 데이터 마이그레이션 작업이나 테마 코드 맞춤 설정에 필요할 수 있는 이형 상품 ID를 찾기 위해 제품의 JSON 파일을 검토할 수 있습니다. 또 다른 예로, Shopify Flow에서 자동화된 워크플로를 구축할 때 사용하려는 데이터 변수를 확인하기 위해 주문의 JSON 파일을 참조할 수 있습니다.

JSON은 주로 개발자가 사용하지만 코딩 지식이 제한적인 사용자라도 Shopify 관리자에서 몇 가지 일반적인 JSON 정보를 찾고 해석하는 방법을 배우면 이점을 얻을 수 있습니다.

이 페이지의 내용

JSON 파일 서식 다시 지정하기

원시 JSON 데이터는 중첩된 변수와 괄호가 길게 이어져 표시되므로 사람이 읽기 어렵습니다.

JSON 서식을 더 읽기 쉽게 만들려면 다음 옵션 중 하나를 고려해 보십시오.

  • 브라우저에 JSON 뷰어 확장 프로그램을 설치하십시오.
  • 대부분의 최신 웹 브라우저에서 기본적으로 제공하는 pretty-print 기능을 사용합니다.

예시 제품 정보가 표시된 JSON 제품 파일의 스크린샷입니다. 페이지 왼쪽 상단에서 “pretty-print” 확인란 설정이 활성화되고 강조 표시되어 있습니다.

Shopify 관리자에서 JSON 파일에 액세스하기

Shopify 관리자는 비즈니스의 모든 측면을 관리하기 위한 중앙 허브이며 기본적으로 가장 유용하고 관련성 높은 정보만 표시하도록 설계되었습니다. 관리자에서 작업이 수행될 때마다 수집되는 추가 정보는 여러 리소스 페이지의 .json 파일에 저장됩니다. 이러한 추가 세부 정보는 정보의 양이 너무 많아 도움이 되지 않으며 관리자 사용을 어렵게 만들 수 있으므로 기본적으로 표시되지 않습니다.

대부분의 비즈니스 작업의 경우 Shopify의 기존 도구를 사용하여 스토어 정보에 액세스하고 해석할 수 있습니다. 하지만 어떤 일이 발생한 이유나 시기를 문제 해결할 때 제품 또는 주문과 같은 특정 리소스에 대한 구체적인 정보를 검토하는 것이 때때로 도움이 될 수 있습니다.

예: 주문의 JSON 파일에 액세스

이 예시에서는 Shopify 관리자에서 주문의 JSON 파일에 액세스합니다.

단계:

  1. Shopify 관리자에서 주문으로 이동하십시오.

  2. 주문 목록에서 아무 주문이나 클릭하십시오.

  3. 브라우저 주소 표시줄에서 URL 주소 끝에 .json을 추가하십시오. 다음 예시와 비슷합니다.

https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json
  1. Enter 키를 눌러 JSON 서식으로 페이지를 다시 로드하십시오.
  2. 선택 사항: 브라우저에 JSON 뷰어 확장 프로그램이 설치되어 있지 않은 경우, 브라우저에서 Pretty-print 설정을 활성화하여 JSON 파일을 더 쉽게 읽을 수 있도록 하십시오. JSON 파일 형식 다시 지정에 대해 자세히 알아보세요.

주문과 관련된 "currency" 및 "line_items"와 같이 주문에 대한 예상 정보가 많이 표시되지만 고객이 주문할 때 사용한 브라우저 세션의 "client_details"와 같이 다른 많은 세부 정보도 포함되어 있음을 알 수 있습니다. 이러한 종류의 정보는 전체 세션 추적 및 마케팅 플랫폼 분석에 유용하지만 주문을 처리하고 이행하는 데는 필요하지 않습니다.

JSON 파일에 특정 필드 표시하기

JSON 파일에 특정 필드만 표시하도록 강제할 수 있으며, 포함하려는 특정 속성을 알고 있으면 정보를 더 쉽게 해석할 수 있습니다. 브라우저 주소 표시줄의 JSON 파일 URL 끝에 ?fields=를 추가한 다음 표시할 속성 이름을 쉼표로 구분하여 순서에 상관없이 포함하십시오.

예를 들어 주문의 ID, 고객 정보, 총 가격 및 태그를 표시하려면 다음 예시와 같이 JSON 파일 URL의 끝에 ?fields=id,customer,total_price,tags를 추가합니다.

https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json?fields=id,customer,total_price,tags

다른 JSON 리소스 사용하기

다음 JSON 리소스를 사용하여 Shopify 관리자에 특정 정보를 표시할 수 있습니다.

  • 제품 수: 제품 목록 URL 끝에 /count.json을 추가하여 총 제품 수를 표시합니다. 전체 URL은 다음과 같아야 합니다.
https://admin.shopify.com/store/{example-shop-name}/products/count.json
  • 거래: 주문 페이지 URL 끝에 /transactions.json을 추가하여 주문 거래 정보만 표시합니다. 거래 리소스에 대해 자세히 알아보세요.
  • 주문 처리: 주문 페이지 URL 끝에 /fulfillments.json을 추가하여 주문 처리 정보만 표시합니다. 주문 처리 리소스에 대해 자세히 알아보세요.
  • 중단된 체크아웃: 중단된 체크아웃 URL 끝에 .json을 추가하여 중단된 체크아웃에 대한 자세한 정보를 표시합니다. 중단된 체크아웃 리소스에 대해 자세히 알아보세요.

문제 해결을 위한 일반적인 JSON 속성

다음 표에는 여러 리소스 유형에 대한 문제 해결 지원을 위해 참조할 수 있는 JSON 속성이 나와 있습니다. 예를 들어 특정 제품이 게시된 시점을 확인하려면 제품의 JSON 파일에서 published_at 속성을 검토하면 됩니다. 이 속성은 ISO 8601 형식으로 날짜와 시간을 표시합니다.

이 표에는 Shopify 관리자에 저장된 모든 JSON 리소스나 속성이 포함되어 있지 않으므로 여기에 포함되지 않은 리소스나 속성의 정의는 Shopify 개발자 설명서를 참조하십시오.

문제 해결 시 사용할 수 있는 용도에 대한 정의를 포함하여 몇 가지 예시 관리자 리소스 및 관련 일반 속성을 나열합니다.
리소스JSON 속성정의
제품
"product": {
  "created_at"
제품이 처음 생성된 시간 및 날짜입니다.
"product": {
  "published_at"
제품 상태가 활성으로 설정된 시간 및 날짜입니다.
"product": {
  "updated_at"
제품이 업데이트된 가장 최근 시간 및 날짜입니다. 여기에는 제품 설명, 제목 또는 SEO 정보 변경은 물론 제품 구매 시 재고 변경과 같은 자동 업데이트가 포함될 수 있습니다.
이형 상품
"product": {
  "variants": [
    {
    "created_at"
이형 상품이 처음 생성된 시간 및 날짜입니다. 이 시간은 전체 제품이 생성된 날짜 및 시간과 다를 수 있습니다.
"product": {
  "variants": [
    {
    "updated_at"
이형 상품이 업데이트된 가장 최근 시간 및 날짜입니다. 이 시간은 전체 제품이 마지막으로 업데이트된 날짜 및 시간과 다를 수 있습니다.
"product": {
  "variants": [
    {
    "inventory_quantity"
현재 데이터베이스 값이며 고객이 구매할 수 있는 값입니다. 이형 상품 재고가 추적되지 않거나 과잉 판매되도록 설정된 경우에는 음수 값일 수 있습니다.
"product": {
  "variants": [
    {
    "old_inventory_quantity"
이형 상품의 마지막 updated_at 날짜 이전의 데이터베이스 값입니다.
주문
"order": {
   "line_items": [
    {
    "requires_shipping"
true 또는 false로 표시됩니다. 이는 주문이 접수될 때의 제품 또는 이형 상품의 배송 설정을 나타냅니다.
"order": {
   "line_items": [
    {
    "taxable"
true 또는 false로 표시됩니다. 이는 주문이 접수될 때 제품 또는 이형 상품에 세금을 부과하도록 설정된 방식을 나타냅니다.
"order": {
   "line_items": [
    {
    "variant_inventory_management"
어떤 주문 처리 서비스가 제품의 재고를 추적하도록 설정되었는지에 따라 shopify, amazon_marketplace_web, null 또는 타사 값으로 표시됩니다. null 값은 주문 시점에 제품이 추적되지 않았음을 의미합니다.
"order": {
   "line_items": [
    {
    "fulfillable_quantity"
주문을 완료하기 위해 시스템에서 예약된 재고량을 표시합니다. 이 값은 현재 이형 상품 재고와 동일하지 않습니다.
"order": {
   "line_items": [
    {
    "quantity"
구매한 제품 또는 이형 상품의 수입니다.
"order": {
   "line_items": [
    {
    "tax_lines"
미국에서는 주, 카운티, 시/군 값을 표시합니다. 세금 항목이 표시되지 않지만 주문에 세금이 부과된 경우 배송비에 세금이 부과되었음을 의미합니다.
고객
"customer": {
  "created_at"
고객이 처음 생성된 시간 및 날짜입니다.
"customer": {
  "updated_at"
고객 프로필이 업데이트된 가장 최근 시간 및 날짜입니다.

JSON의 메타 필드

메타 필드는 제품이나 컬렉션 같은 Shopify 리소스에 추가 맞춤 정보를 첨부하는 유연한 방법입니다. 메타 필드를 사용하여 저장하는 데이터의 예시로는 제품 사양, 사이즈 차트, 다운로드 가능한 문서, 출시일, 이미지, 부품 번호 등이 있습니다. 메타 필드 사용에 대해 자세히 알아보세요.

지원되는 리소스 페이지 URL 끝에 /metafields.json을 추가하여 해당 리소스와 연결된 메타 필드를 표시할 수 있습니다. JSON을 사용하여 메타 필드 정보를 표시하는 데 사용할 리소스 및 URL 형식의 몇 가지 예는 다음 표를 참조하십시오.

예시 JSON 메타 필드 파일 URL과 함께 일부 예시 관리자 리소스를 나열합니다.
예시 리소스 유형예시 URL
스마트 컬렉션https://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json
고객https://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json
주문https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/metafields.json
페이지https://admin.shopify.com/store/{your-store-name}/pages/{page-id}/metafields.json
제품https://admin.shopify.com/store/{your-store-name}/products/{product-id}/metafields.json
이형 상품https://admin.shopify.com/store/{your-store-name}/products/{product-id}/variants/{variant-id}/metafields.json
제품 이미지https://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image

참고: 제품 이미지 메타 필드는 API를 통해서만 추가할 수 있습니다. URL의 {id} 및 기타 플레이스 홀더를 API 쿼리의 실제 값으로 바꾸십시오.


스토어https://admin.shopify.com/store/{your-store-name}/metafields.json

메타 필드를 가질 수 있는 리소스의 전체 목록과 각 리소스 유형에 대해 저장되는 특정 속성 유형은 Shopify 개발자 설명서의 메타 필드 JSON 리소스를 참조하십시오.

JSON의 이벤트

이벤트는 블로그 게시물 생성, 주문 처리 또는 제품 추가와 같은 특정 작업이 완료될 때 일부 Shopify 리소스에 의해 생성됩니다.

지원되는 리소스 페이지 URL 끝에 /events.json을 추가하여 해당 리소스와 연결된 이벤트를 표시할 수 있습니다. JSON을 사용하여 이벤트 정보를 표시하는 데 사용할 리소스 및 URL 형식의 몇 가지 예는 다음 표를 참조하십시오.

예시 JSON 이벤트 파일 URL과 함께 일부 예시 관리자 리소스를 나열합니다.
예시 리소스 유형예시 URL
주문https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json

이 파일은 이벤트의 author를 나열하여 제품을 게시한 사람 또는 항목과 같이 특정 작업을 완료한 사용자를 알려줍니다.


제품https://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json

이 파일은 이벤트의 author를 나열하여 결제를 결제됨으로 표시한 사람 또는 항목과 같이 특정 작업을 완료한 사용자를 알려줍니다.


스토어https://admin.shopify.com/store/{your-store-name}/events.json?limit=250

이 URL 형식은 스토어에서 발생한 가장 최근 이벤트 250개를 표시합니다. 이벤트에는 제품 생성 또는 업데이트, 페이지 삭제, 이형 상품 업데이트 등이 포함됩니다.


이벤트를 생성할 수 있는 리소스의 전체 목록과 각 리소스 유형에 대해 생성되는 특정 이벤트는 Shopify 개발자 설명서의 이벤트 JSON 리소스를 참조하십시오.