advertiser

Documentation

Overview

Package advertiser 账户信息获取

Index

• type AccountBudgetGetRequest
  • func (r AccountBudgetGetRequest) Encode() string
• type AccountBudgetGetResponse
• type AccountBudgetUpdateRequest
  • func (r AccountBudgetUpdateRequest) Encode() []byte
• type Advertiser
• type AwemeAuthInfo
• type AwemeAuthListGetFilter
• type AwemeAuthListGetRequest
  • func (r AwemeAuthListGetRequest) Encode() string
• type AwemeAuthListGetResponse
• type AwemeAuthListGetResult
• type AwemeAuthVideoInfo
• type Balance
• type BalanceGetRequest
  • func (r BalanceGetRequest) Encode() string
• type BalanceGetResponse
• type Budget
• type TypeGetRequest
  • func (r TypeGetRequest) Encode() string
• type TypeGetResponse

Types

type AccountBudgetGetRequest

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

AccountBudgetGetRequest 获取账户日预算

func (AccountBudgetGetRequest) Encode

func (r AccountBudgetGetRequest) Encode() string

Encode implement GetRequest interface

type AccountBudgetGetResponse

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

AccountBudgetGetResponse 获取账户日预算

type AccountBudgetUpdateRequest

type AccountBudgetUpdateRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// BudgetMode 预算类型
	// INFINITE 不限
	// SPECIFIED 日预算
	BudgetMode qianchuan.BudgetMode `json:"budget_mode,omitempty"`
	// Budget 账户今日竞价预算，单位元
	Budget float64 `json:"budget,omitempty"`
}

AccountBudgetUpdateRequest 更新账户日预算 API Request

func (AccountBudgetUpdateRequest) Encode

func (r AccountBudgetUpdateRequest) Encode() []byte

type Advertiser

type Advertiser struct {
	// EcpType 账户类型，可选值:
	// SHOP: 商家
	// SHOP_STAR: 商家达人
	// COMMON_STAR: 普通达人
	// AGENT: 百应机构
	EcpType qianchuan.EcpType `json:"ecp_type,omitempty"`
	// AdvertiserID 广告主id
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
}

type AwemeAuthInfo

type AwemeAuthInfo struct {
	// AuthVideoInfo 视频信息
	AuthVideoInfo *AwemeAuthVideoInfo `json:"auth_video_info,omitempty"`
	// AuthType 抖音号授权类型
	AuthType []string `json:"auth_type,omitempty"`
	// AwemeShowID 抖音号，即客户在手机端上看到的抖音号，若向客户披露抖音号请使用该字段
	AwemeShowID string `json:"aweme_show_id,omitempty"`
	// AwemeAvatar 抖音号头像
	AwemeAvatar string `json:"aweme_avatar,omitempty"`
	// AwemeName 抖音号名称
	AwemeName string `json:"aweme_name,omitempty"`
	// AuthSource 授权来源
	// STAR 星图
	// QIANCHUAN 千川PC
	// AWEME 随心推
	AuthSource string `json:"auth_source,omitempty"`
	// StartTime 授权开始时间
	StartTime string `json:"start_time,omitempty"`
	// EndTime 授权结束时间
	EndTime string `json:"end_time,omitempty"`
	// CreateTime 授权时间
	CreateTime string `json:"create_time,omitempty"`
	// AuthStatus 授权状态
	AuthStatus string `json:"auth_status,omitempty"`
	// AuthRange 授权范围
	AuthRange string `json:"auth_range,omitempty"`
	// AwemeID 抖音id
	AwemeID uint64 `json:"aweme_id,omitempty"`
	// IsCancellationProgress 是否有待处理解除授权申请
	IsCancellationProgress bool `json:"is_cancellation_progress,omitempty"`
}

AwemeAuthInfo 抖音号授权信息

type AwemeAuthListGetFilter

type AwemeAuthListGetFilter struct {
	// AwemeShowID 抖音show_id
	// 注意：最多支持100个抖音号
	AwemeShowID []string `json:"aweme_show_id,omitempty"`
	// AwemeID 抖音id
	// 注意：最多支持100个抖音号
	AwemeID []uint64 `json:"aweme_id,omitempty"`
	// AuthStatus 授权状态筛选 可选值:
	// ALL 全部授权状态
	// EFFECTIVE 授权生效
	// EXPIRED 授权失效
	// WAIT_BIND 待达人确认授权
	AuthStatus string `json:"auth_status,omitempty"`
	// AuthType 授权类型筛选，仅支持传0，1，2，3 可选值:
	// ALL 全部授权类型
	// AWEME_COOPERATOR 合作达人
	// OFFICIAL 官方
	// SELF 自运营
	AuthType string `json:"auth_type,omitempty"`
	// AwemeName 抖音号名称
	// 注意：模糊查询
	AwemeName string `json:"aweme_name,omitempty"`
	// AuthRange 授权范围筛选 可选值:
	// ALL 全部授权
	// BY_AWEME 抖音号授权
	// BY_VIDEO 单视频授权
	AuthRange string `json:"auth_range,omitempty"`
	// IsCancellationProgress 待处理解除授权申请
	// 默认 false
	IsCancellationProgress bool `json:"is_cancellation_progress,omitempty"`
}

AwemeAuthListGetFilter 过滤条件

type AwemeAuthListGetRequest

type AwemeAuthListGetRequest struct {
	// Filtering 过滤条件
	Filtering *AwemeAuthListGetFilter `json:"filtering,omitempty"`
	// AdvertiserID 广告主id
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// Page 页码，默认1
	Page int `json:"page,omitempty"`
	// PageSize 页码大小，可选值：10、20、50、100，默认10
	PageSize int `json:"page_size,omitempty"`
}

AwemeAuthListGetRequest 获取千川账户下抖音号授权列表 API Request

func (AwemeAuthListGetRequest) Encode

func (r AwemeAuthListGetRequest) Encode() string

Encode implement GetRequest interface

type AwemeAuthListGetResponse

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

AwemeAuthListGetResponse 获取千川账户下抖音号授权列表 API Response

type AwemeAuthListGetResult

type AwemeAuthListGetResult struct {
	// PageInfo 分页信息
	PageInfo *model.PageInfo `json:"page_info,omitempty"`
	// AuthorizationInfos 抖音号列表
	AuthorizationInfos []AwemeAuthInfo `json:"authorization_infos,omitempty"`
}

type AwemeAuthVideoInfo

type AwemeAuthVideoInfo struct {
	// VideoID 视频 ID
	VideoID string `json:"video_id,omitempty"`
	// AwemeItemID 抖音短视频 ID
	AwemeItemID string `json:"aweme_item_id,omitempty"`
	// Title 抖音中的视频标题
	Title string `json:"title,omitempty"`
	// VideoCoverURL 视频封面
	VideoCoverURL string `json:"video_cover_url,omitempty"`
}

AwemeAuthVideoInfo 视频信息

type Balance

type Balance struct {
	// AdvertiserID 广告主ID或代理商ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// AccountTotal 账户总余额
	AccountTotal float64 `json:"account_total,omitempty"`
	// AccountValid 账户可用总余额
	AccountValid float64 `json:"account_valid,omitempty"`
	// AccountFrozen 账户冻结总余额
	AccountFrozen float64 `json:"account_frozen,omitempty"`
	// AccountGeneralTotal 通用总余额
	AccountGeneralTotal float64 `json:"account_general_total,omitempty"`
	// AccountGeneralValid 通用可用余额
	AccountGeneralValid float64 `json:"account_general_valid,omitempty"`
	// AccountGeneralFrozen 通用冻结余额
	AccountGeneralFrozen float64 `json:"account_general_frozen,omitempty"`
	// AccountBiddingTotal 竞价总余额
	AccountBiddingTotal float64 `json:"account_bidding_total,omitempty"`
	// AccountBiddingValid 竞价可用余额
	AccountBiddingValid float64 `json:"account_bidding_valid,omitempty"`
	// AccountBiddingFrozen 竞价冻结余额
	AccountBiddingFrozen float64 `json:"account_bidding_frozen,omitempty"`
	// AccountBrandTotal 账户品牌总余额
	AccountBrandTotal float64 `json:"account_brand_total,omitempty"`
	// AccountBrandValid 账户品牌可用余额
	AccountBrandValid float64 `json:"account_brand_valid,omitempty"`
	// AccountBrandFrozen 账户品牌冻结余额
	AccountBrandFrozen float64 `json:"account_brand_frozen,omitempty"`
	// ShareGrantTotal 总共享赠款
	ShareGrantTotal float64 `json:"share_grant_total,omitempty"`
	// ShareWalletGeneralValid 共享钱包通用可用余额
	ShareWalletGeneralValid float64 `json:"share_wallet_general_valid,omitempty"`
	// ShareWalletBiddingValid 共享钱包竞价可用余额
	ShareWalletBiddingValid float64 `json:"share_wallet_bidding_valid,omitempty"`
	// ShareWalletBrandValid 共享钱包品牌可用余额
	ShareWalletBrandValid float64 `json:"share_wallet_brand_valid,omitempty"`
	// ShareWalletID 共享钱包id
	ShareWalletID string `json:"share_wallet_id,omitempty"`
	// ShareWalletName 共享钱包名称
	ShareWalletName string `json:"share_wallet_name,omitempty"`
	// ShareWalletTotal 共享钱包可用总余额
	ShareWalletTotal float64 `json:"share_wallet_total,omitempty"`
}

type BalanceGetRequest

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

BalanceGetRequest 获取账户余额 API Request

func (BalanceGetRequest) Encode

func (r BalanceGetRequest) Encode() string

Encode implement GetRequest interface

type BalanceGetResponse

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

BalanceGetResponse 获取账户余额 API Response

type Budget

type Budget struct {
	// BudgetMode 预算类型
	// INFINITE 不限
	// SPECIFIED 日预算
	BudgetMode qianchuan.BudgetMode `json:"budget_mode,omitempty"`
	// Budget 账户今日竞价预算，单位元
	Budget float64 `json:"budget,omitempty"`
}

type TypeGetRequest

type TypeGetRequest struct {
	// AdvertiserIDs 千川广告主账户id，一次请求不超过20个
	AdvertiserIDs []uint64 `json:"advertiser_ids,omitempty"`
}

TypeGetRequest 获取千川账户类型 API Request

func (TypeGetRequest) Encode

func (r TypeGetRequest) Encode() string

Encode implement GetRequest interface

type TypeGetResponse

type TypeGetResponse struct {
	model.BaseResponse
	Data struct {
		// List 广告主数据列表
		List []Advertiser `json:"list,omitempty"`
	} `json:"data,omitempty"`
}

TypeGetResponse 获取千川账户类型 API Response