Documentation ¶
Overview ¶
Package dpa 商品广告相关API models
Index ¶
- func CopyProductForUpdateFromProduct(src *Product, dist *ProductForUpdate)
- type Asset
- type AssetsDetailReadRequest
- type AssetsDetailReadResponse
- type AssetsListFilter
- type AssetsListRequest
- type AssetsListResponse
- type AssetsListResponseData
- type AssetsListV2Filter
- type AssetsListV2Request
- type AssetsListV2Response
- type AssetsListV2Result
- type Behaviour
- type BehaviourAvailablesRequest
- type BehaviourAvailablesResponse
- type BrandInfo
- type Category
- type CategoryGetRequest
- type CategoryGetResponse
- type ClueProductDetailRequest
- type ClueProductDetailResponse
- type ClueProductListFilter
- type ClueProductListRequest
- type ClueProductListResponse
- type ClueProductListResult
- type DetailGetFilter
- type DetailGetRequest
- type DetailGetResponse
- type DetailGetResponseData
- type Dict
- type DictGetRequest
- type DictGetResponse
- type ImageInfo
- type LandingInfo
- type Link
- type Meta
- type MetaGetRequest
- type MetaGetResponse
- type Platform
- type PlayletAuthGetRequest
- type PlayletAuthGetResponse
- type PlayletAuthGetResult
- type PriceInfo
- type Product
- type ProductAvailablesRequest
- type ProductAvailablesResponse
- type ProductCategory
- type ProductCreateRequest
- type ProductCreateResponse
- type ProductDeleteRequest
- type ProductDetailGetFilter
- type ProductDetailGetRequest
- type ProductDetailGetResponse
- type ProductForUpdate
- type ProductStatusBatchUpdateRequest
- type ProductStatusBatchUpdateResponse
- type ProductStatusBatchUpdateResponseData
- type ProductUpdateRequest
- type ProductUpdateResponse
- type Profession
- type ShopKeeperInfo
- type Template
- type TemplateData
- type TemplateGetRequest
- type TemplateGetResponse
- type TemplateGetResponseData
- type UpdateError
- type Video
- type VideoGetFilter
- type VideoGetRequest
- type VideoGetResponse
- type VideoGetResponseData
- type VideoInfo
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 品牌logo 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 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 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 商家logo 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 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 ¶
- asset.go
- assets_detail_read.go
- assets_list.go
- assets_list_v2.go
- behaviour.go
- behaviour_availables.go
- category.go
- category_get.go
- clue_product_detail.go
- clue_product_list.go
- detail_get.go
- dict.go
- dict_get.go
- doc.go
- meta.go
- meta_get.go
- platform.go
- playlet_auth_get.go
- product.go
- product_availables.go
- product_create.go
- product_delete.go
- product_detail_get.go
- product_for_update.go
- product_status_batch_update.go
- product_update.go
- template.go
- template_get.go
- video.go
- video_get.go