creative

Documentation

Index

• type AddCreativeRequest
  • func (r AddCreativeRequest) Url() string
• type AddCreativeResponse
• type Creative
• type DeleteCreativeRequest
  • func (r DeleteCreativeRequest) Url() string
• type GetCreativeRequest
  • func (r GetCreativeRequest) Url() string
• type GetCreativeResponse
• type UpdateCreativeRequest
  • func (r UpdateCreativeRequest) Url() string
• type UpdateCreativeResponse

Types

type AddCreativeRequest

type AddCreativeRequest struct {
	// CreativeTypes 新增推广创意物料;集合长度限制：[1, 3000];建议分批多次请求
	CreativeTypes []Creative `json:"creativeTypes"`
}

AddCreativeRequest 新增推广创意 API Request

func (AddCreativeRequest) Url

func (r AddCreativeRequest) Url() string

type AddCreativeResponse

type AddCreativeResponse struct {
	Data []Creative `json:"data,omitempty"`
}

AddCreativeResponse 新增推广创意 API Response

type Creative

type Creative struct {
	// CampaignId 计划ID
	CampaignId int64 `json:"campaignId,omitempty"`
	// CreativeId 创意ID
	CreativeId int64 `json:"creativeId,omitempty"`
	// AdgroupId 推广单元ID
	AdgroupId int64 `json:"adgroupId,omitempty"`
	// Title 创意标题;长度限制：[9, 50];长度限制为字节数限制，1个中文按2个字节计算，英文、数字按1个字节计算，通配符不计入
	Title string `json:"title,omitempty"`
	// Description1 创意描述第一行;长度限制：[9, 80];长度限制为字节数限制，1个中文按2个字节计算，英文、数字按1个字节计算，通配符不计入
	Description1 string `json:"description1,omitempty"`
	Description2 string `json:"description2,omitempty"`
	// Description2 创意描述第二行;长度限制：[0, 80];长度限制为字节数限制，1个中文按2个字节计算，英文、数字按1个字节计算，通配符不计入
	// Pause 暂停/启用创意
	Pause *bool `json:"pause,omitempty"`
	// Status 创意状态
	Status int `json:"status,omitempty"`
	// MobileDestinationUrl 移动访问网址;长度限制：[1, 1024];网址域名需与账户注册域名相同，其他情况请参考业务限制
	MobileDestinationUrl string `json:"mobileDestinationUrl,omitempty"`
	// MobileDisplayUrl 移动显示网址;长度限制：[1, 36];取值限制为账户注册域名本身，可通过"查询账户"接口获取，对应字段为regDomain
	MobileDisplayUrl string `json:"mobileDisplayUrl,omitempty"`
	// PcDestinationUrl 计算机访问网址;长度限制：[1, 1024];网址域名需与账户注册域名相同，其他情况请参考业务限制
	PcDestinationUrl string `json:"pcDestinationUrl,omitempty"`
	// PcDisplayUrl 计算机显示网址;长度限制：[1, 36];取值限制为账户注册域名本身，可通过"查询账户"接口获取，对应字段为regDomain
	PcDisplayUrl string `json:"pcDisplayUrl,omitempty"`
	// OfflineReasons 推广下线原因;当有多个推广下线原因时，数组会有多个元素，每个代表一种原因
	OfflineReasons []model.OfflineReason `json:"offlineReasons,omitempty"`
	// Tabs 标签;说明: 同一创意支持添加多个标签，最多可添加30个，每个标签ID的取值范围为0-30，0表示无标签。;举例：创意同时标记了1、2、3号标签，则该字段取值为：[1,2,3]
	Tabs []int `json:"tabs,omitempty"`
	// Deeplink 应用调起网址;长度限制：[0, 1024];仅部分客户可设置，如需开通名单请咨询销售或客服同学
	Deeplink string `json:"deeplink,omitempty"`
	// MiniProgramUrl 小程序访问网址;长度限制：[0, 1024]
	MiniProgramUrl string `json:"miniProgramUrl,omitempty"`
}

Creative 推广创意

// Pause 可选值 // true - 暂停 // false - 启用

// Status 可选值 // 51 - 有效 // 52 - 暂停推广 // 53 - 审核不通过 // 54 - 待激活 // 55 - 审核中 // 56 - 部分无效 // 57 - 有效-移动URL审核中 // 备注：部分无效：移动物料审核未通过，计算机物料审核通过

type DeleteCreativeRequest

type DeleteCreativeRequest struct {
	// CreativeIds 创意ID
	CreativeIds []int64 `json:"creativeIds"`
}

DeleteCreativeRequest 删除推广创意 API Request

func (DeleteCreativeRequest) Url

func (r DeleteCreativeRequest) Url() string

type GetCreativeRequest

type GetCreativeRequest struct {
	// Ids 查询id集合;类型为单元ID时不超过1000个，类型为创意ID时不超过3000个，建议分批多次请求
	Ids []int64 `json:"ids"`
	// CreativeFields 查询推广创意字段
	CreativeFields []string `json:"creativeFields"`
	// IdType 查询id类型;5 - 单元ID;7 - 创意ID
	IdType int `json:"idType"`
	// GetTemp 是否获取创意影子;0 - 只查询创意本身;1 - 只查询创意影子;影子说明：用户先向系统提交了创意A，并且A已审核通过，之后再对A进行影响审核状态的修改（例如修改创意文案/url），修改后的创意为A’（A’即为影子，仅对审核通过的物料进行修改才会产生影子），在A’通过审核生效之前，线上的生效创意仍然为A。;此时：getTemp为0查询到的是A getTemp为1查询到的是A’
	GetTemp int `json:"getTemp,omitempty"`
}

GetCreativeRequest 查询推广创意 API Request 查询推广创意字段 creativeId - 创意ID adgroupId - 推广单元ID title - 创意标题 pause - 暂停/启用创意 status - 创意状态 description1 - 创意描述第一行 description2 - 创意描述第二行 pcDestinationUrl - 计算机访问网址 pcDisplayUrl - 计算机显示网址 mobileDestinationUrl - 移动访问网址 mobileDisplayUrl - 移动显示网址 tabs - 标签 miniProgramUrl - 小程序访问网址 offlineReasons - 推广下线原因 deeplink - 应用调起网址

func (GetCreativeRequest) Url

func (r GetCreativeRequest) Url() string

type GetCreativeResponse

type GetCreativeResponse struct {
	Data []Creative `json:"data,omitempty"`
}

GetCreativeResponse 获取推广创意 API Response

type UpdateCreativeRequest

type UpdateCreativeRequest struct {
	// CreativeTypes 更新推广创意字段;集合长度限制：[1, 3000];建议分批多次请求
	CreativeTypes []Creative `json:"creativeTypes,omitempty"`
}

UpdateCreativeRequest 修改推广创意 API Request

func (UpdateCreativeRequest) Url

func (r UpdateCreativeRequest) Url() string

type UpdateCreativeResponse

type UpdateCreativeResponse struct {
	Data []Creative `json:"data,omitempty"`
}

UpdateCreativeResponse 修改推广创意