dpa

package
v1.27.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Aug 27, 2024 License: Apache-2.0 Imports: 5 Imported by: 1

Documentation

Overview

Package dpa 商品广告相关API models

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func CopyProductForUpdateFromProduct added in v1.16.9 

func CopyProductForUpdateFromProduct(src *Product, dist *ProductForUpdate)

Types

type Asset added in v1.8.0 

type Asset struct {
	// AdvertiserID 广告主id
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// AssetID 物件id
	AssetID uint64 `json:"asset_id,omitempty"`
	// PlatformID 商品库id
	PlatformID uint64 `json:"platform_id,omitempty"`
	// AssetType 物件类型，AUTO为汽车
	AssetType string `json:"asset_type,omitempty"`
	// ProductID 商品id
	ProductID uint64 `json:"product_id,omitempty"`
	// UniqueProductID 线索商品id
	UniqueProductID uint64 `json:"unique_product_id,omitempty"`
	// Status 物件状态，DISABLE代表暂停， ENABLE代表启用
	Status string `json:"status,omitempty"`
	// AuditStatus 投放条件状态 可选值:
	// REVIEW_FAIL 审核失败
	// REVIEW_SUCCESS 审核成功
	// UNDER_REVIEW 审核中
	// UNREVIEWED 未送审
	AuditStatus string `json:"audit_status,omitempty"`
	// Source 来源，MANUAL为用户操作，AUTO为系统生成
	Source string `json:"source,omitempty"`
	// AssetCreateTime 物件创建时间，格式: yyyy-MM-DD
	AssetCreateTime string `json:"asset_create_time,omitempty"`
	// AssetModifyTime 物件最近一次修改时间，格式: yyyy-MM-DD
	AssetModifyTime string `json:"asset_modify_time,omitempty"`
}

Asset 投放条件

type AssetsDetailReadRequest added in v1.8.0 

type AssetsDetailReadRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// AssetIDs 物件ID, 最多允许传入100个，可通过【获取投放条件列表】获取
	AssetIDs []uint64 `json:"asset_ids,omitempty"`
}

AssetsDetailReadRequest 获取投放条件详情 API Request

func (AssetsDetailReadRequest) Encode added in v1.8.0 

func (r AssetsDetailReadRequest) Encode() string

Encode implement GetRequest interface

type AssetsDetailReadResponse added in v1.8.0 

type AssetsDetailReadResponse struct {
	model.BaseResponse
	Data struct {
		// List 商品库商品列表
		List []Asset `json:"list,omitempty"`
	} `json:"data,omitempty"`
}

AssetsDetailReadResponse 获取投放条件详情 API Response

type AssetsListFilter added in v1.8.0 

type AssetsListFilter struct {
	// Status 物件状态， 0代表暂停， 1代表启用
	Status int `json:"status"`
}

AssetsListFilter 过滤条件

type AssetsListRequest added in v1.8.0 

type AssetsListRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// PlatformID 商品库ID
	PlatformID uint64 `json:"platform_id,omitempty"`
	// ProductIDs 商品ID列表
	ProductIDs []uint64 `json:"product_ids,omitempty"`
	// Filtering 过滤条件
	Filtering *AssetsListFilter `json:"filtering,omitempty"`
	// Page 页码， 默认值: 1
	Page int `json:"page,omitempty"`
	// PageSize 页面数据量， 默认值: 10，最大 100
	PageSize int `json:"page_size,omitempty"`
}

AssetsListRequest 获取投放条件列表 API Request

func (AssetsListRequest) Encode added in v1.8.0 

func (r AssetsListRequest) Encode() string

Encode implement GetRequest interface

type AssetsListResponse added in v1.8.0 

type AssetsListResponse struct {
	model.BaseResponse
	Data *AssetsListResponseData `json:"data,omitempty"`
}

AssetsListResponse 获取投放条件列表 API Response

type AssetsListResponseData added in v1.8.0 

type AssetsListResponseData struct {
	// PageInfo 分页信息
	PageInfo *model.PageInfo `json:"page_info,omitempty"`
	// List 商品库商品列表
	List []Asset `json:"list,omitempty"`
}

AssetsListResponseData

type AssetsListV2Filter added in v1.26.6 

type AssetsListV2Filter struct {
	// Status 物件状态，
	// DISABLE 暂停
	// ENABLE 启用
	Status string `json:"status"`
}

AssetsListV2Filter 过滤条件

type AssetsListV2Request added in v1.26.6 

type AssetsListV2Request struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// UniqueProductIDs 新线索商品ID列表，最多传入100个
	UniqueProductIDs []uint64 `json:"unique_product_ids,omitempty"`
	// Filtering 过滤条件
	Filtering *AssetsListV2Filter `json:"filtering,omitempty"`
	// Page 页码， 默认值: 1
	Page int `json:"page,omitempty"`
	// PageSize 页面数据量， 默认值: 10，最大 100
	PageSize int `json:"page_size,omitempty"`
}

AssetsListV2Request 获取投放条件列表(线索版) API Request

func (AssetsListV2Request) Encode added in v1.26.6 

func (r AssetsListV2Request) Encode() string

Encode implement GetRequest interface

type AssetsListV2Response added in v1.26.6 

type AssetsListV2Response struct {
	Data *AssetsListV2Result `json:"data,omitempty"`
	model.BaseResponse
}

AssetsListV2Response 获取投放条件列表 API Response

type AssetsListV2Result added in v1.26.6 

type AssetsListV2Result struct {
	// PageInfo 分页信息
	PageInfo *model.PageInfo `json:"page_info,omitempty"`
	// AssetList 商品库商品列表
	AssetList []Asset `json:"asset_list,omitempty"`
}

AssetsListV2Result

type Behaviour added in v1.8.0 

type Behaviour struct {
	// CodeID 行为id
	CodeID uint64 `json:"code_id,omitempty"`
	// Name 行为名称
	Name string `json:"name,omitempty"`
}

Behaviour 行为

type BehaviourAvailablesRequest added in v1.8.0 

type BehaviourAvailablesRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// PlatformID 商品库id
	PlatformID uint64 `json:"platform_id,omitempty"`
}

BehaviourAvailablesRequest 获取DPA可用行为 API Request

func (BehaviourAvailablesRequest) Encode added in v1.8.0 

func (r BehaviourAvailablesRequest) Encode() string

Encode implement GetRequest interface

type BehaviourAvailablesResponse added in v1.8.0 

type BehaviourAvailablesResponse struct {
	model.BaseResponse
	Data struct {
		// List DPA行为列表
		List []Behaviour `json:"list,omitempty"`
	} `json:"data,omitempty"`
}

BehaviourAvailablesResponse 获取DPA可用行为 API Response

type BrandInfo 

type BrandInfo struct {
	// BrandID 品牌ID
	BrandID string `json:"brand_id,omitempty"`
	// BrandName 品牌名称
	BrandName string `json:"brand_name,omitempty"`
	// EnBrand 英文品牌名
	EnBrand string `json:"en_brand,omitempty"`
	BrandLogo string `json:"brand_logo,omitempty"`
	// BrandURL PC端品牌落地页URL
	BrandURL string `json:"brand_url,omitempty"`
	// BrandURLMobile H5页面品牌落地页URL
	BrandURLMobile string `json:"brand_url_mobile,omitempty"`
	// BrandURLAndroidApp Android应用品牌直达调起链接
	BrandURLAndroidApp string `json:"brand_url_android_app,omitempty"`
	// BrandURLIosApp IOS应用品牌直达调起链接
	BrandURLIosApp string `json:"brand_url_ios_app,omitempty"`
	// BrandURLUniversalLink IOS应用品牌调起ulink链接
	BrandURLUniversalLink string `json:"brand_url_universal_link,omitempty"`
}

BrandInfo 品牌信息

type Category added in v1.8.0 

type Category struct {
	// Name 分类名称
	Name string `json:"name,omitempty"`
	// Subs 子级分类，嵌套递归
	Subs []Category `json:"subs,omitempty"`
	// ID 分类id
	ID model.Uint64 `json:"id,omitempty"`
	// Parent 父级分类id，没有父级则为-1
	Parent model.Uint64 `json:"parent,omitempty"`
}

Category DPA分类

type CategoryGetRequest added in v1.8.0 

type CategoryGetRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// PlatformID 商品库id
	PlatformID uint64 `json:"platform_id,omitempty"`
}

CategoryGetRequest 获取DPA分类 API Request

func (CategoryGetRequest) Encode added in v1.8.0 

func (r CategoryGetRequest) Encode() string

Encode implement GetRequest interface

type CategoryGetResponse added in v1.8.0 

type CategoryGetResponse struct {
	model.BaseResponse
	Data struct {
		// List DPA分类列表
		List []Category `json:"list,omitempty"`
	} `json:"data,omitempty"`
}

CategoryGetResponse 获取DPA分类 API Response

type ClueProductDetailRequest added in v1.26.6 

type ClueProductDetailRequest struct {
	// ProductIDs 线索商品ID
	ProductIDs []uint64 `json:"product_ids,omitempty"`
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
}

ClueProductDetailRequest 获取升级版商品详情 API Request

func (ClueProductDetailRequest) Encode added in v1.26.6 

func (r ClueProductDetailRequest) Encode() string

Encode implements GetRequest interface

type ClueProductDetailResponse added in v1.26.6 

type ClueProductDetailResponse struct {
	model.BaseResponse
	Data struct {
		// Products 商品信息
		Products []Product `json:"products,omitempty"`
	} `json:"data,omitempty"`
}

ClueProductDetailResponse 获取升级版商品详情 API Response

type ClueProductListFilter added in v1.26.6 

type ClueProductListFilter struct {
	// ProductIDs 商品ID精确搜索
	ProductIDs []uint64 `json:"product_ids,omitempty"`
	// ProductName 商品名称模糊搜索
	ProductName string `json:"product_name,omitempty"`
	// AuditStatus 商品审核状态 可选值:
	// AUDIT_STATUS_APPROVE 审核通过
	// AUDIT_STATUS_INIT 审核中
	// AUDIT_STATUS_REJECT 审核未通过
	AuditStatus enum.ProductAuditStatus `json:"audit_status,omitempty"`
	// CategoryIDs 类目id，会级联查询所有叶子类目
	CategoryIDs []uint64 `json:"category_ids,omitempty"`
	// CategoryName 类目名称，支持模糊搜索
	CategoryName string `json:"category_name,omitempty"`
	// CompletionStatus 商品必填字段完整性
	CompletionStatus []enum.ProductCompletionStatus `json:"completion_status,omitempty"`
	// ProductIDOrNameSearch 商品ID或商品名称查询
	ProductIDOrNameSearch string `json:"product_id_or_name_search,omitempty"`
	// Statuses 可投状态过滤
	Statuses []string `json:"statuses,omitempty"`
	// Rels 商品权限关系过滤，允许值：
	// REL_COP 授权
	// REL_OWN own
	Rels []string `json:"rels,omitempty"`
}

type ClueProductListRequest added in v1.26.6 

type ClueProductListRequest struct {
	// Filtering 过滤条件
	Filtering *ClueProductListFilter `json:"filtering,omitempty"`
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// Page 页码
	Page int `json:"page,omitempty"`
	// PageSize 页面大小，默认值为10，传参范围[1,100]
	PageSize int `json:"page_size,omitempty"`
}

ClueProductListRequest 获取升级版商品列表 API Request

func (ClueProductListRequest) Encode added in v1.26.6 

func (r ClueProductListRequest) Encode() string

Encode implements GetRequest interface

type ClueProductListResponse added in v1.26.6 

type ClueProductListResponse struct {
	Data *ClueProductListResult `json:"data,omitempty"`
	model.BaseResponse
}

ClueProductListResponse 获取升级版商品列表 API Response

type ClueProductListResult added in v1.26.6 

type ClueProductListResult struct {
	// PageInfo 分页信息
	PageInfo *model.PageInfo `json:"page_info,omitempty"`
	// Products 商品列表
	Products []Product `json:"products,omitempty"`
}

type DetailGetFilter added in v1.8.0 

type DetailGetFilter struct {
	// DpaCategories 商品行业分类，长度限制 50，使用的三级行业ID ，可从 【获取行业列表】 接口获取
	DpaCategories []uint64 `json:"dpa_categories,omitempty"`
	// IsRecommend 是否系统推荐，1表示只看系统推荐，0表示不限系统推荐，默认为0
	IsRecommend int `json:"is_recommend,omitempty"`
	// ProductID 商品ID，精准匹配，与product_name（商品名称）同时传入，以商品ID为准
	ProductID uint64 `json:"product_id,omitempty"`
	// ProductName 商品名称，模糊匹配，长度限制50字，与product_id（商品ID）同时传入，以商品ID为准
	ProductName string `json:"product_name,omitempty"`
	// Status 商品投放状态，枚举值：0代表不可投放，1代表可投放
	Status *int `json:"status,omitempty"`
}

DetailGetFilter 过滤条件

type DetailGetRequest added in v1.8.0 

type DetailGetRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// ProductPlatformID 商品库ID ，可通过【获取商品库信息】获取
	ProductPlatformID uint64 `json:"product_platform_id,omitempty"`
	// Filtering 过滤条件
	Filtering *DetailGetFilter `json:"filtering,omitempty"`
	// Page 页码， 默认值: 1
	Page int `json:"page,omitempty"`
	// PageSize 页面数据量， 默认值: 20，最大 100
	PageSize int `json:"page_size,omitempty"`
}

DetailGetRequest 获取商品列表 API Request

func (DetailGetRequest) Encode added in v1.8.0 

func (r DetailGetRequest) Encode() string

Encode implement GetRequest interface

type DetailGetResponse added in v1.8.0 

type DetailGetResponse struct {
	model.BaseResponse
	// Data 返回数据
	Data *DetailGetResponseData `json:"data,omitempty"`
}

DetailGetResponse 获取商品列表 API Response

type DetailGetResponseData added in v1.8.0 

type DetailGetResponseData struct {
	// PageInfo 分页信息
	PageInfo *model.PageInfo `json:"page_info,omitempty"`
	// List 商品库商品列表
	List []Product `json:"list,omitempty"`
}

DetailGetResponseData 返回数据

type Dict added in v1.8.0 

type Dict struct {
	// ID 词包id
	ID uint64 `json:"id,omitempty"`
	// PdaID 商品库id
	PdaID uint64 `json:"pda_id,omitempty"`
	// DefaultWord 默认词
	DefaultWord string `json:"default_word,omitempty"`
	// Name 词包名称
	Name string `json:"name,omitempty"`
}

Dict 词包

type DictGetRequest added in v1.8.0 

type DictGetRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// PlatformID 商品库id
	PlatformID uint64 `json:"platform_id,omitempty"`
}

DictGetRequest 获取DPA词包 API Request

func (DictGetRequest) Encode added in v1.8.0 

func (r DictGetRequest) Encode() string

Encode implement GetRequest interface

type DictGetResponse added in v1.8.0 

type DictGetResponse struct {
	model.BaseResponse
	Data struct {
		// List DPA词包列表
		List []Dict `json:"list,omitempty"`
	} `json:"data,omitempty"`
}

DictGetResponse 获取DPA词包 API Response

type ImageInfo added in v1.8.0 

type ImageInfo struct {
	// Height 图片高度
	Height int `json:"height,omitempty"`
	// ImageID 图片id
	ImageID string `json:"image_id,omitempty"`
	// Width 图片宽度
	Width int `json:"width,omitempty"`
}

ImageInfo 视频模板封面图信息

type LandingInfo 

type LandingInfo struct {
	// TargetURL PC端商品落地页URL
	TargetURL string `json:"target_url,omitempty"`
	// TargetURLMobile H5页面商品落地页URL
	TargetURLMobile string `json:"target_url_mobile,omitempty"`
	// TargetURLAndroidApp Android应用直达落地页
	TargetURLAndroidApp string `json:"target_url_android_app,omitempty"`
	// TargetURLIosApp IOS应用商品直达调起链接
	TargetURLIosApp string `json:"target_url_ios_app,omitempty"`
	// TargetURLUniversalLink IOS应用商品调起ulink链接
	TargetURLUniversalLink string `json:"target_url_universal_link,omitempty"`
}

LandingInfo 落地页信息 

type Link struct {
	URL string `json:"string,omitempty"`
	// TemplateID 视频模板ID
	TemplateID string `json:"template_id,omitempty"`
}

type Meta 

type Meta struct {
	// Status 元信息状态
	Status int `json:"status,omitempty"`
	// Name 元信息名称
	Name string `json:"name,omitempty"`
	// Title 元信息头
	Title string `json:"title,omitempty"`
	// MediaType 元信息媒体类型
	MediaType int `json:"media_type,omitempty"`
	// FieldGroup 分组
	FieldGroup string `json:"field_group,omitempty"`
	// Type 字段类型
	Type string `json:"type,omitempty"`
}

Meta 商品库元信息

type MetaGetRequest 

type MetaGetRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// PlatformID 商品库id
	PlatformID uint64 `json:"platform_id,omitempty"`
}

MetaGetRequest 获取商品库元信息 API Request

func (MetaGetRequest) Encode 

func (r MetaGetRequest) Encode() string

Encode implement GetRequest interface

type MetaGetResponse 

type MetaGetResponse struct {
	model.BaseResponse
	// Data json返回值
	Data struct {
		// List
		List []Meta `json:"list,omitempty"`
	} `json:"data,omitempty"`
}

MetaGetResponse 获取商品库元信息 API Response

type Platform 

type Platform struct {
	// PlatformID 商品库ID
	PlatformID uint64 `json:"platform_id,omitempty"`
	// Name 商品库名称
	Name string `json:"name,omitempty"`
	// ProductIndustry 商品库行业类别
	ProductIndustry enum.ProductIndustry `json:"product_industry,omitempty"`
}

Platform 商品库详情

type PlayletAuthGetRequest added in v1.26.6 

type PlayletAuthGetRequest struct {
	// AdvertiserID 广告主账户ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// PlatformID 商品库ID，可通过「获取商品列表」接口获取
	PlatformID uint64 `json:"platform_id,omitempty"`
	// ProductID 商品ID，可通过「获取商品列表」接口获取
	ProductID uint64 `json:"product_id,omitempty"`
}

PlayletAuthGetRequest 查询短剧商品原片授权申请状态 API Request

func (PlayletAuthGetRequest) Encode added in v1.26.6 

func (r PlayletAuthGetRequest) Encode() string

Encode implements GetRequest interface

type PlayletAuthGetResponse added in v1.26.6 

type PlayletAuthGetResponse struct {
	Data *PlayletAuthGetResult `json:"data,omitempty"`
	model.BaseResponse
}

PlayletAuthGetResponse 查询短剧商品原片授权申请状态 API Response

type PlayletAuthGetResult added in v1.26.6 

type PlayletAuthGetResult struct {
	// AlbumID 短剧ID
	AlbumID string `json:"album_id,omitempty"`
	// Status 申请状态 可选值:
	// ING 申请中
	// SUCCESS 申请成功
	// FAIL 申请失败
	// UNSUBMITTED 未提交申请
	Status string `json:"status,omitempty"`
	// ApplyTime 申请提交时间，时间格式为yyyy-mm-dd hh:mm:ss
	ApplyTime string `json:"apply_time,omitempty"`
	// ExpireTime 授权过期时间，时间格式为yyyy-mm-dd hh:mm:ss
	ExpireTime string `json:"expire_time,omitempty"`
	// AlbumName 短剧名称
	AlbumName string `json:"album_name,omitempty"`
}

type PriceInfo 

type PriceInfo struct {
	// Value 商品原价，可用于素材拼接，以及动态创意标题或者素材
	Value float64 `json:"value,omitempty"`
	// Saving 减价
	Saving float64 `json:"saving,omitempty"`
	// Discount 折扣
	Discount float64 `json:"discount,omitempty"`
	// Price 商品现价
	Price float64 `json:"price,omitempty"`
	// PriceUnit 价格单位
	PriceUnit string `json:"price_unit,omitempty"`
	// SalesPromotion 促销活动，关于商品促销活动的描述信息
	SalesPromotion string `json:"sales_promotion,omitempty"`
	// DownPayment 首付
	DownPayment string `json:"down_payment,omitempty"`
	// Montage 月付
	Montage string `json:"montage,omitempty"`
	// DailyMontage 日付
	DailyMontage string `json:"daily_montage,omitempty"`
}

PriceInfo 价格信息

type Product 

type Product struct {
	// Name 商品名称
	Name string `json:"name,omitempty"`
	// Title 商品标题
	Title string `json:"title,omitempty"`
	// Description 商品标题
	Description string `json:"description,omitempty"`
	// OfflineTime 下线时间，格式"YYYY-MM-DD" 或 格式为十位unix时间戳类型
	OfflineTime model.UnixTime `json:"offline_time,omitempty"`
	// OnlineTime 上线时间，格式"YYYY-MM-DD" 或 格式为十位unix时间戳类型
	OnlineTime model.UnixTime `json:"online_time,omitempty"`
	// PlatformID 商品库ID
	PlatformID uint64 `json:"platform_id,omitempty"`
	// ProductID 商品ID
	ProductID uint64 `json:"product_id,omitempty"`
	// SpuID 商品spu_id
	SpuID string `json:"spu_id,omitempty"`
	// PoiID 商品poiID
	PoiID string `json:"poi_id,omitempty"`
	// OuterID 商品外部id
	OuterID string `json:"outer_id,omitempty"`
	// ImageURL 商品封面图片链接
	ImageURL string `json:"image_url,omitempty"`
	// ImageURLs 扩展商品图，商品图片的补充
	ImageURLs []Link `json:"image_urls,omitempty"`
	// Status 商品投放状态，0代表不可投放，1代表可投放
	Status enum.ProductStatus `json:"status,omitempty"`
	// AuditStatus 审核状态，可选值:
	// AUDIT_STATUS_APPROVE 审核通过
	// AUDIT_STATUS_INIT 审核中
	// AUDIT_STATUS_REJECT 审核未通过
	AuditStatus enum.ProductAuditStatus `json:"audit_status,omitempty"`
	// CompletionStatus 字段填充状态，可选值:
	// AD_COMPLETED 广告场景已完善
	// ALL_COMPLETED 必填字段已完善
	// LEADS_COMPLETED 经营场景已完善
	// TO_BE_COMPLETED 必填字段待完善
	CompletionStatus enum.ProductCompletionStatus `json:"completion_status,omitempty"`
	// Stock 商品库存状态，0代表无库存，1代表有库存
	Stock int `json:"stock,omitempty"`
	// LandingInfo 落地页信息
	LandingInfo *LandingInfo `json:"landing_info,omitempty"`
	// BrandInfo 品牌信息
	BrandInfo *BrandInfo `json:"brand_info,omitempty"`
	// ShopKeeperInfo 商户信息
	ShopKeeperInfo *ShopKeeperInfo `json:"shop_keeper_info,omitempty"`
	// PriceInfo 价格信息
	PriceInfo *PriceInfo `json:"price_info,omitempty"`
	// Feature 特色信息
	Feature string `json:"feature,omitempty"`
	// Mark 评分
	Mark float64 `json:"mark,omitempty"`
	// Bought 购买量
	Bought int64 `json:"bought,omitempty"`
	// Comments 评论数
	Comments int64 `json:"comments,omitempty"`
	// Province 省份，用于定向人群，默认不限，示例：["江苏","浙江"]
	Province []string `json:"province,omitempty"`
	// City 定向城市
	City []string `json:"city,omitempty"`
	// Age 年龄段，用于定向人群，默认不限，数组项允许值如下：
	// 1 2 3 4 5 6
	// 1代表年龄段<18
	// 2 代表年龄段在18~23之间
	// 3代表年龄段在24~30之间
	// 4代表年龄段在31~40之间
	// 5代表年龄段在41~49之间
	// 6代表年龄段>50
	// 如：[2,4]代表年龄段在18~23之间或31~40之间
	Age []int `json:"age,omitempty"`
	// Label 商品标签，小说库特有字段
	Label string `json:"label,omitempty"`
	// ExternalURL 落地页链接
	ExternalURL string `json:"external_url,omitempty"`
	// Category 商品类目信息
	Category *ProductCategory `json:"category,omitempty"`
	// FirstCategory 商品所处一级行业
	FirstCategory string `json:"first_category,omitempty"`
	// SubCategory 商品所处二级行业
	SubCategory string `json:"sub_category,omitempty"`
	// ThirdCategory 商品所处三级行业
	ThirdCategory string `json:"third_category,omitempty"`
	// FirstCategoryID 商品所处一级行业 ID
	FirstCategoryID model.Uint64 `json:"first_category_id,omitempty"`
	// SubCategoryID 商品所处二级行业 ID
	SubCategoryID model.Uint64 `json:"sub_category_id,omitempty"`
	// ThirdCategoryID 商品所处三级行业 ID
	ThirdCategoryID model.Uint64 `json:"third_category_id,omitempty"`
	// BrandName 商品名称
	BrandName string `json:"brand_name,omitempty"`
	// Tags 商品标签
	Tags []string `json:"tags,omitempty"`
	// Video 视频链接url
	Video string `json:"video,omitempty"`
	// VideoURL 商品视频链接
	VideoURL string `json:"video_url,omitempty"`
	// Videos 视频内容，小说库特有字段
	Videos []Link `json:"videos,omitempty"`
	// HasVideo 当前商品是否有商品视频 0：没有，1：有
	HasVideo model.Bool `json:"has_video,omitempty"`
	// Profession 额外信息
	Profession *Profession `json:"profession,omitempty"`
}

Product 商品详情

type ProductAvailablesRequest 

type ProductAvailablesRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
}

ProductAvailablesRequest 获取商品库信息 API Request

func (ProductAvailablesRequest) Encode 

func (r ProductAvailablesRequest) Encode() string

Encode implement GetRequest interface

type ProductAvailablesResponse 

type ProductAvailablesResponse struct {
	model.BaseResponse
	// Data json返回值
	Data struct {
		// List
		List []Platform `json:"list,omitempty"`
	} `json:"data,omitempty"`
}

ProductAvailablesResponse 获取商品库信息 API Response

type ProductCategory added in v1.26.6 

type ProductCategory struct {
	// FirstCategoryName 商品所处一级行业
	FirstCategoryName string `json:"first_category_name,omitempty"`
	// SubCategoryName 商品所处二级行业
	SubCategoryName string `json:"sub_category_name,omitempty"`
	// ThirdCategoryName 商品所处三级行业
	ThirdCategoryName string `json:"third_category_name,omitempty"`
	// FourthCategoryName 四级类目名称
	FourthCategoryName string `json:"fourth_category_name,omitempty"`
	// FirstCategoryID 商品所处一级行业 ID
	FirstCategoryID uint64 `json:"first_category_id,omitempty"`
	// SubCategoryID 商品所处二级行业 ID
	SubCategoryID uint64 `json:"sub_category_id,omitempty"`
	// ThirdCategoryID 商品所处三级行业 ID
	ThirdCategoryID uint64 `json:"third_category_id,omitempty"`
	// FourthCategoryID 四级类目ID
	FourthCategoryID uint64 `json:"fourth_category_id,omitempty"`
}

Category 商品类目信息

type ProductCreateRequest added in v1.8.0 

type ProductCreateRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// PlatformID 商品库ID
	PlatformID uint64 `json:"platform_id,omitempty"`
	// ProductInfo 商品详情，包括商品库基础字段、落地页、品牌、商户、价格以及其他字段信息，以下所有字段均包含在该结构体下，且不同类型商品库填入字段存在差异，具体格式见下方字段详情
	ProductInfo *Product `json:"product_info,omitempty"`
}

ProductCreateRequest 创建DPA商品（无商品id） API Request

func (ProductCreateRequest) Encode added in v1.8.0 

func (r ProductCreateRequest) Encode() []byte

Encode implement PostRequest interface

type ProductCreateResponse added in v1.8.0 

type ProductCreateResponse struct {
	model.BaseResponse
	Data struct {
		// ProductID 商品ID
		ProductID uint64 `json:"product_id,omitempty"`
	} `json:"data,omitempty"`
}

ProductCreateResponse 创建DPA商品（无商品id） API Response

type ProductDeleteRequest added in v1.8.0 

type ProductDeleteRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// PlatformID 商品库ID
	PlatformID uint64 `json:"platform_id,omitempty"`
	// ProductID 商品ID
	ProductID uint64 `json:"product_id,omitempty"`
}

ProductDeleteRequest

func (ProductDeleteRequest) Encode added in v1.8.0 

func (r ProductDeleteRequest) Encode() []byte

Encode implement PostRequest interface

type ProductDetailGetFilter added in v1.8.0 

type ProductDetailGetFilter struct {
	// ProductIDs 商品ID
	ProductIDs []uint64 `json:"product_ids,omitempty"`
}

ProductDetailGetFilter 过滤条件

type ProductDetailGetRequest added in v1.8.0 

type ProductDetailGetRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// PlatformID 商品库ID，可通过【获取商品库信息】获取
	// 若仅填写platform_id不填filtering.product_ids则表示查询该商品库下所有商品
	PlatformID uint64 `json:"platform_id,omitempty"`
	// Filtering 过滤条件
	Filtering *ProductDetailGetFilter `json:"filtering,omitempty"`
	// Page 页码， 默认值: 1
	Page int `json:"page,omitempty"`
	// PageSize 页面数据量， 默认值: 20，最大 100
	PageSize int `json:"page_size,omitempty"`
}

ProductDetailGetRequest 获取商品详情 API Request

func (ProductDetailGetRequest) Encode added in v1.8.0 

func (r ProductDetailGetRequest) Encode() string

Encode implement GetRequest interface

type ProductDetailGetResponse added in v1.8.0 

type ProductDetailGetResponse struct {
	model.BaseResponse
	// Data 返回数据
	Data *DetailGetResponseData `json:"data,omitempty"`
}

ProductDetailGetResponse 获取商品详情 API Response

type ProductForUpdate added in v1.8.0 

type ProductForUpdate struct {
	// Name 商品名称
	Name string `json:"name,omitempty"`
	// Title 商品标题
	Title string `json:"title,omitempty"`
	// Description 商品标题
	Description string `json:"description,omitempty"`
	// OfflineTime 下线时间, 格式为十位unix时间戳类型，默认为当前时间+3年
	OfflineTime int64 `json:"offline_time,omitempty"`
	// OnlineTime 上线时间, 格式为十位unix时间戳类型，默认为当前时间
	OnlineTime int64 `json:"online_time,omitempty"`
	// Status 商品投放状态，0代表不可投放，1代表可投放
	Status int `json:"status"`
	// Stock 商品库存状态，0代表无库存，1代表有库存
	Stock int `json:"stock"`
	// FirstCategory 商品所处一级行业
	FirstCategory string `json:"first_category,omitempty"`
	// SubCategory 商品所处二级行业
	SubCategory string `json:"sub_category,omitempty"`
	// ThirdCategory 商品所处三级行业
	ThirdCategory string `json:"third_category,omitempty"`
	// FirstCategoryID 商品所处一级行业 ID
	FirstCategoryID string `json:"first_category_id,omitempty"`
	// SubCategoryID 商品所处二级行业 ID
	SubCategoryID string `json:"sub_category_id,omitempty"`
	// ThirdCategoryID 商品所处三级行业 ID
	ThirdCategoryID string `json:"third_category_id,omitempty"`
	// SpuID 商品spu_id
	SpuID string `json:"spu_id,omitempty"`
	// OuterID 商品外部id
	OuterID string `json:"outer_id,omitempty"`
	// ImageURL 商品封面图片链接
	ImageURL string `json:"image_url,omitempty"`
	// ImageURLs 扩展商品图，商品图片的补充
	ImageURLs []Link `json:"image_urls,omitempty"`
	// LandingInfo 落地页信息
	LandingInfo *LandingInfo `json:"landing_info,omitempty"`
	// BrandInfo 品牌信息
	BrandInfo *BrandInfo `json:"brand_info,omitempty"`
	// ShopKeeperInfo 商户信息
	ShopKeeperInfo *ShopKeeperInfo `json:"shop_keeper_info,omitempty"`
	// PriceInfo 价格信息
	PriceInfo *PriceInfo `json:"price_info,omitempty"`
	// Feature 特色信息
	Feature string `json:"feature,omitempty"`
	// Mark 评分
	Mark float64 `json:"mark,omitempty"`
	// Bought 购买量
	Bought int64 `json:"bought,omitempty"`
	// Comments 评论数
	Comments int64 `json:"comments,omitempty"`
	// Province 省份，用于定向人群，默认不限，示例：["江苏","浙江"]
	Province []string `json:"province,omitempty"`
	// City 定向城市
	City []string `json:"city,omitempty"`
	// Age 年龄段，用于定向人群，默认不限，数组项允许值如下：
	// 1 2 3 4 5 6
	// 1代表年龄段<18
	// 2 代表年龄段在18~23之间
	// 3代表年龄段在24~30之间
	// 4代表年龄段在31~40之间
	// 5代表年龄段在41~49之间
	// 6代表年龄段>50
	// 如：[2,4]代表年龄段在18~23之间或31~40之间
	Age []int `json:"age,omitempty"`
	// Label 商品标签，小说库特有字段
	Label string `json:"label,omitempty"`
	// ExternalURL 落地页链接
	ExternalURL string `json:"external_url,omitempty"`
	// BrandName 商品名称
	BrandName string `json:"brand_name,omitempty"`
	// Tags 商品标签
	Tags []string `json:"tags,omitempty"`
	// Video 视频链接url
	Video string `json:"video,omitempty"`
	// Videos 视频内容，小说库特有字段
	Videos []Link `json:"videos,omitempty"`
	// HasVideo 当前商品是否有商品视频 0：没有，1：有
	HasVideo int `json:"has_video,omitempty"`
	// Profession 额外信息
	Profession *Profession `json:"profession,omitempty"`
}

ProductForUpdate 商品详情

type ProductStatusBatchUpdateRequest added in v1.8.0 

type ProductStatusBatchUpdateRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// PlatformID 商品库ID
	PlatformID uint64 `json:"platform_id,omitempty"`
	// ProductIDs 商品ID
	ProductIDs []uint64 `json:"product_ids,omitempty"`
	// OptStatus 操作
	// ENABLE开启投放
	// DISABLE停止投放
	OptStatus string `json:"opt_status,omitempty"`
}

ProductStatusBatchUpdateRequest 批量修改DPA商品状态 API Request

func (ProductStatusBatchUpdateRequest) Encode added in v1.8.0 

func (r ProductStatusBatchUpdateRequest) Encode() []byte

Encode implement PostRequest interface

type ProductStatusBatchUpdateResponse added in v1.8.0 

type ProductStatusBatchUpdateResponse struct {
	model.BaseResponse
	Data *ProductStatusBatchUpdateResponseData `json:"data,omitempty"`
}

ProductStatusBatchUpdateResponse 批量修改DPA商品状态 API Response

type ProductStatusBatchUpdateResponseData added in v1.8.0 

type ProductStatusBatchUpdateResponseData struct {
	// SuccessList 修改状态成功的商品列表
	SuccessList []uint64 `json:"success_list,omitempty"`
	// ErrorList 修改状态失败的商品列表
	ErrorList []UpdateError `json:"error_list,omitempty"`
}

type ProductUpdateRequest added in v1.8.0 

type ProductUpdateRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// PlatformID 商品库ID
	PlatformID uint64 `json:"platform_id,omitempty"`
	// ProductID 商品ID
	ProductID uint64 `json:"product_id,omitempty"`
	// ProductInfo 商品详情，包括商品库基础字段、落地页、品牌、商户、价格以及其他字段信息，以下所有字段均包含在该结构体下，且不同类型商品库填入字段存在差异，具体格式见下方字段详情
	ProductInfo *ProductForUpdate `json:"product_info,omitempty"`
}

ProductUpdateRequest 创建DPA商品（已有商品id）/修改DPA商品 API Request

func (ProductUpdateRequest) Encode added in v1.8.0 

func (r ProductUpdateRequest) Encode() []byte

Encode implement PostRequest interface

type ProductUpdateResponse added in v1.8.0 

type ProductUpdateResponse struct {
	model.BaseResponse
	Data struct {
		// ProductID 商品ID
		ProductID uint64 `json:"product_id,omitempty"`
	} `json:"data,omitempty"`
}

ProductUpdateResponse 创建DPA商品（已有商品id）/修改DPA商品 API Response

type Profession 

type Profession struct {
	// Platform 平台信息，枚举值：淘宝 天猫 京东 其他
	Platform string `json:"platform,omitempty"`
	// Chapter 章节信息，结构为一个json字符串，章节名称name长度小于100；章节详细内容content长度小于5000
	// 示例："[{"id":"0","name":"莫欺少年穷","content":"莫欺少年穷"},{"id":"1","name":"莫欺中年穷","content":"莫欺中年穷"}]"
	Chapter string `json:"chapter,omitempty"`
	// NovelLength 书籍长短篇，枚举值：长篇书 短篇书
	NovelLength string `json:"novel_length,omitempty"`
	// NovelGender 书籍男女频，枚举值：男频书 女频书 其他
	NovelGender string `json:"novel_gender,omitempty"`
	// NovelAuthor 书籍作者
	NovelAuthor string `json:"novel_author,omitempty"`
	// NovelStar 书籍收藏数
	NovelStar string `json:"novel_star,omitempty"`
	// NovelType 书籍付费/免费信息，枚举值：免费小说 付费小说
	NovelType string `json:"novel_type,omitempty"`
	// StartPayChapter 起始付费章节
	StartPayChapter string `json:"start_pay_chapter,omitempty"`
	// MinPayMoney 最低付费金额
	MinPayMoney string `json:"min_pay_money,omitempty"`
	// AccPayPeople 累计付费人数
	AccPayPeople string `json:"acc_pay_people,omitempty"`
	// AccPayMoney 累计付费金额
	AccPayMoney string `json:"acc_pay_money,omitempty"`
}

Profession 额外信息

type ShopKeeperInfo 

type ShopKeeperInfo struct {
	// ShopKeeperID 商户ID
	ShopKeeperID string `json:"shop_keeper_id,omitempty"`
	// ShopKeeperName 商户名称
	ShopKeeperName string `json:"shop_keeper_name,omitempty"`
	ShopKeeperLogo string `json:"shop_keeper_logo,omitempty"`
	// ShopKeeperURL PC端商户落地页URL
	ShopKeeperURL string `json:"shop_keeper_url,omitempty"`
	// ShopKeeperURLMobile H5页面商户落地页URL
	ShopKeeperURLMobile string `json:"shop_keeper_url_mobile,omitempty"`
	// ShopKeeperURLAndroidApp Android应用商户直达调起链接
	ShopKeeperURLAndroidApp string `json:"shop_keeper_url_android_app,omitempty"`
	// ShopKeeperURLIosApp IOS应用商户直达调起链接
	ShopKeeperURLIosApp string `json:"shop_keeper_url_ios_app,omitempty"`
	// ShopKeeperURLUniversalLink IOS应用商户调起ulink链接
	ShopKeeperURLUniversalLink string `json:"shop_keeper_url_universal_link,omitempty"`
	// Address 商户地址
	Address string `json:"address,omitempty"`
}

ShopKeeperInfo 商户信息

type Template added in v1.8.0 

type Template struct {
	// TemplateID 模板id
	TemplateID uint64 `json:"template_id,omitempty"`
	// TemplateName 模板名称
	TemplateName string `json:"template_name,omitempty"`
	// TemplateMode 模板类型，对应创意素材类型中的大图小图组图
	TemplateMode string `json:"template_mode,omitempty"`
	// Industry 行业
	Industry uint64 `json:"industry,omitempty"`
	// IsPublic 是否是公共模板
	IsPublic bool `json:"is_public,omitempty"`
	// TemplateDataList 模板数据列表
	TemplateDataList []TemplateData `json:"template_data_list,omitempty"`
}

Template 模板

type TemplateData added in v1.8.0 

type TemplateData struct {
	// WebURL 背景图
	WebURL string `json:"web_url,omitempty"`
	// TemplateImageURL 预览图
	TemplateImageURL string `json:"template_image_url,omitempty"`
}

TemplateData 模板数据

type TemplateGetRequest added in v1.8.0 

type TemplateGetRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// Page 页码， 默认值: 1
	Page int `json:"page,omitempty"`
	// PageSize 页面数据量， 默认值: 10，最大 100
	PageSize int `json:"page_size,omitempty"`
}

TemplateGetRequest 获取DPA模板 API Request

func (TemplateGetRequest) Encode added in v1.8.0 

func (r TemplateGetRequest) Encode() string

Encode implement GetRequest interface

type TemplateGetResponse added in v1.8.0 

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

TemplateGetResponse 获取DPA模板 API Response

type TemplateGetResponseData added in v1.8.0 

type TemplateGetResponseData struct {
	// PageInfo 分页信息
	PageInfo *model.PageInfo `json:"page_info,omitempty"`
	// List 模板列表
	List []Template `json:"list,omitempty"`
}

TemplateGetResponseData 返回值

type UpdateError added in v1.8.0 

type UpdateError struct {
	// ProductID 修改失败的商品id
	ProductID uint64 `json:"product_id,omitempty"`
	// ErrorMsg 失败原因
	ErrorMsg string `json:"error_msg,omitempty"`
}

type Video added in v1.8.0 

type Video struct {
	// ProductPlatformID 商品库id
	ProductPlatformID uint64 `json:"product_platform_id,omitempty"`
	// ProductID 商品库商品id
	ProductID uint64 `json:"product_id,omitempty"`
	// PackageID 商品库视频模板id
	PackageID string `json:"package_id,omitempty"`
	// Name 商品库视频模板名称
	Name string `json:"name,omitempty"`
	// CreateTime 创建时间，格式 %Y-%m-%d %H:%M:%S
	CreateTime string `json:"create_time,omitempty"`
	// ImageInfo 视频模板封面图信息
	ImageInfo *ImageInfo `json:"image_info,omitempty"`
	// VideoInfo 商品库视频模板视频信息
	VideoInfo *VideoInfo `json:"video_info,omitempty"`
}

Video 视频模板

type VideoGetFilter added in v1.8.0 

type VideoGetFilter struct {
	// ProductPlatformIDs 商品库ids，长度限制 50个
	ProductPlatformIDs []uint64 `json:"product_platform_ids,omitempty"`
	// ProductIDs 商品库商品ids，长度限制 50个
	ProductIDs []uint64 `json:"product_ids,omitempty"`
	// StartTime 视频创建的筛选起始时间
	StartTime string `json:"start_time,omitempty"`
	// EndTime 视频创建的筛选结束时间
	EndTime string `json:"end_time,omitempty"`
	// ImageMode 素材类型，详见【附录-枚举值-素材类型】
	// 可选值: CREATIVE_IMAGE_MODE_VIDEO：横版视频,CREATIVE_IMAGE_MODE_VIDEO_VERTICAL：竖版视频
	ImageMode enum.ImageMode `json:"image_mode,omitempty"`
	// PackageID 根据视频模板id搜索，精确匹配，长度限制 50字
	PackageID string `json:"package_id,omitempty"`
	// PackageName 根据视频模板名称搜索，精确匹配 长度限制 50字
	PackageName string `json:"package_name,omitempty"`
}

VideoGetFilter 过滤条件

type VideoGetRequest added in v1.8.0 

type VideoGetRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// Filtering 过滤条件
	Filtering *VideoGetFilter `json:"filtering,omitempty"`
	// Page 页码， 默认值: 1
	Page int `json:"page,omitempty"`
	// PageSize 页面数据量， 默认值: 10，最大 100
	PageSize int `json:"page_size,omitempty"`
}

VideoGetRequest 获取 DPA 商品库视频模板 API Request

func (VideoGetRequest) Encode added in v1.8.0 

func (r VideoGetRequest) Encode() string

Encode implement GetRequest interface

type VideoGetResponse added in v1.8.0 

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

VideoGetResponse 获取 DPA 商品库视频模板 API Response

type VideoGetResponseData added in v1.8.0 

type VideoGetResponseData struct {
	// PageInfo 分页信息
	PageInfo *model.PageInfo `json:"page_info,omitempty"`
	// List 商品视频模板列表
	List []Video `json:"list,omitempty"`
}

VideoGetResponseData 返回值

type VideoInfo added in v1.8.0 

type VideoInfo struct {
	// Height 视频高度
	Height int `json:"height,omitempty"`
	// Width 视频宽度
	Width int `json:"width,omitempty"`
	// ImageMode 视频类型，详见【附录-枚举值-素材类型】
	// 可选值: CREATIVE_IMAGE_MODE_VIDEO：横版视频,CREATIVE_IMAGE_MODE_VIDEO_VERTICAL：竖版视频
	ImageMode enum.ImageMode `json:"image_mode,omitempty"`
	// Status 视频状态，可选值: AVAILABLE：可用,UNAVAILABLE：不可用
	Status string `json:"status,omitempty"`
	// VideoID 视频id
	VideoID string `json:"video_id,omitempty"`
}

VideoInfo 商品库视频模板视频信息

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.