스토어 마이그레이션 데이터 사전
이 페이지는 Mar 29, 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
리소스의 속성에 대한 몇 가지 유용한 정보가 나와 있습니다.
속성 | 값 | 설명 | 데이터 유형 | 필드 길이 | 필드 액세스 | 중요한 필수 필드 |
---|---|---|---|---|---|---|
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 |
|
고객이 이메일로 마케팅 자료 수신을 동의할 때 제공한 마케팅 가입 옵트인 수준(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 마케팅 상태입니다. | 문자열 | |||
상태 |
|
상점에 있는 고객 계정의 상태입니다. | 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
리소스의 속성에 대한 몇 가지 유용한 정보가 나와 있습니다. 이 리소스에 대한 중요 필수 필드가 없습니다.
속성 | 값 | 설명 | 데이터 유형 | 필드 길이 | 필드 액세스 |
---|---|---|---|---|---|
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
리소스의 속성에 대한 몇 가지 유용한 정보가 나와 있습니다.
속성 | 값 | 설명 | 데이터 유형 | 필드 길이 | 필드 액세스 | 중요한 필수 필드 |
---|---|---|---|---|---|---|
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 |
|
주문이 취소된 이유 | 문자열 | 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: 브라우저 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 |
|
주문과 관련된 결제 상태입니다. 주문이 생성된 경우에만 설정할 수 있습니다. | 문자열 | varchar(255) | read-only | |
fulfillment_status |
|
주문 처리된 품목을 기준으로 한 주문의 상태입니다. | 문자열 | 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 |
|
결제가 처리된 방식 | 문자열 | 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 |
|
세금이 주문 소계에 포함되는지 여부입니다. | boolean | tinyint(1) | ||
테스트 |
|
테스트 주문인지 여부입니다. | 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
리소스의 속성에 대한 몇 가지 유용한 정보가 나와 있습니다.
속성 | 값 | 설명 | 데이터 유형 | 필드 길이 | 필드 액세스 | 중요한 필수 필드 |
---|---|---|---|---|---|---|
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 |
|
제품이 POS(Point of Sale) 채널에 게시되는지 여부입니다. | 문자열 | |||
상태 |
|
제품의 상태입니다. | 문자열 | 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
리소스의 속성에 대한 몇 가지 유용한 정보가 나와 있습니다. 이 리소스에 대한 읽기 전용 또는 중요 필수 필드가 없습니다.
속성 | 값 | 설명 | 데이터 유형 | 필드 길이 |
---|---|---|---|---|
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
리소스의 속성에 대한 몇 가지 유용한 정보가 나와 있습니다. 이 리소스에 대한 중요 필수 필드가 없습니다.
속성 | 값 | 설명 | 데이터 유형 | 필드 길이 | 필드 액세스 |
---|---|---|---|---|---|
바코드 | Default: NULL | 상품의 바코드, UPC 또는 ISBN 번호 | varchar(255) | ||
compare_at_price | Default: NULL | 조정 또는 할인 전 품목의 원래 가격입니다. | decimal(20,2) | ||
created_at | Default: NULL | 제품 이형이 생성된 날짜 및 시간(ISO 8601 형식)입니다. | 날짜 | datetime | |
fulfillment_service |
|
제품 이형과 관련된 주문 처리 서비스입니다. | varchar(255) | ||
그램 | 제품 이형의 중량(그램 단위)입니다. | ||||
id | Default: NULL | 제품 이형용 고유 숫자 식별자입니다. 이 값은 자동으로 증가합니다. | bigint(20) | ||
image_id | Default: NULL | 제품 이미지의 고유 숫자 식별자입니다. 이미지는 이형 상품과 동일한 제품에 연결되어야 합니다. | bigint(20) | ||
inventory_item_id | 재고 API에서 재고 정보를 쿼리하는 데 사용되는 재고 품목에 대한 고유 식별자입니다. | ||||
inventory_management |
|
제품 이형의 재고 품목 수를 추적하는 주문 처리 서비스입니다. | varchar(255) | ||
inventory_policy |
|
품절 시 제품 이형에 대한 주문을 할 수 있는지 여부입니다. | 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 |
|
제품 이형의 중량에 적용되는 측정 단위입니다. weight_unit 값을 지정하지 않으면 상점의 기본 측정 단위가 적용됩니다. | varchar(2) |