advertiser

Documentation

Overview

Package advertiser 账号服务相关API models

Index

• type AvatarGetRequest
  • func (r AvatarGetRequest) Encode() string
• type AvatarGetResponse
• type AvatarGetResponseData
• type AvatarInfo
• type BudgetGetRequest
  • func (r BudgetGetRequest) Encode() string
• type BudgetGetResponse
• type BudgetGetResponseData
• type BudgetGetResponseList
• type FundDailyStatRequest
  • func (r FundDailyStatRequest) Encode() string
• type FundDailyStatResponse
• type FundDailyStatResponseData
• type FundDailyStatResponseList
• type FundGetRequest
  • func (r FundGetRequest) Encode() string
• type FundGetResponse
• type FundGetResponseData
• type FundTransactionGetRequest
  • func (r FundTransactionGetRequest) Encode() string
• type FundTransactionGetResponse
• type FundTransactionGetResponseData
• type FundTransactionGetResponseList
• type Info
• type InfoRequest
  • func (r InfoRequest) Encode() string
• type InfoResponse
• type PublicInfo
• type PublicInfoRequest
  • func (r PublicInfoRequest) Encode() string
• type PublicInfoResponse
• type UpdateBudgetRequest
  • func (r UpdateBudgetRequest) Encode() []byte

Types

type AvatarGetRequest

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

AvatarGetRequest 获取广告主头像信息 API Request

func (AvatarGetRequest) Encode

func (r AvatarGetRequest) Encode() string

Encode implement GetRequest interface

type AvatarGetResponse

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

AvatarGetResponse 获取广告主头像信息 API Response

type AvatarGetResponseData

type AvatarGetResponseData struct {
	// AdvertiserID 广告主id
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// AvatarStatus 头像审核状态 0-未设置，1-审核中，2-审核被拒，3-审核通过
	AvatarStatus int `json:"avatar_status,omitempty"`
	// AvatarReason 头像被拒原因
	AvatarReason string `json:"avatar_reason,omitempty"`
	// SourceStatus 品牌审核状态 0-未设置，1-审核中，2-审核被拒，3-审核通过,
	SourceStatus int `json:"source_status,omitempty"`
	// SourceReason 品牌信息被拒原因
	SourceReason string `json:"source_reason,omitempty"`
	// AvatarInfo 头像信息
	AvatarInfo *AvatarInfo `json:"avatar_info,omitempty"`
}

AvatarGetResponseData 获取广告主头像信息json返回值

type AvatarInfo

type AvatarInfo struct {
	// WebUri 当前头像的uri
	WebUri string `json:"web_uri,omitempty"`
	// AuditWebUri 审核中头像的uri
	AuditWebUri string `json:"audit_web_uri,omitempty"`
	// Height 审核中头像的高度
	Height int `json:"height,omitempty"`
	// Width 审核中头像的宽度
	Width int `json:"width,omitempty"`
}

AvatarInfo 头像信息

type BudgetGetRequest

type BudgetGetRequest struct {
	// AdvertiserIDs 广告主ID集合(如果包含没有访问权限的ID,将返回no permission error) 取值范围: 1-100
	AdvertiserIDs []uint64 `json:"advertiser_ids,omitempty"`
}

BudgetGetRequest 获取账户日预算 API Request

func (BudgetGetRequest) Encode

func (r BudgetGetRequest) Encode() string

Encode implement GetRequest interface

type BudgetGetResponse

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

BudgetGetResponse 获取账户日预算 API Response

type BudgetGetResponseData

type BudgetGetResponseData struct {
	// List 返回值列表
	List []BudgetGetResponseList `json:"list,omitempty"`
}

BudgetGetResponseData json返回值

type BudgetGetResponseList

type BudgetGetResponseList struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// Budget 预算，单位：元； 精度：小数点后两位；举例：100.01。当预算类型为不限，返回的预算为0.0
	Budget float64 `json:"budget,omitempty"`
	// BudgetMode 预算类型
	BudgetMode enum.BudgetMode `json:"budget_mode,omitempty"`
}

BudgetGetResponseList 返回值列表

type FundDailyStatRequest

type FundDailyStatRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// StartDate 开始时间，格式YYYY-MM-DD，默认当前年份的1月1日
	StartDate time.Time `json:"start_date,omitempty"`
	// EndDate 结束时间，格式YYYY-MM-DD，默认为今天
	EndDate time.Time `json:"end_date,omitempty"`
	// Page 页码. 默认值: 1
	Page int `json:"page,omitempty"`
	// PageSize 页面数据量. 默认值: 10
	PageSize int `json:"page_size,omitempty"`
}

FundDailyStatRequest 查询账户日流水 API Request

func (FundDailyStatRequest) Encode

func (r FundDailyStatRequest) Encode() string

Encode implement GetRequest interface

type FundDailyStatResponse

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

FundDailyStatResponse 查询账户日流水 API Response

type FundDailyStatResponseData

type FundDailyStatResponseData struct {
	// List list
	List []FundDailyStatResponseList `json:"list,omitempty"`
	// PageInfo 分页信息
	PageInfo *model.PageInfo `json:"page_info,omitempty"`
}

FundDailyStatResponseData json返回值

type FundDailyStatResponseList

type FundDailyStatResponseList struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// Date 日期
	Date string `json:"date,omitempty"`
	// Balance 日终结余(单位元）
	Balance float64 `json:"balance,omitempty"`
	// CashCost 现金支出(单位元)
	CashCost float64 `json:"cash_cost,omitempty"`
	// Cost 总支出(单位元)
	Cost float64 `json:"cost,omitempty"`
	// Frozen 冻结(单位元)
	Frozen float64 `json:"frozen,omitempty"`
	// Income 总存入(单位元)
	Income float64 `json:"income,omitempty"`
	// RewardCost 赠款支出(单位元)
	RewardCost float64 `json:"reward_cost,omitempty"`
	// ReturnGoodsCost 返货支出(单位元)
	ReturnGoodsCost float64 `json:"return_goods_cost,omitempty"`
	// TransferIn 总转入(单位元)
	TransferIn float64 `json:"transfer_in,omitempty"`
	// TransferOut 总转出(单位元)
	TransferOut float64 `json:"transfer_out,omitempty"`
}

FundDailyStatResponseList 广告主流水

type FundGetRequest

type FundGetRequest struct {
	// AdvertiserID 广告主ID或代理商ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
}

FundGetRequest 查询账号余额 API Request

func (FundGetRequest) Encode

func (r FundGetRequest) Encode() string

Encode implement GetRequest interface

type FundGetResponse

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

FundGetResponse 查询账号余额 API Response

type FundGetResponseData

type FundGetResponseData struct {
	// AdvertiserID 广告主ID或代理商ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// Name 账户名
	Name string `json:"name,omitempty"`
	// Email 联系邮箱
	Email string `json:"email,omitempty"`
	// Balance 账户总余额(单位元)
	Balance float64 `json:"balance,omitempty"`
	// ValidBalance 账户可用总余额(单位元)
	ValidBalance float64 `json:"valid_balance,omitempty"`
	// Cash 现金余额(单位元)
	Cash float64 `json:"cash,omitempty"`
	// ValidCash 现金可用余额(单位元)
	ValidCash float64 `json:"valid_cash,omitempty"`
	// Grant 赠款余额(单位元)
	Grant float64 `json:"grant,omitempty"`
	// ValidGrant 赠款可用余额(单位元)
	ValidGrant float64 `json:"valid_grant,omitempty"`
	// ReturnGoodsAbs 返货余额(单位元)，仅支持部分广告主
	ReturnGoodsAbs float64 `json:"return_goods_abs,omitempty"`
	// ValidReturnGoodsAbs 返货可用余额(单位元)，仅支持部分广告主
	ValidReturnGoodsAbs float64 `json:"valid_return_goods_abs,omitempty"`
	// ReturnGoodsCost 返货支出(单位元)，仅支持部分广告主
	ReturnGoodsCost float64 `json:"return_goods_cost,omitempty"`
}

FundGetResponseData 账号余额

type FundTransactionGetRequest

type FundTransactionGetRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// StartDate 开始时间，格式YYYY-MM-DD，默认当前年份的1月1日
	StartDate time.Time `json:"start_date,omitempty"`
	// EndDate 结束时间，格式YYYY-MM-DD，默认为今天
	EndDate time.Time `json:"end_date,omitempty"`
	// TransactionType 流水类型
	TransactionType enum.TransactionType `json:"transaction_type,omitempty"`
	// Page 页码. 默认值: 1
	Page int `json:"page,omitempty"`
	// PageSize 页面数据量. 默认值: 10
	PageSize int `json:"page_size,omitempty"`
}

FundTransactionGetRequest 查询账号流水明细 API Request

func (FundTransactionGetRequest) Encode

func (r FundTransactionGetRequest) Encode() string

Encode implement GetRequest interface

type FundTransactionGetResponse

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

FundTransactionGetResponse 查询账号流水明细 API Response

type FundTransactionGetResponseData

type FundTransactionGetResponseData struct {
	// List 明细list
	List []FundTransactionGetResponseList `json:"list,omitempty"`
}

FundTransactionGetResponseData json返回值

type FundTransactionGetResponseList

type FundTransactionGetResponseList struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// TransactionType 流水类型
	TransactionType enum.TransactionType `json:"transaction_type,omitempty"`
	// CreateTime 流水产生时间
	CreateTime string `json:"create_time,omitempty"`
	// Amount 交易总金额(单位元)
	Amount float64 `json:"amount,omitempty"`
	// Cash 现金总金额(单位元)
	Cash float64 `json:"cash,omitempty"`
	// Frozen 冻结(单位元)
	Frozen float64 `json:"frozen,omitempty"`
	// Grant 赠款总金额(单位元）
	Grant float64 `json:"grant,omitempty"`
	// ReturnGoods 返货总金额(单位元)
	ReturnGoods float64 `json:"return_goods,omitempty"`
	// TransactionSeq 交易流水号
	TransactionSeq uint64 `json:"transaction_seq,omitempty"`
	// Remitter 付款方，即广告主id。
	Remitter uint64 `json:"remitter,omitempty"`
	// Payee 收款方，即广告主id。
	Payee uint64 `json:"payee,omitempty"`
	// Dealbase 返点
	Dealbase float64 `json:"dealbase,omitempty"`
}

FundTransactionGetResponseList 明细

type Info

type Info struct {
	// ID 广告主ID
	ID uint64 `json:"id,omitempty"`
	// Name 账户名
	Name string `json:"name,omitempty"`
	// Description 品牌描述,即推广内容
	Description string `json:"description,omitempty"`
	// Email 联系邮箱
	Email string `json:"email,omitempty"`
	// Contacter 联系人
	Contacter string `json:"contacter,omitempty"`
	// Phonenumber 手机号码
	Phonenumber string `json:"phonenumber,omitempty"`
	// Address 固定电话
	Address string `json:"address,omitempty"`
	// LiscenseUrl 执照预览地址(链接默认1小时内有效)
	LicenseUrl string `json:"license_url,omitempty"`
	// LicenseNo 执照编号
	LicenseNo string `json:"license_no,omitempty"`
	// LicenseProvice 执照省份
	LicenseProvince string `json:"license_province,omitempty"`
	// LicenseCity 执照城市
	LicenseCity string `json:"license_city,omitempty"`
	// Company 公司名
	Company string `json:"company,omitempty"`
	// Brand 经营类别
	Brand string `json:"brand,omitempty"`
	// Role 角色
	Role enum.AdvertiserRole `json:"role,omitempty"`
	// Status 状态
	Status enum.AdvertiserStatus `json:"status,omitempty"`
	// PromotionArea 运营区域
	PromotionArea string `json:"promotion_area,omitempty"`
	// PromotionCenterProvince 运营省份
	PromotionCenterProvince string `json:"promotion_center_province,omitempty"`
	// PromotionCenterCity 运营城市
	PromotionCenterCity string `json:"promotion_center_city,omitempty"`
	// FirstIndustryName 一级行业名称（新版）
	FirstIndustryName string `json:"first_industry_name,omitempty"`
	// SecondIndustryName 二级行业名称（新版）
	SecondIndustryName string `json:"second_industry_name,omitempty"`
	// Reason 审核拒绝原因
	Reason string `json:"reason,omitempty"`
	// CreateTime 创建时间
	CreateTime string `json:"create_time,omitempty"`
}

Info 广告主信息

type InfoRequest

type InfoRequest struct {
	// AdvertiserIDs 广告主ID集合(如果包含没有访问权限的ID,将返回no permission error) 取值范围: 1-100
	AdvertiserIDs []uint64 `json:"advertiser_ids,omitempty"`
	// Fields 查询字段集合, 默认:查询所有。字段详见下方response字段定义 .允许值: "id", "name","description", "email", "contacter", "phonenumber", "role", "status", "telephone", "address", "reason", "license_url", "license_no", "license_province", "license_city", "company", "brand", "promotion_area", "promotion_center_province", "promotion_center_city", "industry", "balance"， "create_time"
	Fields []string `json:"fields,omitempty"`
}

InfoRequest 广告主信息 API Request

func (InfoRequest) Encode

func (r InfoRequest) Encode() string

Encode implement GetRequest interface

type InfoResponse

type InfoResponse struct {
	model.BaseResponse
	// Data json返回值
	Data []Info `json:"data,omitempty"`
}

InfoResponse 广告主信息 API Response

type PublicInfo

type PublicInfo struct {
	// ID 广告主ID
	ID uint64 `json:"id,omitempty"`
	// Name 账户名
	Name string `json:"name,omitempty"`
	// Company 公司名
	Company string `json:"company,omitempty"`
	// FirstIndustryName 一级行业名
	FirstIndustryName string `json:"first_industry_name,omitempty"`
	// SecondIndustryName 二级行业名
	SecondIndustryName string `json:"second_industry_name,omitempty"`
}

PublicInfo 广告主公开信息

type PublicInfoRequest

type PublicInfoRequest struct {
	// AdvertiserIDs 广告主ID集合(如果包含没有访问权限的ID,将返回no permission error) 取值范围: 1-100
	AdvertiserIDs []uint64 `json:"advertiser_ids,omitempty"`
}

PublicInfoRequest 广告主公开信息 API Request

func (PublicInfoRequest) Encode

func (r PublicInfoRequest) Encode() string

Encode implement GetRequest interface

type PublicInfoResponse

type PublicInfoResponse struct {
	model.BaseResponse
	// Data json返回值
	Data []PublicInfo `json:"data,omitempty"`
}

PublicInfoResponse 广告主公开信息 API Response

type UpdateBudgetRequest

type UpdateBudgetRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// BudgetMode 预算模式
	BudgetMode enum.BudgetMode `json:"budget_mode,omitempty"`
	// Budget 预算值，取值范围：1000～9999999.99，当budget_mode=BUDGET_MODE_DAY时，必填
	// 单位：元； 最小值：0； 精度：小数点后两位
	Budget float64 `json:"budget,omitempty"`
}

UpdateBudgetRequest 更新账户日预算 API Request

func (UpdateBudgetRequest) Encode

func (r UpdateBudgetRequest) Encode() []byte

Encode implement PostRequest interface