REST Resource: accounts.products

リソース: Product

ルールと補助データソースを適用した後、複数の [product input][[google.shopping.content.bundles.Products.ProductInput] から構築された処理済みの商品。処理された商品は、Merchant Center アカウント、ショッピング広告、その他の Google 掲載に表示される商品と一致します。各プロダクトは、1 つのプライマリ データソース プロダクト入力と、複数の補助データソース入力から構築されています。商品入力を挿入、更新、または削除した後、更新された処理済みの商品を取得できるようになるまでに数分かかることがあります。

処理された商品とそのサブメッセージのすべてのフィールドは、一部の例外を除き、商品データ仕様の対応する属性の名前と一致します。

JSON 表現 
{
  "name": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
フィールド
name

string

商品の名前。形式: "{product.name=accounts/{account}/products/{product}}"
channel

enum (ChannelEnum)

出力専用。商品のチャネル。
offerId

string

出力専用。商品の一意の識別子です。商品入力と処理済み商品についても同様です。送信時に先頭と末尾の空白文字は削除され、複数の空白文字は 1 つの空白文字に置き換えられます。詳しくは、商品データ仕様をご覧ください。
contentLanguage

string

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

string

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

string

出力専用。商品のメイン データソース。
attributes

object (Attributes)

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

object (CustomAttribute)

出力専用。カスタム（販売者指定）属性のリスト。また、データ仕様の任意の属性を汎用形式で登録するためにも使用できます（例: { "name": "size type", "value": "regular" }）。これは、「Google で購入」で使用される追加の属性など、API で明示的に公開されていない属性を登録する場合に便利です。
productStatus

object (ProductStatus)

出力専用。商品のステータス、データ検証の問題、つまり非同期で計算された商品に関する情報です。
versionNumber

string (int64 format)

出力専用。商品の既存のバージョン（新しさ）を表します。複数の更新が同時に行われたときに正しい順序を保持するために使用できます。

設定すると、バージョン番号が既存のプロダクトの現在のバージョン番号よりも小さい場合、挿入できなくなります。再挿入（30 日後に商品を更新するなど）は、現在の versionNumber で実行できます。

メイン データソースへの挿入でのみサポートされます。

オペレーションが阻止されると、中止された例外がスローされます。

属性

属性。

JSON 表現 
{
  "additionalImageLinks": [
    string
  ],
  "expirationDate": string,
  "disclosureDate": string,
  "availabilityDate": string,
  "price": {
    object (Price)
  },
  "installment": {
    object (Installment)
  },
  "subscriptionCost": {
    object (SubscriptionCost)
  },
  "loyaltyPoints": {
    object (LoyaltyPoints)
  },
  "loyaltyPrograms": [
    {
      object (LoyaltyProgram)
    }
  ],
  "productTypes": [
    string
  ],
  "salePrice": {
    object (Price)
  },
  "salePriceEffectiveDate": {
    object (Interval)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productWeight": {
    object (ProductWeight)
  },
  "shipping": [
    {
      object (Shipping)
    }
  ],
  "freeShippingThreshold": [
    {
      object (FreeShippingThreshold)
    }
  ],
  "shippingWeight": {
    object (ShippingWeight)
  },
  "shippingLength": {
    object (ShippingDimension)
  },
  "shippingWidth": {
    object (ShippingDimension)
  },
  "shippingHeight": {
    object (ShippingDimension)
  },
  "sizeTypes": [
    string
  ],
  "taxes": [
    {
      object (Tax)
    }
  ],
  "unitPricingMeasure": {
    object (UnitPricingMeasure)
  },
  "unitPricingBaseMeasure": {
    object (UnitPricingBaseMeasure)
  },
  "adsLabels": [
    string
  ],
  "costOfGoodsSold": {
    object (Price)
  },
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productHighlights": [
    string
  ],
  "displayAdsSimilarIds": [
    string
  ],
  "promotionIds": [
    string
  ],
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "shoppingAdsExcludedCountries": [
    string
  ],
  "lifestyleImageLinks": [
    string
  ],
  "cloudExportAdditionalProperties": [
    {
      object (CloudExportAdditionalProperties)
    }
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "autoPricingMinPrice": {
    object (Price)
  },
  "identifierExists": boolean,
  "isBundle": boolean,
  "title": string,
  "description": string,
  "link": string,
  "mobileLink": string,
  "canonicalLink": string,
  "imageLink": string,
  "adult": boolean,
  "ageGroup": string,
  "availability": string,
  "brand": string,
  "color": string,
  "condition": string,
  "gender": string,
  "googleProductCategory": string,
  "gtin": string,
  "itemGroupId": string,
  "material": string,
  "mpn": string,
  "pattern": string,
  "sellOnGoogleQuantity": string,
  "maxHandlingTime": string,
  "minHandlingTime": string,
  "shippingLabel": string,
  "transitTimeLabel": string,
  "size": string,
  "sizeSystem": string,
  "taxCategory": string,
  "energyEfficiencyClass": string,
  "minEnergyEfficiencyClass": string,
  "maxEnergyEfficiencyClass": string,
  "multipack": string,
  "adsGrouping": string,
  "adsRedirect": string,
  "displayAdsId": string,
  "displayAdsTitle": string,
  "displayAdsLink": string,
  "displayAdsValue": number,
  "pickupMethod": string,
  "pickupSla": string,
  "linkTemplate": string,
  "mobileLinkTemplate": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "externalSellerId": string,
  "pause": string,
  "virtualModelLink": string,
  "structuredTitle": {
    object (ProductStructuredTitle)
  },
  "structuredDescription": {
    object (ProductStructuredDescription)
  }
}
フィールド
expirationDate

string (Timestamp format)

商品アイテムの有効期限が切れる日付。挿入時に指定されます（ISO 8601 形式）。実際の有効期限は、productstatuses で googleExpirationDate として公開されていますが、expirationDate が遠すぎる場合は、それより早く公開される場合があります。
disclosureDate

string (Timestamp format)

Google の YouTube サーフェスで検索結果に特典が表示される日時（ISO 8601 形式）。詳しくは、[掲載開始日]（https://support.google.com/merchants/answer/13034208）をご覧ください。
availabilityDate

string (Timestamp format)

予約を受け付けた商品の発送が可能になる日（ISO 8601 形式）。
price

object (Price)

商品アイテムの価格。
installment

object (Installment)

アイテムに対する分割払いの回数と金額。
subscriptionCost

object (SubscriptionCost)

定期購入契約が関連付けられているアイテムの期間数（月数または年数）と期間あたりのお支払い額。
loyaltyPoints

object (LoyaltyPoints)

ユーザーが商品を購入した後に受け取るポイント。日本国内のみ対応。
loyaltyPrograms[]

object (LoyaltyProgram)

ポイント プログラムの特典（よりお得な価格、ポイントなど）をこのアイテムのユーザーに表示するために使用されるポイント プログラム情報のリスト。
productTypes[]

string

商品アイテムのカテゴリ（商品データ仕様の形式）。
salePrice

object (Price)

商品アイテムの公表販売価格。
salePriceEffectiveDate

object (Interval)

商品アイテムの販売期間（商品データ仕様をご覧ください）。
productHeight

object (ProductDimension)

商品の高さ（指定された単位で単位）。値は 0（0 を除く）～ 3000（両端を含む）の範囲で指定してください。
productLength

object (ProductDimension)

商品の長さ（単位: 単位）。値は 0（0 を除く）～ 3000（両端を含む）の範囲で指定してください。
productWidth

object (ProductDimension)

指定された単位での商品の幅。値は 0（0 を除く）～ 3000（両端を含む）の範囲で指定してください。
productWeight

object (ProductWeight)

商品の重量（指定された単位）。値は 0（0 を除く）～ 2000（両端を含む）の範囲で指定してください。
shipping[]

object (Shipping)

送料ルール。
freeShippingThreshold[]

object (FreeShippingThreshold)

商品が送料無料の対象となる条件です。
shippingWeight

object (ShippingWeight)

配送する商品の重量。
shippingLength

object (ShippingDimension)

配送する商品の長さ。
shippingWidth

object (ShippingDimension)

配送する商品アイテムの幅。
shippingHeight

object (ShippingDimension)

配送する商品の高さ。
sizeTypes[]

string

商品の形状。ファッション関連商品のサイズタイプの組み合わせを表すために使用できます。最大 2 つのサイズタイプを指定できます（[https://support.google.com/merchants/answer/6324497](size type) をご覧ください）。
taxes[]

object (Tax)

税務情報。
unitPricingMeasure

object (UnitPricingMeasure)

アイテムの計量単位と寸法。
unitPricingBaseMeasure

object (UnitPricingBaseMeasure)

単価の分母の設定。
adsLabels[]

string

adsGrouping に似ていますが、CPC に対してのみ機能します。
costOfGoodsSold

object (Price)

売上原価。売上総利益のレポートに使用されます。
productDetails[]

object (ProductDetail)

技術仕様またはその他の商品の詳細。
productHighlights[]

string

箇条書きの項目は、商品の特に重要なポイントを表します。
displayAdsSimilarIds[]

string

広告主様が指定した最適化案。
promotionIds[]

string

プロモーションの一意の ID。
includedDestinations[]

string

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

string

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

string

ショッピング広告の掲載先から商品情報を除外する国コード（ISO 3166-1 alpha-2）のリスト。このリストに含まれている国は、データソースの設定で指定した国から削除されます。
cloudExportAdditionalProperties[]

object (CloudExportAdditionalProperties)

Cloud Retail プログラムにエクスポートする追加フィールド。
certifications[]

object (Certification)

商品の認証（例: EU EPREL データベースに記録された商品のエネルギー効率ラベル）。詳しくは、ヘルプセンターの記事をご覧ください。
autoPricingMinPrice

object (Price)

「自動割引」（https://support.google.com/merchants/answer/10295759）および「動的プロモーション」（https://support.google.com/merchants/answer/13949249）プロジェクトにおける安全保護対策。販売者の商品の割引がこの値を下回らないようにすることで、商品の価値と収益性を維持します。
identifierExists

boolean

GTIN、MPN、ブランドなど、カテゴリに適した固有商品 ID が商品アイテムにない場合、この値を false に設定します。指定しない場合のデフォルトは true です。
isBundle

boolean

商品アイテムが販売者が定める一括販売であるかどうかを表します。一括販売商品とは、販売者が単一の価格で販売するさまざまな商品のカスタム グループです。
title

string

商品アイテムのタイトル。
description

string

項目の説明。
adult

boolean

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

string

商品アイテムの年齢層。
availability

string

商品アイテムの在庫状況。
brand

string

商品アイテムのブランド。
color

string

商品アイテムの色。
condition

string

商品アイテムの状態。
gender

string

商品アイテムのターゲットの性別。
googleProductCategory

string

Google の商品アイテムのカテゴリ（Google の商品分類をご覧ください）。商品をクエリする場合、このフィールドにはユーザーが指定した値が含まれます。現時点では、自動的に割り当てられた Google 商品カテゴリを API を使用して復元する方法はありません。
gtin

string

商品アイテムの国際取引商品番号（GTIN）。
itemGroupId

string

同じ商品のすべてのバリエーションに共通の ID。
material

string

商品の素材。
mpn

string

商品アイテムの製造番号（MPN）。
pattern

string

商品アイテムの柄（水玉など）。
sellOnGoogleQuantity

string (int64 format)

Google で販売できる商品の数量。オンライン商品でのみサポートされています。
maxHandlingTime

string (int64 format)

商品の最長発送準備時間（営業日数）。
minHandlingTime

string (int64 format)

商品の最短発送準備時間（営業日数）。
shippingLabel

string

商品の送料ラベル。アカウント単位の送料ルールで商品をグループ化するために使用します。
transitTimeLabel

string

商品のお届け日数ラベル。アカウント単位のお届け日数表で商品をグループ化するために使用します。
size

string

商品アイテムのサイズ。指定できる値は 1 つのみです。サイズが異なるバリエーションがある場合は、サイズごとに同じ itemGroupId 値を持つ個別の商品を挿入します（[https://support.google.com/merchants/answer/6324492]（サイズ定義）をご覧ください）。
sizeSystem

string

サイズを指定するシステム。ファッション関連商品に推奨されます。
taxCategory

string

商品の税のカテゴリ。アカウント レベルの税金設定で税金のネクサスを詳細に設定するために使用します。
energyEfficiencyClass

string

EU 指令 2010/30/EU で定義されている省エネ性能。
minEnergyEfficiencyClass

string

EU 指令 2010/30/EU で定義されている省エネ性能。
maxEnergyEfficiencyClass

string

EU 指令 2010/30/EU で定義されている省エネ性能。
multipack

string (int64 format)

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

string

アイテムを任意の方法でグループ化するために使用します。割合によるコンバージョン単価でのみ使用します。それ以外の場合は使用しないでください。
adsRedirect

string

商品広告のコンテキスト内に商品が表示される場合、広告主はアイテムの URL をオーバーライドできます。
displayAdsId

string

動的リマーケティング キャンペーン向けの商品アイテムの ID。
displayAdsTitle

string

動的リマーケティング キャンペーンの商品アイテムのタイトル。
displayAdsValue

number

動的リマーケティング キャンペーンの利益率
pickupMethod

string

商品アイテムの受け取りオプション。
pickupSla

string

店舗受け取りのタイムライン。
customLabel0

string

カスタムラベル 0: ショッピング キャンペーンの商品アイテムのカスタムグループ化に使用します。
customLabel1

string

カスタムラベル 1: ショッピング キャンペーンの商品アイテムのカスタムグループ化に使用します。
customLabel2

string

カスタムラベル 2: ショッピング キャンペーンの商品アイテムのカスタムグループ化に使用します。
customLabel3

string

カスタムラベル 3: ショッピング キャンペーンの商品アイテムのカスタムグループ化に使用します。
customLabel4

string

カスタムラベル 4: ショッピング キャンペーンの商品アイテムのカスタムグループ化に使用します。
externalSellerId

string

複数販売者アカウントの場合は必須です。ショッピングモールで、さまざまな販売者の商品を複数販売者アカウントにアップロードしている場合は、この属性を使用します。
pause

string

このアイテムの公開は一時的に一時停止されます。
structuredTitle

object (ProductStructuredTitle)

アルゴリズム（AI）によって生成されたタイトル用の構造化されたタイトル。
structuredDescription

object (ProductStructuredDescription)

アルゴリズム（AI）によって生成された説明用の構造化された説明。

分割払い

分割払いを表すメッセージ。

JSON 表現 
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  },
  "creditType": string
}
フィールド
months

string (int64 format)

購入代金の分割回数です。
amount

object (Price)

購入者が毎月支払う金額。
downpayment

object (Price)

購入者が支払う前払い金額の金額。
creditType

string

分割払いの種類。サポートされている値: * "finance" * "lease"

SubscriptionCost

商品の 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 サブスクリプション期間が年であることを示します。

LoyaltyPoints

ポイントを表すメッセージ。

JSON 表現 
{
  "name": string,
  "pointsValue": string,
  "ratio": number
}
フィールド
name

string

ポイント プログラムの名前。名前は全角 12 文字またはローマ字 24 文字までにすることをおすすめします。
pointsValue

string (int64 format)

販売店のポイント（絶対値）。
ratio

number

ポイントを金額に換算するときの率。通貨は Merchant Center の設定に基づきます。比率を指定しないと、デフォルトの 1.0 になります。

LoyaltyProgram

ポイント プログラムを表すメッセージ。

JSON 表現 
{
  "programLabel": string,
  "tierLabel": string,
  "price": {
    object (Price)
  },
  "cashbackForFutureUse": {
    object (Price)
  },
  "loyaltyPoints": string
}
フィールド
programLabel

string

ポイント プログラムのラベル。これは、販売者のエンティティとポイント プログラム エンティティの関係を一意に識別する内部ラベルです。ラベルは、システムが以下のアセット（価格、ポイントなど）を販売者に関連付けるために指定する必要があります。対応するプログラムが販売アカウントにリンクされている必要があります。
tierLabel

string

ポイント プログラム内のレベルのラベル。プログラム内のラベルのいずれかと一致する必要があります。
price

object (Price)

特定の階層のメンバーの料金（インスタント割引料金）。通常価格以下の値を指定してください。
cashbackForFutureUse

object (Price)

今後の購入に使用できるキャッシュバック。
loyaltyPoints

string (int64 format)

購入で獲得したポイント数。

ProductDimension

商品の寸法。

JSON 表現 
{
  "value": number,
  "unit": string
}
フィールド
value

number

必須。数値で表されるディメンション値。値の最大精度は小数点以下 4 桁です。
unit

string

必須。ディメンションの単位。有効な値: * "in" * "cm"

ProductWeight

商品の重量。

JSON 表現 
{
  "value": number,
  "unit": string
}
フィールド
value

number

必須。数値で表される重み。重みの最大精度は小数点以下 4 桁です。
unit

string

必須。重量の単位。指定できる値は次のとおりです。* "g" * "kg" * "oz" * "lb"

配送

商品の送料。

JSON 表現 
{
  "price": {
    object (Price)
  },
  "country": string,
  "region": string,
  "service": string,
  "locationId": string,
  "locationGroupName": string,
  "postalCode": string,
  "minHandlingTime": string,
  "maxHandlingTime": string,
  "minTransitTime": string,
  "maxTransitTime": string
}
フィールド
price

object (Price)

数値で表される固定送料。
country

string

商品アイテムの配送先国の CLDR 地域コード。
region

string

送料が適用される地域。詳細については、リージョンをご覧ください。
service

string

サービスクラスまたは配送日数に関する自由形式の説明。
locationId

string (int64 format)

AdWords API で定義された送料が適用される地域の数値 ID。
locationGroupName

string

送料が適用される地域。地域グループ名で指定します。
postalCode

string

送料を適用する郵便番号の範囲です。郵便番号、郵便番号の接頭辞の後にワイルドカード * を付けたもの、2 つの郵便番号の範囲、または長さが同じ 2 つの郵便番号範囲です。
minHandlingTime

string (int64 format)

注文を受けてから発送するまでの最短発送準備時間（日数を含む）。0 は、注文が受付終了時間より前に行われた場合、商品が入荷と同じ日に発送されることを意味します。[minHandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] は、[maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] とのみ一緒に指定できますが、[maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] を指定する場合は必須ではありません。
maxHandlingTime

string (int64 format)

注文が受け取られてから発送されるまでの営業日における最長発送準備時間（両端を含む）。0 は、注文が受付終了時間より前に行われた場合、商品が入荷と同じ日に発送されることを意味します。配送所要日数を指定する場合は、[maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] と [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] の両方が必要です。[maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] が指定されている場合、[minHandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] は省略できます。
minTransitTime

string (int64 format)

注文の発送から配達までの最短お届け日数（営業日数を含む）。0 は、注文が発送と同じ日に配達されることを意味します。[minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] は [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] とのみ一緒に存在できます。[maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] が存在する場合は必須ではありません。
maxTransitTime

string (int64 format)

注文の発送から配送までの最長お届け日数（営業日を含む）。0 は、注文が発送と同じ日に配達されることを意味します。配送所要日数を指定する場合は、[maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] と [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] の両方が必要です。[maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] が指定されている場合、[minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] はオプションです。

FreeShippingThreshold

商品が送料無料の対象となる条件です。

JSON 表現 
{
  "country": string,
  "priceThreshold": {
    object (Price)
  }
}
フィールド
country

string

商品アイテムの配送先国の CLDR 地域コード。
priceThreshold

object (Price)

送料が無料になる最低商品価格。数値で表されます。

ShippingWeight

商品の ShippingWeight です。

JSON 表現 
{
  "value": number,
  "unit": string
}
フィールド
value

number

商品アイテムの送料の計算に使用する商品の重量。
unit

string

値の単位。

ShippingDimension

商品の ShippingDimension。

JSON 表現 
{
  "value": number,
  "unit": string
}
フィールド
value

number

商品アイテムの送料を計算するために使用される商品の寸法。
unit

string

値の単位。

税

商品の税金。

JSON 表現 
{
  "rate": number,
  "country": string,
  "region": string,
  "taxShip": boolean,
  "locationId": string,
  "postalCode": string
}
フィールド
rate

number

商品価格に適用される税率のパーセンテージ。
country

string

商品アイテムが課税される国で、CLDR 地域コードで指定します。
region

string

税率が適用される地域。
taxShip

boolean

送料に税金がかかる場合は true に設定します。
locationId

string (int64 format)

AdWords API で定義された税率が適用される地域の数値 ID。
postalCode

string

税率が適用される郵便番号の範囲です。郵便番号、ワイルドカード「*」を使用した郵便番号の接頭辞、2 つの郵便番号間の範囲、または 2 つの同じ長さの郵便番号の接頭辞です。例: 94114、94*、94002-95460、94*-95*。

UnitPricingMeasure

商品の UnitPricingMeasure。

JSON 表現 
{
  "value": number,
  "unit": string
}
フィールド
value

number

商品アイテムの計量単位。
unit

string

単位。

UnitPricingBaseMeasure

商品の UnitPricingBaseMeasure。

JSON 表現 
{
  "value": string,
  "unit": string
}
フィールド
value

string (int64 format)

単価の分母。
unit

string

分母の単位。

ProductDetail

商品の詳細。

JSON 表現 
{
  "sectionName": string,
  "attributeName": string,
  "attributeValue": string
}
フィールド
sectionName

string

一連の商品の詳細をグループ化するために使用するセクション ヘッダー。
attributeName

string

商品の詳細の名前。
attributeValue

string

商品の詳細の値。

CloudExportAdditionalProperties

Cloud Retail API の商品プロパティ。たとえば、テレビ商品のプロパティとして「Screen-Resolution」や「Screen-Size」などを指定できます。

JSON 表現 
{
  "textValue": [
    string
  ],
  "intValue": [
    string
  ],
  "floatValue": [
    number
  ],
  "propertyName": string,
  "boolValue": boolean,
  "minValue": number,
  "maxValue": number,
  "unitCode": string
}
フィールド
textValue[]

string

指定されたプロパティのテキスト値。たとえば、テレビの場合は「8K（UHD）」がテキスト値になります。この値の最大繰り返し数は 400 です。値は任意だが、一貫した順序で格納されます。文字列の最大サイズは 256 文字です。
intValue[]

string (int64 format)

指定されたプロパティの整数値。たとえば、テレビ製品の画面解像度の場合は 1080 です。この値の最大繰り返し数は 400 です。値は任意だが、一貫した順序で格納されます。
floatValue[]

number

指定されたプロパティの浮動小数点数値。たとえば、テレビ商品の場合は 1.2345 です。この値の最大繰り返し数は 400 です。値は任意だが、一貫した順序で格納されます。
propertyName

string

指定されたプロパティの名前。たとえば、テレビ商品の場合は「Screen-Resolution」と指定します。文字列の最大サイズは 256 文字です。
boolValue

boolean

指定されたプロパティのブール値。たとえば、テレビ製品の場合は、画面が UHD の場合は「True」または「False」を指定します。
minValue

number

指定されたプロパティの浮動小数点数の最小値。たとえば、テレビ商品の場合は 1.00 です。
maxValue

number

指定されたプロパティの最大浮動小数点値。たとえば、テレビ商品の場合は 100.00 です。
unitCode

string

指定されたプロパティの単位。たとえば、テレビ商品の場合は「Pixels」となります。文字列の最大サイズは 256 バイトです。

認定

商品の認証: 当初は EU EPREL データベースを使用した EU エネルギー効率ラベルの遵守のために導入されました。

JSON 表現 
{
  "certificationAuthority": string,
  "certificationName": string,
  "certificationCode": string,
  "certificationValue": string
}
フィールド
certificationAuthority

string

認証局（例: European_Commission）。最大文字数は 2,000 文字です。
certificationName

string

認証の名称（「EPREL」など）。最大文字数は 2,000 文字です。
certificationCode

string

認証コード。最大文字数は 2,000 文字です。
certificationValue

string

認定資格の値（クラス、レベル、学年とも呼ばれます）。例: 「A+」、「C」、「ゴールド」。最大文字数は 2,000 文字です。

ProductStructuredTitle

アルゴリズム（AI）によって生成されたタイトル用の構造化されたタイトル。

JSON 表現 
{
  "digitalSourceType": string,
  "content": string
}
フィールド
digitalSourceType

string

デジタルソースのタイプ（例: 「trained_algorithmic_media」）。IPTC に準拠している。最大文字数は 40 文字です。
content

string

タイトル テキストの最大文字数は 150 文字です

ProductStructuredDescription

アルゴリズム（AI）によって生成された説明用の構造化された説明。

JSON 表現 
{
  "digitalSourceType": string,
  "content": string
}
フィールド
digitalSourceType

string

デジタルソースのタイプ（例: 「trained_algorithmic_media」）。IPTC に準拠している。最大文字数は 40 文字です。
content

string

説明文は最大 5,000 文字です

ProductStatus

商品のステータス、データ検証の問題、つまり非同期で計算された商品に関する情報です。

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 表現 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
フィールド
reportingContext

enum (ReportingContextEnum)

レポート コンテキストの名前。
approvedCountries[]

string

オファーが承認された国コード（ISO 3166-1 alpha-2）のリスト。
pendingCountries[]

string

オファーが承認待ちの国コード（ISO 3166-1 alpha-2）のリスト。
disapprovedCountries[]

string

商品が不承認となる国コード（ISO 3166-1 alpha-2）のリスト。

ItemLevelIssue

商品ステータスの ItemLevelIssue。

JSON 表現 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
フィールド
code

string

問題のエラーコード。
severity

enum (Severity)

この問題が特典の提供に及ぼす影響
resolution

string

販売者が問題を解決できるかどうか。
attribute

string

属性の名前（問題の原因が 1 つの属性の場合）。
reportingContext

enum (ReportingContextEnum)

問題が適用される報告のコンテキスト。
description

string

問題の簡単な説明（英語）。
detail

string

問題の詳細な説明（英語）。
documentation

string

この問題の解決に役立つウェブページの URL。
applicableCountries[]

string

問題がクーポンに適用される国コード（ISO 3166-1 alpha-2）のリスト。

重大度

問題が商品の配信にどのように影響するか。

列挙型
SEVERITY_UNSPECIFIED 指定されていません。
NOT_IMPACTED この問題は警告であり、商品に直接影響することはありません。
DEMOTED プロダクトの順位が下がり、検索結果でのパフォーマンスが制限される可能性が高い
DISAPPROVED 問題により商品が不承認となる。

メソッド

get

 処理された商品を Merchant Center アカウントから取得します。

list

 Merchant Center アカウントにある処理済みの商品が一覧表示されます。