{"id":18903789,"url":"https://github.com/bububa/baidu-marketing","last_synced_at":"2025-07-29T03:42:48.295Z","repository":{"id":41817941,"uuid":"373813527","full_name":"bububa/baidu-marketing","owner":"bububa","description":"baidu marketing-api golang sdk","archived":false,"fork":false,"pushed_at":"2023-04-19T06:30:18.000Z","size":145,"stargazers_count":6,"open_issues_count":1,"forks_count":6,"subscribers_count":1,"default_branch":"main","last_synced_at":"2023-07-11T19:37:31.226Z","etag":null,"topics":["advertising-api","baidu","marketing-api"],"latest_commit_sha":null,"homepage":"https://dev2.baidu.com/home","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bububa.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2021-06-04T11:02:36.000Z","updated_at":"2024-04-15T12:40:48.892Z","dependencies_parsed_at":"2024-04-15T12:53:36.304Z","dependency_job_id":null,"html_url":"https://github.com/bububa/baidu-marketing","commit_stats":null,"previous_names":[],"tags_count":22,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bububa%2Fbaidu-marketing","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bububa%2Fbaidu-marketing/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bububa%2Fbaidu-marketing/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bububa%2Fbaidu-marketing/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bububa","download_url":"https://codeload.github.com/bububa/baidu-marketing/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223657830,"owners_count":17181024,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["advertising-api","baidu","marketing-api"],"created_at":"2024-11-08T09:06:29.288Z","updated_at":"2024-11-08T09:06:29.842Z","avatar_url":"https://github.com/bububa.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 百度营销 MarketingAPI Golang SDK\n\n[![Go Reference](https://pkg.go.dev/badge/github.com/bububa/baidu-marketing.svg)](https://pkg.go.dev/github.com/bububa/baidu-marketing)\n[![Go](https://github.com/bububa/baidu-marketing/actions/workflows/go.yml/badge.svg)](https://github.com/bububa/baidu-marketing/actions/workflows/go.yml)\n[![goreleaser](https://github.com/bububa/baidu-marketing/actions/workflows/goreleaser.yml/badge.svg)](https://github.com/bububa/baidu-marketing/actions/workflows/goreleaser.yml)\n[![GitHub go.mod Go version of a Go module](https://img.shields.io/github/go-mod/go-version/bububa/baidu-marketing.svg)](https://github.com/bububa/baidu-marketing)\n[![GoReportCard](https://goreportcard.com/badge/github.com/bububa/baidu-marketing)](https://goreportcard.com/report/github.com/bububa/baidu-marketing)\n[![GitHub license](https://img.shields.io/github/license/bububa/baidu-marketing.svg)](https://github.com/bububa/baidu-marketing/blob/master/LICENSE)\n[![GitHub release](https://img.shields.io/github/release/bububa/baidu-marketing.svg)](https://GitHub.com/bububa/baidu-marketing/releases/)\n\n- OAuth授权 (api/oauth)\n  - 换取授权令牌接口 [ AccessToken(ctx context.Context, clt *core.SDKClient, req *oauth.AccessTokenRequest) (*oauth.AccessToken, error) ]\n  - 更新授权令牌接口 [ RefreshToken(ctx context.Context, clt *core.SDKClient, req *oauth.RefreshTokenRequest) (*oauth.AccessToken, error) ]\n  - 查询授权用户信息 [ GetUserInfo(ctx context.Context, clt *core.SDKClient, req *oauth.GetUserInfoRequest) (*oauth.UserInfo, error) ]\n- 账户管理\n  - 财务管理 (api/account/balance)\n    - 查询账户余额成分 [ GetBalanceInfo(ctx context.Context, clt \\*core.SDKClient, auth model.RequestHeader, productIds[]uint64) ([]balance.BalanceInfo, error) ]\n    - 查询转账记录 [ GetAccountTransferHistory(ctx context.Context, clt \\*core.SDKClient, auth model.RequestHeader, startTime time.Time, endTime time.Time) ([]balance.AccountTransferHistory, error) ]\n    - 查询待加款信息 [ GetPaymentHistory(ctx context.Context, clt \\*core.SDK, auth model.RequestHeader, reqBody balance.GetPaymentHistoryRequest) ([]balance.PaymentHistory, error) ]\n    - 查询付款信息与待加款信息 [ GetPaymentRecord(ctx context.Context, clt *core.SDK, auth model.RequestHeader, reqBody balance.GetPaymentRecordRequest) (*balance.GetPaymentRecordResponse, error) ]\n  - 账户管家管理 [ GetUserListByMccid(ctx context.Context, clt \\*core.SDK, auth model.RequestHeader) ([]account.MccUser, error) ]\n- 搜索广告投放 (api/search)\n  - 账户 (api/search/account)\n    - 查询账户 [ GetAccountInfo(ctx context.Context, clt \\*core.SDKClient, auth model.RequestHeader, accountFields []string) ([]account.Account, error) ]\n    - 更新账户 [ UpdateAccountInfo(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, account *account.Account) ([]account.Account, error) ]\n  - 计划 (api/search/campaign)\n    - 查询计划 [ GetCampaign(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, reqBody *campaign.GetCampaignRequest) (\\*model.ResponseHeader, []campaign.Campaign, error) ]\n    - 添加计划 [ AddCampaign(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, reqBody *campaign.AddCampaignRequest) (\\*model.ResponseHeader, []campaign.Campaign, error) ]\n    - 更新计划 [ UpdateCampaign(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, campaigns []campaign.Campaign) (*model.ResponseHeader, []campaign.Campaign, error) ]\n    - 删除计划 [ DeleteCampaign(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, campaignIds ...uint64) (*model.ResponseHeader, error) ]\n    - 查询计划已使用的推广业务 [ GetBindBusinessPointList(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, reqBody *campaign.GetBindBusinessPointListRequest) (\\*model.ResponseHeader, []campaign.BusinessPoint, error) ]\n  - 单元 (api/search/adgroup)\n    - 查询单元 [ GetAdgroup(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, reqBody *adgroup.GetAdgroupRequest) (\\*model.ResponseHeader, []adgroup.Adgroup, error) ]\n    - 添加单元 [ AddAdgroup(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, reqBody *adgroup.AddAdgroupRequest) (\\*model.ResponseHeader, []adgroup.Adgroup, error) ]\n    - 更新单元 [ UpdateAdgroup(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, adgroups []adgroup.Adgroup) (*model.ResponseHeader, []adgroup.Adgroup, error) ]\n    - 删除单元 [ DeleteAdgroup(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, adgroupIds ...uint64) (*model.ResponseHeader, error) ]\n  - 关键词 (api/search/keyword)\n    - 查询关键词 [ GetKeyword(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, reqBody *keyword.GetKeywordRequest) (\\*model.ResponseHeader, []keyword.Keyword, error) ]\n    - 添加关键词 [ AddWord(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *keyword.AddWordRequest) (*model.ResponseHeader, []keyword.Keyword, error) ]\n    - 更新关键词 [ UpdateWord(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *keyword.Keyword) (*model.ResponseHeader, []keyword.Keyword, error) ]\n    - 删除关键词 [ DeleteWord(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, keywordIds ...uint64) (\\*model.ResponseHeader, []keyword.Keyword, error)]\n  - 创意 (api/search/creative)\n    - 基础创基\n      - 查询基础创意 [ GetCreative(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *creative.GetCreativeRequest) (*model.ResponseHeader, []creative.Creative, error) ]\n      - 添加基础创意 [ AddCreative(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *creative.AddCreativeRequest) (*model.ResponseHeader, []creative.Creative, error) ]\n      - 更新基础创意 [ UpdateCreative(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, creatives []creative.Creative) (\\*model.ResponseHeader, []creative.Creative, error) ]\n      - 删除基础创意 [ DeleteCreative(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, creativeIds ...uint64) (*model.ResponseHeader, error) ]\n  - 创意组件\n    - APP 服务 (api/search/app)\n      - 获取APP素材 [ GetAppList(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *app.GetAppListRequest) (*model.ResponseHeader, []app.AppInfoItemList, error) ]\n    - APP绑定服务 (api/search/app)\n      - 查询APP绑定 [ GetAdgroupAppBind(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *app.GetAdgroupAppBindRequest) (*model.ResponseHeader, []app.AppBindItem, error) ]\n      - 添加APP绑定 [ AddAdgroupAppBind(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *app.AddAdgroupAppBindRequest) (*model.ResponseHeader, []app.AppBindItem, error) ]\n      - 删除APP绑定 [ DeleteAdgroupAppBind(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *app.DeleteAdgroupAppBindRequest) (*model.ResponseHeader,[]app.AppBindItem, error) ]\n- 信息流广告投放 (api/feed)\n  - 账户 (api/feed/account)\n    - 查询账户 [ GetAccountFeed(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, accountFields []string) (*model.ResponseHeader, []account.Account, error) ]\n    - 更新账户 [ UpdateAccountFeed(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, budget float64) (*model.ResponseHeader, []account.Account, error) ]\n  - 计划 (api/feed/campaign)\n    - 查询计划 [ GetCampaign(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, reqBody *campaign.GetCampaignFeedRequest) (\\*model.ResponseHeader, []campaign.Campaign, error) ]\n    - 添加计划 [ AddCampaign(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, reqBody *campaign.AddCampaignRequest) (\\*model.ResponseHeader, []campaign.Campaign, error) ]\n    - 更新计划 [ UpdateCampaign(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, campaigns []campaign.Campaign) (*model.ResponseHeader, []campaign.Campaign, error) ]\n    - 删除计划 [ DeleteCampaign(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, campaignIds ...uint64) (*model.ResponseHeader, []campaign.Campaign, error) ]\n    - 查询APP信息 [ GetJsKpAppList(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *campaign.GetJsKpAppListRequest) (*model.ResponseHeader, []campaign.AppInfo, error) ]\n  - 单元\n    - 推广单元 (api/feed/adgroup)\n      - 查询推广单元 [ GetAdgroup(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *adgroup.GetAdgroupFeedRequest) (*model.ResponseHeader, []adgroup.Adgroup, error) ]\n      - 添加单元 [ AddAdgroup(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *adgroup.AddAdgroupRequest) (*model.ResponseHeader, []adgroup.Adgroup, error) ]\n      - 更新单元 [ UpdateAdgroup(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, adgroups []adgroup.Adgroup) (\\*model.ResponseHeader, []adgroup.Adgroup, error) ]\n      - 删除单元 [ DeleteAdgroup(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, adgroupFeedIds ...uint64) (\\*model.ResponseHeader, []adgroup.Adgroup, error) ]\n    - 转化追踪 (api/feed/trands)\n      - 查询转化追踪 [ GetOcpcTransFeed(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *trans.GetOcpcTransFeedRequest) (*model.ResponseHeader, []trans.OcpcTransFeed, error) ]\n      - 添加转化追踪 [ AddOcpcTransFeed(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, list []trans.OcpcTransFeed) (\\*model.ResponseHeader, []trans.OcpcTransFeed, error) ]\n      - 修改转化追踪 [ UpdateOcpcTransFeed(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, list []trans.OcpcTransFeed) (\\*model.ResponseHeader, []trans.OcpcTransFeed, error) ]\n  - 创意 (api/feed/creative)\n    - 查询创意 [ GetCreativeFeed(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *creative.GetCreativeRequest) (*model.ResponseHeader, []creative.Creative, error) ]\n    - 添加创意 [ AddCreative(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *creative.AddCreativeRequest) (*model.ResponseHeader, []creative.Creative, error) ]\n    - 更新创意 [ UpdateCreative(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, creatives []creative.Creative) (\\*model.ResponseHeader, []creative.Creative, error) ]\n    - 删除创意 [ DeleteCreative(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, creativeFeedIds ...uint64) (\\*model.ResponseHeader, []creative.Creative, error) ]\n- 数据报告 (api/report)\n  - 一站式多渠道报告 [ GetReportData(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]\n  - 搜索报告 (api/report/search)\n    - 推广报告\n      - 搜索整体账户报告 [ Overall(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]\n      - 账户报告 [ Account(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]\n      - 计划报告 [ Campaign(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]\n      - 单元报告 [ Adgroup(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]\n    - 定向报告\n      - 关键词报告 [ Keyword(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]\n      - 搜索词报告 [ QueryWord(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]\n      - 搜索商品报告 [ Product(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]\n      - 人群报告 [ Audience(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]\n    - 创意报告\n      - 创意报告 [ Creative(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]\n    - 落地页报告\n      - 落地页报告 [ LandingPage(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]\n      - 搜索访客明细报告 [ Visitor(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]\n  - 信息流报告 (api/report/feed)\n    - 推广报告\n      - 信息流整体账户报告 [ Overall(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]\n      - 账户报告 [ Account(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]\n      - 计划报告 [ Campaign(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]\n      - 单元报告 [ Adgroup(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]\n    - 创意报告\n      - 信息流商品报告 [ Product(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]\n      - 创意报告 [ Creative(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]\n      - 视频报告 [ Video(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]\n      - 图片报告 [ Image(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]\n    - 落地页报告\n      - 落地页报告 [ LandingPage(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]\n      - 信息流访客明细报告 [ Visitor(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]\n  - 异步报告 (api/report)\n    - 创建异步任务 [ CreateReportTask(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, createRequest *report.CreateReportTaskRequest) (*model.ResponseHeader, string, error) ]\n    - 获取任务状态和结果 [ GetTaskStatus(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, taskRequest *report.GetTaskStatusRequest) (*model.ResponseHeader, []report.ReportTaskStatus, error) ]\n- 资产管理 (api/asset)\n  - 图片 (api/asset/image)\n    - 查询图片 [ GetImage(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, reqBody *image.GetImageRequest) ([]image.Image, error) ]\n  - 视频 (api/asset/video)\n    - 查询图片 [ GetVideo(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, reqBody *image.GetVideoRequest) ([]video.Video, error) ]\n- 转化追踪 (api/ocpc)\n  - 广告主回传转化数据接口 [ UploadConvertData(ctx context.Context, clt *core.SDKClient, req *ocpc.UploadConvertDataRequest) error ]\n  - 广告主回传无效转化数据接口 [ UploadInvalidConvertData(ctx context.Context, clt *core.SDKClient, req *ocpc.UploadInvalidConvertDataRequest) error ]\n  - APP 转化数据收集 [ ActionCb(ctx context.Context, clt *core.SDKClient, req model.ActionCbRequest) error ]\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbububa%2Fbaidu-marketing","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbububa%2Fbaidu-marketing","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbububa%2Fbaidu-marketing/lists"}