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" } など)で登録するためにも使用できます。これは、API で明示的に公開されていない属性(「Google で購入」で使用される追加属性など)を登録する場合に便利です。

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 で指定しない限り、常に含まれます。

サポートされている値は次のとおりです。- css_ads_experiences - css_organic_experiences

excludedDestinations[]

string

このターゲットで除外する掲載先のリストです(Merchant Center でオフになっているチェックボックスに対応します)。

サポートされている値は次のとおりです。- 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 の商品分類を参照)。商品をクエリする場合、このフィールドにはユーザーが指定した値が含まれます。現在のところ、自動的に割り当てられた Google 商品カテゴリを API で取得する方法はありません。

adult

boolean

商品アイテムが成人向けの場合は true に設定します。

multipack

string (int64 format)

販売者が定めるマルチパックに含まれる同一商品の数量。

isBundle

boolean

商品アイテムが販売者定義の一括販売商品かどうか。一括販売商品とは、販売者が独自に組み合わせた異なる商品を 1 つの価格で販売するものです。

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 USD = 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

認証の名称現時点では、最も一般的な値は「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 Center アカウントから処理済みの CSS 商品を取得します。

list

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