# 获取商品促销活动列表

获取项目的商品促销列表。

促销活动提供商品折扣(%)。
折扣应用于指定商品的所有价格。

Endpoint: GET /v3/project/{project_id}/admin/promotion/item
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    项目ID。

## Query parameters:

  - `limit` (integer)
    页面上元素数量的限制。

  - `offset` (integer)
    元素编号，从该元素开始生成列表（从0开始数）。

## Response 200 fields (application/json):

  - `active_promotions_count` (integer)
    进行中的促销活动的数量。

  - `inactive_promotions_count` (integer)
    已停用的促销活动的数量。

  - `promotions` (array)

  - `promotions.attribute_conditions` (array)
    用户属性验证条件。
根据用户属性是否满足所有指定条件来确定促销活动可用性。

  - `promotions.discount` (object)

  - `promotions.discount.percent` (string,null)
    百分比折扣。
商品价格使用此百分比计算打折价格。

  - `promotions.excluded_promotions` (array)
    应用此促销活动时要排除的促销活动ID列表。Example：[12, 789]
    Example: [12,789]

  - `promotions.id` (integer)
    促销活动ID。项目内的唯一促销活动标识符。

  - `promotions.is_enabled` (boolean)
    是否启用了促销活动。
    Example: true

  - `promotions.items` (array,null)

  - `promotions.items.sku` (string,null)
    物品 SKU。

  - `promotions.limits` (object)
    促销活动限制。

  - `promotions.limits.per_item` (integer,null)
    全局商品限制。
    Example: 10

  - `promotions.limits.per_user` (object,null)
    针对单独用户的促销活动限制。

  - `promotions.limits.per_user.total` (integer)
    用户可以购买的商品总数。您可以在发布商帐户中设置此数字或使用商店实体的管理端点（限制对象）。
    Example: 5

  - `promotions.limits.recurrent_schedule` (object,null)
    限制次数刷新周期。

  - `promotions.limits.recurrent_schedule.per_user` (object)
    用户限制刷新周期。

  - `promotions.limits.recurrent_schedule.per_user.day_of_month` (integer,null)
    在一个月中的哪一天刷新限制次数。如果由于较短的月没有选择具体哪一天，刷新将在该月的最后一天发生。仅针对monthly限制刷新周期类型不为null。

  - `promotions.limits.recurrent_schedule.per_user.day_of_week` (integer,null)
    在一周中的哪一天刷新限制次数。其中1是星期一，7是星期日。仅针对weekly限制刷新周期类型不为null。

  - `promotions.limits.recurrent_schedule.per_user.displayable_reset_next_date` (string)
    应重置限制次数的日期和时间 (ISO 8601)。
    Example: "2023-02-28T11:00:00+08:00"

  - `promotions.limits.recurrent_schedule.per_user.displayable_reset_start_date` (string)
    第一次限制次数刷新的日期和时间 (ISO 8601)。
    Example: "2023-02-28T11:00:00+08:00"

  - `promotions.limits.recurrent_schedule.per_user.interval_type` (string)
    循环刷新周期类型。
    Enum: "daily", "weekly", "monthly"

  - `promotions.limits.recurrent_schedule.per_user.reset_next_date` (integer)
    限制次数刷新的日期和时间（Unix时间戳）。
    Example: 1677553200

  - `promotions.limits.recurrent_schedule.per_user.time` (string)
    所需时区的限制次数刷新时间（四舍五入到小时）。
    Example: "11:00:00+03:00"

  - `promotions.name` (object)
    促销活动名称。应包含键/值对，其中键是格式为"^[a-z]{2}-[A-Z]{2}$"的区域设置，值是字符串。
    Example: {"en-US":"Promotion","ru-RU":"Акция"}

  - `promotions.price_conditions` (array,null)
    具有设置促销价格范围的条件的对象数组。 促销仅适用于价格符合数组中所有条件的商品。如果传递此数组，请设置[items](/zh/api/shop-builder/operation/create-item-promotion/#!path=items&t=request)对象为null。

  - `promotions.price_conditions.operator` (string, required)
    用于设置应用促销活动的价格范围的比较运算符。
    Enum: "ge", "gt", "le", "lt", "eq", "ne"

  - `promotions.price_conditions.value` (string, required)
    用于决定应用促销活动的价格范围的值。

  - `promotions.promotion_periods` (array)
    促销活动有效期。若指定了多个时间段，则date_from和date_until均为必需。

  - `promotions.promotion_periods.date_from` (string, required)
    指定促销活动的开始日期。
    Example: "2020-08-11T10:00:00+03:00"

  - `promotions.promotion_periods.date_until` (string,null)
    促销活动的结束日期。设置为null时，促销活动永久有效。仅在指定单个有效期时可设置为null。
    Example: "2020-08-11T20:00:00+03:00"

  - `total_promotions_count` (integer)
    促销活动总数。

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Example: 1020

  - `errorMessage` (string)
    Example: "[0401-1020]: Error in Authentication method occurred"

  - `statusCode` (integer)
    Example: 401