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

出力専用。商品の 2 文字の ISO 639-1 言語コード。
feedLabel

string

出力専用。商品のフィードラベル。
attributes

object (Attributes)

出力専用。商品属性のリスト。
customAttributes[]

object (CustomAttribute)

出力専用。カスタム（CSS 提供）属性のリスト。また、フィード仕様の任意の属性を汎用形式（{ "name": "size type", "value": "regular" } など）で送信するためにも使用できます。これは、「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 より大きく 2,000 以下の範囲で指定する必要があります。
productLength

object (ProductDimension)

指定された単位での商品の長さ。値は 0 より大きく 3,000 以下の範囲で指定する必要があります。
productWidth

object (ProductDimension)

指定された単位での商品の幅。値は 0 より大きく 3,000 以下の範囲で指定する必要があります。
productHeight

object (ProductDimension)

指定された単位での商品の高さ。値は 0 より大きく 3,000 以下の範囲で指定する必要があります。
productHighlights[]

string

商品の最も関連性の高いハイライトを説明する箇条書き。
certifications[]

object (Certification)

特定の製品について CSS が主張する証明書のリスト。
expirationDate

string (Timestamp format)

商品アイテムの有効期限（日付）。挿入時に指定されます。ISO 8601 形式で指定します。実際の有効期限は productstatuses で googleExpirationDate として公開されます。expirationDate が未来の日付である場合は、有効期限が早まる可能性があります。注: アイテムが実際に削除されるまでには、有効期限から 2 日以上かかることがあります。
includedDestinations[]

string

このターゲット向けに含める掲載先のリストです（Merchant Center でオンになっているチェックボックスに対応します）。デフォルトの掲載先は、excludedDestinations で指定しない限り、常に含まれます。
excludedDestinations[]

string

このターゲットで除外する掲載先のリスト（Merchant Center でオフになっているチェックボックスに対応します）。
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

商品のサイズ。指定できる値は 1 つのみです。サイズ違いのバリエーションの場合、サイズごとに別々の商品を挿入し、同じ itemGroupId 値を指定します（[https://support.google.com/merchants/answer/6324492](サイズの定義) を参照）。
sizeSystem

string

サイズが指定されているシステム。ファッション関連の商品アイテムに推奨されます。
itemGroupId

string

同一商品でバリエーションがある場合の共通 ID。
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 桁の [1, 5] のスケールに正規化されます。指定する場合は、reviewCount、minRating、maxRating も必須です。このフィールドは今後の機能のためのものであり、まだ使用されていません。

価格

数値と通貨で表された価格。

JSON 表現 
{
  "amountMicros": string,
  "currencyCode": string
}
フィールド
amountMicros

string (int64 format)

価格をマイクロ単位の数値で表します（100 万マイクロは通貨の 1 単位に相当します。たとえば、1 USD = 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

認証の名称現時点では、最も一般的な値は「EPREL」です。これは、EU の European Registry for Energy Labeling（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 のいずれか 1 つのみを空にしないでください。

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 商品を CSS Center アカウントから取得します。

list

 CSS Center アカウントで処理された CSS 商品が一覧表示されます。