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
}
필드
lowPrice

object (Price)

CSS 제품의 최저가입니다.
highPrice

object (Price)

CSS 제품의 높은 가격
headlineOfferPrice

object (Price)

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

object (Price)

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

string

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

string

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

object (ProductDetail)

기술 사양 또는 추가 제품 세부정보
productWeight

object (ProductWeight)

제공된 단위로 표시된 제품의 중량입니다. 값은 0 (0 제외)~2000 (2000 포함) 사이여야 합니다.
productLength

object (ProductDimension)

제공된 단위로 표시된 제품의 길이입니다. 값은 0 (0 제외)~3,000 (3,000 포함) 사이여야 합니다.
productWidth

object (ProductDimension)

제공된 단위로 표시된 제품의 너비입니다. 값은 0 (0 제외)~3,000 (3,000 포함) 사이여야 합니다.
productHeight

object (ProductDimension)

제공된 단위로 표시된 제품의 높이입니다. 값은 0 (0 제외)~3,000 (3,000 포함) 사이여야 합니다.
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입니다.

가격

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

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 제품을 표시합니다.