Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/bububa/baidu-marketing

baidu marketing-api golang sdk
https://github.com/bububa/baidu-marketing
advertising-api baidu marketing-api
Last synced: about 5 hours ago
JSON representation
baidu marketing-api golang sdk
Host: GitHub
URL: https://github.com/bububa/baidu-marketing
Owner: bububa
License: apache-2.0
Created: 2021-06-04T11:02:36.000Z (over 3 years ago)
Default Branch: main
Last Pushed: 2023-04-19T06:30:18.000Z (over 1 year ago)
Last Synced: 2023-07-11T19:37:31.226Z (over 1 year ago)
Topics: advertising-api, baidu, marketing-api
Language: Go
Homepage: https://dev2.baidu.com/home
Size: 142 KB
Stars: 6
Watchers: 1
Forks: 6
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project

README

        # 百度营销 MarketingAPI Golang SDK

[![Go Reference](https://pkg.go.dev/badge/github.com/bububa/baidu-marketing.svg)](https://pkg.go.dev/github.com/bububa/baidu-marketing)

[![Go](https://github.com/bububa/baidu-marketing/actions/workflows/go.yml/badge.svg)](https://github.com/bububa/baidu-marketing/actions/workflows/go.yml)

[![goreleaser](https://github.com/bububa/baidu-marketing/actions/workflows/goreleaser.yml/badge.svg)](https://github.com/bububa/baidu-marketing/actions/workflows/goreleaser.yml)

[![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)

[![GoReportCard](https://goreportcard.com/badge/github.com/bububa/baidu-marketing)](https://goreportcard.com/report/github.com/bububa/baidu-marketing)

[![GitHub license](https://img.shields.io/github/license/bububa/baidu-marketing.svg)](https://github.com/bububa/baidu-marketing/blob/master/LICENSE)

[![GitHub release](https://img.shields.io/github/release/bububa/baidu-marketing.svg)](https://GitHub.com/bububa/baidu-marketing/releases/)

- OAuth授权 (api/oauth)

  - 换取授权令牌接口 [ AccessToken(ctx context.Context, clt *core.SDKClient, req *oauth.AccessTokenRequest) (*oauth.AccessToken, error) ]

  - 更新授权令牌接口 [ RefreshToken(ctx context.Context, clt *core.SDKClient, req *oauth.RefreshTokenRequest) (*oauth.AccessToken, error) ]

  - 查询授权用户信息 [ GetUserInfo(ctx context.Context, clt *core.SDKClient, req *oauth.GetUserInfoRequest) (*oauth.UserInfo, error) ]

- 账户管理

  - 财务管理 (api/account/balance)

    - 查询账户余额成分 [ GetBalanceInfo(ctx context.Context, clt \*core.SDKClient, auth model.RequestHeader, productIds[]uint64) ([]balance.BalanceInfo, error) ]

    - 查询转账记录 [ GetAccountTransferHistory(ctx context.Context, clt \*core.SDKClient, auth model.RequestHeader, startTime time.Time, endTime time.Time) ([]balance.AccountTransferHistory, error) ]

    - 查询待加款信息 [ GetPaymentHistory(ctx context.Context, clt \*core.SDK, auth model.RequestHeader, reqBody balance.GetPaymentHistoryRequest) ([]balance.PaymentHistory, error) ]

    - 查询付款信息与待加款信息 [ GetPaymentRecord(ctx context.Context, clt *core.SDK, auth model.RequestHeader, reqBody balance.GetPaymentRecordRequest) (*balance.GetPaymentRecordResponse, error) ]

  - 账户管家管理 [ GetUserListByMccid(ctx context.Context, clt \*core.SDK, auth model.RequestHeader) ([]account.MccUser, error) ]

- 搜索广告投放 (api/search)

  - 账户 (api/search/account)

    - 查询账户 [ GetAccountInfo(ctx context.Context, clt \*core.SDKClient, auth model.RequestHeader, accountFields []string) ([]account.Account, error) ]

    - 更新账户 [ UpdateAccountInfo(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, account *account.Account) ([]account.Account, error) ]

  - 计划 (api/search/campaign)

    - 查询计划 [ GetCampaign(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, reqBody *campaign.GetCampaignRequest) (\*model.ResponseHeader, []campaign.Campaign, error) ]

    - 添加计划 [ AddCampaign(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, reqBody *campaign.AddCampaignRequest) (\*model.ResponseHeader, []campaign.Campaign, error) ]

    - 更新计划 [ UpdateCampaign(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, campaigns []campaign.Campaign) (*model.ResponseHeader, []campaign.Campaign, error) ]

    - 删除计划 [ DeleteCampaign(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, campaignIds ...uint64) (*model.ResponseHeader, error) ]

    - 查询计划已使用的推广业务 [ GetBindBusinessPointList(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, reqBody *campaign.GetBindBusinessPointListRequest) (\*model.ResponseHeader, []campaign.BusinessPoint, error) ]

  - 单元 (api/search/adgroup)

    - 查询单元 [ GetAdgroup(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, reqBody *adgroup.GetAdgroupRequest) (\*model.ResponseHeader, []adgroup.Adgroup, error) ]

    - 添加单元 [ AddAdgroup(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, reqBody *adgroup.AddAdgroupRequest) (\*model.ResponseHeader, []adgroup.Adgroup, error) ]

    - 更新单元 [ UpdateAdgroup(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, adgroups []adgroup.Adgroup) (*model.ResponseHeader, []adgroup.Adgroup, error) ]

    - 删除单元 [ DeleteAdgroup(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, adgroupIds ...uint64) (*model.ResponseHeader, error) ]

  - 关键词 (api/search/keyword)

    - 查询关键词 [ GetKeyword(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, reqBody *keyword.GetKeywordRequest) (\*model.ResponseHeader, []keyword.Keyword, error) ]

    - 添加关键词 [ AddWord(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *keyword.AddWordRequest) (*model.ResponseHeader, []keyword.Keyword, error) ]

    - 更新关键词 [ UpdateWord(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *keyword.Keyword) (*model.ResponseHeader, []keyword.Keyword, error) ]

    - 删除关键词 [ DeleteWord(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, keywordIds ...uint64) (\*model.ResponseHeader, []keyword.Keyword, error)]

  - 创意 (api/search/creative)

    - 基础创基

      - 查询基础创意 [ GetCreative(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *creative.GetCreativeRequest) (*model.ResponseHeader, []creative.Creative, error) ]

      - 添加基础创意 [ AddCreative(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *creative.AddCreativeRequest) (*model.ResponseHeader, []creative.Creative, error) ]

      - 更新基础创意 [ UpdateCreative(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, creatives []creative.Creative) (\*model.ResponseHeader, []creative.Creative, error) ]

      - 删除基础创意 [ DeleteCreative(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, creativeIds ...uint64) (*model.ResponseHeader, error) ]

  - 创意组件

    - APP 服务 (api/search/app)

      - 获取APP素材 [ GetAppList(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *app.GetAppListRequest) (*model.ResponseHeader, []app.AppInfoItemList, error) ]

    - APP绑定服务 (api/search/app)

      - 查询APP绑定 [ GetAdgroupAppBind(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *app.GetAdgroupAppBindRequest) (*model.ResponseHeader, []app.AppBindItem, error) ]

      - 添加APP绑定 [ AddAdgroupAppBind(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *app.AddAdgroupAppBindRequest) (*model.ResponseHeader, []app.AppBindItem, error) ]

      - 删除APP绑定 [ DeleteAdgroupAppBind(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *app.DeleteAdgroupAppBindRequest) (*model.ResponseHeader,[]app.AppBindItem, error) ]

- 信息流广告投放 (api/feed)

  - 账户 (api/feed/account)

    - 查询账户 [ GetAccountFeed(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, accountFields []string) (*model.ResponseHeader, []account.Account, error) ]

    - 更新账户 [ UpdateAccountFeed(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, budget float64) (*model.ResponseHeader, []account.Account, error) ]

  - 计划 (api/feed/campaign)

    - 查询计划 [ GetCampaign(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, reqBody *campaign.GetCampaignFeedRequest) (\*model.ResponseHeader, []campaign.Campaign, error) ]

    - 添加计划 [ AddCampaign(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, reqBody *campaign.AddCampaignRequest) (\*model.ResponseHeader, []campaign.Campaign, error) ]

    - 更新计划 [ UpdateCampaign(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, campaigns []campaign.Campaign) (*model.ResponseHeader, []campaign.Campaign, error) ]

    - 删除计划 [ DeleteCampaign(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, campaignIds ...uint64) (*model.ResponseHeader, []campaign.Campaign, error) ]

    - 查询APP信息 [ GetJsKpAppList(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *campaign.GetJsKpAppListRequest) (*model.ResponseHeader, []campaign.AppInfo, error) ]

  - 单元

    - 推广单元 (api/feed/adgroup)

      - 查询推广单元 [ GetAdgroup(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *adgroup.GetAdgroupFeedRequest) (*model.ResponseHeader, []adgroup.Adgroup, error) ]

      - 添加单元 [ AddAdgroup(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *adgroup.AddAdgroupRequest) (*model.ResponseHeader, []adgroup.Adgroup, error) ]

      - 更新单元 [ UpdateAdgroup(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, adgroups []adgroup.Adgroup) (\*model.ResponseHeader, []adgroup.Adgroup, error) ]

      - 删除单元 [ DeleteAdgroup(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, adgroupFeedIds ...uint64) (\*model.ResponseHeader, []adgroup.Adgroup, error) ]

    - 转化追踪 (api/feed/trands)

      - 查询转化追踪 [ GetOcpcTransFeed(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *trans.GetOcpcTransFeedRequest) (*model.ResponseHeader, []trans.OcpcTransFeed, error) ]

      - 添加转化追踪 [ AddOcpcTransFeed(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, list []trans.OcpcTransFeed) (\*model.ResponseHeader, []trans.OcpcTransFeed, error) ]

      - 修改转化追踪 [ UpdateOcpcTransFeed(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, list []trans.OcpcTransFeed) (\*model.ResponseHeader, []trans.OcpcTransFeed, error) ]

  - 创意 (api/feed/creative)

    - 查询创意 [ GetCreativeFeed(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *creative.GetCreativeRequest) (*model.ResponseHeader, []creative.Creative, error) ]

    - 添加创意 [ AddCreative(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reqBody *creative.AddCreativeRequest) (*model.ResponseHeader, []creative.Creative, error) ]

    - 更新创意 [ UpdateCreative(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, creatives []creative.Creative) (\*model.ResponseHeader, []creative.Creative, error) ]

    - 删除创意 [ DeleteCreative(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, creativeFeedIds ...uint64) (\*model.ResponseHeader, []creative.Creative, error) ]

- 数据报告 (api/report)

  - 一站式多渠道报告 [ GetReportData(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]

  - 搜索报告 (api/report/search)

    - 推广报告

      - 搜索整体账户报告 [ Overall(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]

      - 账户报告 [ Account(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]

      - 计划报告 [ Campaign(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]

      - 单元报告 [ Adgroup(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]

    - 定向报告

      - 关键词报告 [ Keyword(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]

      - 搜索词报告 [ QueryWord(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]

      - 搜索商品报告 [ Product(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]

      - 人群报告 [ Audience(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]

    - 创意报告

      - 创意报告 [ Creative(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]

    - 落地页报告

      - 落地页报告 [ LandingPage(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]

      - 搜索访客明细报告 [ Visitor(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]

  - 信息流报告 (api/report/feed)

    - 推广报告

      - 信息流整体账户报告 [ Overall(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]

      - 账户报告 [ Account(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]

      - 计划报告 [ Campaign(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]

      - 单元报告 [ Adgroup(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]

    - 创意报告

      - 信息流商品报告 [ Product(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]

      - 创意报告 [ Creative(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]

      - 视频报告 [ Video(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]

      - 图片报告 [ Image(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]

    - 落地页报告

      - 落地页报告 [ LandingPage(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]

      - 信息流访客明细报告 [ Visitor(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, reportRequest *report.GetReportDataRequest) (*model.ResponseHeader, *report.ReportData, error) ]

  - 异步报告 (api/report)

    - 创建异步任务 [ CreateReportTask(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, createRequest *report.CreateReportTaskRequest) (*model.ResponseHeader, string, error) ]

    - 获取任务状态和结果 [ GetTaskStatus(ctx context.Context, clt *core.SDKClient, auth *model.RequestHeader, taskRequest *report.GetTaskStatusRequest) (*model.ResponseHeader, []report.ReportTaskStatus, error) ]

- 资产管理 (api/asset)

  - 图片 (api/asset/image)

    - 查询图片 [ GetImage(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, reqBody *image.GetImageRequest) ([]image.Image, error) ]

  - 视频 (api/asset/video)

    - 查询图片 [ GetVideo(ctx context.Context, clt *core.SDKClient, auth model.RequestHeader, reqBody *image.GetVideoRequest) ([]video.Video, error) ]

- 转化追踪 (api/ocpc)

  - 广告主回传转化数据接口 [ UploadConvertData(ctx context.Context, clt *core.SDKClient, req *ocpc.UploadConvertDataRequest) error ]

  - 广告主回传无效转化数据接口 [ UploadInvalidConvertData(ctx context.Context, clt *core.SDKClient, req *ocpc.UploadInvalidConvertDataRequest) error ]

  - APP 转化数据收集 [ ActionCb(ctx context.Context, clt *core.SDKClient, req model.ActionCbRequest) error ]