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 (0 제외)에서 2000 (2000 포함) 사이여야 합니다.
productLength

object (ProductDimension)

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

object (ProductDimension)

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

object (ProductDimension)

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

string

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

object (Certification)

지정된 제품에 대해 CSS가 소유권을 주장한 인증서 목록입니다.
expirationDate

string (Timestamp format)

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

string

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

string

이 타겟에서 제외할 대상 유형의 목록입니다 (판매자 센터의 선택되지 않은 체크박스에 해당).
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에 해당함. 예를 들어 1USD = 100만 마이크로).
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 제품을 나열합니다.