스토어 마이그레이션 데이터 사전

이 페이지는 May 09, 2024에 인쇄되었습니다. 최신 버전은 https://help.shopify.com/ko/partners/building-stores-for-merchants/data-dictionary에서 확인하십시오.

스토어 마이그레이션 데이터 사전에는 REST 관리자 API Customer, Order 및 Product 리소스에 대한 정보가 포함됩니다. 데이터 사전은 스토어를 Shopify로 마이그레이션하는 경험이 풍부한 파트너를 위한 추가 참조를 제공합니다.

참고: 데이터 사전의 정보는 Shopify API 버전 2022-01로 확인되었습니다. 최신 정보 및 예시는 REST 관리자 API 참조 문서를 참조하십시오.

이 페이지의 정보

Customer 리소스 속성

다음 표에는 REST 관리자 API Customer 리소스의 속성에 대한 몇 가지 유용한 정보가 나와 있습니다.

REST 고객 리소스와 관련된 중요 속성에 대한 데이터
속성 값 설명 데이터 유형 필드 길이 필드 액세스 중요한 필수 필드
accepts_marketing Default: 0 고객이 스토어의 마케팅 자료 수락에 동의했는지 여부입니다. 부울 tinyint(1) Y
accepts_marketing_
updated_at		 고객이 이메일로 마케팅 자료를 수신하는 데 동의하거나 거부한 날짜 및 시간(ISO 8601 형식)입니다. DateTime
주소 고객과 연결된 주소 목록입니다. [{ Address }]
통화 고객이 마지막 주문을 결제할 때 사용한 통화에 대한 3자 코드(ISO 4217 형식)입니다. 문자열 Shop's currency read-only
created_at Default: NULL 고객이 스토어에 추가된 날짜 및 시간(ISO 8601 형식)입니다. DateTime datetime read-only
default_address 고객의 기본 주소입니다. { Address }
이메일 Default: NULL 고객의 고유한 이메일 주소입니다. 문자열 varchar(255)
first_name(이름) Default: NULL 고객의 이름 문자열 varchar(255)
id Default: NULL 국제 고유 식별자입니다(이 값은 자동으로 증가함). 정수 bigint(20) Y
last_name(성) Default: NULL 고객의 성 문자열 varchar(255)
last_order_id Default: NULL 고객의 마지막 주문 ID입니다. 정수 bigint(20) read-only
last_order_name Default: NULL 고객의 마지막 주문 이름입니다. 문자열 read-only
메타 필드 Default: NULL 리소스에 속하는 키 및 네임스페이스로 메타 필드를 반환합니다. { Metafield }
marketing_opt_
in_level
  • null
  • single_opt_in
  • confirmed_opt_in
  • unknown
Default: NULL		 고객이 이메일로 마케팅 자료 수신을 동의할 때 제공한 마케팅 가입 옵트인 수준(M3AAWG 모범 사례 가이드라인에 설명됨)입니다. String, enum
multipass_identifier Default: NULL 멀티패스 로그인에 사용되는 고객의 고유 식별자입니다. 문자열 varchar(255)
참고 사항 Default: NULL 고객에 대한 참고 사항입니다. 문자열 mediumtext
orders_count Default: 0 평생 동안 스토어에서 고객이 진행한 주문의 수입니다. 정수 int(11) read-only
휴대폰 Default: NULL 이 고객의 고유(스토어 전체) 전화번호(E.164 형식)입니다. 문자열 varchar(255)
sms_marketing_
consent		 Default: NULL 고객 전화번호의 현재 SMS 마케팅 상태입니다. 문자열
상태
  • disabled
  • invited
  • 사용
  • 거절됨
Default: disabled		 상점에 있는 고객 계정의 상태입니다. String, enum varchar(255) read-only
태그 Default: NULL 고객에게 추가된 최대 250개의 태그를 쉼표로 구분한 목록입니다. 문자열 255 per tag
tax_exempt Default: 0 고객이 주문에 청구된 세금을 면세할 수 있는지 여부입니다. 부울 tinyint(1) Y
tax_exemptions 전체 값 목록은 고객 리소스를 참조하십시오. 고객에게 적용되는 면세 목록입니다. 문자열
total_spent Default: 0 고객이 평생 동안 주문에 지출한 총 금액이며 스토어 통화로 나열됩니다. 여러 통화를 사용하는 경우 이 금액은 환율이 없는 기본 통화로 표시됩니다. 번호 decimal(21,3) read-only
updated_at 고객이 마지막으로 업데이트된 날짜와 시간입니다. Shop의 표준 시간대를 기준으로 합니다. DateTime datetime read-only
verified_email Default: 1 고객이 이메일 주소를 확인했는지 여부입니다. 고객이 Shopify Admin 또는 API를 통해 생성된 경우 기본값은 true입니다. 부울 tinyint(1) read-only

CustomerAddress 리소스 속성

다음 표에는 REST 관리자 API CustomerAddress 리소스의 속성에 대한 몇 가지 유용한 정보가 나와 있습니다. 이 리소스에 대한 중요 필수 필드가 없습니다.

REST 고객 주소 리소스와 관련된 중요 속성에 대한 데이터
속성 값 설명 데이터 유형 필드 길이 필드 액세스
address1 Default: NULL 고객의 우편 주소로, 고객 계정당 100개입니다. 문자열 varchar(255)
address2 Default: NULL 고객의 우편 주소에 추가되는 필드입니다. 문자열 varchar(255)
city Default: NULL 고객의 구/군/시 또는 마을입니다. 문자열 varchar(255)
company Default: NULL 고객의 회사입니다. 문자열 varchar(255)
국가 Default: NULL 고객 거주지 국가 문자열 varchar(255)
first_name(이름) Default: NULL 고객의 이름 문자열 varchar(255)
country_code 고객의 국가에 해당하는 2자 국가 코드입니다. 문자열 read-only
country_name 고객의 정규화된 국가 이름입니다. 문자열
last_name(성) Default: NULL 고객의 성 문자열 varchar(255)
이름 고객의 이름과 성 문자열
휴대폰 Default: NULL 이 주소에 있는 고객의 전화번호입니다. 문자열 varchar(255)
province Default: NULL 고객의 지역 이름입니다. 일반적으로 시, 도 또는 현입니다. 문자열 varchar(255)
province_code 고객 지역의 2자 코드입니다. 문자열 read-only
우편 번호 Default: NULL Eircode 등으로도 알려진 고객의 우편번호입니다. 문자열 varchar(255)

Order 리소스 속성

다음 표에는 REST 관리자 API Order 리소스의 속성에 대한 몇 가지 유용한 정보가 나와 있습니다.

REST 주문 리소스의 중요 속성에 대한 데이터
속성 값 설명 데이터 유형 필드 길이 필드 액세스 중요한 필수 필드
app_id Default: NULL 주문을 생성한 앱의 ID입니다. integer bigint(20) read-only
billing_address Default: NULL 결제 방법과 연결된 우편 주소입니다. 이 주소는 결제 방법이 필요하지 않은 주문에 사용할 수 없는 선택적 필드입니다. integer bigint(20)
browser_ip 고객이 주문할 때 사용한 브라우저의 IP 주소입니다. IPv4 및 IPv6이 모두 지원됩니다. 문자열 varchar(255) read-only
buyer_accepts_marketing Default: 0 고객이 상점의 이메일 업데이트 수신에 동의했는지 여부입니다. boolean tinyint(1)
cancel_reason
  • 고객
  • 사기
  • 재고
  • 거절됨
  • other
Default: NULL		 주문이 취소된 이유 문자열 varchar(255)
cancelled_at Default: NULL 주문이 취소된 날짜 및 시간입니다. 주문이 취소되지 않은 경우 null을 반환합니다. 날짜 datetime read-only
cart_token Default: NULL 주문과 연결된 카트를 참조할 때 고유 값입니다. 문자열 varchar(255) read-only
checkout_token Default: NULL 주문과 연결된 결제를 참조할 때 고유 값입니다. 문자열 varchar(64) read-only
client_details
  • accept_language
  • browser_height
  • browser_ip
  • browser_width
  • session_hash
  • user_agent
 고객이 주문할 때 사용한 브라우저에 대한 정보:

accept_language: 브라우저에서 이해할 수 있는 언어와 로케일입니다.
browser_height: 사용 가능한 경우 브라우저 화면 높이(픽셀 단위)입니다.
browser_ip: 브라우저 IP 주소입니다.
browser_width: 사용 가능한 경우 브라우저 화면 폭(픽셀 단위)입니다.
session_hash: 세션의 해시입니다.
user_agent: 소프트웨어 및 운영 버전을 포함한 검색 클라이언트의 세부 정보입니다.		 object read-only
closed_at Default: NULL 주문이 마감된 날짜 및 시간입니다. 주문이 마감되지 않은 경우 null을 반환합니다. 날짜 datetime read-only
created_at Default: NULL Shopify에서 주문을 생성했을 때 자동 생성된 날짜 및 시간(ISO 8601 형식)입니다. 이 속성의 값은 변경할 수 없습니다. 날짜 datetime(6) read-only
통화 Default: NULL 상점 통화에 대한 3자 코드(ISO 4217 형식)입니다. 문자열 char(3)
current_subtotal_price 상점 통화로 표시된 주문의 현재 소계 가격입니다. 이 필드의 값은 주문 편집, 반품 및 환불을 반영합니다. 문자열 varchar(255) read-only
current_subtotal_price_set 상점 및 제시 통화로 표시된 주문에 대한 현재 소계 가격입니다. 이 필드와 연결된 금액 값은 주문 편집, 반품 및 환불을 반영합니다. object read-only
current_total_discounts 상점 통화로 표시된 주문에 대한 현재 총 할인액입니다. 이 필드의 값은 주문 편집, 반품 및 환불을 반영합니다. 문자열 varchar(255) read-only
current_total_discounts_set 상점 및 제시 통화로 표시된 주문에 대한 현재 총 할인액입니다. 이 필드와 연결된 금액 값은 주문 편집, 반품 및 환불을 반영합니다. object read-only
current_total_duties_set 상점 및 제시 통화로 표시된 주문에 부과하는 현재 총 관세입니다. 이 필드와 연결된 금액 값은 주문 편집, 반품 및 환불을 반영합니다. object read-only
current_total_price 상점 통화로 표시된 주문의 현재 총 가격입니다. 이 필드의 값은 주문 편집, 반품 및 환불을 반영합니다. 문자열 varchar(255) read-only
current_total_price_set 상점 및 제시 통화로 표시된 주문에 대한 현재 총 가격입니다. 이 필드와 연결된 금액 값은 주문 편집, 반품 및 환불을 반영합니다. object read-only
current_total_tax 상점 통화로 표시된 주문에 부과하는 현재 총 세금입니다. 이 필드의 값은 주문 편집, 반품 또는 환불을 반영합니다. 문자열 varchar(255) read-only
current_total_tax_set 상점 및 제시 통화로 표시된 주문에 부과하는 현재 총 세금입니다. 이 필드와 연결된 금액 값은 주문 편집, 반품 및 환불을 반영합니다. object read-only
고객 Default: NULL 고객에 대한 정보입니다. 주문에 고객이 없을 수 있으며, 앱은 고객 개체의 유무에 의존해서는 안 됩니다. Shopify POS를 통해 주문을 생성한 경우 이 값은 null일 수 있습니다. integer bigint(20)
customer_locale Default: NULL 2~3자 언어 코드로, 지역 수정자를 뒤에 입력할 수도 있습니다. 문자열 varchar(255) read-only
discount_applications 다양한 할인 애플리케이션이 정렬된 목록입니다.

discount_applications 속성에는 discount_code, 수동 및 스크립트의 3가지 유형이 포함됩니다. 3가지 유형은 모두 공통적 구조를 공유하며 일부 유형별 특성이 있습니다.		 array read-only
discount_codes 주문에 적용된 할인 목록입니다. array
이메일 고객 이메일 주소 varchar(255)
estimated_taxes 주문에 세금을 추정할지 여부입니다. 고객이 주문한 시간과 주문이 배송된 시간 사이에 많은 요인이 변경될 수 있으므로 세금 계산에 영향을 줄 수 있습니다. 이 속성은 주문에 부과하는 세금이 확정되고 변경되지 않을 때 false를 반환합니다. boolean tinyint(1)
financial_status
  • 보류 중
  • authorized
  • partially_paid
  • 유료
  • partially_refunded
  • refunded
Default: NULL		 주문과 관련된 결제 상태입니다. 주문이 생성된 경우에만 설정할 수 있습니다. 문자열 varchar(255) read-only
fulfillment_status
  • 주문 처리됨
    • 주문 미처리
  • null
  • 부분
  • restocked
Default: unfulfilled		 주문 처리된 품목을 기준으로 한 주문의 상태입니다. 문자열 varchar(255)
주문 처리 주문과 관련된 주문 처리 배열 array
id Default: NULL API 용도로 사용되는 주문의 ID입니다. 이는 상점 소유자와 고객이 사용하는 ID인 order_number 속성과 다릅니다. integer bigint(20) read-only
landing_site Default: NULL 구매자가 상점에 접속할 때 방문한 페이지의 URL입니다. 문자열 varchar(4096) read-only
line_items 주문한 품목에 대한 정보가 포함된 각 품목 개체 목록 array Y
location_id Default: NULL 주문이 처리된 실제 위치의 ID입니다. 주문에 대한 위치를 참조해야 하는 경우 FulfillmentOrder 리소스를 사용하십시오. integer bigint(20)
이름 Default: NULL 판매자 일반 설정에서 지정한 주문 접두사와 접미사를 order_number 속성과 결합하여 생성된 주문 이름입니다. 이는 API에서 사용하는 주문의 ID인 id 속성과 다릅니다. 이 필드는 API에서 임의의 문자열 값으로 설정할 수도 있습니다. 문자열 varchar(255)
참고 사항 Default: NULL 상점 소유자가 주문에 첨부할 수 있는 선택적 참고 사항입니다. 문자열
note_attributes Default: NULL 주문에 덧붙이는 추가 정보입니다. 주문 세부 정보 페이지의 추가 세부 정보 섹션에 표시됩니다. 각 배열 항목에는 이름 및 값 키가 있는 해시가 있어야 합니다. 문자열
number Default: NULL 상점의 주문 수에서 주문 위치입니다. 숫자는 순차적이며 1부터 시작합니다. integer int(11) read-only
order_number 상점의 주문 수에서 주문 위치로 1,001부터 시작합니다. 주문 번호는 순차적입니다. integer bigint(20) read-only
order_status_url 해당되는 경우 주문 상태 웹 페이지를 가리키는 URL입니다. 문자열 varchar(255) read-only
original_total_duties_set 상점 및 제시 통화로 표시된 주문에 부과하는 원래의 총 관세입니다. object read-only
payment_gateway_names Default: NULL 주문에 사용되는 전자결제 대행사 목록입니다.
 varchar(255) read-only
payment_terms Default: NULL 결제를 처리해야 하는 근거가 되는 이용 약관입니다. object bigint(20) read-only
휴대폰 Default: NULL SMS 알림을 수신하는 고객의 전화번호입니다. 문자열 varchar(255)
presentment_currency Default: NULL 고객에게 가격을 표시하는 데 사용된 제시 통화입니다. 문자열 char(3)
processed_at Default: NULL 주문이 처리된 날짜 및 시간(ISO 8601 형식)입니다. 이 값은 주문에 표시하고 분석 보고서에서 사용되는 날짜입니다. 앱이나 다른 플랫폼에서 주문을 가져오는 경우 원래 주문이 생성된 시기와 일치하도록 processed_at 속성을 과거의 날짜와 시간으로 설정할 수 있습니다. 날짜 datetime(6)
processing_method
  • 결제
  • 직접
  • 수동
  • offsite
  • Express
  • 무료
 결제가 처리된 방식 문자열 varchar(255) read-only
referring_site Default: NULL 고객이 상점으로 연결되는 링크를 클릭한 웹사이트입니다. 문자열 varchar(4096)
환불 주문에 적용된 환불 목록 array read-only
shipping_address Default: NULL 주문을 배송할 우편 주소입니다. 이 주소는 선택 사항이며 배송이 필요하지 않은 주문에는 사용할 수 없습니다. integer bigint(20)
shipping_lines 사용된 배송 방법을 세부적으로 설명하는 개체 배열입니다. array
source_name Default: NULL 주문이 시작된 위치입니다. 주문 생성 중에만 설정 가능하며 이후에는 작성할 수 없습니다. Shopify 채널 값은 보호되어 다른 API 클라이언트(웹, POS, shopify_draft_order, iPhone 및 Android)에서 할당할 수 없습니다. API를 통해 생성된 주문에는 선택한 다른 문자열을 할당할 수 있습니다. 지정하지 않은 경우 새 주문에 앱 ID의 값이 할당됩니다. 문자열 varchar(255)
subtotal_price 할인 후 배송, 관세, 세금 및 팁을 적용하기 전의 상점 통화로 표시된 주문 가격입니다. integer bigint(20)
subtotal_price_set 할인 후 배송, 관세, 세금, 팁을 적용하기 전의 상점 및 제시 통화로 표시된 주문 소계입니다. object
태그 쉼표로 구분된 값의 문자열로 형식을 지정하여 주문에 첨부한 태그입니다. 태그는 일반적으로 필터링 및 검색에 사용되는 짧은 추가 기술어입니다. 각 개별 태그의 길이는 40자로 제한됩니다. 문자열 varchar(4096)
tax_lines 각 주문에 적용되는 세금을 세부적으로 설명하는 세금 항목 개체의 배열입니다. 각 개체에는 다음과 같은 속성이 있습니다.

API를 통해 주문을 생성하는 경우 세금 항목은 주문 또는 품목에 지정할 수 있지만 둘 다 지정할 수는 없습니다. 주문에 지정된 세금 항목은 생성된 주문의 과세 품목으로 분할됩니다.		 array
taxes_included
  • 참
  • 거짓
Default: 0		 세금이 주문 소계에 포함되는지 여부입니다. boolean tinyint(1)
테스트
  • 참
  • 거짓
Default: 0		 테스트 주문인지 여부입니다. boolean tinyint(1) read-only
token Default: NULL 주문을 참조할 때 고유 값입니다. 문자열 varchar(32) read-only
total_discounts Default: 0 상점 통화로 표시된 주문 가격에 적용하는 총 할인액입니다. 문자열 decimal(21,3)
total_discounts_set 상점 및 제시 통화로 표시된 주문 가격에 적용하는 총 할인액입니다. object
total_line_items_price Default: 0 상점 통화로 표시된 모든 품목 가격의 합계입니다. 문자열 decimal(21,3)
total_line_items_price_set 상점 및 제시 통화로 표시된 모든 품목 가격의 총액입니다. object
total_outstanding Default: 0 상점 통화로 표시된 주문의 총 미결제 금액입니다. 문자열 decimal(21,3)
total_price Default: 0 상점 통화로 표시된 모든 품목 가격, 할인액, 배송비, 세금 및 팁의 합계입니다. 양수 값이어야 합니다. 문자열 decimal(21,3)
total_price_set 상점 및 제시 통화로 표시된 주문에 대한 총 가격입니다. object
total_shipping_price_set 상점 및 제시 통화로 표시된 주문의 총 배송비입니다(할인 및 반품 제외). taxes_included가 true로 설정된 경우 total_shipping_price_set에 세금이 포함됩니다. object
total_tax Default: 0 상점 통화로 표시된 주문에 적용하는 모든 세금의 합계입니다. 양수 값이어야 합니다. 문자열 decimal(21,3)
total_tax_set 상점 및 제시 통화로 표시된 주문에 적용하는 총 세금입니다. object
total_tip_received 상점 통화로 표시된 주문의 모든 팁 합계입니다. integer bigint(20) read-only
total_weight Default: 0 모든 품목 중량(그램 단위)의 합계입니다. 주문에서 품목을 제거해도 합계가 조정되지 않습니다. integer bigint(20) unsigned
updated_at 주문이 마지막으로 수정된 날짜 및 시간(ISO 8601 형식)입니다. 날짜 datetime(6) read-only
user_id Default: NULL 해당되는 경우 주문을 처리하고 Shopify POS에 로그인한 사용자의 ID입니다. integer bigint(20)

Product 리소스 속성

다음 표에는 REST 관리자 API Product 리소스의 속성에 대한 몇 가지 유용한 정보가 나와 있습니다.

REST 제품 리소스의 중요 속성에 대한 데이터
속성 값 설명 데이터 유형 필드 길이 필드 액세스 중요한 필수 필드
body_html Default: NULL 제품에 대한 설명입니다. HTML 형식을 지원합니다. 문자열 mediumtext
created_at Default: NULL 제품이 생성된 날짜 및 시간(ISO 8601 형식)입니다. 날짜 datetime read-only
handle Default: NULL 문자열 varchar(255)
id Default: NULL 제품의 고유 식별자로 사용되는 64비트 무부호 정수입니다. 각 ID는 Shopify 시스템 전체에서 고유합니다. 두 개의 제품이 서로 다른 상점에 있더라도 ID는 동일하지 않습니다. integer bigint(20) read-only Y
이미지 제품 관련 이미지를 나타내는 각 제품 이미지 개체의 목록입니다. [{ product_image }]
옵션 사용자 지정 제품 속성입니다. 예를 들어 크기, 색상 및 재료입니다. 제품마다 최대 3개의 옵션을 포함할 수 있으며, 각 옵션 값은 255자까지 사용할 수 있습니다. 제품 이형은 옵션 값을 조합하여 구성됩니다. 값 없이는 옵션을 만들 수 없습니다. 새 옵션을 생성하려면 관련 옵션 값이 있는 이형 상품도 생성해야 합니다. array
product_type Default: NULL 제품 필터링 및 검색에 사용되는 제품의 분류입니다. 문자열 varchar(255)
published_at Default: NULL 제품이 게시된 날짜 및 시간(ISO 8601 형식)입니다. 온라인 스토어 채널에서 제품 게시를 취소하려면 null로 설정할 수 있습니다. 날짜 datetime
published_scope
  • 웹
  • global
 제품이 POS(Point of Sale) 채널에 게시되는지 여부입니다. 문자열
상태
  • 활성
  • 보관됨
  • 발주
Default: active		 제품의 상태입니다. 문자열 varchar(32)
태그 필터링 및 검색에 사용되는 쉼표로 구분된 태그의 문자열입니다. 제품에는 최대 250개의 태그를 포함할 수 있습니다. 각 태그는 255자까지 사용할 수 있습니다. 문자열
template_suffix Default: NULL 제품 페이지에 사용되는 Liquid 템플릿 접미사입니다. 이 속성이 지정된 경우 제품 페이지는 "product.suffix.liquid"라는 템플릿을 사용합니다. 여기서 "접미사"는 이 속성의 값입니다. 이 속성이 "" 또는 null이면 제품 페이지는 기본 템플릿 "product.liquid"를 사용합니다. 문자열 varchar(255)
제목 Default: NULL 제품의 이름입니다. 문자열 varchar(255)
updated_at Default: NULL 제품이 마지막으로 수정된 날짜 및 시간(ISO 8601 형식)입니다. 제품의 updated_at 값은 다양한 이유로 변경될 수 있습니다. 예를 들어 재고 추적이 설정된 제품을 주문한 경우 재고 조정이 업데이트되어 계산됩니다. 날짜 datetime read-only
이형 상품 각각 다른 버전의 제품을 나타내는 제품 이형의 배열입니다. 위치 속성은 읽기 전용입니다. 이형 상품의 위치는 나열된 순서로 표시됩니다. array
공급업체 Default: NULL 제품의 공급업체 이름입니다. 문자열 varchar(255)

ProductImage 리소스 속성

다음 표에는 REST 관리자 API ProductImage 리소스의 속성에 대한 몇 가지 유용한 정보가 나와 있습니다. 이 리소스에 대한 읽기 전용 또는 중요 필수 필드가 없습니다.

REST ProductImage 리소스와 관련된 중요 속성에 대한 데이터
속성 값 설명 데이터 유형 필드 길이
created_at Default: NULL 제품 이미지를 생성한 날짜와 시간입니다. API는 이 값을 ISO 8601 형식으로 반환합니다. 날짜 datetime
height Default: NULL 업로드할 때 결정되는 이미지의 높이 치수입니다. smallint(4) unsigned
id Default: NULL 제품 이미지의 고유 숫자 식별자입니다. (auto_increment) integer bigint(20)
position Default: 0 목록에 표시되는 제품 이미지의 순서입니다. 첫 번째 제품 이미지는 위치 1에 있으며 제품의 "기본" 이미지입니다. smallint(5) unsigned
product_id Default: NULL 이미지와 연결된 제품의 ID입니다. bigint(20)
src 제품 이미지의 위치를 지정합니다. 이 매개 변수는 수정된 이미지 사본을 검색하는 데 사용할 수 있는 URL 필터를 지원합니다. 예를 들어 파일 이름에 _small을 추가하여 100x100픽셀 크기의 이미지 사본(예: ipod-nano_small.png)을 검색하거나 _2048x2048을 추가하여 2048x2048픽셀 해상도로 제한된 이미지 사본(예: ipod-nano_2048x2048.png)을 검색합니다.
updated_at Default: NULL 제품 이미지를 마지막으로 수정한 날짜와 시간입니다. API는 이 값을 ISO 8601 형식으로 반환합니다. 날짜 datetime
variant_ids 이미지와 연결된 이형 상품 ID의 배열입니다.
width Default: NULL 업로드할 때 결정되는 이미지의 폭 치수입니다. smallint(4) unsigned

ProductVariant 리소스 속성

다음 표에는 REST 관리자 API ProductVariant 리소스의 속성에 대한 몇 가지 유용한 정보가 나와 있습니다. 이 리소스에 대한 중요 필수 필드가 없습니다.

REST ProductVariant 리소스와 관련된 중요 속성에 대한 데이터
속성 값 설명 데이터 유형 필드 길이 필드 액세스
바코드 Default: NULL 상품의 바코드, UPC 또는 ISBN 번호 varchar(255)
compare_at_price Default: NULL 조정 또는 할인 전 품목의 원래 가격입니다. decimal(20,2)
created_at Default: NULL 제품 이형이 생성된 날짜 및 시간(ISO 8601 형식)입니다. 날짜 datetime
fulfillment_service
  • 수동
  • { handle of fulfillment service }
Default: manual 		제품 이형과 관련된 주문 처리 서비스입니다. varchar(255)
그램 제품 이형의 중량(그램 단위)입니다.
id Default: NULL 제품 이형용 고유 숫자 식별자입니다. 이 값은 자동으로 증가합니다. bigint(20)
image_id Default: NULL 제품 이미지의 고유 숫자 식별자입니다. 이미지는 이형 상품과 동일한 제품에 연결되어야 합니다. bigint(20)
inventory_item_id 재고 API에서 재고 정보를 쿼리하는 데 사용되는 재고 품목에 대한 고유 식별자입니다.
inventory_management
  • Shopify
  • null
  • { handle of fulfillment service }
    • Default: NULL     		제품 이형의 재고 품목 수를 추적하는 주문 처리 서비스입니다. varchar(255)
    inventory_policy
    • deny
    • continue
    Default: deny    		 품절 시 제품 이형에 대한 주문을 할 수 있는지 여부입니다. varchar(40)
    inventory_quantity Default: 1 모든 위치에 있는 재고의 집계입니다. 특정 위치에서 재고를 조정하려면 InventoryLevel 리소스를 사용하십시오. int(11) read-only
    option 상점 소유자가 제품 이형을 정의하는 데 사용하는 사용자 지정 속성입니다. 제품 이형에는 세 가지 옵션(옵션1, 옵션2, 옵션3)을 정의할 수 있습니다. 기본값은 기본 제목입니다. 제목 필드는 옵션1, 옵션2, 옵션3 필드를 연결한 것입니다. 옵션 필드를 업데이트하면 제목 필드가 업데이트됩니다.
    position Default: 0 제품 이형 목록에 나타나는 제품 이형의 순서입니다. 목록의 첫 번째 위치는 1입니다. 이형 상품의 위치는 나열된 순서로 표시됩니다. smallint(5) unsigned read-only
    presentment_prices 상점에서 활성화된 각 제시 통화로 표시되는 이형 상품 제시 가격 및 비교가 목록입니다. 가격 개체마다 다음과 같은 속성이 있습니다.
    -currency_code: 상점에서 활성화된 제시 통화 중 하나에 대한 3자 코드(ISO 4217 형식)입니다.
    -amount: 제시 통화로 표시된 이형 상품의 가격 또는 비교가입니다.
    'X-Shopify-Api-Features'인 'include-presentment-prices'의 헤더가 필요합니다.    		 read-only
    가격 Default: 0 제품 이형 상품의 가격입니다. decimal(20,2)
    product_id Default: NULL 제품용 고유 숫자 식별자입니다. bigint(20)
    requires_shipping Default: 1 이 속성 사용은 중지되었습니다. 대신 InventoryItem 리소스의 'requires_shipping' 속성을 사용하십시오. boolean tinyint(1)
    sku(재고 관리 코드) 상점의 제품 이형에 대한 고유 식별자입니다. FulfillmentService에 연결하는 데 필요합니다. varchar(255)
    tax_code 이 매개 변수는 Avalara AvaTax 앱이 설치된 스토어에만 적용됩니다. 제품 이형에 대한 Avalara 세금 코드를 지정합니다.
    과세 Default: 1 제품 이형 판매 시 세금이 부과되는지 여부 boolean tinyint(1)
    제목 제품 이형의 제목입니다. 제목 필드는 옵션1, 옵션2, 옵션3 필드를 연결한 것입니다. 옵션 필드를 사용하여 부차적으로 제목만 업데이트할 수 있습니다. varchar(255) read-only
    updated_at Default: NULL 제품 이형이 마지막으로 수정된 날짜와 시간입니다. ISO 8601 형식으로 반환됩니다. 날짜 datetime
    weight weight_unit으로 지정된 단위 시스템의 제품 이형 중량입니다.
    weight_unit
    • g
    • kg
    • oz
    • lb
    Default: NULL    		 제품 이형의 중량에 적용되는 측정 단위입니다. weight_unit 값을 지정하지 않으면 상점의 기본 측정 단위가 적용됩니다. varchar(2)