Package google.shopping.merchant.promotions.v1beta

ProductApplicability

必需。促销活动适用于所有商品还是仅适用于特定商品。

OfferType

必需。促销活动的类型。您可以使用此属性指明客户是否需要优惠券代码才能兑换您的促销。

string

可选。促销活动的通用兑换码。可与 offerType 字段搭配使用，并且必须满足最低要求。

string

必需。促销活动的长标题。

CouponValueType

必需。优惠券价值类型属性，用于表明您开展的促销活动的类型。某些属性是必需的，具体取决于所选优惠券价值的类型。

DestinationEnum

必需。促销活动适用的目标平台列表。如果您未通过在数据源中添加受支持的值来指定目标平台，则默认情况下，您的促销活动将在购物广告和非付费商品详情中展示。

您以前可能提交了以下值作为商品目标平台：Shopping Actions、Surfaces across Google、Local surfaces across Google。如需表示这些值，请使用 FREE_LISTINGS、FREE_LOCAL_LISTINGS、LOCAL_INVENTORY_ADS。如需了解详情，请参阅促销活动目标位置

string

可选。按促销活动的商品 ID 过滤商品。仅当符合促销条件的商品 product_applicability（适用商品）属性设置为 specific_products 时，商品过滤条件属性才适用。

string

可选。促销活动的按品牌过滤条件。仅当符合促销条件的商品 product_applicability（适用商品）属性设置为 specific_products 时，商品过滤条件属性才适用。

string

可选。按促销活动的商品组 ID 过滤商品。仅当符合促销条件的商品 [product_applicability] 属性设置为 specific_products 时，商品过滤条件属性才适用。

string

可选。按商品类型过滤促销商品。仅当符合促销条件的商品 product_applicability（适用商品）属性设置为 specific_products 时，商品过滤条件属性才适用。

string

可选。按促销活动的商品 ID 排除对象过滤商品。仅当符合促销条件的商品 product_applicability（适用商品）属性设置为 specific_products 时，商品过滤条件属性才适用。

string

可选。促销活动的品牌排除对象过滤条件。仅当符合促销条件的商品 product_applicability（适用商品）属性设置为 specific_products 时，商品过滤条件属性才适用。

string

可选。按商品组 ID 过滤商品。仅当符合促销条件的商品 product_applicability（适用商品）属性设置为 specific_products 时，商品过滤条件属性才适用。

string

可选。促销活动的商品类型排除对象过滤条件。仅当符合促销条件的商品 product_applicability（适用商品）属性设置为 specific_products 时，商品过滤条件属性才适用。

Price

可选。促销活动的最低交易额。

int64

可选。促销的最低购买数量。

int64

可选。促销活动的购买数量上限。

Price

可选。促销活动允许的商品价格上限。

int64

可选。促销活动提供的折扣百分比。

Price

可选。促销活动提供的折扣金额。

int64

可选。促销活动中享受折扣的商品数量。当 couponValueType 等于 buy_m_get_n_money_off 或 buy_m_get_n_percent_off 时，系统会设置此属性。

Price

可选。促销活动的赠品价值。

string

可选。促销活动的赠品说明。

string

可选。促销活动的赠品商品 ID。

Interval

必需。TimePeriod 促销活动生效日期的表示法。此属性用于指定促销活动可在此时间段内在您的网店中进行测试。

Interval

可选。TimePeriod 表示促销的展示日期。此属性用于指定在 Google.com 和购物广告上投放促销活动的日期和时间范围。如果未指定促销展示时间段 promotion_display_time_period 属性，则促销有效时间段 promotion_effective_time_period 将决定在 Google.com 和购物广告上展示促销活动的日期和时间范围。

StoreApplicability

可选。促销活动是适用于所有商店还是仅适用于指定商店。如果未包含适用商店，本地商品目录广告促销活动会抛出错误。如果 store_applicability 设置为 ALL_STORES，并且 store_codes_inclusion 或 score_code_exclusion 设置为某个值，则会抛出 INVALID_ARGUMENT 错误。

string

可选。要包含的商店代码（适用于促销活动）。仅当 store_applicability 属性设置为 specific_stores 时，商店过滤条件属性才适用。

销售相应商品的实体店的商店代码（商家资料中的商店 ID）。如需了解详情，请参阅本地商品目录数据规范。

string

可选。要排除的促销活动所涵盖的商店代码。仅当 store_applicability 属性设置为 specific_stores 时，商店过滤条件属性才适用。

string

可选。指向商家网站上展示促销活动的网页的网址。如果未包含 promotion_url，本地商品目录广告促销活动会抛出错误。网址用于确认促销活动有效，支持兑换。

string

必需。要检索的促销活动的名称。格式：accounts/{account}/promotions/{promotions}

string

必需。要插入促销信息的账号。格式：accounts/{account}

Promotion

必需。要插入的促销活动。

string

必需。促销活动的数据源格式：accounts/{account}/dataSources/{datasource}。

string

必需。要列出已处理的促销活动的账号。格式：accounts/{account}

int32

仅限输出。要返回的促销活动的最大数量。服务返回的值可能小于此值。最大值为 250；大于 250 的值将被强制转换为 250。如果未指定，则会返回最大促销活动数量。

string

仅限输出。从之前的 ListPromotions 调用接收的页面令牌。利用其进行后续页面检索。

进行分页时，提供给 ListPromotions 的所有其他参数必须与提供页面令牌的调用匹配。

Promotion

指定账号中已处理的促销活动。

string

可作为 page_token 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

string

标识符。促销活动的名称。格式：accounts/{account}/promotions/{promotion}

string

必需。用户提供的促销活动 ID，用于唯一标识促销活动。请遵循最低要求，以免促销活动遭拒。

string

必需。促销活动的双字母 ISO 639-1 语言代码。

促销活动仅适用于部分语言。

string

必需。目标国家/地区，用作唯一标识符的一部分。表示为 CLDR 地区代码。

促销活动仅适用于部分国家/地区，非付费商品详情和购物广告 本地商品目录广告

RedemptionChannel

必需。促销活动的兑换渠道。至少需要一个渠道。

string

仅限输出。促销活动的主要数据源。

Attributes

可选。促销属性列表。

CustomAttribute

可选。自定义（商家提供）属性的列表。它还可用于以通用形式（例如 { "name": "size type", "value": "regular" }）提交数据规范的任何属性。这对于提交 API 未明确公开的属性非常有用。

PromotionStatus

仅限输出。促销活动的状态、数据验证问题，即异步计算的促销活动相关信息。

int64

可选。表示促销活动的现有版本（新鲜度），可用于在同时进行多次更新时保留正确的顺序。

如果设置，当版本号低于现有促销活动的当前版本号时，系统会阻止插入。您可以使用当前的 version_number 执行重新插入（例如，在 30 天后刷新促销活动）。

如果操作被阻止，系统会抛出中止异常。

DestinationStatus

仅限输出。促销活动的预期目标平台。

ItemLevelIssue

仅限输出。与促销活动相关的问题列表。

Timestamp

仅限输出。促销活动的创建日期，采用 ISO 8601 格式：日期、时间和偏移量，例如 2020-01-02T09:00:00+01:00 或 2020-01-02T09:00:00Z

Timestamp

仅限输出。促销活动状态的上次更新日期（采用 ISO 8601 格式）：日期、时间和偏移量，例如 2020-01-02T09:00:00+01:00 或 2020-01-02T09:00:00Z

ReportingContextEnum

仅限输出。促销活动目标的名称。

State

仅限输出。指定目的地的状态。

string

仅限输出。问题的错误代码。

Severity

仅限输出。此问题对推广活动的投放有何影响。

string

仅限输出。商家是否可以解决此问题。

string

仅限输出。属性的名称（如果此问题是由单个属性引发的）。

ReportingContextEnum

仅限输出。问题适用的目的地。

string

仅限输出。以英文编写的简短问题说明。

string

仅限输出。以英文编写的详细问题说明。

string

仅限输出。帮助解决此问题的网页的网址。

string

仅限输出。问题适用的国家/地区代码 (ISO 3166-1 alpha-2) 列表。