REST Resource: accounts.cssProducts

リソース: CssProduct

処理済みの価格比較ページの商品。

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
}
フィールド
lowPrice

object (Price)

価格比較ページの商品の低価格。

highPrice

object (Price)

価格比較ページの商品の高価格。

headlineOfferPrice

object (Price)

価格比較ページの商品のヘッドライン プライス。

headlineOfferShippingPrice

object (Price)

価格比較ページの商品のヘッドライン プライス。

productTypes[]

string

商品のカテゴリ(商品データ仕様の形式)。

sizeTypes[]

string

商品のカット。アパレル商品の組み合わせサイズタイプを表すために使用できます。指定できるサイズタイプは 2 つまでです([https://support.google.com/merchants/answer/6324497](サイズタイプ) をご覧ください)。

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 形式で指定します。実際の有効期限は productstatusesgoogleExpirationDate として公開されます。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。

価格

数値と通貨で表した価格。

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

string (int64 format)

価格をマイクロ単位の数値で表します(100 万マイクロが 1 通貨単位に相当します。たとえば、1 USD = 1000000 マイクロ)。

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 の European Registry for Energy Labeling(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 のいずれか 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 Center アカウントから処理済みの CSS 商品を取得します。

list

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