- JSON 표현
- 할부
- SubscriptionCost
- SubscriptionPeriod
- LoyaltyPoints
- LoyaltyProgram
- ProductDimension
- ProductWeight
- 배송
- FreeShippingThreshold
- ShippingWeight
- ShippingDimension
- 세금
- UnitPricingMeasure
- UnitPricingBaseMeasure
- ProductDetail
- CloudExportAdditionalProperties
- 인증
- ProductStructuredTitle
- ProductStructuredDescription
속성
JSON 표현 |
---|
{ "additionalImageLinks": [ string ], "expirationDate": string, "disclosureDate": string, "availabilityDate": string, "gtin": [ string ], "price": { object ( |
필드 | |
---|---|
additional |
상품 이미지의 추가 URL입니다. |
expiration |
삽입 시 지정한 대로 상품이 만료되는 날짜입니다(ISO 8601 형식). 실제 만료일은 |
disclosure |
Google의 YouTube 플랫폼 검색 결과에 제품이 표시되는 날짜 및 시간입니다(ISO 8601 형식). 자세한 내용은 [공개일]( https://support.google.com/merchants/answer/13034208)을 참고하세요. |
availability |
선주문 제품을 배송할 수 있는 날짜입니다. ISO 8601 형식으로 나타냅니다. |
gtin[] |
상품의 국제거래단품식별코드 (GTIN)입니다. GTIN은 최대 10개까지 제공할 수 있습니다. |
price |
상품 가격. |
installment |
상품에 대한 할부 횟수 및 금액입니다. |
subscription |
연결된 정기 결제 계약이 있는 상품의 기간 (월 또는 연) 수 및 기간당 결제 금액입니다. |
loyalty |
사용자가 상품을 구매한 후 받는 적립 포인트입니다. 일본만 해당 |
loyalty |
이 상품의 사용자에게 포인트 제도 혜택 (예: 더 나은 가격, 포인트 등)을 표시하는 데 사용되는 포인트 제도 정보 목록입니다. |
product |
상품의 카테고리입니다 (제품 데이터 사양과 같은 형식). |
sale |
상품의 광고된 할인가입니다. |
sale |
상품 할인이 적용되는 기간입니다 (제품 데이터 사양 참고). |
product |
제공된 단위로 표시된 제품의 높이입니다. 값은 0 (0 제외)~3,000 (3,000 포함) 사이여야 합니다. |
product |
제공된 단위로 표시된 제품의 길이입니다. 값은 0 (0 제외)~3,000 (3,000 포함) 사이여야 합니다. |
product |
제공된 단위로 표시된 제품의 너비입니다. 값은 0 (0 제외)~3,000 (3,000 포함) 사이여야 합니다. |
product |
제공된 단위로 표시된 제품의 중량입니다. 값은 0 (0 제외)~2000 (2000 포함) 사이여야 합니다. |
shipping[] |
배송 규칙 |
free |
제품에 무료 배송이 적용되기 위해 충족해야 하는 조건입니다. |
shipping |
배송할 상품의 중량입니다. |
shipping |
배송할 상품의 길이입니다. |
shipping |
배송할 상품의 너비입니다. |
shipping |
배송할 상품의 높이입니다. |
size |
상품의 컷입니다. 의류 상품의 결합된 사이즈 유형을 나타내는 데 사용할 수 있습니다. 사이즈 유형은 최대 2개까지 제공할 수 있습니다([https://support.google.com/merchants/answer/6324497](사이즈 유형) 참고). |
taxes[] |
세금 정보 |
unit |
상품의 측정값 및 크기입니다. |
unit |
단가의 분모에 대한 환경설정입니다. |
ads |
adsGrouping과 유사하지만 CPC에서만 작동합니다. |
cost |
매출원가입니다. 총이익 보고에 사용됩니다. |
product |
기술 사양 또는 추가 제품 세부정보 |
product |
제품의 가장 관련성 높은 특징을 설명하는 글머리 기호 목록입니다. |
display |
광고주가 지정한 추천 |
promotion |
프로모션의 고유 ID입니다. |
included |
이 타겟에 포함할 대상 유형의 목록입니다 (판매자 센터의 선택된 체크박스에 해당). |
excluded |
이 타겟에서 제외할 대상 유형의 목록입니다 (판매자 센터의 선택 해제된 체크박스에 해당). |
shopping |
쇼핑 광고 도착 페이지에서 제품을 제외할 국가 코드 (ISO 3166-1 alpha-2) 목록입니다. 이 목록에 있는 국가는 데이터 소스 설정에서 구성된 국가에서 삭제됩니다. |
lifestyle |
상품의 라이프스타일 이미지 추가 URL로, 실제 환경에서 상품을 보여주는 이미지를 명시적으로 식별하는 데 사용됩니다. 자세한 내용은 고객센터 도움말을 참고하세요. |
cloud |
Cloud Retail 프로그램으로 내보낼 추가 필드입니다. |
certifications[] |
제품 인증(예: EU EPREL 데이터베이스에 기록된 제품의 에너지 효율 라벨) 자세한 내용은 고객센터 도움말을 참고하세요. |
auto |
'자동 할인' (https://support.google.com/merchants/answer/10295759) 및 '동적 프로모션' (https://support.google.com/merchants/answer/13949249) 프로젝트의 보호 조치로, 판매자의 제품 할인이 이 값 아래로 떨어지지 않도록 하여 제품의 가치와 수익성을 보존합니다. |
identifier |
상품에 카테고리에 적합한 제품 고유 식별자(예: GTIN, MPN, 브랜드)가 없는 경우 이 값을 false로 설정합니다. 제공되지 않으면 기본값은 true입니다. |
is |
상품이 판매자 정의 번들인지 여부입니다. 번들은 판매자가 단일 가격으로 판매하는 여러 제품의 맞춤 그룹입니다. |
title |
상품의 제목입니다. |
description |
상품 설명 |
link |
온라인 상점의 상품 페이지로 바로 연결되는 URL |
mobile |
상품 방문 페이지의 모바일에 최적화된 버전의 URL입니다. |
canonical |
상품 방문 페이지의 표준 버전 URL입니다. |
image |
상품 이미지의 URL입니다. |
adult |
상품이 성인 대상인 경우 true로 설정합니다. |
age |
상품의 대상 연령대입니다. |
availability |
상품의 재고 상태입니다. |
brand |
상품의 브랜드. |
color |
상품의 색상입니다. |
condition |
상품의 상태입니다. |
gender |
상품의 타겟 성별입니다. |
google |
Google의 상품 카테고리입니다 (Google 상품 분류 참고). 제품을 쿼리할 때 이 필드에는 사용자가 제공한 값이 포함됩니다. 현재 API를 통해 자동으로 할당된 Google 제품 카테고리를 가져오는 방법은 없습니다. |
item |
동일한 제품의 모든 옵션에 공유되는 식별자입니다. |
material |
상품을 만든 소재입니다. |
mpn |
상품의 제조업체 부품 번호 (MPN)입니다. |
pattern |
상품의 패턴 (예: 물방울 무늬) |
sell |
Google에서 판매할 수 있는 제품의 수량입니다. 온라인 제품에만 지원됩니다. |
max |
최대 제품 준비 기간 (영업일 기준) |
min |
최소 제품 준비 시간 (영업일 기준) |
shipping |
계정 수준 배송 규칙에서 제품을 그룹화하는 데 사용되는 제품의 배송물 라벨입니다. |
transit |
계정 수준 운송 시간 표에서 제품을 그룹화하는 데 사용되는 제품의 운송 시간 라벨입니다. |
size |
상품 크기입니다. 값은 하나만 허용됩니다. 사이즈가 다른 옵션의 경우 동일한 |
size |
크기가 지정된 시스템입니다. 의류 상품에 권장됩니다. |
tax |
계정 수준 세금 설정에서 세부적인 세금 연관성을 구성하는 데 사용되는 제품의 세금 카테고리입니다. |
energy |
EU 지침 2010/30/EU에 정의된 에너지 효율 등급입니다. |
min |
EU 지침 2010/30/EU에 정의된 에너지 효율 등급입니다. |
max |
EU 지침 2010/30/EU에 정의된 에너지 효율 등급입니다. |
multipack |
판매자가 정의한 패키지 상품에 포함된 동일 제품의 수입니다. |
ads |
임의로 항목을 그룹화하는 데 사용합니다. CPA%에만 적용되며 그 외의 경우에는 권장하지 않습니다. |
ads |
광고주가 제품이 제품 광고의 맥락에서 표시될 때 상품 URL을 재정의할 수 있습니다. |
display |
동적 리마케팅 캠페인의 상품 식별자입니다. |
display |
동적 리마케팅 캠페인의 상품 제목입니다. |
display |
동적 리마케팅 캠페인을 위해 상품의 방문 페이지로 바로 연결되는 URL입니다. |
display |
동적 리마케팅 캠페인의 제품 마진입니다. |
pickup |
상품의 수령 옵션입니다. |
pickup |
상품 매장 수령 타임라인 |
link |
판매자가 호스팅하는 매장 홈페이지의 링크 템플릿입니다. |
mobile |
휴대기기에 최적화된 판매자가 호스팅하는 매장 홈페이지의 링크 템플릿입니다. |
custom |
쇼핑 캠페인에서 상품을 맞춤 그룹화하기 위한 맞춤 라벨 0입니다. |
custom |
쇼핑 캠페인에서 상품을 맞춤 그룹화하기 위한 맞춤 라벨 1입니다. |
custom |
쇼핑 캠페인에서 상품을 맞춤 그룹화하기 위한 맞춤 라벨 2입니다. |
custom |
쇼핑 캠페인에서 상품을 맞춤 그룹화하기 위한 맞춤 라벨 3입니다. |
custom |
쇼핑 캠페인에서 상품을 맞춤 그룹화하기 위한 맞춤 라벨 4입니다. |
external |
다중 판매자 계정에 필수입니다. 다중 판매자 계정에 다양한 판매자의 제품을 업로드하는 마켓인 경우 이 속성을 사용하세요. |
pause |
이 항목의 게시가 일시적으로 일시중지됩니다. |
virtual |
상품의 3D 이미지 URL입니다. 자세한 내용은 고객센터 도움말을 참고하세요. |
structured |
알고리즘 (AI) 생성 제품명의 경우 구조화된 제품명 |
structured |
구조화된 설명: 알고리즘 (AI) 생성 설명 |
할부
할부를 나타내는 메시지입니다.
JSON 표현 |
---|
{ "months": string, "amount": { object ( |
필드 | |
---|---|
months |
구매자가 결제해야 하는 할부 횟수입니다. |
amount |
구매자가 매월 결제해야 하는 금액입니다. |
downpayment |
구매자가 선불로 지불해야 하는 계약금 금액입니다. |
credit |
할부 유형입니다. 지원되는 값은 다음과 같습니다. * " |
SubscriptionCost
제품의 SubscriptionCost입니다.
JSON 표현 |
---|
{ "period": enum ( |
필드 | |
---|---|
period |
구독 기간 유형입니다. 지원되는 값은 다음과 같습니다. * " |
period |
구매자가 결제해야 하는 구독 기간의 수입니다. |
amount |
구매자가 구독 기간당 지불해야 하는 금액입니다. |
SubscriptionPeriod
제품의 정기 결제 기간입니다.
열거형 | |
---|---|
SUBSCRIPTION_PERIOD_UNSPECIFIED |
구독 기간이 지정되지 않았음을 나타냅니다. |
MONTH |
정기 결제 기간이 월임을 나타냅니다. |
YEAR |
정기 결제 기간이 연도임을 나타냅니다. |
LoyaltyPoints
포인트를 나타내는 메시지입니다.
JSON 표현 |
---|
{ "name": string, "pointsValue": string, "ratio": number } |
필드 | |
---|---|
name |
적립 포인트 프로그램의 이름입니다. 이름은 12자(일본어 기준) 또는 24자(영문 기준)로 제한하는 것이 좋습니다. |
points |
소매업체의 충성도 포인트(절대값)입니다. |
ratio |
통화로 전환 시 포인트 비율입니다. Google은 판매자 센터 설정에 따라 통화를 가정합니다. 비율을 생략하면 기본값은 1.0입니다. |
LoyaltyProgram
포인트 제도를 나타내는 메시지입니다.
JSON 표현 |
---|
{ "programLabel": string, "tierLabel": string, "price": { object ( |
필드 | |
---|---|
program |
포인트 멤버십의 라벨입니다. 판매자 항목과 포인트 제도 항목 간의 관계를 고유하게 식별하는 내부 라벨입니다. 시스템에서 아래 확장 소재 (예: 가격 및 포인트)를 판매자와 연결할 수 있도록 라벨을 제공해야 합니다. 해당 프로그램이 판매자 계정에 연결되어 있어야 합니다. |
tier |
포인트 제도 내 등급의 라벨입니다. 프로그램 내 라벨 중 하나와 일치해야 합니다. |
price |
특정 등급의 회원에게 적용되는 가격, 즉 즉시 할인 가격입니다. 일반 가격보다 작거나 같아야 합니다. |
cashback |
향후 구매에 사용할 수 있는 캐시백 |
loyalty |
구매 시 적립되는 적립 포인트 수입니다. |
member |
상품에 회원 가격이 적용되는 기간입니다. 지정하지 않으면 회원 가격이 항상 적용됩니다. 기간은 공백, 쉼표 또는 슬래시로 구분된 ISO 8601 날짜 쌍으로 표시됩니다. |
shipping |
배송 혜택의 라벨입니다. 이 필드에 값이 있으면 이 제품에 포인트 제도 대상 배송 혜택이 적용됩니다. 필드 값이 제공되지 않으면 해당 포인트 등급의 포인트 제도 대상 배송이 적용되지 않습니다. |
ProductDimension
제품의 크기입니다.
JSON 표현 |
---|
{ "value": number, "unit": string } |
필드 | |
---|---|
value |
필수 항목입니다. 숫자로 표시된 측정기준 값입니다. 값의 최대 소수점 자릿수는 4자리입니다. |
unit |
필수 항목입니다. 측정기준 단위입니다. 허용되는 값은 다음과 같습니다. * " |
ProductWeight
제품의 중량입니다.
JSON 표현 |
---|
{ "value": number, "unit": string } |
필드 | |
---|---|
value |
필수 항목입니다. 숫자로 표시된 가중치입니다. 가중치는 소수점 이하 4자리까지 정확하게 지정할 수 있습니다. |
unit |
필수 항목입니다. 중량 단위입니다. 허용되는 값은 다음과 같습니다. * " |
배송
제품 배송입니다.
JSON 표현 |
---|
{
"price": {
object ( |
필드 | |
---|---|
price |
고정 배송비로, 숫자로 표시됩니다. |
country |
상품이 배송될 국가의 CLDR 지역 코드입니다. |
region |
배송비 요율이 적용되는 지리적 리전입니다. 자세한 내용은 region을 참고하세요. |
service |
서비스 등급 또는 배송 속도에 대한 자유 형식의 설명입니다. |
location |
AdWords API에 정의된 대로 배송비가 적용되는 위치의 숫자 ID입니다. |
location |
배송이 적용되는 위치로, 위치 그룹 이름으로 표시됩니다. |
postal |
배송비 요율이 적용되는 우편번호 범위로, 우편번호, 우편번호 접두어 뒤에 와일드 카드(*)가 오는 경우, 두 우편번호 사이의 범위 또는 길이가 같은 두 우편번호 접두어로 표시됩니다. |
min |
주문 접수 시점부터 발송 시점까지의 최소 상품 준비 시간 (일 기준)입니다. 0은 주문이 마감 시간 전에 접수된 경우 주문 접수 당일에 배송됨을 의미합니다. |
max |
주문 접수 시점부터 발송 시점까지의 최대 상품 준비 시간 (일 기준)입니다. 0은 주문이 마감 시간 전에 접수된 경우 주문 접수 당일에 배송됨을 의미합니다. 배송 속도를 제공하는 경우 |
min |
주문 제품이 발송된 날짜와 배송된 날짜 간의 최소 운송 시간 (양 끝값 포함, 영업일 기준)입니다. 0은 주문 제품이 배송된 당일에 배송됨을 의미합니다. |
max |
주문 제품이 발송된 날짜부터 배송된 날짜까지의 최대 운송 시간 (일 기준)입니다. 0은 주문 제품이 배송된 당일에 배송됨을 의미합니다. 배송 속도를 제공하는 경우 |
FreeShippingThreshold
제품에 무료 배송이 적용되기 위해 충족해야 하는 조건입니다.
JSON 표현 |
---|
{
"country": string,
"priceThreshold": {
object ( |
필드 | |
---|---|
country |
상품이 배송될 국가의 CLDR 지역 코드입니다. |
price |
배송비가 무료가 되기 위한 최소 제품 가격입니다. 숫자로 표현됩니다. |
ShippingWeight
제품의 ShippingWeight입니다.
JSON 표현 |
---|
{ "value": number, "unit": string } |
필드 | |
---|---|
value |
상품의 배송비를 계산하는 데 사용되는 제품의 중량입니다. |
unit |
값 단위입니다. |
ShippingDimension
제품의 ShippingDimension입니다.
JSON 표현 |
---|
{ "value": number, "unit": string } |
필드 | |
---|---|
value |
상품의 배송비를 계산하는 데 사용되는 제품의 크기입니다. |
unit |
값 단위입니다. |
세금
제품의 세금입니다.
JSON 표현 |
---|
{ "rate": number, "country": string, "region": string, "taxShip": boolean, "locationId": string, "postalCode": string } |
필드 | |
---|---|
rate |
상품 가격에 적용되는 세율의 비율입니다. |
country |
상품에 세금이 부과되는 국가이며 CLDR 지역 코드로 지정됩니다. |
region |
세율이 적용되는 지리적 리전입니다. |
tax |
배송비에 세금이 부과되는 경우 true로 설정합니다. |
location |
AdWords API에 정의된 대로 세율이 적용되는 위치의 숫자 ID입니다. |
postal |
세율이 적용되는 우편번호 범위로, 우편번호, * 와일드 카드를 사용하는 우편번호 접두어, 두 우편번호 사이의 범위 또는 길이가 같은 두 우편번호 접두어로 표시됩니다. 예: 94114, 94*, 94002-95460, 94*-95*. |
UnitPricingMeasure
제품의 UnitPricingMeasure입니다.
JSON 표현 |
---|
{ "value": number, "unit": string } |
필드 | |
---|---|
value |
상품의 측정값입니다. |
unit |
측정 단위입니다. |
UnitPricingBaseMeasure
제품의 UnitPricingBaseMeasure입니다.
JSON 표현 |
---|
{ "value": string, "unit": string } |
필드 | |
---|---|
value |
단가의 분모입니다. |
unit |
분모의 단위입니다. |
ProductDetail
제품 세부정보
JSON 표현 |
---|
{ "sectionName": string, "attributeName": string, "attributeValue": string } |
필드 | |
---|---|
section |
제품 세부정보 집합을 그룹화하는 데 사용되는 섹션 헤더입니다. |
attribute |
제품 세부정보의 이름입니다. |
attribute |
제품 세부정보의 값입니다. |
CloudExportAdditionalProperties
Cloud Retail API의 제품 속성입니다. 예를 들어 TV 제품의 속성은 'Screen-Resolution' 또는 'Screen-Size'일 수 있습니다.
JSON 표현 |
---|
{ "textValue": [ string ], "intValue": [ string ], "floatValue": [ number ], "propertyName": string, "boolValue": boolean, "minValue": number, "maxValue": number, "unitCode": string } |
필드 | |
---|---|
text |
지정된 속성의 텍스트 값입니다. 예를 들어 '8K(UHD)'는 TV 제품의 텍스트 값일 수 있습니다. 이 값의 최대 반복 횟수는 400회입니다. 값은 임의적이지만 일관된 순서로 저장됩니다. 최대 문자열 크기는 256자(영문 기준)입니다. |
int |
지정된 속성의 정수 값입니다. 예를 들어 TV 제품의 화면 해상도는 1080입니다. 이 값의 최대 반복 횟수는 400회입니다. 값은 임의적이지만 일관된 순서로 저장됩니다. |
float |
지정된 속성의 부동 소수점 값입니다. 예를 들어 TV 제품 1.2345의 경우 이 값의 최대 반복 횟수는 400회입니다. 값은 임의적이지만 일관된 순서로 저장됩니다. |
property |
지정된 속성의 이름입니다. 예를 들어 TV 제품의 경우 'Screen-Resolution'입니다. 최대 문자열 크기는 256자(영문 기준)입니다. |
bool |
지정된 속성의 불리언 값입니다. 예를 들어 TV 제품의 경우 화면이 UHD인 경우 'True' 또는 'False'입니다. |
min |
지정된 속성의 최소 부동 소수점 값입니다. 예를 들어 TV 제품 1.00의 경우 |
max |
지정된 속성의 최대 부동 소수점 값입니다. 예를 들어 TV 제품의 경우 100.00입니다. |
unit |
지정된 속성의 단위입니다. 예를 들어 TV 제품의 경우 '픽셀'입니다. 최대 문자열 크기는 256바이트입니다. |
인증
제품 인증: 처음에는 EU EPREL 데이터베이스를 사용하여 EU 에너지 효율 라벨 지정 규정을 준수하기 위해 도입되었습니다.
JSON 표현 |
---|
{ "certificationAuthority": string, "certificationName": string, "certificationCode": string, "certificationValue": string } |
필드 | |
---|---|
certification |
인증 기관입니다(예: 'European_Commission'). 최대 길이는 2,000자(영문 기준)입니다. |
certification |
인증 이름입니다(예: 'EPREL'). 최대 길이는 2,000자(영문 기준)입니다. |
certification |
인증 코드 최대 길이는 2,000자(영문 기준)입니다. |
certification |
인증 값(클래스, 등급 또는 성적이라고도 함)입니다(예: 'A+', 'C', '골드'). 최대 길이는 2,000자(영문 기준)입니다. |
ProductStructuredTitle
알고리즘 (AI) 생성 제품명의 경우 구조화된 제품명입니다.
JSON 표현 |
---|
{ "digitalSourceType": string, "content": string } |
필드 | |
---|---|
digital |
디지털 소스 유형입니다(예: 'trained_algorithmic_media'). IPTC를 팔로우 중입니다. 최대 길이는 40자(영문 기준)입니다. |
content |
제목 텍스트의 최대 길이는 150자(영문 기준)입니다. |
ProductStructuredDescription
구조화된 설명: 알고리즘 (AI) 생성 설명
JSON 표현 |
---|
{ "digitalSourceType": string, "content": string } |
필드 | |
---|---|
digital |
디지털 소스 유형입니다(예: 'trained_algorithmic_media'). IPTC를 팔로우 중입니다. 최대 길이는 40자(영문 기준)입니다. |
content |
설명 텍스트의 최대 길이는 5,000자(영문 기준)입니다. |