product

Documentation

Overview

Package product 千川商品相关API models

Index

• type AvailableGetRequest
  • func (r AvailableGetRequest) Encode() string
• type AvailableGetResponse
• type AvailableGetResponseData
• type GetFiltering
• type Product

Types

type AvailableGetRequest

type AvailableGetRequest struct {
	// AdvertiserID 千川广告主账户id
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// AwemeID 抖音号id
	// 注意：在渠道品投放时，需要根据aweme_id来拉取渠道品信息
	AwemeID uint64 `json:"aweme_id,omitempty"`
	// Filtering 过滤器
	Filtering *GetFiltering `json:"filtering,omitempty"`
	// Page 页码.默认值: 1
	Page int `json:"page,omitempty"`
	// PageSize 页面数据量.默认值: 10， 最大值：100
	PageSize int `json:"page_size,omitempty"`
}

AvailableGetRequest 获取可投商品列表 API Request

func (AvailableGetRequest) Encode

func (r AvailableGetRequest) Encode() string

Encode implement GetRequest interface

type AvailableGetResponse

type AvailableGetResponse struct {
	model.BaseResponse
	// Data json返回值
	Data *AvailableGetResponseData `json:"data,omitempty"`
}

AvailableGetResponse 获取可投商品列表 API Response

type AvailableGetResponseData

type AvailableGetResponseData struct {
	// PageInfo 分页信息
	PageInfo model.PageInfo `json:"page_info,omitempty"`
	// ProductList 商品列表
	ProductList []Product `json:"product_list,omitempty"`
}

AvailalbeGetResponseData json返回值

type GetFiltering

type GetFiltering struct {
	// ProductIDs 根据商品ID列表筛选，长度：1-100
	ProductIDs []uint64 `json:"product_ids,omitempty"`
	// ProductName 根据商品名称筛选，长度120字符以内，中文算两个字符。
	ProductName string `json:"product_name,omitempty"`
	// MarketingScene 营销场景，可选值，默认FEED：
	// FEED通投
	// SEARCH搜索
	// SHOPPING_MALL 商城广告
	// 注意：如果需要获取商品是否支持新品加速信息，该字段必填，仅允许SEARCH
	MarketingScene qianchuan.MarketingScene `json:"marketing_scene,omitempty"`
}

GetFiltering 过滤器

type Product

type Product struct {
	// ID 商品id
	ID uint64 `json:"id,omitempty"`
	// Img 主图
	Img string `json:"img,omitempty"`
	// Inventory 库存
	Inventory int64 `json:"inventory,omitempty"`
	// Name 商品名称
	Name string `json:"name,omitempty"`
	// CategoryName 分类
	CategoryName string `json:"category_name,omitempty"`
	// ProductRate 好评率
	ProductRate float64 `json:"product_rate,omitempty"`
	// SaleTime 上架时间
	SaleTime string `json:"sale_time,omitempty"`
	// DiscountPrice 售价，单位：元，已废弃
	DiscountPrice float64 `json:"discount_price,omitempty"`
	// MarketPrice 原价，单位为元
	MarketPrice float64 `json:"market_price,omitempty"`
	// DiscountLowerPrice 折扣价区间最小值，单位为元
	DiscountLowerPrice float64 `json:"discount_lower_price,omitempty"`
	// DiscountHigherPrice 折扣价区间最大值，单位为元
	DiscountHigherPrice float64 `json:"discount_higher_price,omitempty"`
	// Tags 是否可投猜喜可选值:
	// 1: 可投猜喜
	// 0: 不可投猜喜
	Tags int `json:"tags,omitempty"`
	// SupportProductNewOpen 当前商品是否支持开启新品加速
	// 支持：true
	// 不支持：false
	SupportProductNewOpen bool `json:"support_product_new_open,omitempty"`
	// ImgList 商品卡方图url列表
	ImgList []struct {
		// ImgURL 商品卡方图url
		// 注意：在使用商品卡投放广告时，需要先将商品卡方图下载，然后上传至素材库
		ImgURL string `json:"img_url,omitempty"`
	} `json:"img_list,omitempty"`
	// ChannelID 渠道ID，如果渠道品生效，价格、销量等信息需要返回渠道品信息
	// 注意：在抖音号入參的情况下，如果当前商品在该抖音号下存在渠道品，会返回渠道品信息。在创编链路，需要使用渠道品来创建计划
	// 渠道品相关介绍见《【抖店】销售渠道品功能操作手册》
	ChannelID uint64 `json:"channel_id,omitempty"`
	// ChannelType 渠道类型，枚举值
	// SHOP_SELL 商家自卖
	// STAR_SELL 达人自播
	ChannelType qianchuan.ProductChannelType `json:"channel_type,omitempty"`
}

Product 商品