快手磁力引擎MarketingAPI Golang SDK

• Oauth2 授权 (api/oauth)
• 生成授权链接 [ Url(ctx context.Context, clt core.SDKClient, req oauth.UrlRequest) string ]
• 获取AccessToken [ AccessToken(ctx context.Context, clt core.SDKClient, authCode String) (oauth.AccessTokenResponse, error) ]
• 刷新Token [ RefreshToken(ctx context.Context, clt core.SDKClient, refreshToken string) (oauth.AccessTokenResponse, error)]
• 拉取token下授权广告账户接口 [ ApprovalList(ctx context.Context, clt *core.SDKClient, accessToken string, pageNo int, pageSize int) ([]uint64, error) ]
• 账号服务
• 广告主 (api/advertiser)
  • 获取广告主信息 [ Info(ctx context.Context, clt core.SDKClient, accessToken string, advertiserID int64) (advertiser.Info, error) ]
  • 获取广告账户余额信息 [ FundGet(ctx context.Context, clt *core.SDKClient, accessToken string, advertiserID int64) (float64, error) ]
  • 获取广告主账户流水信息 [ FundDailyFlows(ctx context.Context, clt core.SDK, accessToken string, req advertiser.FundDailyFlowsRequest) (*advertiser.FundDailyFlowsResponse, error) ]
• 账户罗盘(api/adcompass)
  • 获取罗盘绑定广告主列 [ Advertisers(ctx context.Context, clt *core.SDKClient, accessToken string, advertiserID uint64) ([]adcompass.Advertiser, error) ]
  • 磁力罗盘对外 quota 腾挪接口 [ QuotaTending(ctx context.Context, clt core.SDKClient, accessToken string, req adcompass.QuotaTendingRequest) (string, error) ]
• 广告投放
• 智能创编 (api/dsp)
  • 广告计划 (api/dsp/campaign)
  • 创建广告计划 [ Create(ctx context.Context, clt core.SDKClient, accessToken string, req campaign.CreateRequest) (uint64, error) ]
  • 修改广告计划 [ Update(ctx context.Context, clt core.SDKClient, accessToken string, req campaign.UpdateRequest) (uint64, error) ]
  • 获取广告计划信息 [ List(ctx context.Context, clt core.SDKClient, accessToken string, req campaign.ListRequest) (*campaign.ListResponse, error) ]
  • 修改广告计划状态 [ UpdateStatus(ctx context.Context, clt core.SDKClient, accessToken string, req campaign.UpdateStatusRequest) ([]uint64, error) ]
  • 广告组 (api/dsp/unit)
  • 创建广告组 [ Create(ctx context.Context, clt core.SDKClient, accessToken string, req unit.CreateRequest) (uint64, error) ]
  • 修改广告组 [ Update(ctx context.Context, clt core.SDKClient, accessToken string, req unit.UpdateRequest) (uint64, error) ]
  • 查询广告组 [ List(ctx context.Context, clt core.SDKClient, accessToken string, req unit.ListRequest) (*unit.ListResponse, error) ]
  • 修改广告组预算 [ UpdateDayBudget(ctx context.Context, clt core.SDKClient, accessToken string, req unit.UpdateDayBudgetRequest) error ]
  • 修改广告组状态 [ UpdateStatus(ctx context.Context, clt core.SDKClient, accessToken string, req unit.UpdateStatusRequest) ([]int64, error) ]
  • 修改广告组出价 [ UpdateBid(ctx context.Context, clt core.SDKClient, accessToken string, req unit.UpdateBidRequest) error ]
  • 批量获取监测链接接口 [ GetMonitorURLs(ctx context.Context, clt core.SDKClient, accessToken string, req unit.GetMonitorURLsRequest) ([]unit.UnitMonitorURL, error) ]
  • 监测链接批量更新接口 [ BatchUpdateMonitorURLs(ctx context.Context, clt core.SDKClient, accessToken string, req unit.BatchUpdateMonitorURLsRequest) ([]unit.UnitMonitorURL, error) ]
  • 广告创意 (api/dsp/creative)
  • 创建自定义创意 [ Create(ctx context.Context, clt core.SDKClient, accessToken string, req creative.CreateRequest) (uint64, error) ]
  • 创建程序化创意 [ AdvancedCreativeCreate(ctx context.Context, clt core.SDKClient, accessToken string, req creative.AdvancedCreativeCreateRequest) (uint64, error) ]
  • 修改自定义创意 [ Update(ctx context.Context, clt core.SDKClient, accessToken string, req creative.UpdateRequest) (uint64, error) ]
  • 修改程序化创意 [ AdvancedCreativeUpdate(ctx context.Context, clt core.SDKClient, accessToken string, req creative.AdvancedCreativeUpdateRequest) (uint64, error) ]
  • 批量修改自定义创意 [ BatchUpdate(ctx context.Context, clt core.SDKClient, accessToken string, req creative.BatchUpdateRequest) (*creative.BatchUpdateResponse, error) ]
  • 查询自定义创意 [ List(ctx context.Context, clt core.SDKClient, accessToken string, req creative.ListRequest) (*creative.ListResponse, error) ]
  • 查询程序化创意 [ AdvancedCreativeList(ctx context.Context, clt core.SDKClient, accessToken string, req creative.AdvancedCreativeListRequest) (*creative.AdvancedCreativeListResponse, error) ]
  • 修改创意状态 [ UpdateStatus(ctx context.Context, clt core.SDKClient, accessToken string, req creative.UpdateStatusRequest) ([]uint64, error) ]
  • 创意体验 [ Preview(ctx context.Context, clt core.SDKClient, accessToken string, req creative.PreviewRequest) error ]
• 获取各层级信息
  • 获取广告计划信息 [ campaign.List(ctx context.Context, clt core.SDKClient, accessToken string, req campaign.ListRequest) (*campaign.ListResponse, error) ]
  • 获取广告组信息 [ unit.List(ctx context.Context, clt core.SDKClient, accessToken string, req unit.ListRequest) (*unit.ListResponse, error) ]
  • 获取广告创意信息 [ creative.List(ctx context.Context, clt core.SDKClient, accessToken string, req creative.ListRequest) (*creative.ListResponse, error) ]
  • 获取程序化创意2.0信息 [ creative.AdvancedProgramList(ctx context.Context, clt core.SDKClient, accessToken string, req creative.AdvancedProgramListRequest) (*creative.AdvancedProgramListResponse, error) ]
  • 获取程序化创意2.0审核信息 [ creative.AdvancedProgramReviewDetail(ctx context.Context, clt core.SDKClient, accessToken string, req creative.AdvancedProgramReviewDetailRequest) (*creative.AdvancedProgramReviewDetail, error) ]
  • 账户操作记录信息查询 [ tool.OperationRecordList(ctx context.Context, clt core.SDKClient, accessToken string, req tool.OperationRecordListRequest) (*tool.OperationRecordListResponse, error) ]
  • 定向人群预估查询 [ tool.AudiencePredict(ctx context.Context, clt core.SDKClient, accessToken string, req tool.AudiencePredictRequest) (int64, error) ]
• 账户层级
  • 账户日预算查询 [ advertiser.BudgetGet(ctx context.Context, clt core.SDKClient, accessToken string, advertiserID int64) (advertiser.Budget, error) ]
  • 修改账户预算 [ advertiser.UpdateBudget(ctx context.Context, clt core.SDKClient, accessToken string, req advertiser.UpdateBudgetRequest) error ]
• 广告计划(api/campaign)
  • 创建广告计划 [ Create(ctx context.Context, clt core.SDKClient, accessToken string, req campaign.CreateRequest) (int64, error) ]
  • 修改广告计划 [ Update(ctx context.Context, clt core.SDKClient, accessToken string, req campaign.UpdateRequest) (int64, error) ]
  • 修改广告计划预算 [ UpdateBudget(ctx context.Context, clt core.SDKClient, accessToken string, req campaign.UpdateBudgetRequest) error ]
  • 修改广告计划状态 [ UpdateStatus(ctx context.Context, clt core.SDKClient, accessToken string, req campaign.UpdateStatusRequest) ([]int64, error) ]
• 广告组(api/unit)
  • 创建广告组 [ Create(ctx context.Context, clt core.SDKClient, accessToken string, req unit.CreateRequest) (int64, error) ]
  • 创建创建联盟定投广告组 [ CreateUnion(ctx context.Context, clt core.SDKClient, accessToken string, req unit.CreateUnionRequest) (int64, error) ]
  • 修改广告组 [ Update(ctx context.Context, clt core.SDKClient, accessToken string, req unit.UpdateRequest) (int64, error) ]
  • 修改联盟定投广告组 [ UpdateUnion(ctx context.Context, clt core.SDKClient, accessToken string, req unit.UpdateUnionRequest) (int64, error) ]
  • 修改广告组预算 [ UpdateDayBudget(ctx context.Context, clt core.SDKClient, accessToken string, req unit.UpdateDayBudgetRequest) error ]
  • 修改广告组状态 [ UpdateStatus(ctx context.Context, clt core.SDKClient, accessToken string, req unit.UpdateStatusRequest) ([]int64, error) ]
  • 修改广告组出价 [ UpdateBid(ctx context.Context, clt core.SDKClient, accessToken string, req unit.UpdateBidRequest) error ]
• 广告创意(api/creative)
  • 创建创意 [ Create(ctx context.Context, clt core.SDKClient, accessToken string, req creative.CreateRequest) (int64, error) ]
  • 创建程序化2.0创意 [ AdvancedProgramCreate(ctx context.Context, clt core.SDKClient, accessToken string, req creative.AdvancedProgramCreateRequest) (int64, error) ]
  • 批量创建&修改创意 [ BatchUpdate(ctx context.Context, clt core.SDKClient, accessToken string, req creative.BatchUpdateRequest) (*creative.BatchUpdateResponse, error) ]
  • 修改创意 [ Update(ctx context.Context, clt core.SDKClient, accessToken string, req creative.UpdateRequest) (int64, error) ]
  • 修改程序化2.0创意 [ AdvancedProgramUpdate(ctx context.Context, clt core.SDKClient, accessToken string, req creative.AdvancedProgramUpdateRequest) error ]
  • 修改创意状态 [ UpdateStatus(ctx context.Context, clt core.SDKClient, accessToken string, req creative.UpdateStatusRequest) ([]int64, error) ]
  • 创意体验 [ Preview(ctx context.Context, clt core.SDKClient, accessToken string, req creative.PreviewRequest) error ]
  • 创意标签填写建议 [ CreativeTagAdvise(ctx context.Context, clt core.SDKClient, accessToken string, req creative.CreativeTagAdviseRequest) (*creative.CreativeTagAdviseResponse, error) ]
• 高级创意(api/asset)
  • 获取高级创意列表 [ AdvCardList(ctx context.Context, clt core.SDKClient, accessToken string, req asset.AdvCardListRequest) (*asset.AdvCardListResponse, error) ]
  • 创建高级创意接口 [ AdvCardCreate(ctx context.Context, clt core.SDKClient, accessToken string, req asset.AdvCardCreateRequest) ([]int64, error) ]
  • 删除高级创意接口 [ AdvCardRemove(ctx context.Context, clt core.SDKClient, accessToken string, req asset.AdvCardRemoveRequest) ([]int64, error) ]
• 搜索广告工具
  • 关键词管理 (api/wordinfo)
  • 获取关键词列表 [ List(ctx context.Context, clt core.SDKClient, accessToken string, req wordinfo.ListRequest) (*wordinfo.ListResponse, error) ]
  • 创建关键词 [ Create(ctx context.Context, clt core.SDKClient, accessToken string, req wordinfo.CreateRequest) (*wordinfo.CreateResponse, error) ]
  • 修改关键词匹配方式 [ UpdateMatchType(ctx context.Context, clt core.SDKClient, accessToken string, req wordinfo.UpdateMatchTypeRequest) ([]uint64, error) ]
  • 修改关键词投放状态 [ UpdateStatus(ctx context.Context, clt core.SDKClient, accessToken string, req wordinfo.UpdateStatusRequest) ([]uint64, error) ]
• 数据报表
• 广告数据报表 (api/report)
  • 代理商数据 [ AgentReport(ctx context.Context, clt core.SDKClient, accessToken string, req report.AgentReportRequest) (*report.AgentReportResponse, error) ]
  • 广告主数据 [ AccountReport(ctx context.Context, clt core.SDKClient, accessToken string, req report.AccountReportRequest) (*report.ReportResponse, error) ]
  • 广告计划数据 [ CampaignReport(ctx context.Context, clt core.SDKClient, accessToken string, req report.CampaignReportRequest) (*report.ReportResponse, error) ]
  • 广告单元数据 [ UnitReport(ctx context.Context, clt core.SDKClient, accessToken string, req report.UnitReportRequest) (*report.ReportResponse, error) ]
  • 广告创意数据 [ CreativeReport(ctx context.Context, clt core.SDKClient, accessToken string, req report.CreativeReportRequest) (*report.ReportResponse, error) ]
  • 程序化创意数据 [ ProgramCreativeReport(ctx context.Context, clt core.SDKClient, accessToken string, req report.ProgramCreativeReportRequest) (*report.ReportResponse, error) ]
  • 广告素材数据 [ CreativeReport(ctx context.Context, clt core.SDKClient, accessToken string, req report.MaterialReportRequest) (*report.ReportResponse, error) ]
  • 人群分析数据 [ AudienceReport(ctx context.Context, clt core.SDKClient, accessToken string, req report.AudienceReportRequest) (*report.ReportResponse, error) ]
  • 小店通转化数据 [ MerchantDeatailReport(ctx context.Context, clt core.SDKClient, accessToken string, req report.MerchantDetailReportRequest) (*report.MerchantDetailReportResponse, error) ]
  • 关键词报表 [ WordInfoReport(ctx context.Context, clt core.SDKClient, accessToken string, req report.WordInfoReportRequest) (*report.ReportResponse, error) ]
  • 搜索词报表 [ QueryWordReport(ctx context.Context, clt core.SDKClient, accessToken string, req report.QueryWordReportRequest) (*report.ReportResponse, error) ]
• 素材管理(api/file)
• 图片素材
  • 上传图片v1接口 [ AdImageUploadV1(ctx context.Context, clt core.SDKClient, accessToken string, req file.AdImageUploadRequestV1) (*file.Image, error) ]
  • 上传图片v2接口 [ AdImageUploadV2(ctx context.Context, clt core.SDKClient, accessToken string, req file.AdImageUploadRequestV2) (*file.Image, error) ]
  • 查询图片信息get接口 [ AdImageGet(ctx context.Context, clt core.SDKClient, accessToken string, req file.AdImageGetRequest) (*file.Image, error) ]
  • 查询图片信息list接口 [ AdImageList(ctx context.Context, clt core.SDKClient, accessToken string, req file.AdImageListRequest) (*file.AdImageListResponse, error) ]
• 视频素材
  • 上传视频接口v1 [ AdVideoUploadV1(ctx context.Context, clt core.SDKClient, accessToken string, req file.AdVideoUploadRequestV1) (string, error) ]
  • 上传视频接口v2 [ AdVideoUploadV2(ctx context.Context, clt core.SDKClient, accessToken string, req file.AdVideoUploadRequestV2) (*file.Video, error) ]
  • 获取视频信息get接口 [ AdVideoGet(ctx context.Context, clt core.SDKClient, accessToken string, req file.AdVideoGetRequest) ([]file.Video, error) ]
  • 查询视频信息list接口 [ AdVideoList(ctx context.Context, clt