REST Resource: accounts.products

리소스: Product

규칙 및 보조 데이터 소스를 적용한 후 여러 [제품 입력][[google.shopping.content.bundles.Products.ProductInput] 를 기반으로 빌드된 처리된 제품입니다. 이 처리된 제품은 판매자 센터 계정, 쇼핑 광고, 기타 Google 플랫폼에 표시되는 제품과 일치합니다. 각 제품은 정확히 하나의 기본 데이터 소스 제품 입력과 여러 보조 데이터 소스 입력으로 만들어집니다. 제품 입력을 삽입, 업데이트 또는 삭제한 후 업데이트된 처리된 제품을 가져올 수 있을 때까지 몇 분 정도 걸릴 수 있습니다.

처리된 제품 및 하위 메시지의 모든 필드는 일부 예외를 제외하고 제품 데이터 사양의 해당 속성 이름과 일치합니다.

JSON 표현 
{
  "name": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
입력란
name

string

제품 이름입니다. 형식: "{product.name=accounts/{account}/products/{product}}"
channel

enum (ChannelEnum)

출력 전용입니다. 제품의 채널입니다.
offerId

string

출력 전용입니다. 제품의 고유 식별자입니다. 이는 입력된 제품 및 처리된 제품에서 동일합니다. 선행 및 후행 공백은 제거되며, 제출 시 여러 공백은 단일 공백으로 대체됩니다. 자세한 내용은 제품 데이터 사양을 참조하세요.
contentLanguage

string

출력 전용입니다. 제품의 두 글자 ISO 639-1 언어 코드입니다.
feedLabel

string

출력 전용입니다. 제품의 피드 라벨입니다.
dataSource

string

출력 전용입니다. 제품의 기본 데이터 소스입니다.
attributes

object (Attributes)

출력 전용입니다. 제품 속성의 목록입니다.
customAttributes[]

object (CustomAttribute)

출력 전용입니다. 맞춤 (판매자 제공) 속성의 목록입니다. 데이터 사양의 속성을 일반 형식으로 제출하는 데 사용할 수도 있습니다 (예: { "name": "size type", "value": "regular" }). Buy on Google에 사용되는 추가 속성과 같이 API에 의해 명시적으로 노출되지 않은 속성을 제출하는 데 유용합니다.
productStatus

object (ProductStatus)

출력 전용입니다. 제품 상태, 데이터 유효성 문제, 즉 비동기식으로 계산된 제품에 대한 정보입니다.
versionNumber

string (int64 format)

출력 전용입니다. 제품의 기존 버전 (최신 버전)을 나타내며, 여러 업데이트가 동시에 완료될 때 올바른 순서를 유지하는 데 사용할 수 있습니다.

설정하면 버전 번호가 기존 제품의 현재 버전 번호보다 낮을 때 삽입이 차단됩니다. 현재 versionNumber를 사용하여 다시 삽입 (예: 30일 후 제품 새로고침)할 수 있습니다.

기본 데이터 소스에 삽입할 때만 지원됩니다.

작업이 방지되면 취소된 예외가 발생합니다.

특성

속성.

JSON 표현 
{
  "additionalImageLinks": [
    string
  ],
  "expirationDate": string,
  "disclosureDate": string,
  "availabilityDate": string,
  "price": {
    object (Price)
  },
  "installment": {
    object (Installment)
  },
  "subscriptionCost": {
    object (SubscriptionCost)
  },
  "loyaltyPoints": {
    object (LoyaltyPoints)
  },
  "loyaltyPrograms": [
    {
      object (LoyaltyProgram)
    }
  ],
  "productTypes": [
    string
  ],
  "salePrice": {
    object (Price)
  },
  "salePriceEffectiveDate": {
    object (Interval)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productWeight": {
    object (ProductWeight)
  },
  "shipping": [
    {
      object (Shipping)
    }
  ],
  "freeShippingThreshold": [
    {
      object (FreeShippingThreshold)
    }
  ],
  "shippingWeight": {
    object (ShippingWeight)
  },
  "shippingLength": {
    object (ShippingDimension)
  },
  "shippingWidth": {
    object (ShippingDimension)
  },
  "shippingHeight": {
    object (ShippingDimension)
  },
  "sizeTypes": [
    string
  ],
  "taxes": [
    {
      object (Tax)
    }
  ],
  "unitPricingMeasure": {
    object (UnitPricingMeasure)
  },
  "unitPricingBaseMeasure": {
    object (UnitPricingBaseMeasure)
  },
  "adsLabels": [
    string
  ],
  "costOfGoodsSold": {
    object (Price)
  },
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productHighlights": [
    string
  ],
  "displayAdsSimilarIds": [
    string
  ],
  "promotionIds": [
    string
  ],
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "shoppingAdsExcludedCountries": [
    string
  ],
  "lifestyleImageLinks": [
    string
  ],
  "cloudExportAdditionalProperties": [
    {
      object (CloudExportAdditionalProperties)
    }
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "autoPricingMinPrice": {
    object (Price)
  },
  "identifierExists": boolean,
  "isBundle": boolean,
  "title": string,
  "description": string,
  "link": string,
  "mobileLink": string,
  "canonicalLink": string,
  "imageLink": string,
  "adult": boolean,
  "ageGroup": string,
  "availability": string,
  "brand": string,
  "color": string,
  "condition": string,
  "gender": string,
  "googleProductCategory": string,
  "gtin": string,
  "itemGroupId": string,
  "material": string,
  "mpn": string,
  "pattern": string,
  "sellOnGoogleQuantity": string,
  "maxHandlingTime": string,
  "minHandlingTime": string,
  "shippingLabel": string,
  "transitTimeLabel": string,
  "size": string,
  "sizeSystem": string,
  "taxCategory": string,
  "energyEfficiencyClass": string,
  "minEnergyEfficiencyClass": string,
  "maxEnergyEfficiencyClass": string,
  "multipack": string,
  "adsGrouping": string,
  "adsRedirect": string,
  "displayAdsId": string,
  "displayAdsTitle": string,
  "displayAdsLink": string,
  "displayAdsValue": number,
  "pickupMethod": string,
  "pickupSla": string,
  "linkTemplate": string,
  "mobileLinkTemplate": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "externalSellerId": string,
  "pause": string,
  "virtualModelLink": string,
  "structuredTitle": {
    object (ProductStructuredTitle)
  },
  "structuredDescription": {
    object (ProductStructuredDescription)
  }
}
입력란
expirationDate

string (Timestamp format)

삽입 시 지정한 대로 상품이 만료되어야 하는 날짜입니다. ISO 8601 형식으로 나타냅니다. 실제 만료일은 productstatuses에 googleExpirationDate로 표시되며 expirationDate이 너무 먼 미래인 경우 더 이른 날짜일 수 있습니다.
disclosureDate

string (Timestamp format)

Google의 YouTube 표시 경로 검색 결과에 상품이 표시되는 날짜 시간입니다(ISO 8601 형식). 자세한 내용은 [공개일]( https://support.google.com/merchants/answer/13034208)을 참조하세요.
availabilityDate

string (Timestamp format)

선주문 제품의 배송이 가능한 날(ISO 8601 형식)
price

object (Price)

상품 가격.
installment

object (Installment)

상품 결제에 사용되는 할부 횟수 및 금액입니다.
subscriptionCost

object (SubscriptionCost)

구독 계약이 연결된 항목의 기간 (월 또는 연) 및 기간별 결제 금액입니다.
loyaltyPoints

object (LoyaltyPoints)

사용자가 상품 구매 후 받는 적립 포인트 일본에서만 사용 가능합니다.
loyaltyPrograms[]

object (LoyaltyProgram)

이 항목의 사용자에게 포인트 혜택 (예: 더 나은 가격, 포인트 등)을 표시하는 데 사용되는 포인트 제도 정보의 목록입니다.
productTypes[]

string

상품의 카테고리입니다 (제품 데이터 사양에 지정된 형식).
salePrice

object (Price)

상품의 광고된 할인가입니다.
salePriceEffectiveDate

object (Interval)

상품 할인이 적용되는 기간입니다 (제품 데이터 사양 참조).
productHeight

object (ProductDimension)

제공된 단위로 나타낸 제품의 높이입니다. 값은 0(0 제외) 이상 3000 이하여야 합니다.
productLength

object (ProductDimension)

제공된 단위로 나타낸 제품의 길이입니다. 값은 0(0 제외) 이상 3000 이하여야 합니다.
productWidth

object (ProductDimension)

제공된 단위로 나타낸 제품의 너비입니다. 값은 0(0 제외) 이상 3000 이하여야 합니다.
productWeight

object (ProductWeight)

제공된 단위로 나타낸 제품의 중량입니다. 값은 0 (제외)과 2000 (포함) 사이여야 합니다.
shipping[]

object (Shipping)

배송 규칙
freeShippingThreshold[]

object (FreeShippingThreshold)

무료 배송을 제공하기 위해 충족해야 하는 조건입니다.
shippingWeight

object (ShippingWeight)

배송할 상품의 무게입니다.
shippingLength

object (ShippingDimension)

배송할 상품의 길이입니다.
shippingWidth

object (ShippingDimension)

배송할 상품의 너비입니다.
shippingHeight

object (ShippingDimension)

배송할 상품의 높이입니다.
sizeTypes[]

string

상품의 컷입니다. 의류 상품의 결합된 사이즈 유형을 나타내는 데 사용할 수 있습니다. 최대 2개의 사이즈 유형을 제공할 수 있습니다([https://support.google.com/merchants/answer/6324497](사이즈 유형) 참고).
taxes[]

object (Tax)

세금 정보
unitPricingMeasure

object (UnitPricingMeasure)

상품의 측정치 및 크기입니다.
unitPricingBaseMeasure

object (UnitPricingBaseMeasure)

단가의 분모 선호도입니다.
adsLabels[]

string

adsGrouping과 유사하지만 CPC에서만 작동합니다.
costOfGoodsSold

object (Price)

매출원가 총이익 보고에 사용됩니다.
productDetails[]

object (ProductDetail)

기술 사양 또는 추가 제품 세부정보
productHighlights[]

string

글머리기호는 제품의 가장 관련성이 높은 특징을 설명합니다.
displayAdsSimilarIds[]

string

광고주가 지정한 권장사항입니다.
promotionIds[]

string

프로모션의 고유 ID입니다.
includedDestinations[]

string

이 타겟에 포함할 대상 유형의 목록입니다 (판매자 센터의 선택된 체크박스에 해당). excludedDestinations에 제공되지 않는 한 기본 대상은 항상 포함됩니다.
excludedDestinations[]

string

이 타겟에서 제외할 대상 유형의 목록입니다 (판매자 센터에서 선택 해제된 체크박스에 해당).
shoppingAdsExcludedCountries[]

string

쇼핑 광고 도착 페이지에서 제품을 제외할 국가 코드 (ISO 3166-1 alpha-2) 목록입니다. 이 목록에 있는 국가는 데이터 소스 설정에 구성된 국가에서 삭제됩니다.
cloudExportAdditionalProperties[]

object (CloudExportAdditionalProperties)

Cloud Retail 프로그램으로 내보낼 추가 필드입니다.
certifications[]

object (Certification)

제품 인증(예: EU EPREL 데이터베이스에 기록된 제품의 에너지 효율 라벨 지정) 자세한 내용은 고객센터 도움말을 참고하세요.
autoPricingMinPrice

object (Price)

'자동 할인' (https://support.google.com/merchants/answer/10295759) 및 '동적 프로모션' (https://support.google.com/merchants/answer/13949249) 프로젝트의 보호 장치를 통해 판매자의 혜택에 대한 할인이 이 값 미만으로 떨어지지 않도록 하여 혜택의 가치와 수익성을 유지할 수 있습니다.
identifierExists

boolean

상품에 해당 카테고리에 적합한 제품 고유 식별자(예: GTIN, MPN, 브랜드)가 없는 경우 이 값을 false로 설정합니다. 제공되지 않은 경우 기본값은 true입니다.
isBundle

boolean

상품이 판매자 정의 번들인지 여부입니다. 번들은 판매자가 단일 가격에 판매하는 다양한 제품을 맞춤 그룹화한 것입니다.
title

string

상품의 제목입니다.
description

string

항목의 설명입니다.
adult

boolean

상품이 성인을 대상으로 하는 경우 true로 설정합니다.
ageGroup

string

상품의 대상 연령대입니다.
availability

string

상품의 재고 상태
brand

string

상품의 브랜드.
color

string

상품의 색상입니다.
condition

string

상품의 상태
gender

string

상품의 타겟 성별입니다.
googleProductCategory

string

Google의 상품 카테고리입니다 (Google 상품 분류 참조). 제품을 쿼리할 때 이 필드에는 사용자 제공 값이 포함됩니다. 현재 API를 통해 자동 할당된 Google 제품 카테고리를 가져올 수 있는 방법은 없습니다.
gtin

string

상품의 국제거래단품식별코드 (GTIN)입니다.
itemGroupId

string

동일한 제품의 모든 옵션에 대한 공유 식별자입니다.
material

string

상품을 만든 소재입니다.
mpn

string

상품의 제조업체 부품번호 (MPN)
pattern

string

상품의 패턴 (예: 물방울 무늬)입니다.
sellOnGoogleQuantity

string (int64 format)

Google에서 판매할 수 있는 제품의 수량입니다. 온라인 제품에만 지원됩니다.
maxHandlingTime

string (int64 format)

최대 제품 주문 상품 준비 시간 (영업일 기준)입니다.
minHandlingTime

string (int64 format)

최소 제품 주문 상품 준비 시간 (영업일 기준)
shippingLabel

string

제품 배송물 라벨로, 계정 수준 배송 규칙에서 제품을 그룹화하는 데 사용됩니다.
transitTimeLabel

string

계정 수준 운송 시간 표에서 제품을 그룹화하는 데 사용되는 제품의 운송 시간 라벨입니다.
size

string

상품의 크기입니다. 하나의 값만 허용됩니다. 사이즈가 다양한 옵션의 경우 itemGroupId 값이 동일한 각 사이즈에 별도의 제품을 삽입합니다([https://support.google.com/merchants/answer/6324492](사이즈 정의) 참고).
sizeSystem

string

크기가 지정된 시스템입니다. 의류 상품의 권장사항입니다.
taxCategory

string

계정 수준 세금 설정에서 상세한 세금 연관성을 구성하는 데 사용되는 제품의 세금 카테고리입니다.
energyEfficiencyClass

string

EU 지침 2010/30/EU에 정의된 에너지 효율 등급입니다.
minEnergyEfficiencyClass

string

EU 지침 2010/30/EU에 정의된 에너지 효율 등급입니다.
maxEnergyEfficiencyClass

string

EU 지침 2010/30/EU에 정의된 에너지 효율 등급입니다.
multipack

string (int64 format)

판매자가 정의한 패키지 상품에 포함된 동일 제품의 수량입니다.
adsGrouping

string

임의의 방식으로 항목을 그룹화하는 데 사용됩니다. CPA 비율에만 사용할 수 있으며 달리 권장하지 않음
adsRedirect

string

제품 광고 내에서 제품이 표시될 때 광고주가 상품 URL을 재정의할 수 있도록 합니다.
displayAdsId

string

동적 리마케팅 캠페인의 상품 식별자입니다.
displayAdsTitle

string

동적 리마케팅 캠페인의 상품 제목입니다.
displayAdsValue

number

동적 리마케팅 캠페인의 제공 마진
pickupMethod

string

상품의 수령 옵션입니다.
pickupSla

string

상품 매장 수령 타임라인
customLabel0

string

쇼핑 캠페인에서 상품의 맞춤 그룹화에 대한 맞춤 라벨 0입니다.
customLabel1

string

쇼핑 캠페인에서 상품의 맞춤 그룹화를 위한 맞춤 라벨 1입니다.
customLabel2

string

쇼핑 캠페인에서 상품의 맞춤 그룹화를 위한 맞춤 라벨 2입니다.
customLabel3

string

쇼핑 캠페인에서 상품의 맞춤 그룹화를 위한 맞춤 라벨 3입니다.
customLabel4

string

쇼핑 캠페인의 상품을 맞춤 그룹화하기 위한 맞춤 라벨 4입니다.
externalSellerId

string

복수 판매자 계정에 필요합니다. 다양한 판매자의 제품을 다중 판매자 계정에 업로드하는 마켓인 경우 이 속성을 사용합니다.
pause

string

이 항목의 게시가 일시적으로 일시중지됩니다.
structuredTitle

object (ProductStructuredTitle)

알고리즘 방식으로 (AI) 생성된 제목을 위한 구조화된 제품명
structuredDescription

object (ProductStructuredDescription)

구조화된 설명: 알고리즘 방식으로 (AI) 생성된 내용 입력란

할부

분할 결제를 나타내는 메시지입니다.

JSON 표현 
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  },
  "creditType": string
}
입력란
months

string (int64 format)

구매자가 결제해야 할 할부 횟수입니다.
amount

object (Price)

매 달 구매자가 결제해야 하는 금액입니다.
downpayment

object (Price)

구매자가 지불해야 하는 선불 계약금 금액입니다.
creditType

string

할부 결제 유형입니다. 지원되는 값은 * 'finance' * 'lease'입니다.

SubscriptionCost

제품의 SubscriptionCost입니다.

JSON 표현 
{
  "period": enum (SubscriptionPeriod),
  "periodLength": string,
  "amount": {
    object (Price)
  }
}
입력란
period

enum (SubscriptionPeriod)

구독 기간의 유형입니다. 지원되는 값은 * 'month' * 'year'입니다.
periodLength

string (int64 format)

구매자가 결제해야 하는 구독 기간 수입니다.
amount

object (Price)

구매자가 구독 기간별로 지불해야 하는 금액입니다.

SubscriptionPeriod

제품의 구독 기간입니다.

열거형
SUBSCRIPTION_PERIOD_UNSPECIFIED 구독 기간이 지정되지 않았음을 나타냅니다.
MONTH 구독 기간이 월임을 나타냅니다.
YEAR 구독 기간이 연 단위임을 나타냅니다.

LoyaltyPoints

적립 포인트를 나타내는 메시지입니다.

JSON 표현 
{
  "name": string,
  "pointsValue": string,
  "ratio": number
}
입력란
name

string

적립 포인트 프로그램의 이름입니다. 이름은 전각 12자 또는 로마자 24자로 제한하는 것이 좋습니다.
pointsValue

string (int64 format)

절대값으로 표시된 소매업체의 적립 포인트입니다.
ratio

number

통화로 변환할 때 포인트의 비율입니다. Google은 판매자 센터 설정을 기반으로 통화를 가정합니다. 비율을 생략하면 기본값은 1.0입니다.

LoyaltyProgram

포인트 제도를 나타내는 메시지입니다.

JSON 표현 
{
  "programLabel": string,
  "tierLabel": string,
  "price": {
    object (Price)
  },
  "cashbackForFutureUse": {
    object (Price)
  },
  "loyaltyPoints": string
}
입력란
programLabel

string

포인트 제도의 라벨입니다. 판매자 법인과 포인트 제도 법인 간의 관계를 고유하게 식별하는 내부 라벨입니다. 시스템에서 아래의 저작물 (예: 가격 및 포인트)을 판매자와 연결할 수 있도록 라벨을 제공해야 합니다. 해당 프로그램이 판매자 계정에 연결되어 있어야 합니다.
tierLabel

string

포인트 멤버십 내의 등급 라벨입니다. 프로그램 내의 라벨 중 하나와 일치해야 합니다.
price

object (Price)

지정된 등급의 회원 가격, 즉 즉시 할인 가격입니다. 정상 가격 이하여야 합니다.
cashbackForFutureUse

object (Price)

향후 구매 시 사용할 수 있는 캐시백입니다.
loyaltyPoints

string (int64 format)

구매로 적립된 적립 포인트 금액입니다.

ProductDimension

제품의 크기입니다.

JSON 표현 
{
  "value": number,
  "unit": string
}
입력란
value

number

필수 항목입니다. 숫자로 표시된 측정기준 값입니다. 값의 최대 정밀도는 소수점 네 자리까지 가능합니다.
unit

string

필수 항목입니다. 크기 단위입니다. 허용되는 값: * 'in' * 'cm'

ProductWeight

제품의 중량입니다.

JSON 표현 
{
  "value": number,
  "unit": string
}
입력란
value

number

필수 항목입니다. 숫자로 표시된 가중치입니다. 가중치의 최대 정밀도는 소수점 네 자리까지 가능합니다.
unit

string

필수 항목입니다. 중량 단위입니다. 허용되는 값: * 'g' * 'kg' * 'oz' * 'lb'

배송

제품의 배송입니다.

JSON 표현 
{
  "price": {
    object (Price)
  },
  "country": string,
  "region": string,
  "service": string,
  "locationId": string,
  "locationGroupName": string,
  "postalCode": string,
  "minHandlingTime": string,
  "maxHandlingTime": string,
  "minTransitTime": string,
  "maxTransitTime": string
}
입력란
price

object (Price)

숫자로 표시되는 고정 배송비입니다.
country

string

상품이 배송될 국가의 CLDR 지역 코드입니다.
region

string

배송비가 적용되는 지역입니다. 자세한 내용은 지역을 참조하세요.
service

string

서비스 등급 또는 배송 속도에 대한 자유 형식의 설명입니다.
locationId

string (int64 format)

AdWords API에 정의된 대로 배송비가 적용되는 위치의 숫자 ID입니다.
locationGroupName

string

배송이 적용되는 위치로 위치 그룹 이름으로 표시됩니다.
postalCode

string

배송비가 적용되는 우편번호 범위로, 우편번호, 우편번호 접두어 뒤에 * 와일드 카드, 두 우편번호 사이의 범위 또는 길이가 동일한 두 우편번호 접두어로 표현됩니다.
minHandlingTime

string (int64 format)

영업일 기준 주문 제품을 수령하고 발송하는 시점 사이의 최소 상품 준비 시간 (포함)입니다. 0은 주문 마감 시간 전에 주문 상품이 수령된 날짜와 같은 날에 발송됨을 의미합니다. [minHandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] 은 [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time]과 함께 표시할 수 있지만 [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] 이 있는 경우에는 필요하지 않습니다.
maxHandlingTime

string (int64 format)

영업일 기준 주문 접수부터 배송까지 걸리는 최대 상품 준비 시간입니다. 0은 주문 마감 시간 전에 주문 상품이 수령된 날짜와 같은 날에 발송됨을 의미합니다. 배송 속도를 제공하는 경우 [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] 및 [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] 이 모두 필요합니다. [minhandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] 은 [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] 이 있는 경우 선택사항입니다.
minTransitTime

string (int64 format)

주문 상품이 발송된 시점과 영업일 기준 배송 완료된 시점 사이의 최소 운송 기간 (포함)입니다. 0은 주문 상품이 발송 당일에 배송됨을 의미합니다. [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] 은 [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]과 함께 있을 수 있습니다. 하지만 [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] 이 있는 경우에는 필요하지 않습니다.
maxTransitTime

string (int64 format)

주문 상품이 발송된 시점과 영업일 기준 배송 완료된 시점 사이의 최대 운송 기간 (포함)입니다. 0은 주문 상품이 발송 당일에 배송됨을 의미합니다. 배송 속도를 제공하는 경우 [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] 및 [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] 이 모두 필요합니다. [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] 은 [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] 이 있는 경우 선택사항입니다.

FreeShippingThreshold

무료 배송을 제공하기 위해 충족해야 하는 조건입니다.

JSON 표현 
{
  "country": string,
  "priceThreshold": {
    object (Price)
  }
}
입력란
country

string

상품이 배송될 국가의 CLDR 지역 코드입니다.
priceThreshold

object (Price)

배송비가 무료가 되기 위한 최소 제품 가격입니다. 숫자로 표현됩니다.

ShippingWeight

제품의 배송 중량입니다.

JSON 표현 
{
  "value": number,
  "unit": string
}
입력란
value

number

상품의 배송비를 계산하는 데 사용되는 제품의 중량입니다.
unit

string

값의 단위입니다.

ShippingDimension

제품의 ShippingDimension입니다.

JSON 표현 
{
  "value": number,
  "unit": string
}
입력란
value

number

상품의 배송비를 계산하는 데 사용되는 제품의 크기입니다.
unit

string

값의 단위입니다.

세금

제품의 세금입니다.

JSON 표현 
{
  "rate": number,
  "country": string,
  "region": string,
  "taxShip": boolean,
  "locationId": string,
  "postalCode": string
}
입력란
rate

number

상품 가격에 적용되는 세율입니다.
country

string

상품에 세금이 부과되는 국가이며 CLDR 지역 코드로 지정됩니다.
region

string

세율이 적용되는 지역입니다.
taxShip

boolean

배송비에 세금이 부과되는 경우 true로 설정합니다.
locationId

string (int64 format)

AdWords API에서 정의된 세율이 적용되는 위치의 숫자 ID입니다.
postalCode

string

세율이 적용되는 우편번호 범위로, 우편번호, * 와일드 카드를 사용한 우편번호 접두어, 두 우편번호 또는 길이가 같은 두 우편번호 접두사 사이의 범위입니다. 예: 94114, 94*, 94002-95460, 94*-95*.

UnitPricingMeasure

제품의 UnitPricingMeasure입니다.

JSON 표현 
{
  "value": number,
  "unit": string
}
입력란
value

number

상품의 측정치입니다.
unit

string

측정 단위입니다.

UnitPricingBaseMeasure

제품의 UnitPricingBaseMeasure입니다.

JSON 표현 
{
  "value": string,
  "unit": string
}
입력란
value

string (int64 format)

단가의 분모입니다.
unit

string

분모의 단위입니다.

ProductDetail

제품 세부정보입니다.

JSON 표현 
{
  "sectionName": string,
  "attributeName": string,
  "attributeValue": string
}
입력란
sectionName

string

제품 세부정보 집합을 그룹화하는 데 사용되는 섹션 헤더입니다.
attributeName

string

제품 세부정보의 이름입니다.
attributeValue

string

제품 세부정보의 값입니다.

CloudExportAdditionalProperties

Cloud Retail API의 제품 속성입니다. 예를 들어 TV 제품의 속성은 '화면 해상도' 또는 '화면 크기'일 수 있습니다.

JSON 표현 
{
  "textValue": [
    string
  ],
  "intValue": [
    string
  ],
  "floatValue": [
    number
  ],
  "propertyName": string,
  "boolValue": boolean,
  "minValue": number,
  "maxValue": number,
  "unitCode": string
}
입력란
textValue[]

string

지정된 속성의 텍스트 값입니다. 예를 들어 '8K(UHD)'는 TV 제품의 텍스트 값이 될 수 있습니다. 이 값의 최대 반복률은 400입니다. 값은 임의적이지만 일관된 순서로 저장됩니다. 최대 문자열 크기는 256자(영문 기준)입니다.
intValue[]

string (int64 format)

지정된 속성의 정수 값입니다. 예를 들어 TV 제품의 화면 해상도는 1080입니다. 이 값의 최대 반복률은 400입니다. 값은 임의적이지만 일관된 순서로 저장됩니다.
floatValue[]

number

지정된 속성의 부동 소수점 수 값입니다. 예를 들어 TV 제품 1.2345입니다. 이 값의 최대 반복률은 400입니다. 값은 임의적이지만 일관된 순서로 저장됩니다.
propertyName

string

지정된 속성의 이름입니다. (예: TV 제품의 경우 '화면 해상도'). 최대 문자열 크기는 256자(영문 기준)입니다.
boolValue

boolean

지정된 속성의 부울 값입니다. 예를 들어 TV 제품의 경우 화면이 UHD이면 '참' 또는 '거짓'입니다.
minValue

number

지정된 속성의 최소 부동 소수점 값입니다. 예를 들어 TV 제품 1.00입니다.
maxValue

number

지정된 속성의 부동 소수점 최댓값입니다. 예를 들어 TV 제품 100.00입니다.
unitCode

string

지정된 속성의 단위입니다. (예: TV 제품의 경우 '픽셀') 최대 문자열 크기는 256B입니다.

인증

EU EPREL 데이터베이스를 사용한 EU 에너지 효율 라벨 지정 규정 준수를 위해 처음 도입된 제품 인증입니다.

JSON 표현 
{
  "certificationAuthority": string,
  "certificationName": string,
  "certificationCode": string,
  "certificationValue": string
}
입력란
certificationAuthority

string

인증 기관(예: 'European_Commission')입니다. 최대 길이는 2,000자(영문 기준)입니다.
certificationName

string

인증 이름입니다(예: 'EPREL'). 최대 길이는 2,000자(영문 기준)입니다.
certificationCode

string

인증 코드입니다. 최대 길이는 2,000자(영문 기준)입니다.
certificationValue

string

인증 값(등급, 등급, 등급이라고도 함)입니다(예: 'A+', 'C', '골드'). 최대 길이는 2,000자(영문 기준)입니다.

ProductStructuredTitle

알고리즘 방식으로 (AI) 생성된 제목을 위한 구조화된 제품명

JSON 표현 
{
  "digitalSourceType": string,
  "content": string
}
입력란
digitalSourceType

string

디지털 소스 유형입니다(예: 'trained_algorithmic_media'). IPTC 준수 최대 길이는 40자(영문 기준)입니다.
content

string

제목 텍스트의 최대 길이는 150자(영문 기준)입니다.

ProductStructuredDescription

구조화된 설명: 알고리즘 방식으로 (AI) 생성된 내용 입력란

JSON 표현 
{
  "digitalSourceType": string,
  "content": string
}
입력란
digitalSourceType

string

디지털 소스 유형입니다(예: 'trained_algorithmic_media'). IPTC 준수 최대 길이는 40자(영문 기준)입니다.
content

string

설명 텍스트의 최대 길이는 5,000자(영문 기준)입니다.

ProductStatus

제품 상태, 데이터 유효성 문제, 즉 비동기식으로 계산된 제품에 대한 정보입니다.

JSON 표현 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
입력란
destinationStatuses[]

object (DestinationStatus)

제품의 의도된 대상 유형입니다.
itemLevelIssues[]

object (ItemLevelIssue)

제품과 관련된 모든 문제의 목록입니다.
creationDate

string (Timestamp format)

항목이 생성된 날짜(ISO 8601 형식)입니다.
lastUpdateDate

string (Timestamp format)

상품이 마지막으로 업데이트된 날짜입니다(ISO 8601 형식).
googleExpirationDate

string (Timestamp format)

상품이 만료되는 날짜입니다(ISO 8601 형식).

DestinationStatus

제품 상태의 대상 유형 상태입니다.

JSON 표현 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
입력란
reportingContext

enum (ReportingContextEnum)

보고 컨텍스트의 이름입니다.
approvedCountries[]

string

제품이 승인된 국가 코드 목록 (ISO 3166-1 alpha-2)입니다.
pendingCountries[]

string

제품이 승인 대기 중인 국가 코드 목록 (ISO 3166-1 alpha-2)입니다.
disapprovedCountries[]

string

제품이 비승인된 국가 코드 (ISO 3166-1 alpha-2) 목록입니다.

ItemLevelIssue

제품 상태의 ItemLevelIssue입니다.

JSON 표현 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
입력란
code

string

문제의 오류 코드입니다.
severity

enum (Severity)

이 문제가 혜택 제공에 미치는 영향
resolution

string

판매자가 문제를 해결할 수 있는지 여부입니다.
attribute

string

문제가 단일 속성으로 인해 발생한 경우 속성의 이름입니다.
reportingContext

enum (ReportingContextEnum)

문제가 적용되는 보고 컨텍스트입니다.
description

string

간단한 문제 설명(영어)
detail

string

자세한 문제 설명(영어)
documentation

string

이 문제를 해결하는 데 도움이 되는 웹페이지의 URL입니다.
applicableCountries[]

string

문제가 혜택에 적용되는 국가 코드 (ISO 3166-1 alpha-2) 목록입니다.

심각도

문제가 제품 제공에 미치는 영향

열거형
SEVERITY_UNSPECIFIED 지정되지 않았습니다.
NOT_IMPACTED 이 문제는 경고를 나타내며 제품에 직접적인 영향을 미치지 않습니다.
DEMOTED 제품의 순위가 낮아졌으며 검색결과에서 실적이 제한될 가능성이 높습니다.
DISAPPROVED 문제로 인해 제품이 비승인됩니다.

방법

get

 판매자 센터 계정에서 처리된 제품을 검색합니다.

list

 판매자 센터 계정에서 처리된 제품을 나열합니다.