Documentation
¶
Index ¶
- func AesDecrypt(crypted, key, iv []byte) ([]byte, error)
- func Base64Decode(encodeString string) ([]byte, error)
- func Base64Encode(str []byte) string
- func NewCredentials(appId int64, appSecret string) *auth.Credentials
- func PKCS5UnPadding(origData []byte) []byte
- type AdBidUpdateBody
- type AdBidUpdateBodyData
- type AdBidUpdateReq
- type AdBidUpdateRes
- type AdBidUpdateResData
- type AdBidUpdateResDataError
- type AdBudgetUpdateBody
- type AdBudgetUpdateBodyData
- type AdBudgetUpdateReq
- type AdBudgetUpdateRes
- type AdBudgetUpdateResData
- type AdBudgetUpdateResDataError
- type AdCreateAudience
- type AdCreateBody
- type AdCreateCreative
- type AdCreateCreativeList
- type AdCreateCustomVideoMaterial
- type AdCreateDeliverySetting
- type AdCreateDynamicWords
- type AdCreateImageMaterial
- type AdCreateProgrammaticCreativeCard
- type AdCreateProgrammaticCreativeMediaList
- type AdCreateProgrammaticCreativeTitleList
- type AdCreatePromotionCardMaterial
- type AdCreateReq
- type AdCreateRes
- type AdCreateResData
- type AdCreateTitleMaterial
- type AdDetailGetReq
- type AdDetailGetRes
- type AdDetailGetResData
- type AdListGetFiltering
- type AdListGetReq
- type AdListGetRes
- type AdListGetResData
- type AdListGetResDataDetail
- type AdRejectReasonReq
- type AdRejectReasonRes
- type AdRejectReasonResData
- type AdStatusUpdateBody
- type AdStatusUpdateReq
- type AdStatusUpdateRes
- type AdStatusUpdateResData
- type AdStatusUpdateResDataError
- type AdUpdateAudience
- type AdUpdateBody
- type AdUpdateCreative
- type AdUpdateCreativeList
- type AdUpdateCustomVideoMaterial
- type AdUpdateDeliverySetting
- type AdUpdateDynamicWords
- type AdUpdateImageMaterial
- type AdUpdateProgrammaticCreativeCard
- type AdUpdateProgrammaticCreativeMediaList
- type AdUpdateProgrammaticCreativeTitleList
- type AdUpdatePromotionCardMaterial
- type AdUpdateReq
- type AdUpdateRes
- type AdUpdateResData
- type AdUpdateTitleMaterial
- type AdvertiserInfoReq
- type AdvertiserInfoRes
- type AdvertiserInfoResData
- type AdvertiserListReq
- type AdvertiserListRes
- type AdvertiserListResCom
- type AdvertiserListResData
- type AdvertiserPublicInfoReq
- type AdvertiserPublicInfoRes
- type AdvertiserPublicInfoResData
- type AdvertiserReportFiltering
- type AdvertiserReportReq
- type AdvertiserReportRes
- type AdvertiserReportResData
- type AdvertiserReportResDetail
- type AgentAdvertiserListReq
- type AgentAdvertiserListRes
- type AgentAdvertiserListResCom
- type AgentInfoReq
- type AgentInfoRes
- type AgentInfoResData
- type AwemeAuthorizedGetReq
- type AwemeAuthorizedGetRes
- type AwemeAuthorizedGetResDetail
- type BatchCampaignStatusUpdateBody
- type BatchCampaignStatusUpdateReq
- type BatchCampaignStatusUpdateRes
- type BatchCampaignStatusUpdateResData
- type CampaignCreateBody
- type CampaignCreateReq
- type CampaignCreateRes
- type CampaignCreateResData
- type CampaignListGetFilter
- type CampaignListGetReq
- type CampaignListGetRes
- type CampaignListGetResData
- type CampaignListGetResDataDetail
- type CampaignUpdateBody
- type CampaignUpdateReq
- type CampaignUpdateRes
- type CampaignUpdateResData
- type CreativeGetReq
- type CreativeGetReqFiltering
- type CreativeGetRes
- type CreativeGetResDetail
- type CreativeRejectReasonReq
- type CreativeRejectReasonRes
- type CreativeRejectReasonResDetail
- type CreativeStatusUpdateReq
- type CreativeStatusUpdateReqBody
- type CreativeStatusUpdateRes
- type DmpAudiencesGetReq
- type DmpAudiencesGetRes
- type DmpAudiencesGetResDetail
- type FileImageAdReq
- type FileImageAdReqBody
- type FileImageAdRes
- type FileImageGetReq
- type FileImageGetReqFiltering
- type FileImageGetRes
- type FileImageGetResDetail
- type FileVideoAdReq
- type FileVideoAdReqBody
- type FileVideoAdRes
- type FileVideoAdResDetail
- type FileVideoAwemeGetReq
- type FileVideoAwemeGetReqFiltering
- type FileVideoAwemeGetRes
- type FileVideoAwemeGetResDetail
- type FileVideoGetReq
- type FileVideoGetReqFiltering
- type FileVideoGetRes
- type FileVideoGetResDetail
- type Manager
- func (m *Manager) AdBidUpdate(req AdBidUpdateReq) (res *AdBidUpdateRes, err error)
- func (m *Manager) AdBudgetUpdate(req AdBudgetUpdateReq) (res *AdBudgetUpdateRes, err error)
- func (m *Manager) AdCreate(req AdCreateReq) (res *AdCreateRes, err error)
- func (m *Manager) AdDetailGet(req AdDetailGetReq) (res *AdDetailGetRes, err error)
- func (m *Manager) AdListGet(req AdListGetReq) (res *AdListGetRes, err error)
- func (m *Manager) AdRejectReason(req AdRejectReasonReq) (res *AdRejectReasonRes, err error)
- func (m *Manager) AdStatusUpdate(req AdStatusUpdateReq) (res *AdStatusUpdateRes, err error)
- func (m *Manager) AdUpdate(req AdUpdateReq) (res *AdUpdateRes, err error)
- func (m *Manager) AdvertiserInfo(req AdvertiserInfoReq) (res *AdvertiserInfoRes, err error)
- func (m *Manager) AdvertiserList(req AdvertiserListReq) (res *AdvertiserListRes, err error)
- func (m *Manager) AdvertiserPublicInfo(req AdvertiserPublicInfoReq) (res *AdvertiserPublicInfoRes, err error)
- func (m *Manager) AdvertiserReport(req AdvertiserReportReq) (res *AdvertiserReportRes, err error)
- func (m *Manager) AgentAdvertiserList(req AgentAdvertiserListReq) (res *AgentAdvertiserListRes, err error)
- func (m *Manager) AgentInfo(req AgentInfoReq) (res *AgentInfoRes, err error)
- func (m *Manager) AwemeAuthorizedGet(req AwemeAuthorizedGetReq) (res *AwemeAuthorizedGetRes, err error)
- func (m *Manager) BatchCampaignStatusUpdate(req BatchCampaignStatusUpdateReq) (res *BatchCampaignStatusUpdateRes, err error)
- func (m *Manager) CampaignCreate(req CampaignCreateReq) (res *CampaignCreateRes, err error)
- func (m *Manager) CampaignListGet(req CampaignListGetReq) (res *CampaignListGetRes, err error)
- func (m *Manager) CampaignUpdate(req CampaignUpdateReq) (res *CampaignUpdateRes, err error)
- func (m *Manager) CreativeGet(req CreativeGetReq) (res *CreativeGetRes, err error)
- func (m *Manager) CreativeRejectReason(req CreativeRejectReasonReq) (res *CreativeRejectReasonRes, err error)
- func (m *Manager) CreativeStatusUpdate(req CreativeStatusUpdateReq) (res *CreativeStatusUpdateRes, err error)
- func (m *Manager) DmpAudiencesGet(req DmpAudiencesGetReq) (res *DmpAudiencesGetRes, err error)
- func (m *Manager) FileImageAd(req FileImageAdReq) (res *FileImageAdRes, err error)
- func (m *Manager) FileImageGet(req FileImageGetReq) (res *FileImageGetRes, err error)
- func (m *Manager) FileVideoAd(req FileVideoAdReq) (res *FileVideoAdRes, err error)
- func (m *Manager) FileVideoAwemeGet(req FileVideoAwemeGetReq) (res *FileVideoAwemeGetRes, err error)
- func (m *Manager) FileVideoGet(req FileVideoGetReq) (res *FileVideoGetRes, err error)
- func (m *Manager) OauthAccessToken(req OauthAccessTokenReq) (res OauthAccessTokenRes, err error)
- func (m *Manager) OauthConnect(param OauthParam) string
- func (m *Manager) OauthRefreshToken(req OauthRefreshTokenReq) (res OauthRefreshTokenRes, err error)
- func (m *Manager) ProductAvailableGet(req ProductAvailableGetReq) (res *ProductAvailableGetRes, err error)
- func (m *Manager) ReportAdGet(req ReportAdGetReq) (res *ReportAdGetRes, err error)
- func (m *Manager) ReportCreativeGet(req ReportCreativeGetReq) (res *ReportCreativeGetRes, err error)
- func (m *Manager) ShopAccountInfo(req ShopAccountInfoReq) (res *ShopAccountInfoRes, err error)
- func (m *Manager) ShopAdvertiserList(req ShopAdvertiserListReq) (res *ShopAdvertiserListRes, err error)
- func (m *Manager) ToolsAwemeCategoryTopAuthorGet(req ToolsAwemeCategoryTopAuthorGetReq) (res *ToolsAwemeCategoryTopAuthorGetRes, err error)
- func (m *Manager) ToolsAwemeMultiLevelCategoryGet(req ToolsAwemeMultiLevelCategoryGetReq) (res *ToolsAwemeMultiLevelCategoryGetRes, err error)
- func (m *Manager) ToolsCreativeWordSelect(req ToolsCreativeWordSelectReq) (res *ToolsCreativeWordSelectRes, err error)
- func (m *Manager) ToolsIndustryGet(req ToolsIndustryGetReq) (res *ToolsIndustryGetRes, err error)
- func (m *Manager) ToolsInterestActionActionCategory(req ToolsInterestActionActionCategoryReq) (res *ToolsInterestActionActionCategoryRes, err error)
- func (m *Manager) ToolsInterestActionActionKeyword(req ToolsInterestActionActionKeywordReq) (res *ToolsInterestActionActionKeywordRes, err error)
- func (m *Manager) ToolsInterestActionInterestCategory(req ToolsInterestActionInterestCategoryReq) (res *ToolsInterestActionInterestCategoryRes, err error)
- func (m *Manager) ToolsInterestActionInterestKeyword(req ToolsInterestActionInterestKeywordReq) (res *ToolsInterestActionInterestKeywordRes, err error)
- func (m *Manager) UserInfo(req UserInfoReq) (res *UserInfoRes, err error)
- type OauthAccessTokenReq
- type OauthAccessTokenRes
- type OauthAccessTokenResData
- type OauthParam
- type OauthRefreshTokenReq
- type OauthRefreshTokenRes
- type OauthRefreshTokenResData
- type PageInfo
- type ProductAvailableGetFilter
- type ProductAvailableGetReq
- type ProductAvailableGetRes
- type ProductAvailableGetResDetail
- type QCError
- type ReportAdGetFiltering
- type ReportAdGetReq
- type ReportAdGetRes
- type ReportAdGetResData
- type ReportAdGetResDetail
- type ReportCreativeGetFiltering
- type ReportCreativeGetReq
- type ReportCreativeGetRes
- type ReportCreativeGetResData
- type ReportCreativeGetResDataDetail
- type ShopAccountInfoReq
- type ShopAccountInfoRes
- type ShopAccountInfoResCom
- type ShopAccountInfoResComDetail
- type ShopAdvertiserListReq
- type ShopAdvertiserListRes
- type ShopAdvertiserListResCom
- type ToolsAwemeCategoryTopAuthorGetReq
- type ToolsAwemeCategoryTopAuthorGetRes
- type ToolsAwemeCategoryTopAuthorGetResAuthor
- type ToolsAwemeMultiLevelCategoryGetReq
- type ToolsAwemeMultiLevelCategoryGetRes
- type ToolsAwemeMultiLevelCategoryGetResCategory
- type ToolsCreativeWordSelectReq
- type ToolsCreativeWordSelectRes
- type ToolsCreativeWordSelectResDetail
- type ToolsIndustryGetReq
- type ToolsIndustryGetRes
- type ToolsIndustryGetResDetail
- type ToolsInterestActionActionCategoryReq
- type ToolsInterestActionActionCategoryRes
- type ToolsInterestActionActionCategoryResLevelFour
- type ToolsInterestActionActionCategoryResLevelOne
- type ToolsInterestActionActionCategoryResLevelThree
- type ToolsInterestActionActionCategoryResLevelTwo
- type ToolsInterestActionActionKeywordReq
- type ToolsInterestActionActionKeywordRes
- type ToolsInterestActionActionKeywordResDetail
- type ToolsInterestActionInterestCategoryReq
- type ToolsInterestActionInterestCategoryRes
- type ToolsInterestActionInterestCategoryResLevelFour
- type ToolsInterestActionInterestCategoryResLevelOne
- type ToolsInterestActionInterestCategoryResLevelThree
- type ToolsInterestActionInterestCategoryResLevelTwo
- type ToolsInterestActionInterestKeywordReq
- type ToolsInterestActionInterestKeywordRes
- type ToolsInterestActionInterestKeywordResDetail
- type UserInfoReq
- type UserInfoRes
- type UserInfoResCom
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func NewCredentials ¶
func NewCredentials(appId int64, appSecret string) *auth.Credentials
NewCredentials 获取认证
Types ¶
type AdBidUpdateBody ¶
type AdBidUpdateBody struct {
AdvertiserId int64 `json:"advertiser_id"` //广告主id
Data []AdBidUpdateBodyData `json:"data"` //更新计划出价的列表,最多支持10个
}
type AdBidUpdateBodyData ¶
type AdBidUpdateReq ¶
type AdBidUpdateReq struct {
AccessToken string // 调用/oauth/access_token/生成的token,此token需要用户授权。
Body AdBidUpdateBody // POST请求的data
}
AdBidUpdateReq 更新计划出价 的 请求结构体
type AdBidUpdateRes ¶
type AdBidUpdateRes struct {
QCError
Data AdBidUpdateResData `json:"data"`
}
AdBidUpdateRes 更新计划出价 的 响应结构体
type AdBidUpdateResData ¶
type AdBidUpdateResData struct {
AdId []int64 `json:"ad_id"` //更新成功的计划id
Errors []AdBidUpdateResDataError `json:"errors"` //更新失败的计划id和失败原因
}
type AdBidUpdateResDataError ¶
type AdBudgetUpdateBody ¶
type AdBudgetUpdateBody struct {
AdvertiserId int64 `json:"advertiser_id"` //广告主id
Data []AdBudgetUpdateBodyData `json:"data"` //更新预算的计划id和预算价格列表,最多支持10个
}
type AdBudgetUpdateBodyData ¶
type AdBudgetUpdateReq ¶
type AdBudgetUpdateReq struct {
AccessToken string // 调用/oauth/access_token/生成的token,此token需要用户授权。
Body AdBudgetUpdateBody // POST请求的data
}
AdBudgetUpdateReq 更新计划预算 的 请求结构体
type AdBudgetUpdateRes ¶
type AdBudgetUpdateRes struct {
QCError
Data AdBudgetUpdateResData `json:"data"`
}
AdBudgetUpdateRes 更新计划预算 的 响应结构体
type AdBudgetUpdateResData ¶
type AdBudgetUpdateResData struct {
AdId []int64 `json:"ad_id"` //更新成功的计划id
Errors []AdBudgetUpdateResDataError `json:"errors"` //更新失败的计划id和失败原因
}
type AdCreateAudience ¶
type AdCreateAudience struct {
District string `json:"district,omitempty"` // 地域定向类型,配合 city 字段使用,允许值:CITY 省市, COUNTY 区县, NONE 不限默认值为NONE
City []int64 `json:"city,omitempty"` // 具体定向的城市列表,当 district 为COUNTY,CITY为必填,枚举值详见【附件-city.json】省市的传法:"city" : [12], "district" : "CITY"区县的传法:"city" : [130102], "district" : "COUNTY"
LocationType string `json:"location_type,omitempty"` // 地域定向的用户状态类型,当 district 为COUNTY,CITY为必填,允许值:CURRENT 正在该地区的用户、HOME 居住在该地区的用户、TRAVEL 到该地区旅行的用户、ALL 该地区内的所有用户
Gender string `json:"gender,omitempty"` // 性别,允许值:GENDER_FEMALE 女性, GENDER_MALE 男性,NONE 不限
Age []string `json:"age,omitempty"` // 年龄,详见【附录-受众年龄区间】,允许值:AGE_BETWEEN_18_23, AGE_BETWEEN_24_30、AGE_BETWEEN_31_40、AGE_BETWEEN_41_49、AGE_ABOVE_50
AwemeFanBehaviors []string `json:"aweme_fan_behaviors,omitempty"` // 抖音用户行为类型,详见【附录-抖音达人互动用户行为类型】
AwemeFanBehaviorsDays string `json:"aweme_fan_behaviors_days,omitempty"` // 抖音达人互动用户行为天数
AwemeFanCategories []int64 `json:"aweme_fan_categories,omitempty"` // 抖音达人分类ID列表,与aweme_fan_behaviors同时设置才会生效(抖音达人定向),可通过【工具-抖音达人-查询抖音类目列表】接口获取
AwemeFanAccounts []int64 `json:"aweme_fan_accounts,omitempty"` // 抖音达人ID列表,与aweme_fan_behaviors同时设置才会生效(抖音达人定向),可通过【工具-抖音达人-查询抖音类目下的推荐达人】接口获取
AutoExtendEnabled int64 `json:"auto_extend_enabled,omitempty"` // 是否启用智能放量,允许值:0 关闭、1 开启
AutoExtendTargets []string `json:"auto_extend_targets,omitempty"` // 可放开定向列表。当auto_extend_enabled=1 时必填。允许值:AGE 年龄、REGION 地域、GENDER 性别、INTEREST_ACTION 行为兴趣 、CUSTOM_AUDIENCE 更多人群-自定义人群
Platform []string `json:"platform,omitempty"` // 投放平台列表,允许值:ANDROID、 IOS、不传值为全选
SmartInterestAction string `json:"smart_interest_action,omitempty"` // 行为兴趣意向定向模式,允许值:RECOMMEND系统推荐,CUSTOM 自定义;不传值则为不限制需要注意:如果设置RECOMMEND,则传入action_scene、action_days、action_categories、action_words、 interest_categories、interest_words字段都无效
ActionScene []string `json:"action_scene,omitempty"` // 行为场景,详见【附录-行为场景】,smart_interest_actionCUSTOM时有效,允许值:E-COMMERCE 电商互动行为、NEWS 资讯互动行为、APP APP推广互动行为
ActionDays int64 `json:"action_days,omitempty"` // 用户发生行为天数,当 smart_interest_action 传 CUSTOM 时有效允许值:7, 15, 30, 60, 90, 180, 365
ActionCategories []int64 `json:"action_categories,omitempty"` // 行为类目词,当 smart_interest_action 传 CUSTOM 时有效行为类目可以通过【工具-行为兴趣词管理-行为类目查询】获取
ActionWords []int64 `json:"action_words,omitempty"` // 行为关键词,当 smart_interest_action 传 CUSTOM 时有效行为关键词可以通过【工具-行为兴趣词管理-行为关键词查询】获取
InterestCategories []int64 `json:"interest_categories,omitempty"` // 兴趣类目词,当 smart_interest_action 传 CUSTOM 时有效兴趣类目可以通过【工具-行为兴趣词管理-兴趣类目查询】获取
InterestWords []int64 `json:"interest_words,omitempty"` // 兴趣关键词,当 smart_interest_action 传 CUSTOM 时有效行为关键词可以通过【工具-行为兴趣词管理-行为关键词查询】获取
Ac []string `json:"ac,omitempty"` // 网络类型, 详见【附录-受众网络类型】,允许值:WIFI、2G、3G、4G。 不传值或全传为全选
RetargetingTagsInclude []int64 `json:"retargeting_tags_include,omitempty"` // 定向人群包id列表,长度限制 0-200。定向人群包可以通过【工具-DMP人群管理-获取人群包列表】获取
RetargetingTagsExclude []int64 `json:"retargeting_tags_exclude,omitempty"` // 排除人群包id列表,长度限制 0-200。排除人群包可以通过【工具-DMP人群管理-获取人群包列表】获取
LivePlatformTags []string `json:"live_platform_tags,omitempty"` // 直播带货平台精选人群包,当marketing_goal=LIVE_PROM_GOODS时有效,默认为全不选。允许值:LARGE_FANSCOUNT 高关注人群、ABNORMAL_ACTIVE高活跃人群、AWEME_FANS抖音号粉丝
}
type AdCreateBody ¶
type AdCreateBody struct {
AdvertiserId int64 `json:"advertiser_id"` // 千川广告主账户id
MarketingGoal string `json:"marketing_goal"` // 营销目标,允许值:VIDEO_PROM_GOODS 短视频带货、LIVE_PROM_GOODS 直播带货
PromotionWay string `json:"promotion_way,omitempty"` // 推广方式 ,目前仅支持专业版,不支持极速版,允许值:STANDARD(默认)
Name string `json:"name"` // 计划名称,长度为1-100个字符,其中1个汉字算2位字符。名称不可重复,否则会报错
CampaignId int64 `json:"campaign_id"` // 千川广告组id
AwemeId int64 `json:"aweme_id"`
ProductIds []int64 `json:"product_ids,omitempty"`
DeliverySetting AdCreateDeliverySetting `json:"delivery_setting"`
Audience AdCreateAudience `json:"audience"`
AdCreateCreative
}
type AdCreateCreative ¶
type AdCreateCreative struct {
CreativeMaterialMode string `json:"creative_material_mode"` // 创意呈现方式,允许值:CUSTOM_CREATIVE 自定义创意、PROGRAMMATIC_CREATIVE 程序化创意
FirstIndustryId int64 `json:"first_industry_id"` // 创意一级行业ID。可从【获取行业列表】接口获取
SecondIndustryId int64 `json:"second_industry_id"` // 创意二级行业ID。可从【获取行业列表】接口获取
ThirdIndustryId int64 `json:"third_industry_id"` // 创意三级行业ID。可从【获取行业列表】接口获取
AdKeywords []string `json:"ad_keywords,omitempty"` // 创意标签。最多20个标签,且每个标签长度要求为1~20个字符,汉字算2个字符
CreativeList []AdCreateCreativeList `json:"creative_list,omitempty"` // 自定义素材信息
CreativeAutoGenerate int64 `json:"creative_auto_generate,omitempty"` // 是否开启「生成更多创意」
ProgrammaticCreativeMediaList []AdCreateProgrammaticCreativeMediaList `json:"programmatic_creative_media_list,omitempty"` // 程序化创意素材信息
ProgrammaticCreativeTitleList []AdCreateProgrammaticCreativeTitleList `json:"programmatic_creative_title_list,omitempty"` // 程序化创意标题信息
ProgrammaticCreativeCard *AdCreateProgrammaticCreativeCard `json:"programmatic_creative_card,omitempty"` // 程序化创意推广卡片信息
IsHomepageHide int64 `json:"is_homepage_hide,omitempty"` // 抖音主页是否隐藏视频
}
type AdCreateCreativeList ¶
type AdCreateCreativeList struct {
ImageMode string `json:"image_mode,omitempty"` // 创意素材类型
VideoMaterial *AdCreateCustomVideoMaterial `json:"video_material,omitempty"` // 视频类型素材
ImageMaterial *AdCreateImageMaterial `json:"image_material,omitempty"` // 图片类型素材
TitleMaterial *AdCreateTitleMaterial `json:"title_material,omitempty"` // 标题类型素材,若选择了抖音号上的视频,不支持修改标题
PromotionCardMaterial *AdCreatePromotionCardMaterial `json:"promotion_card_material,omitempty"` // 推广卡片素材
}
AdCreateCreativeList 广告创意 - creative_list
type AdCreateCustomVideoMaterial ¶
type AdCreateCustomVideoMaterial struct {
VideoId string `json:"video_id,omitempty"` // 视频ID
VideoCoverId string `json:"video_cover_id,omitempty"` // 视频封面ID
AwemeItemId int64 `json:"aweme_item_id,omitempty"` // 抖音视频ID
}
AdCreateCustomVideoMaterial 广告创意 - 视频类型素材
type AdCreateDeliverySetting ¶
type AdCreateDeliverySetting struct {
SmartBidType string `json:"smart_bid_type"` // 投放场景(出价方式),详见【附录-自动出价类型】,允许值:SMART_BID_CUSTOM控成本投放、SMART_BID_CONSERVATIVE 放量投放控成本投放:控制成本,尽量消耗完预算放量投放:接受成本上浮,尽量消耗更多预算
FlowControlMode string `json:"flow_control_mode,omitempty"` // 投放速度,详见【附录-计划投放速度类型】仅当 smart_bid_type 为SMART_BID_CUSTOM 时需传值,允许值:FLOW_CONTROL_MODE_FAST 尽快投放(默认值)、FLOW_CONTROL_MODE_BALANCE 均匀投放、FLOW_CONTROL_MODE_SMOOTH 优先低成本,对应千川后台「严格控制成本上限」勾选项
ExternalAction string `json:"external_action"` // 转化目标短视频带货目的允许值:AD_CONVERT_TYPE_SHOPPING 商品购买、AD_CONVERT_TYPE_QC_FOLLOW_ACTION 粉丝提升、AD_CONVERT_TYPE_QC_MUST_BUY 点赞评论直播带货目的允许值:AD_CONVERT_TYPE_LIVE_ENTER_ACTION 进入直播间、AD_CONVERT_TYPE_LIVE_CLICK_PRODUCT_ACTION 直播间商品点击、AD_CONVERT_TYPE_LIVE_SUCCESSORDER_ACTION 直播间下单、AD_CONVERT_TYPE_NEW_FOLLOW_ACTION 直播间粉丝提升、AD_CONVERT_TYPE_LIVE_COMMENT_ACTION 直播间评论、AD_CONVERT_TYPE_LIVE_SUCCESSORDER_PAY直播间成交
DeepExternalAction string `json:"deep_external_action,omitempty"` // 深度转化目标,对应千川后台「期待同时优化」注意:1. 仅直播带货场景支持2. 当 smart_bid_type 为SMART_BID_CUSTOM 且 flow_control_mode 为 FLOW_CONTROL_MODE_SMOOTH 亦不支持深度转化目标允许值:AD_CONVERT_TYPE_LIVE_SUCCESSORDER_ACTION 直播间下单若不传,则不生效;若传入,则仅当转化目标为AD_CONVERT_TYPE_LIVE_ENTER_ACTION、AD_CONVERT_TYPE_LIVE_CLICK_PRODUCT_ACTION 时生效
Budget float64 `json:"budget"` // 预算,最多支持两位小数当预算模式为日预算时,预算范围是300 - 9999999.99;当预算模式为总预算时,预算范围是max(300,投放天数x100) - 9999999.99
BudgetMode string `json:"budget_mode"` // 预算类型(创建后不可修改),详见【附录-预算类型】,允许值:BUDGET_MODE_DAY 日预算,BUDGET_MODE_TOTAL 总预算
CpaBid float64 `json:"cpa_bid,omitempty"` // 转化出价,出价不能大于预算仅当 smart_bid_type 为SMART_BID_CUSTOM 时需传值
VideoScheduleType string `json:"video_schedule_type,omitempty"` // 短视频投放日期选择方式,仅短视频带货场景需入参,允许值:SCHEDULE_FROM_NOW 从今天起长期投放(总预算模式下不支持)、SCHEDULE_START_END 设置开始和结束日期
LiveScheduleType string `json:"live_schedule_type,omitempty"` // 直播间投放时段选择方式,仅直播带货场景需入参,允许值:SCHEDULE_TIME_ALLDAY 全天、SCHEDULE_TIME_WEEKLY_SETTING 指定时间段、SCHEDULE_TIME_FIXEDRANGE 固定时长
StartTime string `json:"start_time,omitempty"` // 投放起始时间,形式如:2017-01-01广告投放起始时间不允许修改。当video_schedule_type为SCHEDULE_START_END 设置开始和结束日期时需传入。当live_schedule_type 为SCHEDULE_TIME_ALLDAY 全天、SCHEDULE_TIME_WEEKLY_SETTING 指定时间段时必填;当 live_schedule_type 为SCHEDULE_TIME_FIXEDRANGE固定时长时不能传入
EndTime string `json:"end_time,omitempty"` // 投放结束时间,形式如:2017-01-01结束时间不能比起始时间早。当video_schedule_type为SCHEDULE_START_END 设置开始和结束日期时需传入。当live_schedule_type 为SCHEDULE_TIME_ALLDAY 全天、SCHEDULE_TIME_WEEKLY_SETTING 指定时间段时必填;当 live_schedule_type 为SCHEDULE_TIME_FIXEDRANGE固定时长时不能传入
ScheduleTime string `json:"schedule_time,omitempty"` // 投放时段,当 live_schedule_type 为SCHEDULE_TIME_WEEKLY_SETTING 时生效默认全时段投放,格式是48*7位字符串,且都是0或1。也就是以半个小时为最小粒度,周一至周日每天分为48个区段,0为不投放,1为投放,不传、全传0、全传1均代表全时段投放。例如:填写"000000000000000000000001111000000000000000000000000000000000000000000001111000000000000000000000000000000000000000000001111000000000000000000000000000000000000000000001111000000000000000000000000000000000000000000001111000000000000000000000000000000000000000000001111000000000000000000000000000000000000000000001111000000000000000000000",则投放时段为周一到周日的11:30~13:30
ScheduleFixedRange int64 `json:"schedule_fixed_range,omitempty"` // 固定投放时长当 live_schedule_type 为 SCHEDULE_TIME_FIXEDRANGE 时必填;当live_schedule_type 为SCHEDULE_TIME_ALLDAY 全天、SCHEDULE_TIME_WEEKLY_SETTING 指定时间段时不能传入。单位为秒,最小值为1800(0.5小时),最大值为48*1800(24小时),值必须为1800倍数,不然会报错
}
type AdCreateDynamicWords ¶
type AdCreateImageMaterial ¶
type AdCreateImageMaterial struct {
ImageIds []string `json:"image_ids,omitempty"` // 图片ID列表
}
AdCreateImageMaterial 广告创意 - 图片类型素材
type AdCreateProgrammaticCreativeCard ¶
type AdCreateProgrammaticCreativeCard struct {
PromotionCardTitle string `json:"promotion_card_title,omitempty"` // 推广卡片标题,最多7个字
PromotionCardSellingPoints []string `json:"promotion_card_selling_points,omitempty"` // 推广卡片卖点列表,卖点文字长度要求为12~18个字符,汉字算2个字符
PromotionCardImageId string `json:"promotion_card_image_id,omitempty"` // 推广卡片配图,可通过【获取图片素材】接口获得图片素材id
PromotionCardActionButton string `json:"promotion_card_action_button,omitempty"` // 推广卡片行动号召按钮文案
PromotionCardButtonSmartOptimization int64 `json:"promotion_card_button_smart_optimization,omitempty"` // 是否对行动号召按钮文案启用智能优选
}
AdCreateProgrammaticCreativeCard 广告创意 - 程序化创意推广卡片信息
type AdCreateProgrammaticCreativeMediaList ¶
type AdCreateProgrammaticCreativeMediaList struct {
ImageMode string `json:"image_mode,omitempty"` // 创意素材类型,支持视频和图片
VideoId string `json:"video_id,omitempty"` // 视频ID
VideoCoverId string `json:"video_cover_id,omitempty"` // 视频封面ID
ImageIds []string `json:"image_ids,omitempty,omitempty"` // 图片ID列表
}
AdCreateProgrammaticCreativeMediaList 广告创意 - 程序化创意素材信息
type AdCreateProgrammaticCreativeTitleList ¶
type AdCreateProgrammaticCreativeTitleList struct {
Title string `json:"title,omitempty"` // 创意标题
DynamicWords []AdCreateDynamicWords `json:"dynamic_words,omitempty"` // 动态词包对象列表
}
AdCreateProgrammaticCreativeTitleList 广告创意 - 程序化创意标题信息
type AdCreatePromotionCardMaterial ¶
type AdCreatePromotionCardMaterial struct {
Title string `json:"title,omitempty"` // 推广卡片标题
SellingPoints []string `json:"selling_points,omitempty"` // 推广卡片卖点列表
ImageId string `json:"image_id,omitempty"` // 推广卡片配图
ActionButton string `json:"action_button,omitempty"` // 推广卡片行动号召按钮文案
ButtonSmartOptimization int64 `json:"button_smart_optimization,omitempty"` // 是否对行动号召按钮文案启用智能优选
}
AdCreatePromotionCardMaterial 广告创意 - 推广卡片素材
type AdCreateReq ¶
type AdCreateReq struct {
AccessToken string // 调用/oauth/access_token/生成的token,此token需要用户授权。
Body AdCreateBody // POST请求的data
}
AdCreateReq 获取广告账户数据-请求
type AdCreateRes ¶
type AdCreateRes struct {
QCError
Data AdCreateResData `json:"data"`
}
AdCreateRes 获取广告账户数据-返回结构体
type AdCreateResData ¶
type AdCreateResData struct {
AdId int64 `json:"ad_id"` // 创建的计划id
}
type AdCreateTitleMaterial ¶
type AdCreateTitleMaterial struct {
Title string `json:"title,omitempty"` // 创意标题
DynamicWords []AdCreateDynamicWords `json:"dynamic_words,omitempty"` // 动态词包对象列表
}
AdCreateTitleMaterial 广告创意 - 标题类型素材,若选择了抖音号上的视频,不支持修改标题
type AdDetailGetReq ¶
type AdDetailGetReq struct {
AdvertiserId int64 `json:"advertiser_id"`
AccessToken string `json:"access_token"`
AdId int64 `json:"ad_id"`
}
AdDetailGetReq 获取计划详情 的 请求结构体
type AdDetailGetRes ¶
type AdDetailGetRes struct {
QCError
Data AdDetailGetResData `json:"data"`
}
AdDetailGetRes 获取计划详情 的 响应结构体
type AdDetailGetResData ¶
type AdDetailGetResData struct {
AdID int64 `json:"ad_id"` //计划ID
CampaignId int64 `json:"campaign_id"` //广告组ID
MarketingGoal string `json:"marketing_goal"` //营销目标
PromotionWay string `json:"promotion_way"` //推广方式
Name string `json:"name"` //计划名称
Status string `json:"status"` //计划投放状态
OptStatus string `json:"opt_status"` //计划操作状态
AdCreateTime string `json:"ad_create_time"` //计划创建时间
AdModifyTime string `json:"ad_modify_time"` //计划修改时间
AwemeInfo []struct {
AwemeAvatar string `json:"aweme_avatar"` //抖音ID
AwemeName string `json:"aweme_name"` //抖音号,即客户在手机端感知到的抖音号,向客户批量抖音号时请使用该字段
AwemeShowID string `json:"aweme_show_id"` //抖音号昵称
AwemeID int64 `json:"aweme_id"` //抖音号头像
} `json:"aweme_info"`
ProductInfo []struct {
ID int64 `json:"id"` //商品id
Name string `json:"name"` //商品名称
DiscountPrice float32 `json:"discount_price"` //售价
Img string `json:"img"` //商品主图
} `json:"product_info"`
RoomInfo []struct {
AnchorName string `json:"anchor_name"` //主播名称
RoomStatus string `json:"room_status"` //直播间状态(若未开播,则返回NULL)
RoomTitle interface{} `json:"room_title"` //直播间名称(若未开播,则返回NULL)
AnchorID int64 `json:"anchor_id"` //主播ID
AnchorAvatar string `json:"anchor_avatar"` //主播头像
} `json:"room_info"`
DeliverySetting struct {
SmartBidType string `json:"smart_bid_type"` //投放场景(出价方式)
FlowControlMode string `json:"flow_control_mode"` //投放速度
ExternalAction string `json:"external_action"` //转化目标
DeepExternalAction string `json:"deep_external_action"` //深度转化目标
Budget float32 `json:"budget"` //预算
BudgetMode string `json:"budget_mode"` //预算类型
CpaBid float32 `json:"cpa_bid"` //转化出价
LiveScheduleType string `json:"live_schedule_type"` //短视频投放日期选择方式
VideoScheduleType string `json:"video_schedule_type"` //直播间投放时段选择方式
StartTime string `json:"start_time"` //投放开始时间
EndTime string `json:"end_time"` //投放结束时间
ScheduleTime string `json:"schedule_time"` //投放时段,当 video_schedule_type 和 live_schedule_type为SCHEDULE_START_END和SCHEDULE_FROM_NOW时有值,格式是48*7位字符串,且都是0或1。也就是以半个小时为最小粒度,周一至周日每天分为48个区段,0为不投放,1为投放,不传、全传0、全传1均代表全时段投放
ScheduleFixedRange int `json:"schedule_fixed_range"` //固定投放时长,当 live_schedule_type 为时有值;单位为秒,最小值为1800(0.5小时),最大值为48*1800(24小时)SCHEDULE_TIME_FIXEDRANGE
} `json:"delivery_setting"`
Audience struct {
District string `json:"district"` //地域定向类型,配合city字段使用,允许值:CITY:省市,COUNTY:区县,NONE:不限;默认值:NONE
City []int64 `json:"city"` //具体定向的城市列表,当 district 为COUNTY,city 为必填,枚举值详见【附件-city.json】;省市传法:city: [12],district: CITY;区县的传法:city: [130102],district: COUNTY
LocationType string `json:"location_type"` //地域定向的用户状态类型,当 district 为COUNTY,CITY为必填,允许值:CURRENT:正在该地区的用户,HOME:居住在该地区的用户,TRAVEL;到该地区旅行的用户,ALL:该地区内的所有用户
Gender string `json:"gender"` //允许值: GENDER_FEMALE:女性,GENDER_MALE:男性,NONE: 不限
Age []string `json:"age"` //年龄,详见【附录-受众年龄区间】;允许值:AGE_BETWEEN_18_23, AGE_BETWEEN_24_30, AGE_BETWEEN_31_40, AGE_BETWEEN_41_49, AGE_ABOVE_50
AwemeFanBehaviors []string `json:"aweme_fan_behaviors"` //抖音达人互动用户行为类型
AwemeFanBehaviorsDays string `json:"aweme_fan_behaviors_days"` //抖音达人互动用户行为天数
AwemeFanCategories []int64 `json:"aweme_fan_categories"` //抖音达人分类ID列表
AwemeFanAccounts []int64 `json:"aweme_fan_accounts"` //抖音达人ID列表
AutoExtendEnabled int64 `json:"auto_extend_enabled"` //是否启用智能放量
AutoExtendTargets []string `json:"auto_extend_targets"` //可放开定向列表
Platform []string `json:"platform"` //投放平台列表
SmartInterestAction string `json:"smart_interest_action"` //行为兴趣意向定向模式
ActionScene []string `json:"action_scene"` //行为场景
ActionDays int64 `json:"action_days"` //用户发生行为天数
ActionCategories []int64 `json:"action_categories"` //行为类目词
ActionWords []int64 `json:"action_words"` //行为关键词
InterestCategories []int64 `json:"interest_categories"` //兴趣类目词
InterestWords []int64 `json:"interest_words"` //兴趣关键词
Ac []string `json:"ac"` //网络类型
RetargetingTagsInclude []int64 `json:"retargeting_tags_include"` //定向人群包id列表
RetargetingTagsExclude []int64 `json:"retargeting_tags_exclude"` //排除人群包id列表
LivePlatformTags []string `json:"live_platform_tags"` //直播带货平台精选人群包
} `json:"audience"`
CreativeMaterialMode string `json:"creative_material_mode"` //创意呈现方式
FirstIndustryID int `json:"first_industry_id"` //创意一级行业ID
SecondIndustryID int `json:"second_industry_id"` //创意二级行业ID
ThirdIndustryID int `json:"third_industry_id"` //创意三级行业ID
AdKeywords []string `json:"ad_keywords"` //创意标签
CreativeList []struct {
CreativeID int64 `json:"creative_id"` //创意ID,程序化创意审核通过后才会生成创意ID
ImageMode string `json:"image_mode"` //创意素材类型
CreativeCreateTime string `json:"creative_create_time"` //创意创建时间
CreativeModifyTime string `json:"creative_modify_time"` //创意修改时间
VideoMaterial struct {
Id int64 `json:"id"` //素材唯一标识
VideoId string `json:"video_id"` //视频ID
VideoCoverId string `json:"video_cover_id"` //视频封面ID
AwemeItemId int64 `json:"aweme_item_id"` //抖音视频ID
IsAutoGenerate int64 `json:"is_auto_generate"` //是否为派生创意标识,1:是,0:不是
} `json:"video_material"`
ImageMaterial struct {
Id int64 `json:"id"` //素材唯一标识
ImageIds []string `json:"image_ids"` //图片ID列表
IsAutoGenerate int64 `json:"is_auto_generate"` //是否为派生创意标识,1:是,0:不是
} `json:"image_material"`
TitleMaterial struct {
Id int64 `json:"id"` //素材唯一标识
Title string `json:"title"` //创意标题
DynamicWords struct {
WordId int64 `json:"word_id"` //动态词包ID
DictName string `json:"dict_name"` //创意词包名称
DefaultWord string `json:"default_word"` //创意词包默认词
} `json:"dynamic_words"`
} `json:"title_material"`
PromotionCardMaterial struct {
Id int64 `json:"id"` //素材唯一标识
ComponentId int64 `json:"component_id"` //组件唯一标识
Title string `json:"title"` //推广卡片标题
SellingPoints []string `json:"selling_points"` //推广卡片卖点列表
ImageId string `json:"image_id"` //推广卡片配图ID
ActionButton string `json:"action_button"` //推广卡片行动号召按钮文案
ButtonSmartOptimization int64 `json:"button_smart_optimization"` //智能优选行动号召按钮文案开关
} `json:"promotion_card_material"`
} `json:"creative_list"`
ProgrammaticCreativeMediaList []struct {
ImageMode string `json:"image_mode"` //创意素材类型
VideoId string `json:"video_id"` //视频ID
VideoCoverId string `json:"video_cover_id"` //视频封面ID
ImageIds []string `json:"image_ids"` //图片ID列表
IsAutoGenerate int64 `json:"is_auto_generate"` //是否为派生创意标识,1:是,0:不是
} `json:"programmatic_creative_media_list"`
ProgrammaticCreativeTitleList []struct {
Title string `json:"title"` //创意标题
DynamicWords []struct {
WordId int64 `json:"word_id"` //动态词包ID
DictName string `json:"dict_name"` //创意词包名称
DefaultWord string `json:"default_word"` //创意词包默认词
}
} `json:"programmatic_creative_title_list"`
ProgrammaticCreativeCard []struct {
PromotionCardTitle string `json:"promotion_card_title"` //推广卡片标题
PromotionCardSellingPoints []string `json:"promotion_card_selling_points"` //推广卡片卖点列表
PromotionCardImageId string `json:"promotion_card_image_id"` //推广卡片配图ID
PromotionCardActionButton string `json:"promotion_card_action_button"` //推广卡片行动号召按钮文案
PromotionCardButtonSmartOptimization int64 `json:"promotion_card_button_smart_optimization"` //智能优选行动号召按钮文案开关
} `json:"programmatic_creative_card"`
CreativeAutoGenerate int `json:"creative_auto_generate"` //是否开启「生成更多创意」
IsHomepageHide int `json:"is_homepage_hide"` //抖音主页是否隐藏视频
}
type AdListGetFiltering ¶
type AdListGetFiltering struct {
Ids []int64 `json:"ids,omitempty"` // 按计划ID过滤,list长度限制 1-100
AdName string `json:"ad_name,omitempty"` // 按计划名称过滤,长度为1-30个字符
Status string `json:"status,omitempty"` // 按计划状态过滤,不传入即默认返回“所有不包含已删除”,其他规则详见【附录-广告计划查询状态】
MarketingGoal string `json:"marketing_goal"` // 按营销目标过滤,允许值:VIDEO_PROM_GOODS:短视频带货;LIVE_PROM_GOODS:直播带货
CampaignId int64 `json:"campaign_id,omitempty"` // 按广告组ID过滤
AdCreateStartDate string `json:"ad_create_start_date,omitempty"` // 计划创建开始时间,格式:"yyyy-mm-dd"
AdCreateEndDate string `json:"ad_create_end_date,omitempty"` // 计划创建结束时间,与ad_create_start_date搭配使用,格式:"yyyy-mm-dd",时间跨度不能超过180天
AdModifyTime string `json:"ad_modify_time,omitempty"` // 计划修改时间,精确到小时,格式:"yyyy-mm-dd HH"
}
type AdListGetReq ¶
type AdListGetReq struct {
AdvertiserId int64 `json:"advertiser_id"` // 千川广告账户ID
RequestAwemeInfo int64 `json:"request_aweme_info,omitempty"` // 是否包含抖音号信息,允许值:0:不包含;1:包含;默认不返回
AwemeId int64 `json:"aweme_id,omitempty"` // 按抖音号ID过滤
Page int64 `json:"page,omitempty"` // 页码,默认为1
PageSize int64 `json:"page_size,omitempty"` // 页面大小,默认值: 10, 允许值:10、20、50、100、500、1000
Filtering AdListGetFiltering `json:"filtering"` // 过滤器,无过滤条件情况下返回“所有不包含已删除”的广告组列表
AccessToken string `json:"access_token"` // 调用/oauth/access_token/生成的token,此token需要用户授权。
}
AdListGetReq 获取账户下计划列表(不含创意)
type AdListGetRes ¶
type AdListGetRes struct {
QCError
Data AdListGetResData `json:"data"`
}
AdListGetRes 获取广告账户数据-返回结构体
type AdListGetResData ¶
type AdListGetResData struct {
List []AdListGetResDataDetail `json:"list"`
FailList []int64 `json:"fail_list"` // 获取失败的计划ID列表
PageInfo PageInfo `json:"page_info"`
}
type AdListGetResDataDetail ¶
type AdListGetResDataDetail struct {
AdId int64 `json:"ad_id"`
CampaignId int64 `json:"campaign_id"`
MarketingGoal string `json:"marketing_goal"`
PromotionWay string `json:"promotion_way"`
Name string `json:"name"`
Status string `json:"status"`
OptStatus string `json:"opt_status"`
AdCreateTime string `json:"ad_create_time"`
AdModifyTime string `json:"ad_modify_time"`
ProductInfo []struct {
Id int64 `json:"id"`
Name string `json:"name"`
DiscountPrice float64 `json:"discount_price"`
Img string
} `json:"product_info"`
AwemeInfo []struct {
AwemeId int64 `json:"aweme_id"`
AwemeName string `json:"aweme_name"`
AwemeShowId string `json:"aweme_show_id"`
AwemeAvatar string `json:"aweme_avatar"`
} `json:"aweme_info"`
DeliverySetting struct {
SmartBidType string `json:"smart_bid_type"`
ExternalAction string `json:"external_action"`
Budget float64 `json:"budget"`
BudgetMode string `json:"budget_mode"`
CpaBid float64 `json:"cpa_bid"`
StartTime string `json:"start_time"`
EndTime string `json:"end_time"`
} `json:"delivery_setting"`
}
type AdRejectReasonReq ¶
type AdRejectReasonReq struct {
AdvertiserId int64 `json:"advertiser_id"`
AccessToken string `json:"access_token"`
AdIds []int64 `json:"ad_id"`
}
AdRejectReasonReq 获取计划审核建议 的 请求结构体
type AdRejectReasonRes ¶
type AdRejectReasonRes struct {
QCError
Data AdRejectReasonResData `json:"data"`
}
type AdRejectReasonResData ¶
type AdRejectReasonResData struct {
List struct {
AdId int64 `json:"ad_id"` //广告计划id
AuditRecords []struct {
Desc string `json:"desc"` //审核内容,即审核的内容类型,如 视频,图片,标题 等
Content string `json:"content"` //拒绝内容(文字类型)
ImageId int64 `json:"image_id"` //拒绝内容id(图片类型)
VideoId int64 `json:"video_id"` //拒绝内容id(视频类型)
AuditPlatform string `json:"audit_platform"` //审核来源类型,返回值: AD 广告审核、CONTENT 内容审核
RejectReason []string `json:"reject_reason"` //拒绝原因,可能会有多条
Suggestion []string `json:"suggestion"` // 审核建议,可能会有多条
} `json:"audit_records"`
} `json:"list"`
}
type AdStatusUpdateBody ¶
type AdStatusUpdateReq ¶
type AdStatusUpdateReq struct {
AccessToken string // 调用/oauth/access_token/生成的token,此token需要用户授权。
Body AdStatusUpdateBody // POST请求的data
}
AdStatusUpdateReq 更新计划状态的请求结构体
type AdStatusUpdateRes ¶
type AdStatusUpdateRes struct {
QCError
Data AdStatusUpdateResData `json:"data"` //返回数据
}
type AdStatusUpdateResData ¶
type AdStatusUpdateResData struct {
AdId []int64 `json:"ad_id"` //更新成功的计划id
Errors []AdStatusUpdateResDataError `json:"errors"` //更新失败的计划id和失败原因
}
AdStatusUpdateResData 更新计划状态 的 响应结构体
type AdUpdateAudience ¶
type AdUpdateAudience AdCreateAudience
type AdUpdateBody ¶
type AdUpdateBody struct {
AdvertiserId int64 `json:"advertiser_id"` // 千川广告主账户id
AdId int64 `json:"ad_id"`
Name string `json:"name,omitempty"` // 计划名称,长度为1-100个字符,其中1个汉字算2位字符。名称不可重复,否则会报错
DeliverySetting AdUpdateDeliverySetting `json:"delivery_setting"`
Audience *AdUpdateAudience `json:"audience,omitempty"`
AdUpdateCreative
}
type AdUpdateCreative ¶
type AdUpdateCreative struct {
CreativeMaterialMode string `json:"creative_material_mode"` // 创意呈现方式,允许值:CUSTOM_CREATIVE 自定义创意、PROGRAMMATIC_CREATIVE 程序化创意
FirstIndustryId int64 `json:"first_industry_id"` // 创意一级行业ID。可从【获取行业列表】接口获取
SecondIndustryId int64 `json:"second_industry_id"` // 创意二级行业ID。可从【获取行业列表】接口获取
ThirdIndustryId int64 `json:"third_industry_id"` // 创意三级行业ID。可从【获取行业列表】接口获取
AdKeywords []string `json:"ad_keywords,omitempty"` // 创意标签。最多20个标签,且每个标签长度要求为1~20个字符,汉字算2个字符
CreativeList []AdUpdateCreativeList `json:"creative_list,omitempty"` // 自定义素材信息
CreativeAutoGenerate int64 `json:"creative_auto_generate,omitempty"` // 是否开启「生成更多创意」
ProgrammaticCreativeMediaList *AdUpdateProgrammaticCreativeMediaList `json:"programmatic_creative_media_list,omitempty"` // 程序化创意素材信息
ProgrammaticCreativeTitleList *AdUpdateProgrammaticCreativeTitleList `json:"programmatic_creative_title_list,omitempty"` // 程序化创意标题信息
ProgrammaticCreativeCard *AdUpdateProgrammaticCreativeCard `json:"programmatic_creative_card,omitempty"` // 程序化创意推广卡片信息
IsHomepageHide int64 `json:"is_homepage_hide,omitempty"` // 抖音主页是否隐藏视频
}
type AdUpdateCreativeList ¶
type AdUpdateCreativeList struct {
CreativeId int64 `json:"creative_id"` // 创意ID
ImageMode string `json:"image_mode,omitempty"` // 创意素材类型
VideoMaterial *AdUpdateCustomVideoMaterial `json:"video_material,omitempty"` // 视频类型素材
ImageMaterial *AdUpdateImageMaterial `json:"image_material,omitempty"` // 图片类型素材
TitleMaterial *AdUpdateTitleMaterial `json:"title_material,omitempty"` // 标题类型素材,若选择了抖音号上的视频,不支持修改标题
PromotionCardMaterial *AdUpdatePromotionCardMaterial `json:"promotion_card_material,omitempty"` // 推广卡片素材
}
AdUpdateCreativeList 广告创意 - creative_list
type AdUpdateCustomVideoMaterial ¶
type AdUpdateCustomVideoMaterial struct {
ID int64 `json:"id,omitempty"`
VideoId string `json:"video_id,omitempty"` // 视频ID
VideoCoverId string `json:"video_cover_id,omitempty"` // 视频封面ID
AwemeItemId int64 `json:"aweme_item_id,omitempty"` // 抖音视频ID
}
AdUpdateCustomVideoMaterial 广告创意 - 视频类型素材
type AdUpdateDeliverySetting ¶
type AdUpdateDeliverySetting struct {
FlowControlMode string `json:"flow_control_mode,omitempty"` // 投放速度,详见【附录-计划投放速度类型】仅当 smart_bid_type 为SMART_BID_CUSTOM 时需传值,允许值:FLOW_CONTROL_MODE_FAST 尽快投放(默认值)、FLOW_CONTROL_MODE_BALANCE 均匀投放、FLOW_CONTROL_MODE_SMOOTH 优先低成本,对应千川后台「严格控制成本上限」勾选项
Budget float64 `json:"budget"` // 预算,最多支持两位小数当预算模式为日预算时,预算范围是300 - 9999999.99;当预算模式为总预算时,预算范围是max(300,投放天数x100) - 9999999.99
CpaBid float64 `json:"cpa_bid,omitempty"` // 转化出价,出价不能大于预算仅当 smart_bid_type 为SMART_BID_CUSTOM 时需传值
VideoScheduleType string `json:"video_schedule_type,omitempty"` // 短视频投放日期选择方式,仅短视频带货场景需入参,允许值:SCHEDULE_FROM_NOW 从今天起长期投放(总预算模式下不支持)、SCHEDULE_START_END 设置开始和结束日期
LiveScheduleType string `json:"live_schedule_type,omitempty"` // 直播间投放时段选择方式, 仅直播带货场景需入参,允许值:SCHEDULE_FROM_NOW 从今天起长期投放、SCHEDULE_START_END 设置开始和结束日期、SCHEDULE_TIME_FIXEDRANGE 固定时长,在保持原枚举之外,只允许SCHEDULE_FROM_NOW切换为SCHEDULE_START_END ,不允许SCHEDULE_START_END 切换为SCHEDULE_FROM_NOW
EndTime string `json:"end_time,omitempty"` // 投放结束时间,形式如:2017-01-01结束时间不能比起始时间早。当video_schedule_type为SCHEDULE_START_END 设置开始和结束日期时需传入。当live_schedule_type 为SCHEDULE_TIME_ALLDAY 全天、SCHEDULE_TIME_WEEKLY_SETTING 指定时间段时必填;当 live_schedule_type 为SCHEDULE_TIME_FIXEDRANGE固定时长时不能传入
ScheduleTime string `json:"schedule_time,omitempty"` // 投放时段,当 live_schedule_type 为SCHEDULE_TIME_WEEKLY_SETTING 时生效默认全时段投放,格式是48*7位字符串,且都是0或1。也就是以半个小时为最小粒度,周一至周日每天分为48个区段,0为不投放,1为投放,不传、全传0、全传1均代表全时段投放。例如:填写"000000000000000000000001111000000000000000000000000000000000000000000001111000000000000000000000000000000000000000000001111000000000000000000000000000000000000000000001111000000000000000000000000000000000000000000001111000000000000000000000000000000000000000000001111000000000000000000000000000000000000000000001111000000000000000000000",则投放时段为周一到周日的11:30~13:30
ScheduleFixedRange int64 `json:"schedule_fixed_range,omitempty"` // 固定投放时长当 live_schedule_type 为 SCHEDULE_TIME_FIXEDRANGE 时必填;当live_schedule_type 为SCHEDULE_TIME_ALLDAY 全天、SCHEDULE_TIME_WEEKLY_SETTING 指定时间段时不能传入。单位为秒,最小值为1800(0.5小时),最大值为48*1800(24小时),值必须为1800倍数,不然会报错
}
type AdUpdateDynamicWords ¶
type AdUpdateDynamicWords AdCreateDynamicWords
type AdUpdateImageMaterial ¶
type AdUpdateImageMaterial struct {
ID int64 `json:"id,omitempty"`
AdCreateImageMaterial
}
AdUpdateImageMaterial 广告创意 - 图片类型素材
type AdUpdateProgrammaticCreativeCard ¶
type AdUpdateProgrammaticCreativeCard AdCreateProgrammaticCreativeCard
AdUpdateProgrammaticCreativeCard 广告创意 - 程序化创意推广卡片信息
type AdUpdateProgrammaticCreativeMediaList ¶
type AdUpdateProgrammaticCreativeMediaList AdCreateProgrammaticCreativeMediaList
AdUpdateProgrammaticCreativeMediaList 广告创意 - 程序化创意素材信息
type AdUpdateProgrammaticCreativeTitleList ¶
type AdUpdateProgrammaticCreativeTitleList AdCreateProgrammaticCreativeTitleList
AdUpdateProgrammaticCreativeTitleList 广告创意 - 程序化创意标题信息
type AdUpdatePromotionCardMaterial ¶
type AdUpdatePromotionCardMaterial struct {
ID int64 `json:"id,omitempty"` // 素材唯一标识,通过获取计划详情接口可以获取
ComponentId int64 `json:"component_id,omitempty"` // 组件唯一标识,通过获取计划详情接口可以获取
AdCreatePromotionCardMaterial
}
AdUpdatePromotionCardMaterial 广告创意 - 推广卡片素材
type AdUpdateReq ¶
type AdUpdateReq struct {
AccessToken string // 调用/oauth/access_token/生成的token,此token需要用户授权。
Body AdUpdateBody // POST请求的data
}
AdUpdateReq 获取广告账户数据-请求
type AdUpdateRes ¶
type AdUpdateRes struct {
QCError
Data AdUpdateResData `json:"data"`
}
AdUpdateRes 获取广告账户数据-返回结构体
type AdUpdateResData ¶
type AdUpdateResData struct {
AdId int64 `json:"ad_id"` // 修改的计划id
ErrorList []struct {
ObjectId int64 `json:"object_id"` // 错误对象id
ObjectType string `json:"object_type"` // 错误对象类型,返回值: AD 计划,CREATIVE 创意
OptType string `json:"opt_type"` // 操作类型,返回值:UPDATE 更新,ADD 新建
ErrorCode int64 `json:"error_code"` // 错误码
ErrorMessage string `json:"error_message"` // 错误信息
} `json:"error_list"` // 错误list,计划为分块更新,存在部分内容更新失败,部分内容更新成功的的情况。若计划更新成功,则返回为空数组;若更新失败,则返回错误的部分及原因
}
type AdUpdateTitleMaterial ¶
type AdUpdateTitleMaterial struct {
ID int64 `json:"id,omitempty"`
Title string `json:"title,omitempty"` // 创意标题
DynamicWords []AdCreateDynamicWords `json:"dynamic_words,omitempty"` // 动态词包对象列表
}
AdUpdateTitleMaterial 广告创意 - 标题类型素材,若选择了抖音号上的视频,不支持修改标题
type AdvertiserInfoReq ¶
type AdvertiserInfoReq struct {
AdvertiserIds []int64
Fields []string
AccessToken string // 调用/oauth/access_token/生成的token,此token需要用户授权。
}
AdvertiserInfoReq 获取千川广告账户全量信息-请求
type AdvertiserInfoRes ¶
type AdvertiserInfoRes struct {
QCError
Data []AdvertiserInfoResData `json:"data"`
}
AdvertiserInfoRes 获取千川广告账户全量信息-返回结构体
type AdvertiserInfoResData ¶
type AdvertiserInfoResData struct {
ID int64 `json:"id"` // 广告主ID
Name string `json:"name"` // 账户名
Role string `json:"role"` // 角色, 详见【附录-广告主角色】
Status string `json:"status"` // 状态,详见【附录-广告主状态】
Address string `json:"address"` // 地址
LicenseUrl string `json:"license_url"` // 执照预览地址(链接默认1小时内有效)
LicenseNo string `json:"license_no"` // 执照编号
LicenseProvince string `json:"license_province"` // 执照省份
LicenseCity string `json:"license_city"` // 执照城市
Company string `json:"company"` // 公司名
Brand string `json:"brand"` // 经营类别
PromotionArea string `json:"promotion_area"` // 运营区域
PromotionCenterProvince string `json:"promotion_center_province"` // 运营省份
PromotionCenterCity string `json:"promotion_center_city"` // 运营城市
FirstIndustryName string `json:"first_industry_name"` // 一级行业名称(新版)
SecondIndustryName string `json:"second_industry_name"` // 二级行业名称(新版)
Reason string `json:"reason"` // 审核拒绝原因
CreateTime string `json:"create_time"` // 创建时间
}
type AdvertiserListReq ¶
type AdvertiserListReq struct {
AccessToken string // 调用/oauth/access_token/生成的token,此token需要用户授权。
AppId int64 // 开发者申请的应用APP_ID,可通过“应用管理”界面查看
Secret string // 开发者应用的私钥Secret,可通过“应用管理”界面查看(确保填入secret与app_id对应以免报错!)
}
AdvertiserListReq 获取已授权的账户(店铺/代理商)-请求
type AdvertiserListRes ¶
type AdvertiserListRes struct {
QCError
Data AdvertiserListResCom `json:"data"`
}
AdvertiserListRes 获取已授权的账户(店铺/代理商)-返回结构体
type AdvertiserListResCom ¶
type AdvertiserListResCom struct {
List []AdvertiserListResData `json:"list"`
}
type AdvertiserListResData ¶
type AdvertiserListResData struct {
AdvertiserId int64 `json:"advertiser_id"` // 账户id
AdvertiserName string `json:"advertiser_name"` // 账户名称
IsValid bool `json:"is_valid"` // 授权有效性,返回值:true/false,用于判断当前授权关系是否仍然有效
AccountRole string `json:"account_role"` // 授权账号角色,返回值:PLATFORM_ROLE_QIANCHUAN_AGENT代理商账户、PLATFORM_ROLE_SHOP_ACCOUNT 店铺账户
}
AdvertiserListResData 获取已授权的账户(店铺/代理商)-返回
type AdvertiserPublicInfoReq ¶
type AdvertiserPublicInfoReq struct {
AdvertiserIds []int64
AccessToken string // 调用/oauth/access_token/生成的token,此token需要用户授权。
}
AdvertiserPublicInfoReq 获取千川广告账户基础信息-请求
type AdvertiserPublicInfoRes ¶
type AdvertiserPublicInfoRes struct {
QCError
Data []AdvertiserPublicInfoResData `json:"data"`
}
AdvertiserPublicInfoRes 获取千川广告账户基础信息-返回结构体
type AdvertiserReportFiltering ¶
type AdvertiserReportFiltering struct {
MarketingGoal string `json:"marketing_goal"`
}
type AdvertiserReportReq ¶
type AdvertiserReportReq struct {
AdvertiserId int64 // 千川广告主账户id
StartDate string // 开始时间,格式 2021-04-05
EndDate string // 结束时间,格式 2021-04-05,时间跨度不能超过180天
Fields []string // 需要查询的消耗指标
Filtering AdvertiserReportFiltering `json:"filtering"`
//MarketingGoal string // 过滤条件 营销目标,允许值:VIDEO_PROM_GOODS:短视频带货 LIVE_PROM_GOODS:直播间带货 ALL:不限
AccessToken string // 调用/oauth/access_token/生成的token,此token需要用户授权。
}
AdvertiserReportReq 获取广告账户数据-请求
type AdvertiserReportRes ¶
type AdvertiserReportRes struct {
QCError
Data AdvertiserReportResData `json:"data"`
}
AdvertiserReportRes 获取广告账户数据-返回结构体
type AdvertiserReportResData ¶
type AdvertiserReportResData struct {
List []AdvertiserReportResDetail `json:"list"`
}
type AdvertiserReportResDetail ¶
type AdvertiserReportResDetail struct {
AdvertiserId int64 `json:"advertiser_id"` // 广告主id
StatCost float64 `json:"stat_cost"` // 消耗
ShowCnt int64 `json:"show_cnt"` // 展示次数
Ctr float64 `json:"ctr"` // 点击率
CpmPlatform float64 `json:"cpm_platform"` // 平均千次展示费用
ClickCnt int64 `json:"click_cnt"` // 点击次数
PayOrderCount int64 `json:"pay_order_count"` // 成交订单数
CreateOrderAmount float64 `json:"create_order_amount"` // 下单成交金额
CreateOrderCount int64 `json:"create_order_count"` // 下单订单数
PayOrderAmount float64 `json:"pay_order_amount"` // 成交订单金额
CreateOrderRoi float64 `json:"create_order_roi"` // 下单roi
DyFollow int64 `json:"dy_follow"` // 新增粉丝数
PrepayAndPayOrderRoi float64 `json:"prepay_and_pay_order_roi"` // 支付roi
PrepayOrderCount int64 `json:"prepay_order_count"` // 广告预售订单数
PrepayOrderAmount float64 `json:"prepay_order_amount"` // 广告预售订单金额
}
type AgentAdvertiserListReq ¶
type AgentAdvertiserListReq struct {
AdvertiserId int64 // 代理商ID
Page uint64 // 页码.默认值: 1
PageSize uint64 // 页面数据量.默认值: 10, 最大值:100
AccessToken string // 调用/oauth/access_token/生成的token,此token需要用户授权。
}
AgentAdvertiserListReq 获取代理商账户关联的广告账户列表-请求
type AgentAdvertiserListRes ¶
type AgentAdvertiserListRes struct {
QCError
Data AgentAdvertiserListResCom `json:"data"`
}
AgentAdvertiserListRes 获取代理商账户关联的广告账户列表-返回结构体
type AgentInfoReq ¶
type AgentInfoReq struct {
AdvertiserIds []int64
Fields []string
AccessToken string // 调用/oauth/access_token/生成的token,此token需要用户授权。
}
AgentInfoReq 获取代理商账户信息-请求
type AgentInfoRes ¶
type AgentInfoRes struct {
QCError
Data []AgentInfoResData `json:"data"`
}
AgentInfoRes 获取代理商账户信息-返回结构体
type AgentInfoResData ¶
type AgentInfoResData struct {
AgentId int64 `json:"agent_id"`
AgentName string `json:"agent_name"`
CustomerId string `json:"customer_id"`
CompanyId string `json:"company_id"`
CompanyName string `json:"company_name"`
AccountStatus string `json:"account_status"`
CreateTime string `json:"create_time"`
Role string `json:"role"`
}
type AwemeAuthorizedGetReq ¶
type AwemeAuthorizedGetReq struct {
AccessToken string `json:"access_token"`
AdvertiserId int64 `json:"advertiser_id,omitempty"`
Page int64 `json:"page,omitempty"`
PageSize int64 `json:"page_size,omitempty"`
}
AwemeAuthorizedGetReq 获取千川账户下已授权抖音号 的 请求结构体
type AwemeAuthorizedGetRes ¶
type AwemeAuthorizedGetRes struct {
QCError
Data struct {
PageInfo PageInfo `json:"page_info"`
AwemeIdList []AwemeAuthorizedGetResDetail `json:"aweme_id_list"`
} `json:"data"`
}
AwemeAuthorizedGetRes 获取千川账户下已授权抖音号 的 响应结构体
type AwemeAuthorizedGetResDetail ¶
type AwemeAuthorizedGetResDetail struct {
AwemeAvatar string `json:"aweme_avatar"` //抖音头像
AwemeId int64 `json:"aweme_id"` //抖音id,用于创建计划,拉取抖音号视频素材时入参
AwemeShowId string `json:"aweme_show_id"` //抖音号,即客户在手机端上看到的抖音号,若向客户披露抖音号请使用该字段
AwemeName string `json:"aweme_name"` //抖音号名称
AwemeStatus string `json:"aweme_status"` //抖音号带货状态,返回值: NORMAL可以正常投放 ANCHOR_FORBID带货口碑分过低,暂时无法创建计划 ANCHOR_REACH_UPPER_LIMIT_TODAY带货分过低或暂无带货分,可以创建计划,但无法产生消耗,带货分恢复正常后可正常消耗
BindType []string `json:"bind_type"` //抖音号关系类型
}
type BatchCampaignStatusUpdateReq ¶
type BatchCampaignStatusUpdateReq struct {
AccessToken string // 调用/oauth/access_token/生成的token,此token需要用户授权。
Body BatchCampaignStatusUpdateBody // POST请求的data
}
BatchCampaignStatusUpdateReq 获取广告账户数据-请求
type BatchCampaignStatusUpdateRes ¶
type BatchCampaignStatusUpdateRes struct {
QCError
Data BatchCampaignStatusUpdateResData `json:"data"`
}
BatchCampaignStatusUpdateRes 获取广告账户数据-返回结构体
type CampaignCreateBody ¶
type CampaignCreateBody struct {
AdvertiserId int64 `json:"advertiser_id"` // 千川广告账户ID
CampaignName string `json:"campaign_name"` // 广告组名称,长度为1-100个字符,其中1个中文字符算2位
MarketingGoal string `json:"marketing_goal"` // 营销目标,允许值:VIDEO_PROM_GOODS 短视频带货、LIVE_PROM_GOODS 直播带货
BudgetMode string `json:"budget_mode"` // 预算类型(创建后不可修改),详见【附录-预算类型】,允许值:BUDGET_MODE_DAY 日预算,BUDGET_MODE_INFINITE 预算不限
Budget float64 `json:"budget,omitempty"` // 条件必填,广告组预算,最多支持两位小数,当budget_mode为BUDGET_MODE_DAY时必填,且日预算不少于300元
}
type CampaignCreateReq ¶
type CampaignCreateReq struct {
AccessToken string // 调用/oauth/access_token/生成的token,此token需要用户授权。
Body CampaignCreateBody // POST请求的data
}
CampaignCreateReq 获取广告账户数据-请求
type CampaignCreateRes ¶
type CampaignCreateRes struct {
QCError
Data CampaignCreateResData `json:"data"`
}
CampaignCreateRes 获取广告账户数据-返回结构体
type CampaignCreateResData ¶
type CampaignCreateResData struct {
CampaignId int64 `json:"campaign_id"` // 创建的广告组id
}
type CampaignListGetFilter ¶
type CampaignListGetFilter struct {
Ids []int64 `json:"ids,omitempty"` // 广告组ID列表,目前只支持一个。
Name string `json:"name,omitempty"` // 广告组名称关键字,长度为1-30个字符,其中1个中文字符算2位
MarketingGoal string `json:"marketing_goal"` // 广告组营销目标,允许值:VIDEO_PROM_GOODS:短视频带货、LIVE_PROM_GOODS:直播带货
Status string `json:"status,omitempty"` // 广告组状态,允许值:ALL:所有包含已删除、ENABLE:启用、DISABLE:暂停、DELETE:已删除。不传入即默认返回“所有不包含已删除”
}
type CampaignListGetReq ¶
type CampaignListGetReq struct {
AdvertiserId int64 `json:"advertiser_id"` // 千川广告账户ID
Page int64 `json:"page,omitempty"` // 页码,默认为1
PageSize int64 `json:"page_size,omitempty"` // 页面大小,默认值: 10, 允许值:10、20、50、100、500、1000
Filter CampaignListGetFilter `json:"filter"` // 过滤器,无过滤条件情况下返回“所有不包含已删除”的广告组列表
AccessToken string `json:"access_token"` // 调用/oauth/access_token/生成的token,此token需要用户授权。
}
CampaignListGetReq 获取广告账户数据-请求
type CampaignListGetRes ¶
type CampaignListGetRes struct {
QCError
Data CampaignListGetResData `json:"data"`
}
CampaignListGetRes 获取广告账户数据-返回结构体
type CampaignListGetResData ¶
type CampaignListGetResData struct {
List []CampaignListGetResDataDetail `json:"list"`
PageInfo PageInfo `json:"page_info"`
}
type CampaignListGetResDataDetail ¶
type CampaignListGetResDataDetail struct {
ID int64 `json:"id"` // 广告组ID
Name string `json:"name"` // 广告组名称
Budget float64 `json:"budget"` // 广告组预算,单位:元,精确到两位小数。
BudgetMode string `json:"budget_mode"` // 广告组预算类型
MarketingGoal string `json:"marketing_goal"` // 广告组营销目标,VIDEO_PROM_GOODS:短视频带货、LIVE_PROM_GOODS:直播带货。
Status string `json:"status"` // 广告组状态,ALL:所有包含已删除、ENABLE:启用、DISABLE:暂停、DELETE:已删除。
CreateDate string `json:"create_date"` // 广告组创建日期, 格式:yyyy-mm-dd
}
type CampaignUpdateBody ¶
type CampaignUpdateBody struct {
AdvertiserId int64 `json:"advertiser_id"` // 千川广告账户ID
CampaignId int64 `json:"campaign_id"` // 广告组名称,长度为1-100个字符,其中1个中文字符算2位
CampaignName string `json:"campaign_name,omitempty"` // 广告组名称,长度为1-100个字符,其中1个中文字符算2位,需要注意:广告组名称不修改的话,可不填。填入的话,需与原广告组名称不同,否则报错
BudgetMode string `json:"budget_mode"` // 预算类型(创建后不可修改),详见【附录-预算类型】,允许值:BUDGET_MODE_DAY 日预算,BUDGET_MODE_INFINITE 预算不限
Budget float64 `json:"budget,omitempty"` // 条件必填,广告组预算,最多支持两位小数,当budget_mode为BUDGET_MODE_DAY时必填,且日预算不少于300元
}
type CampaignUpdateReq ¶
type CampaignUpdateReq struct {
AccessToken string // 调用/oauth/access_token/生成的token,此token需要用户授权。
Body CampaignUpdateBody // POST请求的data
}
CampaignUpdateReq 获取广告账户数据-请求
type CampaignUpdateRes ¶
type CampaignUpdateRes struct {
QCError
Data CampaignUpdateResData `json:"data"`
}
CampaignUpdateRes 获取广告账户数据-返回结构体
type CampaignUpdateResData ¶
type CampaignUpdateResData struct {
CampaignId int64 `json:"campaign_id"` // 修改的广告组id
}
type CreativeGetReq ¶
type CreativeGetReq struct {
AccessToken string `json:"access_token"`
AdvertiserId int64 `json:"advertiser_id"` //千川广告账户ID
Filtering CreativeGetReqFiltering `json:"filtering"`
Page int64 `json:"page,omitempty"` //页码,默认值:1
PageSize int64 `json:"page_size,omitempty"` //页面大小,允许值:10, 20, 50, 100, 500, 1000,默认值:10
}
CreativeGetReq 获取账户下创意列表 的 请求结构体
type CreativeGetReqFiltering ¶
type CreativeGetReqFiltering struct {
AdIds []int64 `json:"ad_ids,omitempty"` //按计划ID过滤,list长度限制 1-100
CreativeId int64 `json:"creative_id,omitempty"` //按创意ID过滤
CreativeMaterialMode string `json:"creative_material_mode,omitempty"` //按创意呈现方式过滤,允许值: CUSTOM_CREATIVE 自定义创意、PROGRAMMATIC_CREATIVE 程序化创意
Status string `json:"status,omitempty"` //按创意状态过滤,不传入即默认返回“所有不包含已删除”,其他规则详见【附录-创意查询状态】
MarketingGoal string `json:"marketing_goal"` //按营销目标过滤,允许值:VIDEO_PROM_GOODS 短视频带货、LIVE_PROM_GOODS 直播带货
CampaignId int64 `json:"campaign_id,omitempty"` //按广告组ID过滤
CreativeCreateStartDate string `json:"creative_create_start_date,omitempty"` //创意创建开始时间,格式:"yyyy-mm-dd"
CreativeCreateEndDate string `json:"creative_create_end_date,omitempty"` //创意创建结束时间,与creative_create_start_date搭配使用,格式:"yyyy-mm-dd",时间跨度不能超过180天
CreativeModifyTime string `json:"creative_modify_time,omitempty"` //创意修改时间,格式:"yyyy-mm-dd HH"
}
type CreativeGetRes ¶
type CreativeGetRes struct {
QCError
Data struct {
List []CreativeGetResDetail `json:"list"`
PageInfo struct {
Page int64 `json:"page"` //页码
PageSize int64 `json:"page_size"` //页面大小
TotalNumber int64 `json:"total_number"` //总数
TotalPage int64 `json:"total_page"` //总页数
} `json:"page_info"`
} `json:"data"`
}
CreativeGetRes 获取账户下创意列表 的 响应结构体
type CreativeGetResDetail ¶
type CreativeGetResDetail struct {
AdId int64 `json:"ad_id"` //计划ID
CreativeId int64 `json:"creative_id"` //创意ID
Status string `json:"status"` //创意状态
OptStatus string `json:"opt_status"` //创意操作状态
ImageMode string `json:"image_mode"` //创意素材类型
CreativeCreateTime string `json:"creative_create_time"` //创意创建时间
CreativeModifyTime string `json:"creative_modify_time"` //创意修改时间
VideoMaterial struct {
VideoId string `json:"video_id"` //视频ID
VideoCoverId string `json:"video_cover_id"` //视频封面ID
AwemeItemId int64 `json:"aweme_item_id"` //抖音视频ID
IsAutoGenerate int64 `json:"is_auto_generate"` //是否为派生创意标识,1:是,0:不是
} `json:"video_material"`
ImageMaterial struct {
ImageIds []string `json:"image_ids"` //图片ID列表
IsAutoGenerate int64 `json:"is_auto_generate"` //是否为派生创意标识,1:是,0:不是
} `json:"image_material"`
TitleMaterial struct {
Title string `json:"title"` //创意标题
DynamicWords []struct {
WordId int64 //动态词包ID
DictName string //创意词包名称
DefaultWord string //创意词包默认词
} `json:"dynamic_words"`
} `json:"title_material"`
}
type CreativeRejectReasonReq ¶
type CreativeRejectReasonReq struct {
AccessToken string `json:"access_token"`
AdvertiserId int64 `json:"advertiser_id"`
CreativeIds []int64 `json:"creative_ids"`
}
CreativeRejectReasonReq 获取创意审核建议 的 请求结构体
type CreativeRejectReasonRes ¶
type CreativeRejectReasonRes struct {
QCError
Data struct {
List []CreativeRejectReasonResDetail `json:"list"`
} `json:"data"`
}
CreativeRejectReasonRes 获取创意审核建议 的 响应结构体
type CreativeRejectReasonResDetail ¶
type CreativeRejectReasonResDetail struct {
CreativeId int64 `json:"creative_id"` //广告创意id
AuditRecords []struct {
Desc string `json:"desc"` //审核内容,即审核的内容类型,如 视频,图片,标题 等
Content string `json:"content"` //拒绝内容(文字类型)
ImageId int64 `json:"image_id"` //拒绝内容(图片类型)
VideoId int64 `json:"video_id"` //拒绝内容(视频类型)
AuditPlatform string `json:"audit_platform"` //审核来源类型,返回值: AD 广告审核、CONTENT 内容审核
RejectReason []string `json:"reject_reason"` //拒绝原因,可能会有多条
Suggestion []string `json:"suggestion"` //审核建议,可能会有多条
} `json:"audit_records"` //
}
type CreativeStatusUpdateReq ¶
type CreativeStatusUpdateReq struct {
AccessToken string `json:"access_token"`
Body CreativeStatusUpdateReqBody `json:"body"`
}
CreativeStatusUpdateReq 更新创意状态 的 请求结构体
type CreativeStatusUpdateRes ¶
type CreativeStatusUpdateRes struct {
QCError
Data struct {
CreativeIds []int64 `json:"creative_ids"` //更新成功的创意id
Errors []struct {
CreativeId int64 `json:"creative_id"` //更新失败的创意id
ErrorMessage string `json:"error_message"` //更新失败的原因
} `json:"errors"`
} `json:"data"`
}
CreativeStatusUpdateRes 更新创意状态 的 响应结构体
type DmpAudiencesGetReq ¶
type DmpAudiencesGetReq struct {
AccessToken string `json:"access_token"` // 调用/oauth/access_token/生成的token,此token需要用户授权。
AdvertiserId int64 `json:"advertiser_id"` // 千川广告账户ID
RetargetingTagsType int64 `json:"retargeting_tags_type"` // 人群包类型,枚举值:0:不限营销目标的平台精选人群包,1:自定义人群包
Offset int64 `json:"offset,omitempty"` // 偏移,类似于SQL中offset(起始为0,翻页时new_offset=old_offset+limit),默认值:0,取值范围:≥ 0
Limit int64 `json:"limit,omitempty"` // 返回数据量,默认值:100,取值范围:1-100
}
DmpAudiencesGetReq 查询人群包列表 的 请求结构体
type DmpAudiencesGetRes ¶
type DmpAudiencesGetRes struct {
QCError
Data struct {
RetargetingTags []DmpAudiencesGetResDetail `json:"retargeting_tags"`
Offset int64 `json:"offset"` //下一次查询的偏移,类似于SQL中offset(起始为0,翻页时new_offset=old_offset+limit),返回0时,代表已查询到最后一页
TotalNum int64 `json:"total_num"` //总的人群包数量
} `json:"data"`
}
DmpAudiencesGetRes 查询人群包列表 的 响应结构体
type DmpAudiencesGetResDetail ¶
type DmpAudiencesGetResDetail struct {
RetargetingTagsId string `json:"retargeting_tags_id"` //人群包id
Name string `json:"name"` //人群包名称
Source string `json:"source"` //人群包来源,自定义类详见【附录-DMP相关-人群包来源】,平台精选类返回空值
Status int64 `json:"status"` //人群包状态,详见【附录-DMP相关-人群包状态】
RetargetingTagsOp string `json:"retargeting_tags_op"` //人群包可选的定向规则,枚举值:INCLUDE只支持定向,EXCLUDE只支持排除,ALL支持两种规则。 当source为RETARGETING_TAGS_TYPE_PLATFORM时,只支持INCLUDE或EXCLUDE;当source为RETARGETING_TAGS_TYPE_CUSTOM时,支持ALL
CoverNum int64 `json:"cover_num"` //预估人群包覆盖人群数目
RetargetingTagsTip string `json:"retargeting_tags_tip"` //人群包说明
IsCommon int64 `json:"is_common"` //0 该人群包不支持通投,1 该人群包支持通投,注意:不支持通投的人群包不能在千川平台创建计划,否则会报错。
}
type FileImageAdReq ¶
type FileImageAdReq struct {
AccessToken string `json:"access_token"`
Body FileImageAdReqBody `json:"body"`
}
FileImageAdReq 上传图片素材 的 请求结构体
type FileImageAdReqBody ¶
type FileImageAdReqBody struct {
AdvertiserId int64 `json:"advertiser_id,omitempty"`
UploadType string `json:"upload_type,omitempty"`
ImageSignature string `json:"image_signature,omitempty"`
ImageFile io.Reader `json:"image_file,omitempty"`
ImageUrl string `json:"image_url,omitempty"`
Filename string `json:"filename,omitempty"`
}
type FileImageAdRes ¶
type FileImageAdRes struct {
QCError
Data struct {
Id string `json:"id"`
Size int64 `json:"size"`
Width int64 `json:"width"`
Height int64 `json:"height"`
Url string `json:"url"`
Format string `json:"format"`
Signature string `json:"signature"`
MaterialId int64 `json:"material_id"`
} `json:"data"`
}
FileImageAdRes 上传图片素材 的 响应结构体
type FileImageGetReq ¶
type FileImageGetReq struct {
AccessToken string // 调用/oauth/access_token/生成的token,此token需要用户授权。
AdvertiserId int64 `json:"advertiser_id"` // 千川广告账户ID
Filtering FileImageGetReqFiltering `json:"filtering,omitempty"`
Page int64 `json:"page,omitempty"`
PageSize int64 `json:"page_size,omitempty"`
}
FileImageGetReq 获取素材库的图片 的 请求结构体
type FileImageGetReqFiltering ¶
type FileImageGetReqFiltering struct {
ImageIds []string `json:"image_ids,omitempty"` //图片ids,可以根据图片ids(创意中使用的图片key,存在一张图片对应多个image_ids的情况)进行过滤 数量限制:<=100 注意:image_ids、material_ids、signatures只能选择一个进行过滤
MaterialIds []int64 `json:"material_ids,omitempty"` //素材id列表,可以根据material_ids(素材报表使用的id,一个素材唯一对应一个素材id)进行过滤 数量限制:<=100 注意:image_ids、material_ids、signatures只能选择一个进行过滤
Signatures []string `json:"signatures,omitempty"` //md5值列表,可以根据素材的md5进行过滤 数量限制:<=100 注意:image_ids、material_ids、signatures只能选择一个进行过滤
Width int64 `json:"width,omitempty"` //图片宽度
Height int64 `json:"height,omitempty"` //图片高度
Ratio []float64 `json:"ratio,omitempty"` //图片宽高比,eg: [1.7, 2.5],输入1.7则搜索满足宽高比介于1.65-1.75之间的图片,即精度上下浮动0.05
StartTime string `json:"start_time,omitempty"` //根据视频上传时间进行过滤的起始时间,与end_time搭配使用,格式:yyyy-mm-dd
EndTime string `json:"end_time,omitempty"` //根据视频上传时间进行过滤的截止时间,与start_time搭配使用,格式:yyyy-mm-dd
}
type FileImageGetRes ¶
type FileImageGetRes struct {
QCError
Data struct {
List []FileImageGetResDetail
PageInfo PageInfo `json:"page_info"`
}
}
FileImageGetRes 获取素材库的图片 的 响应结构体
type FileImageGetResDetail ¶
type FileImageGetResDetail struct {
Id string `json:"id"` //图片ID
MaterialId int64 `json:"material_id"` //素材id,即多合一报表中的素材id,一个素材唯一对应一个素材id
Size int64 `json:"size"` //图片大小
Width int64 `json:"width"` //图片宽度
Height int64 `json:"height"` //图片高度
Url string `json:"url"` //图片预览地址(1小时内有效),仅限同主体进行素材预览查看,若非同主体会返回“素材所属主体与开发者主体不一致无法获取URL”
Format string `json:"format"` //图片格式
Signature string `json:"signature"` //图片md5
CreateTime string `json:"create_time"` //素材的上传时间,格式:"yyyy-mm-dd HH:MM:SS"
Filename string `json:"filename"` //素材的文件名
}
type FileVideoAdReq ¶
type FileVideoAdReq struct {
AccessToken string `json:"access_token"`
Body FileVideoAdReqBody `json:"body"`
}
FileVideoAdReq 上传视频素材 的 请求结构体
type FileVideoAdReqBody ¶
type FileVideoAdRes ¶
type FileVideoAdRes struct {
QCError
Data FileVideoAdResDetail `json:"data"`
}
FileVideoAdRes 上传视频素材 的 响应结构体
type FileVideoAdResDetail ¶
type FileVideoAwemeGetReq ¶
type FileVideoAwemeGetReq struct {
AccessToken string `json:"access_token"` // 调用/oauth/access_token/生成的token,此token需要用户授权。
AdvertiserId int64 `json:"advertiser_id"` // 千川广告账户ID
AwemeId int64 `json:"aweme_id"` // 需拉取视频的抖音号
Filtering FileVideoAwemeGetReqFiltering `json:"filtering,omitempty"`
Cursor int64 `json:"cursor,omitempty"`
Count int64 `json:"count,omitempty"`
}
FileVideoAwemeGetReq 获取抖音号下的视频 的 请求结构体
type FileVideoAwemeGetReqFiltering ¶
type FileVideoAwemeGetReqFiltering struct {
ProductId int64 `json:"product_id,omitempty"` //商品ID,查询关联商品的相应视频,仅短视频带货场景需入参
}
type FileVideoAwemeGetRes ¶
type FileVideoAwemeGetRes struct {
QCError
Data struct {
List []FileVideoAwemeGetResDetail
PageInfo struct {
HasMore int64 `json:"has_more"` //是否有下一页
Count int64 `json:"count"` //过滤后返回的视频数量,注意,此处的数量不一定与入参的count一致,因为存在过滤逻辑
Cursor int64 `json:"cursor"` //下一次分页拉取的游标值
} `json:"page_info"`
}
}
FileVideoAwemeGetRes 获取抖音号下的视频 的 响应结构体
type FileVideoAwemeGetResDetail ¶
type FileVideoAwemeGetResDetail struct {
AwemeItemId string `json:"aweme_item_id"` //抖音短视频 ID
VideoCoverUrl string `json:"video_cover_url"` //视频封面图片url
Width int64 `json:"width"` //视频宽度
Height int64 `json:"height"` //视频高度
Url string `json:"url"` //视频地址,链接1小时过期
Duration int64 `json:"duration"` //视频时长
Title string `json:"title"` //抖音中的视频标题
IsRecommend int64 `json:"is_recommend"` //是否推荐 0 不推荐 1 推荐
}
type FileVideoGetReq ¶
type FileVideoGetReq struct {
AccessToken string // 调用/oauth/access_token/生成的token,此token需要用户授权。
AdvertiserId int64 `json:"advertiser_id"` // 千川广告账户ID
Filtering FileVideoGetReqFiltering `json:"filtering,omitempty"`
Page int64 `json:"page,omitempty"`
PageSize int64 `json:"page_size,omitempty"`
}
FileVideoGetReq 获取素材库的视频 的 请求结构体
type FileVideoGetReqFiltering ¶
type FileVideoGetReqFiltering struct {
Width int64 `json:"width,omitempty"` //视频宽度
Height int64 `json:"height,omitempty"` //视频高度
Ratio []float64 `json:"ratio,omitempty"` //视频宽高比,示例: [1.7, 2.5] 输入1.7则搜索满足宽高比介于1.65-1.75之间的视频,即精度上下浮动0.5
VideoIds []string `json:"video_ids,omitempty"` //视频ids,示例: ["86adb23eaa21229fc04ef932b5089bb8"] 数量限制:<=100 注意:video_ids、material_ids、signatures只能选择一个进行过滤
MaterialIds []int64 `json:"material_ids,omitempty"` //素材id列表,可以根据material_ids(素材报表使用的id,一个素材唯一对应一个素材id)进行过滤 数量限制:<=100 注意:video_ids、material_ids、signatures只能选择一个进行过滤
Signatures []string `json:"signatures,omitempty"` //md5值列表,可以根据素材的md5进行过滤 数量限制:<=100 注意:video_ids、material_ids、signatures只能选择一个进行过滤
StartTime string `json:"start_time,omitempty"` //根据视频上传时间进行过滤的起始时间,与end_time搭配使用,格式:yyyy-mm-dd
EndTime string `json:"end_time,omitempty"` //根据视频上传时间进行过滤的截止时间,与start_time搭配使用,格式:yyyy-mm-dd
}
type FileVideoGetRes ¶
type FileVideoGetRes struct {
QCError
Data struct {
List []FileVideoGetResDetail
PageInfo PageInfo `json:"page_info"`
}
}
FileVideoGetRes 获取素材库的视频 的 响应结构体
type FileVideoGetResDetail ¶
type FileVideoGetResDetail struct {
Id string `json:"id"` //视频ID
Size int64 `json:"size"` //视频大小
Width int64 `json:"width"` //视频宽度
Height int64 `json:"height"` //视频高度
Url string `json:"url"` //视频地址,仅限同主体进行素材预览查看,若非同主体会返回“素材所属主体与开发者主体不一致无法获取URL”,链接1小时过期
Format string `json:"format"` //视频格式
Signature string `json:"signature"` //视频md5值
PosterUrl string `json:"poster_url"` //视频首帧截图,仅限同主体进行素材预览查看,若非同主体会返回“素材所属主体与开发者主体不一致无法获取URL”,链接1小时过期
BitRate int64 `json:"bit_rate"` //码率,单位bps
Duration float64 `json:"duration"` //视频时长
MaterialId int64 `json:"material_id"` //素材id,即多合一报表中的素材id,一个素材唯一对应一个素材id
Source string `json:"source"` //素材来源,E_COMMERCE:巨量千川,BP:巨量纵横, STAR:星图&即合, ARTHUR:亚瑟, VIDEO_CAPTURE:易拍
CreateTime string `json:"create_time"` //素材的上传时间,格式:"yyyy-mm-dd HH:MM:SS"
Filename string `json:"filename"` //素材的文件名
Labels []string `json:"labels"` //视频标签
}
type Manager ¶
type Manager struct {
Credentials *auth.Credentials
// contains filtered or unexported fields
}
Manager Manager结构体
func NewManager ¶
func NewManager(credentials *auth.Credentials, tr http.RoundTripper) *Manager
NewManager 创建新的Manager
func (*Manager) AdBidUpdate ¶
func (m *Manager) AdBidUpdate(req AdBidUpdateReq) (res *AdBidUpdateRes, err error)
AdBidUpdate 更新计划出价
func (*Manager) AdBudgetUpdate ¶
func (m *Manager) AdBudgetUpdate(req AdBudgetUpdateReq) (res *AdBudgetUpdateRes, err error)
AdBudgetUpdate 更新计划预算
func (*Manager) AdCreate ¶
func (m *Manager) AdCreate(req AdCreateReq) (res *AdCreateRes, err error)
AdCreate 创建计划(含创意生成规则)
func (*Manager) AdDetailGet ¶
func (m *Manager) AdDetailGet(req AdDetailGetReq) (res *AdDetailGetRes, err error)
AdDetailGet 获取计划详情(含创意信息)
func (*Manager) AdListGet ¶
func (m *Manager) AdListGet(req AdListGetReq) (res *AdListGetRes, err error)
AdListGet 获取账户下计划列表(不含创意)
func (*Manager) AdRejectReason ¶
func (m *Manager) AdRejectReason(req AdRejectReasonReq) (res *AdRejectReasonRes, err error)
AdRejectReason 获取计划审核建议
func (*Manager) AdStatusUpdate ¶
func (m *Manager) AdStatusUpdate(req AdStatusUpdateReq) (res *AdStatusUpdateRes, err error)
AdStatusUpdate 更新计划状态
func (*Manager) AdUpdate ¶
func (m *Manager) AdUpdate(req AdUpdateReq) (res *AdUpdateRes, err error)
AdUpdate 更新计划(含创意生成规则)
func (*Manager) AdvertiserInfo ¶
func (m *Manager) AdvertiserInfo(req AdvertiserInfoReq) (res *AdvertiserInfoRes, err error)
AdvertiserInfo 获取千川广告账户全量信息
func (*Manager) AdvertiserList ¶
func (m *Manager) AdvertiserList(req AdvertiserListReq) (res *AdvertiserListRes, err error)
AdvertiserList 获取已授权的账户(店铺/代理商)
func (*Manager) AdvertiserPublicInfo ¶
func (m *Manager) AdvertiserPublicInfo(req AdvertiserPublicInfoReq) (res *AdvertiserPublicInfoRes, err error)
AdvertiserPublicInfo 获取千川广告账户基础信息
func (*Manager) AdvertiserReport ¶
func (m *Manager) AdvertiserReport(req AdvertiserReportReq) (res *AdvertiserReportRes, err error)
AdvertiserReport 获取广告账户数据
func (*Manager) AgentAdvertiserList ¶
func (m *Manager) AgentAdvertiserList(req AgentAdvertiserListReq) (res *AgentAdvertiserListRes, err error)
AgentAdvertiserList 获取代理商账户关联的广告账户列表
func (*Manager) AgentInfo ¶
func (m *Manager) AgentInfo(req AgentInfoReq) (res *AgentInfoRes, err error)
AgentInfo 获取代理商账户信息
func (*Manager) AwemeAuthorizedGet ¶
func (m *Manager) AwemeAuthorizedGet(req AwemeAuthorizedGetReq) (res *AwemeAuthorizedGetRes, err error)
AwemeAuthorizedGet 获取千川账户下已授权抖音号
func (*Manager) BatchCampaignStatusUpdate ¶
func (m *Manager) BatchCampaignStatusUpdate(req BatchCampaignStatusUpdateReq) (res *BatchCampaignStatusUpdateRes, err error)
BatchCampaignStatusUpdate 获取广告账户数据
func (*Manager) CampaignCreate ¶
func (m *Manager) CampaignCreate(req CampaignCreateReq) (res *CampaignCreateRes, err error)
CampaignCreate 获取广告账户数据
func (*Manager) CampaignListGet ¶
func (m *Manager) CampaignListGet(req CampaignListGetReq) (res *CampaignListGetRes, err error)
CampaignListGet 获取广告账户数据
func (*Manager) CampaignUpdate ¶
func (m *Manager) CampaignUpdate(req CampaignUpdateReq) (res *CampaignUpdateRes, err error)
CampaignUpdate 获取广告账户数据
func (*Manager) CreativeGet ¶
func (m *Manager) CreativeGet(req CreativeGetReq) (res *CreativeGetRes, err error)
CreativeGet 获取账户下创意列表
func (*Manager) CreativeRejectReason ¶
func (m *Manager) CreativeRejectReason(req CreativeRejectReasonReq) (res *CreativeRejectReasonRes, err error)
CreativeRejectReason 获取创意审核建议
func (*Manager) CreativeStatusUpdate ¶
func (m *Manager) CreativeStatusUpdate(req CreativeStatusUpdateReq) (res *CreativeStatusUpdateRes, err error)
CreativeStatusUpdate 更新创意状态
func (*Manager) DmpAudiencesGet ¶
func (m *Manager) DmpAudiencesGet(req DmpAudiencesGetReq) (res *DmpAudiencesGetRes, err error)
DmpAudiencesGet 查询人群包列表
func (*Manager) FileImageAd ¶
func (m *Manager) FileImageAd(req FileImageAdReq) (res *FileImageAdRes, err error)
FileImageAd 上传图片素材
func (*Manager) FileImageGet ¶
func (m *Manager) FileImageGet(req FileImageGetReq) (res *FileImageGetRes, err error)
FileImageGet 获取素材库的图片
func (*Manager) FileVideoAd ¶
func (m *Manager) FileVideoAd(req FileVideoAdReq) (res *FileVideoAdRes, err error)
FileVideoAd 上传视频素材
func (*Manager) FileVideoAwemeGet ¶
func (m *Manager) FileVideoAwemeGet(req FileVideoAwemeGetReq) (res *FileVideoAwemeGetRes, err error)
FileVideoAwemeGet 获取抖音号下的视频
func (*Manager) FileVideoGet ¶
func (m *Manager) FileVideoGet(req FileVideoGetReq) (res *FileVideoGetRes, err error)
FileVideoGet 获取素材库的视频
func (*Manager) OauthAccessToken ¶
func (m *Manager) OauthAccessToken(req OauthAccessTokenReq) (res OauthAccessTokenRes, err error)
OauthAccessToken 获取access_token
func (*Manager) OauthConnect ¶
func (m *Manager) OauthConnect(param OauthParam) string
OauthConnect 生成授权链接,获取授权码
func (*Manager) OauthRefreshToken ¶
func (m *Manager) OauthRefreshToken(req OauthRefreshTokenReq) (res OauthRefreshTokenRes, err error)
OauthRefreshToken 刷新access_token
func (*Manager) ProductAvailableGet ¶
func (m *Manager) ProductAvailableGet(req ProductAvailableGetReq) (res *ProductAvailableGetRes, err error)
ProductAvailableGet 获取可投商品列表接口
func (*Manager) ReportAdGet ¶
func (m *Manager) ReportAdGet(req ReportAdGetReq) (res *ReportAdGetRes, err error)
ReportAdGet 获取广告计划数据
func (*Manager) ReportCreativeGet ¶
func (m *Manager) ReportCreativeGet(req ReportCreativeGetReq) (res *ReportCreativeGetRes, err error)
ReportCreativeGet 获取千川广告账户全量信息
func (*Manager) ShopAccountInfo ¶
func (m *Manager) ShopAccountInfo(req ShopAccountInfoReq) (res *ShopAccountInfoRes, err error)
ShopAccountInfo 获取店铺账户信息
func (*Manager) ShopAdvertiserList ¶
func (m *Manager) ShopAdvertiserList(req ShopAdvertiserListReq) (res *ShopAdvertiserListRes, err error)
ShopAdvertiserList 获取店铺账户关联的广告账户列表
func (*Manager) ToolsAwemeCategoryTopAuthorGet ¶
func (m *Manager) ToolsAwemeCategoryTopAuthorGet(req ToolsAwemeCategoryTopAuthorGetReq) (res *ToolsAwemeCategoryTopAuthorGetRes, err error)
ToolsAwemeCategoryTopAuthorGet 查询抖音类目下的推荐达人
func (*Manager) ToolsAwemeMultiLevelCategoryGet ¶
func (m *Manager) ToolsAwemeMultiLevelCategoryGet(req ToolsAwemeMultiLevelCategoryGetReq) (res *ToolsAwemeMultiLevelCategoryGetRes, err error)
ToolsAwemeMultiLevelCategoryGet 查询抖音类目列表
func (*Manager) ToolsCreativeWordSelect ¶
func (m *Manager) ToolsCreativeWordSelect(req ToolsCreativeWordSelectReq) (res *ToolsCreativeWordSelectRes, err error)
ToolsCreativeWordSelect 查询动态创意词包
func (*Manager) ToolsIndustryGet ¶
func (m *Manager) ToolsIndustryGet(req ToolsIndustryGetReq) (res *ToolsIndustryGetRes, err error)
ToolsIndustryGet 获取行业列表
func (*Manager) ToolsInterestActionActionCategory ¶
func (m *Manager) ToolsInterestActionActionCategory(req ToolsInterestActionActionCategoryReq) (res *ToolsInterestActionActionCategoryRes, err error)
ToolsInterestActionActionCategory 行为类目查询
func (*Manager) ToolsInterestActionActionKeyword ¶
func (m *Manager) ToolsInterestActionActionKeyword(req ToolsInterestActionActionKeywordReq) (res *ToolsInterestActionActionKeywordRes, err error)
ToolsInterestActionActionKeyword 行为关键词查询
func (*Manager) ToolsInterestActionInterestCategory ¶
func (m *Manager) ToolsInterestActionInterestCategory(req ToolsInterestActionInterestCategoryReq) (res *ToolsInterestActionInterestCategoryRes, err error)
ToolsInterestActionInterestCategory 兴趣类目查询
func (*Manager) ToolsInterestActionInterestKeyword ¶
func (m *Manager) ToolsInterestActionInterestKeyword(req ToolsInterestActionInterestKeywordReq) (res *ToolsInterestActionInterestKeywordRes, err error)
ToolsInterestActionInterestKeyword 兴趣关键词查询
func (*Manager) UserInfo ¶
func (m *Manager) UserInfo(req UserInfoReq) (res *UserInfoRes, err error)
UserInfo 获取授权时登录用户信息
type OauthAccessTokenReq ¶
type OauthAccessTokenReq struct {
Code string // 授权码
}
OauthAccessTokenReq access_token请求
type OauthAccessTokenRes ¶
type OauthAccessTokenRes struct {
QCError
Data OauthAccessTokenResData `json:"data"`
}
OauthAccessTokenRes access_token返回结构体
type OauthAccessTokenResData ¶
type OauthAccessTokenResData struct {
AccessToken string `json:"access_token"` // 用于验证权限的token
ExpiresIn uint64 `json:"expires_in"` // access_token剩余有效时间,单位(秒)
RefreshToken string `json:"refresh_token"` // 刷新access_token,用于获取新的access_token和refresh_token,并且刷新过期时间
RefreshTokenExpiresIn uint64 `json:"refresh_token_expires_in"` // refresh_token剩余有效时间,单位(秒)
}
OauthAccessTokenResData access_token返回
type OauthParam ¶
type OauthParam struct {
AppId int64 // 应用的app_id
State string // 应用的状态,默认”your_custom_params“,暂时不知道其他选项
Scope []int64 // 应用权限范围,形如”[20120000,22000000]“
MaterialAuth string // 暂时不知道,默认”1“
RedirectUri string // 重定向链接
Rid string // 暂时不知道
}
OauthParam 授权参数
type OauthRefreshTokenReq ¶
type OauthRefreshTokenReq struct {
RefreshToken string // 填写通过access_token获取到的refresh_token参数
}
OauthRefreshTokenReq 刷新access_token请求
type OauthRefreshTokenRes ¶
type OauthRefreshTokenRes struct {
QCError
Data OauthRefreshTokenResData `json:"data"`
}
OauthRefreshTokenRes 刷新access_token返回结构体
type OauthRefreshTokenResData ¶
type OauthRefreshTokenResData OauthAccessTokenResData
OauthRefreshTokenResData 刷新access_token返回
type PageInfo ¶
type PageInfo struct {
Page uint64 `json:"page"` // 页数
PageSize uint64 `json:"page_size"` // 页面大小
TotalNumber uint64 `json:"total_number"` // 总数
TotalPage uint64 `json:"total_page"` // 总页数
}
PageInfo 页码结构体
type ProductAvailableGetReq ¶
type ProductAvailableGetReq struct {
AccessToken string `json:"access_token"`
AdvertiserId int64 `json:"advertiser_id,omitempty"`
Filter ProductAvailableGetFilter
Page int64 `json:"page,omitempty"`
PageSize int64 `json:"page_size,omitempty"`
}
ProductAvailableGetReq 获取可投商品列表接口 的 请求结构体
type ProductAvailableGetRes ¶
type ProductAvailableGetRes struct {
QCError
Data struct {
PageInfo PageInfo `json:"page_info"`
ProductList []ProductAvailableGetResDetail `json:"product_list"`
} `json:"data"`
}
ProductAvailableGetRes 获取可投商品列表接口 的 响应结构体
type ProductAvailableGetResDetail ¶
type ProductAvailableGetResDetail struct {
CategoryName string `json:"category_name"` //分类
DiscountPrice float64 `json:"discount_price"` //售价,单位:元
Id int64 `json:"id"` //商品id
Img string `json:"img"` //主图
Inventory int64 `json:"inventory"` //库存
Name string `json:"name"` //商品名称
ProductRate float64 `json:"product_rate"` //好评率
SaleTime string `json:"sale_time"` //上架时间
}
type QCError ¶
type QCError struct {
Code int64 `json:"code"` // 错误码
Message string `json:"message"` // 错误码描述
RequestId string `json:"request_id,omitempty"` // 错误码描述r
}
QCError 错误结构体
type ReportAdGetFiltering ¶
type ReportAdGetReq ¶
type ReportAdGetReq struct {
AdvertiserId int64 `json:"advertiser_id"` // 千川广告主账户id
StartDate string `json:"start_date"` // 开始时间,格式 2021-04-05
EndDate string `json:"end_date"` // 结束时间,格式 2021-04-05,时间跨度不能超过180天
Fields []string `json:"fields"` // 需要查询的消耗指标
Filtering ReportAdGetFiltering `json:"filtering"` //过滤条件
OrderField string `json:"order_field,omitempty"` // 排序字段
OrderType string `json:"order_type,omitempty"` // 排序方式,允许值: ASC 升序(默认)、DESC 降序
Page int64 `json:"page,omitempty"` // 页码,默认为1
PageSize int64 `json:"page_size,omitempty"` // 页面大小,默认为10,取值范围:1-500
AccessToken string `json:"access_token"` // 调用/oauth/access_token/生成的token,此token需要用户授权。
}
ReportAdGetReq 获取广告计划数据-请求
type ReportAdGetRes ¶
type ReportAdGetRes struct {
QCError
Data ReportAdGetResData `json:"data"`
}
ReportAdGetRes 获取广告计划数据-返回结构体
type ReportAdGetResData ¶
type ReportAdGetResData struct {
List []ReportAdGetResDetail `json:"list"`
PageInfo PageInfo `json:"page_info"`
}
type ReportAdGetResDetail ¶
type ReportAdGetResDetail struct {
AdvertiserId int64 `json:"advertiser_id"` // 广告主id
AdId int64 `json:"ad_id"` // 广告计划id
StatCost float64 `json:"stat_cost"` // 消耗
ShowCnt int64 `json:"show_cnt"` // 展示次数
Ctr float64 `json:"ctr"` // 点击率
CpmPlatform float64 `json:"cpm_platform"` // 平均千次展示费用
ClickCnt int64 `json:"click_cnt"` // 点击次数
PayOrderCount int64 `json:"pay_order_count"` // 成交订单数
CreateOrderAmount float64 `json:"create_order_amount"` // 下单成交金额
CreateOrderCount int64 `json:"create_order_count"` // 下单订单数
PayOrderAmount float64 `json:"pay_order_amount"` // 成交订单金额
CreateOrderRoi float64 `json:"create_order_roi"` // 下单roi
PrepayAndPayOrderRoi float64 `json:"prepay_and_pay_order_roi"` // 支付roi
PrepayOrderCount int64 `json:"prepay_order_count"` // 广告预售订单数
PrepayOrderAmount float64 `json:"prepay_order_amount"` // 广告预售订单金额
DyFollow int64 `json:"dy_follow"` // 新增粉丝数
ConvertCnt int64 `json:"convert_cnt"` // 转化数
ConvertCost int64 `json:"convert_cost"` // 转化成本
ConvertRate float64 `json:"convert_rate"` // 转化率
DyComment int64 `json:"dy_comment"` // 评论次数。直播间带货:LIVE_PROM_GOODS 不支持该指标
DyLike int64 `json:"dy_like"` // 点赞次数。直播间带货:LIVE_PROM_GOODS 不支持该指标
LivePayOrderCostPerOrder float64 `json:"live_pay_order_cost_per_order"` // 成交客单价。短视频带货:VIDEO_PROM_GOODS 不支持该指标
LubanLiveEnterCnt int64 `json:"luban_live_enter_cnt"` // 直播间观看人次。短视频带货:VIDEO_PROM_GOODS 不支持该指标
LiveWatchOneMinuteCount int64 `json:"live_watch_one_minute_count"` // 直播间超过1分钟观看人次。短视频带货:VIDEO_PROM_GOODS 不支持该指标
LiveFansClubJoinCnt int64 `json:"live_fans_club_join_cnt"` // 直播间新加团人次。短视频带货:VIDEO_PROM_GOODS 不支持该指标
LubanLiveSlidecartClickCnt int64 `json:"luban_live_slidecart_click_cnt"` // 直播间查看购物车次数。短视频带货:VIDEO_PROM_GOODS 不支持该指标
LubanLiveClickProductCnt int64 `json:"luban_live_click_product_cnt"` // 直播间商品点击次数。短视频带货:VIDEO_PROM_GOODS 不支持该指标
LubanLiveCommentCnt int64 `json:"luban_live_comment_cnt"` // 直播间评论次数。短视频带货:VIDEO_PROM_GOODS 不支持该指标
LubanLiveGiftCnt int64 `json:"luban_live_gift_cnt"` // 直播间打赏次数。短视频带货:VIDEO_PROM_GOODS 不支持该指标
LubanLiveGiftAmount float64 `json:"luban_live_gift_amount"` // 直播间音浪收入。短视频带货:VIDEO_PROM_GOODS 不支持该指标
}
type ReportCreativeGetReq ¶
type ReportCreativeGetReq struct {
AdvertiserId int64 `json:"advertiser_id"` // 千川广告主账户id
StartDate string `json:"start_date"` // 开始时间,格式 2021-04-05
EndDate string `json:"end_date"` // 结束时间,格式 2021-04-05,时间跨度不能超过180天
Fields []string `json:"fields"` // 需要查询的消耗指标
Filtering ReportCreativeGetFiltering `json:"filtering"` //过滤条件
OrderField string `json:"order_field,omitempty"` // 排序字段
OrderType string `json:"order_type,omitempty"` // 排序方式,允许值: ASC 升序(默认)、DESC 降序
Page int64 `json:"page,omitempty"` // 页码,默认为1
PageSize int64 `json:"page_size,omitempty"` // 页面大小,默认为10,取值范围:1-500
AccessToken string `json:"access_token"` // 调用/oauth/access_token/生成的token,此token需要用户授权。
}
ReportCreativeGetReq 获取广告创意数据-请求
type ReportCreativeGetRes ¶
type ReportCreativeGetRes struct {
QCError
Data ReportCreativeGetResData `json:"data"`
}
ReportCreativeGetRes 获取千川广告账户全量信息-返回结构体
type ReportCreativeGetResData ¶
type ReportCreativeGetResData struct {
List []ReportCreativeGetResDataDetail `json:"list"`
PageInfo PageInfo `json:"page_info"`
}
type ReportCreativeGetResDataDetail ¶
type ReportCreativeGetResDataDetail struct {
AdvertiserId int64 `json:"advertiser_id"` // 广告主id
CreativeId int64 `json:"creative_id"` // 广告创意id
StatCost float64 `json:"stat_cost"` // 消耗
ShowCnt int64 `json:"show_cnt"` // 展示次数
Ctr float64 `json:"ctr"` // 点击率
CpmPlatform float64 `json:"cpm_platform"` // 平均千次展示费用
ClickCnt int64 `json:"click_cnt"` // 点击次数
PayOrderCount int64 `json:"pay_order_count"` // 成交订单数
CreateOrderAmount float64 `json:"create_order_amount"` // 下单成交金额
CreateOrderCount int64 `json:"create_order_count"` // 下单订单数
PayOrderAmount float64 `json:"pay_order_amount"` // 成交订单金额
CreateOrderRoi float64 `json:"create_order_roi"` // 下单roi
PrepayAndPayOrderRoi float64 `json:"prepay_and_pay_order_roi"` // 支付roi
PrepayOrderCount int64 `json:"prepay_order_count"` // 广告预售订单数
PrepayOrderAmount float64 `json:"prepay_order_amount"` // 广告预售订单金额
DyFollow int64 `json:"dy_follow"` // 新增粉丝数
ConvertCnt int64 `json:"convert_cnt"` // 转化数
ConvertCost int64 `json:"convert_cost"` // 转化成本
ConvertRate float64 `json:"convert_rate"` // 转化率
DyComment int64 `json:"dy_comment"` // 评论次数。直播间带货:LIVE_PROM_GOODS 不支持该指标
DyLike int64 `json:"dy_like"` // 点赞次数。直播间带货:LIVE_PROM_GOODS 不支持该指标
LivePayOrderCostPerOrder float64 `json:"live_pay_order_cost_per_order"` // 成交客单价。短视频带货:VIDEO_PROM_GOODS 不支持该指标
LubanLiveEnterCnt int64 `json:"luban_live_enter_cnt"` // 直播间观看人次。短视频带货:VIDEO_PROM_GOODS 不支持该指标
LiveWatchOneMinuteCount int64 `json:"live_watch_one_minute_count"` // 直播间超过1分钟观看人次。短视频带货:VIDEO_PROM_GOODS 不支持该指标
LiveFansClubJoinCnt int64 `json:"live_fans_club_join_cnt"` // 直播间新加团人次。短视频带货:VIDEO_PROM_GOODS 不支持该指标
LubanLiveSlidecartClickCnt int64 `json:"luban_live_slidecart_click_cnt"` // 直播间查看购物车次数。短视频带货:VIDEO_PROM_GOODS 不支持该指标
LubanLiveClickProductCnt int64 `json:"luban_live_click_product_cnt"` // 直播间商品点击次数。短视频带货:VIDEO_PROM_GOODS 不支持该指标
LubanLiveCommentCnt int64 `json:"luban_live_comment_cnt"` // 直播间评论次数。短视频带货:VIDEO_PROM_GOODS 不支持该指标
LubanLiveGiftCnt int64 `json:"luban_live_gift_cnt"` // 直播间打赏次数。短视频带货:VIDEO_PROM_GOODS 不支持该指标
LubanLiveGiftAmount float64 `json:"luban_live_gift_amount"` // 直播间音浪收入。短视频带货:VIDEO_PROM_GOODS 不支持该指标
}
type ShopAccountInfoReq ¶
type ShopAccountInfoReq struct {
ShopIds []int64 //店铺id列表,一次最多查询10个shop_id信息
AccessToken string // 调用/oauth/access_token/生成的token,此token需要用户授权。
}
ShopAccountInfoReq 获取店铺账户信息
type ShopAccountInfoRes ¶
type ShopAccountInfoRes struct {
QCError
Data ShopAccountInfoResCom `json:"data"`
}
ShopAccountInfoRes 获取店铺账户信息-返回结构体
type ShopAccountInfoResCom ¶
type ShopAccountInfoResCom struct {
List []ShopAccountInfoResComDetail `json:"list"`
}
type ShopAdvertiserListReq ¶
type ShopAdvertiserListReq struct {
ShopId int64 // 店铺id
Page uint64 // 页码.默认值: 1
PageSize uint64 // 页面数据量.默认值: 10, 最大值:100
AccessToken string // 调用/oauth/access_token/生成的token,此token需要用户授权。
}
ShopAdvertiserListReq 获取店铺账户关联的广告账户列表-请求
type ShopAdvertiserListRes ¶
type ShopAdvertiserListRes struct {
QCError
Data ShopAdvertiserListResCom `json:"data"`
}
ShopAdvertiserListRes 获取店铺账户关联的广告账户列表-返回结构体
type ToolsAwemeCategoryTopAuthorGetReq ¶
type ToolsAwemeCategoryTopAuthorGetReq struct {
AccessToken string `json:"access_token"` // 调用/oauth/access_token/生成的token,此token需要用户授权。
AdvertiserId int64 `json:"advertiser_id"` // 广告主ID
CategoryId int64 `json:"category_id,omitempty"` // 类目id,一级,二级,三级类目id均可
Behaviors []string `json:"behaviors,omitempty"` // 抖音用户行为类型,详见【附录-抖音达人互动用户行为类型】 默认为空,仅影响覆盖人群数
}
ToolsAwemeCategoryTopAuthorGetReq 查询抖音类目下的推荐达人 的 请求结构体
type ToolsAwemeCategoryTopAuthorGetRes ¶
type ToolsAwemeCategoryTopAuthorGetRes struct {
QCError
Data struct {
Authors []ToolsAwemeCategoryTopAuthorGetResAuthor `json:"authors"`
} `json:"data"`
}
ToolsAwemeCategoryTopAuthorGetRes 查询抖音类目下的推荐达人 的 响应结构体
type ToolsAwemeCategoryTopAuthorGetResAuthor ¶
type ToolsAwemeCategoryTopAuthorGetResAuthor struct {
AuthorName string `json:"author_name"` //抖音作者名
TotalFansNumStr string `json:"total_fans_num_str"` //粉丝数
CoverNumStr string `json:"cover_num_str"` //覆盖人群数
LabelId string `json:"label_id"` //抖音号id
AwemeId string `json:"aweme_id"` //抖音id
Avatar string `json:"avatar"` //抖音头像
CategoryName string `json:"category_name"` //抖音分类
}
type ToolsAwemeMultiLevelCategoryGetReq ¶
type ToolsAwemeMultiLevelCategoryGetReq struct {
AccessToken string `json:"access_token"` // 调用/oauth/access_token/生成的token,此token需要用户授权。
AdvertiserId int64 `json:"advertiser_id"` // 广告主ID
Behaviors []string `json:"behaviors,omitempty"` // 抖音用户行为类型,详见【附录-抖音达人互动用户行为类型】 默认为空,仅影响覆盖人群数
}
ToolsAwemeMultiLevelCategoryGetReq 查询抖音类目列表 的 请求结构体
type ToolsAwemeMultiLevelCategoryGetRes ¶
type ToolsAwemeMultiLevelCategoryGetRes struct {
QCError
Data struct {
Categories []ToolsAwemeMultiLevelCategoryGetResCategory `json:"authors"`
} `json:"data"`
}
ToolsAwemeMultiLevelCategoryGetRes 查询抖音类目列表 的 响应结构体
type ToolsAwemeMultiLevelCategoryGetResCategory ¶
type ToolsAwemeMultiLevelCategoryGetResCategory struct {
Id int64 `json:"id"`
CoverNumStr string `json:"cover_num_str"`
FansNumStr string `json:"fans_num_str"`
Value string `json:"value"`
Children []struct {
Id int64 `json:"id"`
CoverNumStr string `json:"cover_num_str"`
FansNumStr string `json:"fans_num_str"`
Value string `json:"value"`
Children []struct {
Id int64 `json:"id"`
CoverNumStr string `json:"cover_num_str"`
FansNumStr string `json:"fans_num_str"`
Value string `json:"value"`
} `json:"children"`
} `json:"children"`
}
type ToolsCreativeWordSelectReq ¶
type ToolsCreativeWordSelectReq struct {
AccessToken string `json:"access_token"` // 调用/oauth/access_token/生成的token,此token需要用户授权。
AdvertiserId int64 `json:"advertiser_id"` // 广告主ID
CreativeWordIds []string `json:"creative_word_ids"` // 创意词包id列表,如不填默认返回所有创意词包
}
ToolsCreativeWordSelectReq 查询动态创意词包 的 请求结构体
type ToolsCreativeWordSelectRes ¶
type ToolsCreativeWordSelectRes struct {
QCError
Data struct {
CreativeWord []ToolsCreativeWordSelectResDetail `json:"creative_word"`
} `json:"data"`
}
ToolsCreativeWordSelectRes 查询动态创意词包 的 响应结构体
type ToolsCreativeWordSelectResDetail ¶
type ToolsCreativeWordSelectResDetail struct {
CreativeWordId int64 `json:"creative_word_id"`
Name string `json:"name"`
DefaultWord string `json:"default_word"`
Words []string `json:"words"`
ContentType string `json:"content_type"`
MaxWordLen int64 `json:"max_word_len"`
Status string `json:"status"`
UserRate float64 `json:"user_rate"`
}
type ToolsIndustryGetReq ¶
type ToolsIndustryGetReq struct {
AccessToken string `json:"access_token"` // 调用/oauth/access_token/生成的token,此token需要用户授权。
Level int64 `json:"level,omitempty"` //只获取某级别数据,1:第一级,2:第二级,3:第三级,默认都返回
Type string `json:"type,omitempty"` //可选值:"ADVERTISER","AGENT","ADVERTISER"为原有广告3.0行业, "AGENT"为代理商行业获取,代理商行业level都为1
}
ToolsIndustryGetReq 获取行业列表 的 请求结构体
type ToolsIndustryGetRes ¶
type ToolsIndustryGetRes struct {
QCError
Data struct {
List []ToolsIndustryGetResDetail `json:"list"`
} `json:"data"`
}
ToolsIndustryGetRes 获取行业列表 的 响应结构体
type ToolsIndustryGetResDetail ¶
type ToolsIndustryGetResDetail struct {
IndustryId int64 `json:"industry_id"`
IndustryName string `json:"industry_name"`
Level int64 `json:"level"`
ToolsAwemeCategoryTopAuthorGetRes int64 `json:"first_industry_id"`
FirstIndustryName string `json:"first_industry_name"`
SecondIndustryId int64 `json:"second_industry_id"`
SecondIndustryName string `json:"second_industry_name"`
ThirdIndustryId int64 `json:"third_industry_id"`
ThirdIndustryName string `json:"third_industry_name"`
}
type ToolsInterestActionActionCategoryReq ¶
type ToolsInterestActionActionCategoryReq struct {
AccessToken string `json:"access_token"` // 调用/oauth/access_token/生成的token,此token需要用户授权。
AdvertiserId int64 `json:"advertiser_id"` // 广告主ID
ActionScene []string `json:"action_scene"` // 行为场景,详见【附录-行为场景】 允许值: "E-COMMERCE","NEWS","APP"
ActionDays int64 `json:"action_days"` // 行为天数 默认值: 7、15、30、60、90、180、365
}
ToolsInterestActionActionCategoryReq 行为类目查询 的 请求结构体
type ToolsInterestActionActionCategoryRes ¶
type ToolsInterestActionActionCategoryRes struct {
QCError
Data ToolsInterestActionActionCategoryResLevelOne `json:"data"`
}
ToolsInterestActionActionCategoryRes 行为类目查询 的 响应结构体
type ToolsInterestActionActionCategoryResLevelOne ¶
type ToolsInterestActionActionCategoryResLevelOne struct {
Id string `json:"id"` //行为类目id
Num string `json:"num"` //数量
Name string `json:"name"` //行为类目
Children []ToolsInterestActionActionCategoryResLevelTwo `json:"children"`
}
type ToolsInterestActionActionCategoryResLevelThree ¶
type ToolsInterestActionActionCategoryResLevelThree struct {
Id string `json:"id"` //行为类目id
Num string `json:"num"` //数量
Name string `json:"name"` //行为类目
Children []ToolsInterestActionActionCategoryResLevelFour `json:"children"`
}
type ToolsInterestActionActionCategoryResLevelTwo ¶
type ToolsInterestActionActionCategoryResLevelTwo struct {
Id string `json:"id"` //行为类目id
Num string `json:"num"` //数量
Name string `json:"name"` //行为类目
Children []ToolsInterestActionActionCategoryResLevelThree `json:"children"`
}
type ToolsInterestActionActionKeywordReq ¶
type ToolsInterestActionActionKeywordReq struct {
AccessToken string `json:"access_token"` // 调用/oauth/access_token/生成的token,此token需要用户授权。
AdvertiserId int64 `json:"advertiser_id"` // 广告主ID
QueryWords string `json:"query_words"` // 关键词
ActionScene []string `json:"action_scene"` // 行为场景,详见【附录-行为场景】 允许值: "E-COMMERCE","NEWS","APP"
ActionDays int64 `json:"action_days"` // 行为天数 默认值: 7、15、30、60、90、180、365
}
ToolsInterestActionActionKeywordReq 行为关键词查询 的 请求结构体
type ToolsInterestActionActionKeywordRes ¶
type ToolsInterestActionActionKeywordRes struct {
QCError
Data struct {
List []ToolsInterestActionActionKeywordResDetail `json:"list"`
} `json:"data"`
}
ToolsInterestActionActionKeywordRes 行为关键词查询 的 响应结构体
type ToolsInterestActionInterestCategoryReq ¶
type ToolsInterestActionInterestCategoryReq struct {
AccessToken string `json:"access_token"` // 调用/oauth/access_token/生成的token,此token需要用户授权。
AdvertiserId int64 `json:"advertiser_id"` // 广告主ID
}
ToolsInterestActionInterestCategoryReq 兴趣类目查询 的 请求结构体
type ToolsInterestActionInterestCategoryRes ¶
type ToolsInterestActionInterestCategoryRes struct {
QCError
Data []ToolsInterestActionInterestCategoryResLevelOne `json:"data"`
}
ToolsInterestActionInterestCategoryRes 兴趣类目查询 的 响应结构体
type ToolsInterestActionInterestCategoryResLevelOne ¶
type ToolsInterestActionInterestCategoryResLevelOne struct {
Id string `json:"id"`
Num string `json:"num"`
Name string `json:"name"`
Children []ToolsInterestActionInterestCategoryResLevelTwo `json:"children"`
}
type ToolsInterestActionInterestCategoryResLevelThree ¶
type ToolsInterestActionInterestCategoryResLevelThree struct {
Id string `json:"id"`
Num string `json:"num"`
Name string `json:"name"`
Children []ToolsInterestActionInterestCategoryResLevelFour `json:"children"`
}
type ToolsInterestActionInterestCategoryResLevelTwo ¶
type ToolsInterestActionInterestCategoryResLevelTwo struct {
Id string `json:"id"`
Num string `json:"num"`
Name string `json:"name"`
Children []ToolsInterestActionInterestCategoryResLevelThree `json:"children"`
}
type ToolsInterestActionInterestKeywordReq ¶
type ToolsInterestActionInterestKeywordReq struct {
AccessToken string `json:"access_token"` // 调用/oauth/access_token/生成的token,此token需要用户授权。
AdvertiserId int64 `json:"advertiser_id"` // 广告主ID
QueryWords string `json:"query_words"` // 关键词
}
ToolsInterestActionInterestKeywordReq 兴趣关键词查询 的 请求结构体
type ToolsInterestActionInterestKeywordRes ¶
type ToolsInterestActionInterestKeywordRes struct {
QCError
Data struct {
List []ToolsInterestActionInterestKeywordResDetail `json:"list"`
} `json:"data"`
}
ToolsInterestActionInterestKeywordRes 兴趣关键词查询 的 响应结构体
type UserInfoReq ¶
type UserInfoReq struct {
AccessToken string // 调用/oauth/access_token/生成的token,此token需要用户授权。
}
UserInfoReq 获取授权时登录用户信息-请求
type UserInfoRes ¶
type UserInfoRes struct {
QCError
Data UserInfoResCom `json:"data"`
}
UserInfoRes 获取授权时登录用户信息-返回结构体