- リソース: CssProduct
- 属性
- 価格
- ProductDetail
- ProductWeight
- ProductDimension
- 認定資格
- HeadlineOfferInstallment
- HeadlineOfferSubscriptionCost
- SubscriptionPeriod
- CustomAttribute
- CssProductStatus
- DestinationStatus
- ItemLevelIssue
- メソッド
リソース: CssProduct
処理された CSS 商品。
| JSON 表現 |
|---|
{ "name": string, "rawProvidedId": string, "contentLanguage": string, "feedLabel": string, "attributes": { object ( |
| フィールド | |
|---|---|
name |
CSS 商品の名前。形式: |
rawProvidedId |
出力専用。商品の一意の未加工識別子。 |
contentLanguage |
出力専用。商品の 2 文字の ISO 639-1 言語コード。 |
feedLabel |
出力専用。商品のフィードラベル。 |
attributes |
出力専用。商品属性のリスト。 |
customAttributes[] |
出力専用。カスタム(CSS 提供)属性のリスト。また、フィード仕様の任意の属性を一般的な形式( |
cssProductStatus |
出力専用。商品のステータス、データ検証の問題、つまり非同期で計算された商品に関する情報。 |
属性
CSS 商品の属性。
| JSON 表現 |
|---|
{ "lowPrice": { object ( |
| フィールド | |
|---|---|
lowPrice |
CSS 商品の低価格。 |
highPrice |
CSS 商品の高価格。 |
headlineOfferPrice |
CSS 商品のヘッドライン価格。 |
headlineOfferShippingPrice |
CSS 商品のヘッドライン価格。 |
additionalImageLinks[] |
商品アイテムの画像の追加 URL。 |
productTypes[] |
アイテムのカテゴリ(商品データ仕様の形式)。 |
sizeTypes[] |
商品アイテムのカット。衣料品の複合サイズタイプを表すために使用できます。指定できるサイズタイプは 2 つまでです(サイズタイプを参照)。 |
productDetails[] |
技術仕様または商品の詳細。 |
productWeight |
指定された単位での商品の重量。値は 0(指定した値を含まない)~ 2,000(指定した値を含む)の範囲で指定してください。 |
productLength |
指定された単位での商品の長さ。値は 0(指定した値を含まない)~ 3,000(指定した値を含む)の範囲で指定してください。 |
productWidth |
指定された単位での商品の幅。値は 0(指定した値を含まない)~ 3,000(指定した値を含む)の範囲で指定してください。 |
productHeight |
指定された単位での商品の高さ。値は 0(指定した値を含まない)~ 3,000(指定した値を含む)の範囲で指定してください。 |
productHighlights[] |
商品に関する最も関連性の高い情報を箇条書きで説明します。 |
certifications[] |
指定された商品に対して CSS が申請した証明書のリスト。 |
expirationDate |
商品アイテムの有効期限(日付)。挿入時に指定されます。ISO 8601 形式。実際の有効期限は、 |
includedDestinations[] |
このターゲット向けに含める掲載先のリストです(Merchant Center でオンになっているチェックボックスに対応します)。デフォルトの掲載先は、 サポートされている値は次のとおりです。- |
excludedDestinations[] |
このターゲットで除外する掲載先のリストです(Merchant Center でオフになっているチェックボックスに対応します)。 サポートされている値は次のとおりです。- |
headlineOfferInstallment |
商品アイテムの分割払いの回数と金額。 |
headlineOfferSubscriptionCost |
サブスクリプション契約が関連付けられている商品の期間数(月数または年数)と期間あたりの支払い額。 |
cppLink |
CSS の商品の詳細ページに直接リンクしている URL。 |
cppMobileLink |
CSS の商品の詳細ページのモバイル デバイス向けバージョンの URL。 |
cppAdsRedirect |
商品広告のコンテキストで商品が表示される場合に、広告主が商品アイテムの URL をオーバーライドできるようにします。 |
numberOfOffers |
CSS 商品の数。 |
headlineOfferCondition |
ヘッドライン オファーの条件。 |
headlineOfferLink |
ヘッドライン オファーへのリンク。 |
headlineOfferMobileLink |
ヘッドライン オファーへのモバイルリンク。 |
title |
商品アイテムの商品名。 |
imageLink |
商品アイテムの画像の URL。 |
description |
項目の説明。 |
brand |
商品関連の属性。[14-36] 商品アイテムのブランド。 |
mpn |
商品アイテムの商品の製造番号(MPN)。 |
gtin |
商品アイテムの国際取引商品番号(GTIN)。 |
googleProductCategory |
商品アイテムの Google カテゴリ(Google の商品分類を参照)。商品をクエリする場合、このフィールドにはユーザーが指定した値が含まれます。現在のところ、自動的に割り当てられた Google 商品カテゴリを API で取得する方法はありません。 |
adult |
商品アイテムが成人向けの場合は true に設定します。 |
multipack |
販売者が定めるマルチパックに含まれる同一商品の数量。 |
isBundle |
商品アイテムが販売者定義の一括販売商品かどうか。一括販売商品とは、販売者が独自に組み合わせた異なる商品を 1 つの価格で販売するものです。 |
ageGroup |
商品アイテムが対象とする年齢層。 |
color |
商品アイテムの色。 |
gender |
商品アイテムの対象性別。 |
material |
商品アイテムの素材。 |
pattern |
商品の柄(例: 水玉模様)。 |
size |
アイテムのサイズ。指定できる値は 1 つのみです。サイズが異なるバリエーションの場合は、サイズごとに別個の商品を挿入し、同じ |
sizeSystem |
サイズが指定されているシステム。アパレル商品におすすめです。 |
itemGroupId |
同一商品でバリエーションがある場合の共通 ID。 |
pause |
このアイテムの公開は一時的に停止されます。 |
customLabel0 |
ショッピング キャンペーンで商品アイテムのカスタム グループに使用するカスタムラベル 0。 |
customLabel1 |
ショッピング キャンペーンで商品アイテムのカスタム グループに使用するカスタムラベル 1。 |
customLabel2 |
ショッピング キャンペーンで商品アイテムのカスタム グループに使用するカスタムラベル 2。 |
customLabel3 |
ショッピング キャンペーンで商品アイテムのカスタム グループに使用するカスタムラベル 3。 |
customLabel4 |
ショッピング キャンペーンで商品アイテムのカスタム グループに使用するカスタムラベル 4。 |
reviewCount |
商品のレビュー数。 |
minRating |
商品の最小評価スコア。 |
maxRating |
商品の最高評価スコア。 |
rating |
商品の平均評価スコア。値は [ |
価格
数値と通貨で表される価格。
| JSON 表現 |
|---|
{ "amountMicros": string, "currencyCode": string } |
| フィールド | |
|---|---|
amountMicros |
マイクロ単位の数値で表される価格(100 万マイクロは通貨の標準単位に相当します。たとえば、1 USD = 1, 000, 000 マイクロ)。 |
currencyCode |
価格の通貨。ISO 4217 に準拠した 3 文字の略語を使用します。 |
ProductDetail
商品の詳細。
| JSON 表現 |
|---|
{ "sectionName": string, "attributeName": string, "attributeValue": string } |
| フィールド | |
|---|---|
sectionName |
一連の商品の詳細をグループ化するために使用されるセクション ヘッダー。 |
attributeName |
商品の詳細の名前。 |
attributeValue |
商品の詳細の値。 |
ProductWeight
商品の重量。
| JSON 表現 |
|---|
{ "value": number, "unit": string } |
| フィールド | |
|---|---|
value |
必須。数値で表される重み。重みの精度は小数点以下 4 桁までです。 |
unit |
必須。重量の単位。指定できる値は次のとおりです。* " |
ProductDimension
商品の寸法。
| JSON 表現 |
|---|
{ "value": number, "unit": string } |
| フィールド | |
|---|---|
value |
必須。数値で表されるディメンション値。値の精度は小数点以下 4 桁までです。 |
unit |
必須。ディメンションの単位。有効な値は次のとおりです。* " |
認定資格
プロダクトの認証。この属性は、商品に関連する認証(エネルギー効率に優れた評価など)について記述するために使用します。
| JSON 表現 |
|---|
{ "name": string, "authority": string, "code": string } |
| フィールド | |
|---|---|
name |
認証の名称現時点では、最も一般的な値は「EPREL」です。これは、EU の European Registry for Energy Labeling(EPREL)データベースのエネルギー効率認証を表します。 |
authority |
認証を発行する権限を有する機関または認証機関。現時点では、EU のエネルギー ラベルの最も一般的な値は「EC」または「European_Commission」です。 |
code |
認証のコード。たとえば、リンクが https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456 の EPREL 認証の場合、コードは 123456 です。このコードは欧州エネルギー ラベルに必要です。 |
HeadlineOfferInstallment
分割払いを表すメッセージ。
| JSON 表現 |
|---|
{ "months": string, "amount": { object ( |
| フィールド | |
|---|---|
months |
購入者が支払う分割回数です。 |
amount |
購入者が毎月支払う金額。 |
downpayment |
購入者が最初に支払う頭金の金額。 |
HeadlineOfferSubscriptionCost
商品の SubscriptionCost。
| JSON 表現 |
|---|
{ "period": enum ( |
| フィールド | |
|---|---|
period |
サブスクリプション期間のタイプ。サポートされている値は次のとおりです。* " |
periodLength |
購入者が支払う定期購入の期間数。 |
amount |
購入者が定期購入期間ごとに支払う金額。 |
SubscriptionPeriod
商品の定期購入期間。
| 列挙型 | |
|---|---|
SUBSCRIPTION_PERIOD_UNSPECIFIED |
サブスクリプション期間が指定されていないことを示します。 |
MONTH |
サブスクリプション期間が月単位であることを示します。 |
YEAR |
定期購入期間が年単位であることを示します。 |
CustomAttribute
カスタム属性を表すメッセージ。value または groupValues のいずれか 1 つのみを空にしないでください。
| JSON 表現 |
|---|
{
"groupValues": [
{
object ( |
| フィールド | |
|---|---|
groupValues[] |
この属性グループ内のサブ属性。 |
name |
属性名。 |
value |
属性の値。 |
CssProductStatus
CSS 商品のステータス、データ検証の問題(非同期で計算された CSS 商品に関する情報)。
| JSON 表現 |
|---|
{ "destinationStatuses": [ { object ( |
| フィールド | |
|---|---|
destinationStatuses[] |
商品アイテムの宛先。 |
itemLevelIssues[] |
商品に関連するすべての問題のリスト。 |
creationDate |
アイテムが作成された日付(ISO 8601 形式)。 |
lastUpdateDate |
アイテムが最後に更新された日付(ISO 8601 形式)。 |
googleExpirationDate |
商品アイテムの有効期限。ISO 8601 形式で指定します。 |
DestinationStatus
商品ステータスの掲載先のステータス。
| JSON 表現 |
|---|
{ "destination": string, "approvedCountries": [ string ], "pendingCountries": [ string ], "disapprovedCountries": [ string ] } |
| フィールド | |
|---|---|
destination |
宛先の名前 |
approvedCountries[] |
CSS 商品が承認されている国コード(ISO 3166-1 alpha-2)のリスト。 |
pendingCountries[] |
CSS 商品が承認待ちの国コード(ISO 3166-1 alpha-2)のリスト。 |
disapprovedCountries[] |
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 |
問題のエラーコード。 |
servability |
この問題による CSS 商品のサービスへの影響。 |
resolution |
販売者側で問題が解決可能かどうか。 |
attribute |
属性名(問題の原因が単一属性の場合)。 |
destination |
問題の適用先。 |
description |
問題の簡単な説明(英語)。 |
detail |
問題の詳しい説明(英語)。 |
documentation |
この問題の解決に役立つウェブページの URL。 |
applicableCountries[] |
CSS 商品に問題が適用される国コード(ISO 3166-1 alpha-2)のリスト。 |
メソッド |
|
|---|---|
|
CSS Center アカウントから処理済みの CSS 商品を取得します。 |
|
CSS Center アカウントで処理された CSS 商品を一覧表示します。 |