REST Resource: accounts.cssProducts

리소스: CssProduct

처리된 CSS 제품입니다.

JSON 표현
{
  "name": string,
  "rawProvidedId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "cssProductStatus": {
    object (CssProductStatus)
  }
}
필드
name

string

CSS 제품의 이름입니다. 형식: "accounts/{account}/cssProducts/{css_product}"

rawProvidedId

string

출력 전용입니다. 제품의 고유한 원시 식별자입니다.

contentLanguage

string

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

feedLabel

string

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

attributes

object (Attributes)

출력 전용입니다. 제품 속성 목록입니다.

customAttributes[]

object (CustomAttribute)

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

cssProductStatus

object (CssProductStatus)

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

속성

CSS 제품의 속성입니다.

JSON 표현
{
  "lowPrice": {
    object (Price)
  },
  "highPrice": {
    object (Price)
  },
  "headlineOfferPrice": {
    object (Price)
  },
  "headlineOfferShippingPrice": {
    object (Price)
  },
  "additionalImageLinks": [
    string
  ],
  "productTypes": [
    string
  ],
  "sizeTypes": [
    string
  ],
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productWeight": {
    object (ProductWeight)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productHighlights": [
    string
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "expirationDate": string,
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "headlineOfferInstallment": {
    object (HeadlineOfferInstallment)
  },
  "headlineOfferSubscriptionCost": {
    object (HeadlineOfferSubscriptionCost)
  },
  "cppLink": string,
  "cppMobileLink": string,
  "cppAdsRedirect": string,
  "numberOfOffers": string,
  "headlineOfferCondition": string,
  "headlineOfferLink": string,
  "headlineOfferMobileLink": string,
  "title": string,
  "imageLink": string,
  "description": string,
  "brand": string,
  "mpn": string,
  "gtin": string,
  "googleProductCategory": string,
  "adult": boolean,
  "multipack": string,
  "isBundle": boolean,
  "ageGroup": string,
  "color": string,
  "gender": string,
  "material": string,
  "pattern": string,
  "size": string,
  "sizeSystem": string,
  "itemGroupId": string,
  "pause": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "reviewCount": string,
  "minRating": string,
  "maxRating": string,
  "rating": number
}
필드
lowPrice

object (Price)

CSS 제품의 최저가입니다.

highPrice

object (Price)

CSS 제품의 최고가입니다.

headlineOfferPrice

object (Price)

CSS 제품의 대표 가격입니다.

headlineOfferShippingPrice

object (Price)

CSS 제품의 대표 가격입니다.

productTypes[]

string

상품의 카테고리입니다(제품 데이터 사양과 같은 형식).

sizeTypes[]

string

상품의 컷입니다. 의류 상품의 결합된 사이즈 유형을 나타내는 데 사용할 수 있습니다. 사이즈 유형은 최대 2개까지 제공할 수 있습니다(사이즈 유형 참고).

productDetails[]

object (ProductDetail)

기술 사양 또는 추가 제품 세부정보입니다.

productWeight

object (ProductWeight)

제공된 단위의 제품 중량입니다. 값은 0(제외)에서 2000(포함) 사이여야 합니다.

productLength

object (ProductDimension)

제공된 단위의 제품 길이입니다. 값은 0(제외)에서 3000(포함) 사이여야 합니다.

productWidth

object (ProductDimension)

제공된 단위의 제품 너비입니다. 값은 0(제외)에서 3000(포함) 사이여야 합니다.

productHeight

object (ProductDimension)

제공된 단위의 제품 높이입니다. 값은 0(제외)에서 3000(포함) 사이여야 합니다.

productHighlights[]

string

제품의 가장 관련성 높은 특징을 설명하는 글머리기호입니다.

certifications[]

object (Certification)

지정된 제품에 대해 CSS에서 주장하는 인증서 목록입니다.

expirationDate

string (Timestamp format)

삽입 시 지정한 대로 상품이 만료되는 날짜입니다(ISO 8601 형식). 실제 만료일은 productstatuses에 googleExpirationDate로 노출되며 expirationDate가 너무 먼 미래인 경우 더 빠를 수 있습니다. 참고: 상품이 실제로 삭제되기까지 만료일로부터 2일 이상 걸릴 수 있습니다.

includedDestinations[]

string

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

지원되는 값은 css_ads_experiences, css_organic_experiences입니다.

excludedDestinations[]

string

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

지원되는 값은 css_ads_experiences, css_organic_experiences입니다.

headlineOfferInstallment

object (HeadlineOfferInstallment)

상품 결제에 대한 할부 횟수 및 금액입니다.

headlineOfferSubscriptionCost

object (HeadlineOfferSubscriptionCost)

연결된 구독 계약이 있는 상품의 기간 수(월 또는 연) 및 기간당 결제 금액입니다.

cppAdsRedirect

string

제품이 제품 광고의 맥락 내에서 표시될 때 광고주가 상품 URL을 재정의할 수 있습니다.

numberOfOffers

string (int64 format)

CSS 제품 수입니다.

headlineOfferCondition

string

대표 상품의 상태입니다.

title

string

상품 제목

description

string

상품의 설명입니다.

brand

string

제품 관련 속성입니다.[14-36] 상품의 브랜드입니다.

mpn

string

상품의 제조업체 부품 번호(MPN)입니다.

gtin

string

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

googleProductCategory

string

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

adult

boolean

상품이 성인 대상인 경우 true로 설정합니다.

multipack

string (int64 format)

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

isBundle

boolean

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

ageGroup

string

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

color

string

상품의 색상입니다.

gender

string

상품의 대상 성별입니다.

material

string

상품의 소재입니다.

pattern

string

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

size

string

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

sizeSystem

string

사이즈가 지정된 체계입니다. 의류 상품에 권장됩니다.

itemGroupId

string

동일한 상품의 모든 변형에 공유되는 식별자

pause

string

이 항목의 게시가 일시중지됩니다.

customLabel0

string

쇼핑 캠페인에서 상품을 맞춤 그룹화하기 위한 맞춤 라벨 0입니다.

customLabel1

string

쇼핑 캠페인에서 상품을 맞춤 그룹화하기 위한 맞춤 라벨 1입니다.

customLabel2

string

쇼핑 캠페인에서 상품을 맞춤 그룹화하기 위한 맞춤 라벨 2입니다.

customLabel3

string

쇼핑 캠페인에서 상품을 맞춤 그룹화하기 위한 맞춤 라벨 3입니다.

customLabel4

string

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

reviewCount

string (int64 format)

제품의 리뷰 수입니다. rating가 제공된 경우 필수입니다.

minRating

string (int64 format)

제품의 최소 평점입니다. rating이 제공된 경우 필수입니다.

maxRating

string (int64 format)

제품의 최대 평점입니다. rating이 제공된 경우 필수입니다.

rating

number

제품의 평균 평점입니다. 값은 [minRating, maxRating] 범위 내에 있어야 합니다(양 끝값 포함). 제품 페이지에 표시될 때 이 평점은 소수점 이하 한 자리의 [1, 5] 범위로 정규화됩니다. 제공된 경우 reviewCount, minRating, maxRating도 필요합니다.

가격

숫자와 통화로 표시된 가격입니다.

JSON 표현
{
  "amountMicros": string,
  "currencyCode": string
}
필드
amountMicros

string (int64 format)

마이크로 단위의 숫자로 표시된 가격입니다(100만 마이크로는 통화 표준 단위 1개에 해당, 예: 1달러 = 1,000,000마이크로).

currencyCode

string

ISO 4217에 따른 3글자 약어를 사용하는 가격의 통화입니다.

ProductDetail

제품 세부정보입니다.

JSON 표현
{
  "sectionName": string,
  "attributeName": string,
  "attributeValue": string
}
필드
sectionName

string

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

attributeName

string

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

attributeValue

string

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

ProductWeight

제품의 중량입니다.

JSON 표현
{
  "value": number,
  "unit": string
}
필드
value

number

필수 항목입니다. 숫자로 표시되는 체중입니다. 가중치는 소수점 이하 4자리까지 정확히 표시할 수 있습니다.

unit

string

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

ProductDimension

제품의 크기입니다.

JSON 표현
{
  "value": number,
  "unit": string
}
필드
value

number

필수 항목입니다. 숫자로 표현된 측정기준 값입니다. 값은 소수점 이하 4자리까지 정확히 표시할 수 있습니다.

unit

string

필수 항목입니다. 측정기준 단위입니다. 허용되는 값은 * 'in' * 'cm'입니다.

인증

제품의 인증입니다. 이 속성을 사용하여 제품과 관련된 에너지 효율이 높은 등급과 같은 인증을 설명합니다.

JSON 표현
{
  "name": string,
  "authority": string,
  "code": string
}
필드
name

string

인증 이름입니다. 현재 가장 일반적인 값은 EU 에너지 라벨 등록처(EPREL) 데이터베이스의 에너지 효율 인증을 나타내는 'EPREL'입니다.

authority

string

인증 발급을 담당하는 당국 또는 인증 기관입니다. 현재 EU 에너지 라벨의 경우 가장 일반적인 값은 'EC' 또는 'European_Commission'입니다.

code

string

인증 코드입니다. 예를 들어 링크가 https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456인 EPREL 인증서의 경우 코드는 123456입니다. 이 코드는 유럽 에너지 라벨에 필요하며,

HeadlineOfferInstallment

할부를 나타내는 메시지입니다.

JSON 표현
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  }
}
필드
months

string (int64 format)

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

amount

object (Price)

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

downpayment

object (Price)

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

HeadlineOfferSubscriptionCost

제품의 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 구독 기간이 연 단위임을 나타냅니다.

CustomAttribute

맞춤 속성을 나타내는 메시지입니다. value 또는 groupValues 중 하나만 비어 있지 않아야 합니다.

JSON 표현
{
  "groupValues": [
    {
      object (CustomAttribute)
    }
  ],
  "name": string,
  "value": string
}
필드
groupValues[]

object (CustomAttribute)

이 속성 그룹 내의 하위 속성입니다. groupValues가 비어 있지 않으면 value가 비어 있어야 합니다.

name

string

속성의 이름입니다.

value

string

속성의 값입니다. value가 비어 있지 않으면 groupValues가 비어 있어야 합니다.

CssProductStatus

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

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 표현
{
  "destination": string,
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
필드
destination

string

목적지 이름

approvedCountries[]

string

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

pendingCountries[]

string

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

disapprovedCountries[]

string

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

ItemLevelIssue

제품 상태의 ItemLevelIssue입니다.

JSON 표현
{
  "code": string,
  "servability": string,
  "resolution": string,
  "attribute": string,
  "destination": string,
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
필드
code

string

문제의 오류 코드

servability

string

이 문제가 CSS 제품 게재에 미치는 영향

resolution

string

판매자가 문제를 해결할 수 있는지 여부

attribute

string

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

destination

string

문제가 적용되는 대상 위치.

description

string

간단한 문제 설명(영어)

detail

string

자세한 문제 설명(영어)

documentation

string

이 문제를 해결하는 데 도움이 되는 웹페이지의 URL

applicableCountries[]

string

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

메서드

get

CSS Center 계정에서 처리된 CSS 제품을 가져옵니다.

list

CSS Center 계정에서 처리된 CSS 제품을 나열합니다.