REST Resource: accounts.products

资源:Product

已处理的商品,在应用规则和补充数据源后根据多项 [商品输入][[google.shopping.content.bundles.Products.ProductInput] 构建而成。处理后的商品与您的 Merchant Center 账号、购物广告和其他“Google 平台呈现”中显示的商品一致。每个产品都基于一个主要数据源产品输入和多个补充数据源输入。插入、更新或删除输入的商品后,可能需要几分钟才能检索到更新后的已处理商品。

已处理的商品及其子消息中的所有字段均与商品数据规范中相应属性名称一致,但也有一些例外情况。

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

仅限输出。商品的唯一标识符。输入的商品和已处理的商品也是如此。提交后,开头和结尾的空格会被去掉,并且多个空格会被一个空格替换。如需了解详情,请参阅商品数据规范

contentLanguage

string

仅限输出。商品的双字母 ISO 639-1 语言代码。

feedLabel

string

仅限输出。产品的 Feed 标签。

dataSource

string

仅限输出。商品的主要数据源。

attributes

object (Attributes)

仅限输出。产品属性列表。

customAttributes[]

object (CustomAttribute)

仅限输出。自定义(商家提供的)属性列表。它还可用于以通用形式提交数据规范的任何属性(例如 { "name": "size type", "value": "regular" })。如果您要提交该 API 未明确公开的属性(例如用于“Google 易购”的其他属性),此功能会非常有用。

productStatus

object (ProductStatus)

仅限输出。商品状态、数据验证问题,即异步计算的商品相关信息。

versionNumber

string (int64 format)

仅限输出。表示商品的现有版本(新鲜度),可用于在同时进行多项更新时保持正确的顺序。

如果设置了此字段,则在版本号低于现有产品的当前版本号时,系统会阻止插入。您可以使用当前的 versionNumber 重新插入数据(例如,在 30 天后刷新产品)。

仅支持插入主要数据源。

如果操作被阻止,则会抛出已中止的异常。

属性

属性。

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(不含)到 3000(含)之间。

productLength

object (ProductDimension)

商品的长度(以提供的单位表示)。该值必须介于 0(不含)到 3000(含)之间。

productWidth

object (ProductDimension)

商品的宽度(以提供的单位表示)。该值必须介于 0(不含)到 3000(含)之间。

productWeight

object (ProductWeight)

商品的重量(以提供的单位表示)。该值必须介于 0(不含)到 2000(含)之间。

shipping[]

object (Shipping)

配送规则。

freeShippingThreshold[]

object (FreeShippingThreshold)

商品免运费需满足的条件。

shippingWeight

object (ShippingWeight)

要运送的商品的重量。

shippingLength

object (ShippingDimension)

要运送的商品的长度。

shippingWidth

object (ShippingDimension)

要运送的商品的宽度。

shippingHeight

object (ShippingDimension)

要运送的商品的高度。

sizeTypes[]

string

商品的裁剪。它可用于表示服饰商品的组合尺码类型。最多可以提供两种尺寸类型(请参阅 [https://support.google.com/merchants/answer/6324497](size type))。

taxes[]

object (Tax)

税务信息。

unitPricingMeasure

object (UnitPricingMeasure)

商品的计量单位和尺寸。

unitPricingBaseMeasure

object (UnitPricingBaseMeasure)

单价分母的偏好。

adsLabels[]

string

与 adsGrouping 类似,但仅适用于每次点击费用。

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)

商品认证,例如在欧盟 EPREL 数据库中记录的商品能效标识。如需了解详情,请参阅帮助中心中的相关文章。

autoPricingMinPrice

object (Price)

“自动折扣”中的保护措施(https://support.google.com/merchants/answer/10295759) 和“动态促销”(https://support.google.com/merchants/answer/13949249) 项目,确保商家因此,优惠的价值和盈利能力不会低于该值。

identifierExists

boolean

如果商品没有与其类别对应的唯一商品标识码(如 GTIN、MPN 和品牌),请将此值设为 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 商品类目)。查询商品时,此字段将包含用户提供的值。目前,您无法通过该 API 取回自动分配的 Google 商品类别。

gtin

string

商品的全球贸易项目代码 (GTIN)。

itemGroupId

string

同一商品的所有款式/规格的共用标识符。

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

商品的尺寸。只允许添加一个值。对于具有不同尺寸的款式/规格,请使用相同的 itemGroupId 值(请参阅 [https://support.google.com/merchants/answer/6324492] 尺寸定义)为每种尺寸插入单独的商品。

sizeSystem

string

用于指定大小的系统。建议为服饰商品提供。

taxCategory

string

商品的税种,用于在账号级税费设置中配置详细的税费直接关系。

energyEfficiencyClass

string

欧盟指令 2010/30/EU 中定义的能效等级。

minEnergyEfficiencyClass

string

欧盟指令 2010/30/EU 中定义的能效等级。

maxEnergyEfficiencyClass

string

欧盟指令 2010/30/EU 中定义的能效等级。

multipack

string (int64 format)

商家定义的多件组合装中相同商品的数量。

adsGrouping

string

用于以任意方式对内容进行分组。仅针对每次转化费用百分比出价,不推荐使用。

adsRedirect

string

当商品在产品广告中展示时,允许广告客户覆盖商品网址。

displayAdsId

string

动态再营销广告系列商品的标识符。

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

积分与货币的兑换比率。Google 会根据 Google Merchant Center 设置假定货币。如果未填写兑换率,则默认为 1.0。

LoyaltyProgram

表示会员卡的消息。

JSON 表示法
{
  "programLabel": string,
  "tierLabel": string,
  "price": {
    object (Price)
  },
  "cashbackForFutureUse": {
    object (Price)
  },
  "loyaltyPoints": string,
  "memberPriceEffectiveDate": {
    object (Interval)
  }
}
字段
programLabel

string

会员回馈活动的标签。这是一个内部标签,用于唯一标识商家实体和会员回馈活动实体之间的关系。必须提供标签,以便系统可以将以下资源(例如价格和积分)与商家相关联。相应计划必须与商家账号关联。

tierLabel

string

会员回馈活动中层级的标签。必须与节目中的某个标签一致。

price

object (Price)

指定层级的会员价格,即即时折扣价格。必须低于或等于常规价格。

cashbackForFutureUse

object (Price)

可用于未来购买交易的返现。

loyaltyPoints

string (int64 format)

购物时获得的积分数。

memberPriceEffectiveDate

object (Interval)

商品有资格享受会员价格的日期范围。如果未指定,会员价格始终适用。日期范围由一对 ISO 8601 日期(用空格、英文逗号或正斜线分隔)表示。

ProductDimension

产品的维度。

JSON 表示法
{
  "value": number,
  "unit": string
}
字段
value

number

必需。以数字表示的维度值。值的最高精度可精确到小数点后四位。

unit

string

必需。维度单位。可接受的值为:*“in”*“cm

ProductWeight

商品的重量。

JSON 表示法
{
  "value": number,
  "unit": string
}
字段
value

number

必需。以数字表示的权重。权重最多可精确到小数点后四位。

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

运费所适用的邮政编码范围,由邮政编码、邮政编码前缀后跟 * 通配符表示,范围介于两个邮政编码或长度相等的两个邮政编码前缀之间。

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

税率所适用的邮政编码范围,由邮政编码、使用 * 通配符的邮政编码前缀表示,即两个邮政编码前缀或长度相等的两个邮政编码前缀之间的范围。例如: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”或“屏幕尺寸”。

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

指定属性的名称。例如,“屏幕分辨率”。字符串大小上限为 256 个字符。

boolValue

boolean

给定属性的布尔值。例如,对于电视产品,则为“True”或“False”如果屏幕是超高清。

minValue

number

指定属性的最小浮点值。例如,电视产品 1.00.

maxValue

number

指定属性的最大浮点值。例如,电视产品 100.00。

unitCode

string

指定属性的单位。例如,“Pixels”电视产品。字符串大小上限为 256B。

认证

产品认证,最初旨在通过欧盟 EPREL 数据库满足欧盟能效标识要求。

JSON 表示法
{
  "certificationAuthority": string,
  "certificationName": string,
  "certificationCode": string,
  "certificationValue": string
}
字段
certificationAuthority

string

认证机构,例如“European_Commission”。长度上限为 2000 个字符。

certificationName

string

认证的名称,例如“EPREL”。长度上限为 2000 个字符。

certificationCode

string

认证代码。长度上限为 2000 个字符。

certificationValue

string

认证值(也称为等级、等级或等级),例如“A+”“C”“金级”。长度上限为 2000 个字符。

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

广告内容描述的文字长度上限为 5000 个字符

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

属性的名称(如果问题是由单个属性导致的)。

reportingContext

enum (ReportingContextEnum)

问题适用的报告背景。

description

string

英文的简短问题说明。

detail

string

详细的问题说明(英文)。

documentation

string

帮助解决此问题的网页的网址。

applicableCountries[]

string

商品存在问题的国家/地区代码列表 (ISO 3166-1 alpha-2)。

严重程度

该问题对商品的投放有何影响。

枚举
SEVERITY_UNSPECIFIED 未指定。
NOT_IMPACTED 此问题是警告,不会对商品产生直接影响。
DEMOTED 商品已降位,在搜索结果中的效果很可能不太理想
DISAPPROVED 问题导致商品被拒批。

方法

get

从您的 Merchant Center 账号中检索已处理的产品。

list

列出您的 Merchant Center 账号中已处理的产品。