腾讯广告 Marketing API(以下简称API) SDK 提供了Token获取、请求封装、响应解释等功能，以本地化方式轻松完成API的调用和结果的获取，旨在帮助开发者快速搭建投放管理系统。 未来还会基于常用的广告投放场景，提供场景化的接口组合及调用封装。
- 使用SDK需要首先注册成为腾讯广告开发者，请参考开发者快速入门文档
- 使用SDK需要先拥有API的访问权限，所有SDK的使用与应用拥有的权限组相关联
- Go SDK 需要依赖 1.11 版本及以上
推荐使用 go mod 的方式获取
其中的 ${VERSION} 需要替换成要使用的版本，如v1.0.0，具体版本号可查看相应的tag
go mod edit -require="github.com/tencentad/marketing-api-go-sdk@${VERSION}"
go mod downloadgo get github.com/tencentad/marketing-api-go-sdkSDK数组参数调用的方法名与API接口一一对应，如campaigns/get接口就对应tads.Campaigns().Get()方法
注意:model中的所有基本数据类型均为指针类型, 例如：*string, *bool, *int64, *float64
注：本示例适用于授权时通过Authorization Code获取Access Token和Refresh Token，如需更新Access Token请参考 ./examples/Authentication/RefreshAccessToken.go 示例
package main
import (
"encoding/json"
"fmt"
"github.com/antihax/optional"
"github.com/tencentad/marketing-api-go-sdk/pkg/ads"
"github.com/tencentad/marketing-api-go-sdk/pkg/api"
"github.com/tencentad/marketing-api-go-sdk/pkg/config"
"github.com/tencentad/marketing-api-go-sdk/pkg/errors"
)
func main() {
tads := ads.Init(&config.SDKConfig{})
// your client id
clientId := int64(0)
clientSecret := "your client secret"
grantType := "authorization_code"
oauthTokenOpts := &api.OauthTokenOpts{
AuthorizationCode: optional.NewString("your authorization code"),
RedirectUri: optional.NewString("your authorization code"),
}
ctx := *tads.Ctx
// oauth/token接口即对应Oauth().Token()方法
response, _, err := tads.Oauth().Token(ctx, clientId, clientSecret, grantType, oauthTokenOpts)
if err != nil {
if resErr, ok := err.(errors.ResponseError); ok {
errStr, _ := json.Marshal(resErr)
// TODO for api error
fmt.Println("Response error:", string(errStr))
} else {
// TODO for other error
fmt.Println("Error:", err)
}
}
tads.SetAccessToken(response.AccessToken)
}package main
import (
"github.com/tencentad/marketing-api-go-sdk/pkg/ads"
"github.com/tencentad/marketing-api-go-sdk/pkg/config"
)
func main() {
accessToken := "YOUR ACCESS TOKEN"
tads := ads.Init(&config.SDKConfig{
AccessToken: accessToken,
})
// 默认访问沙箱环境，如访问正式环境，请调用tads.UseProduction()
tads.UseSandbox()
}package main
import (
"encoding/json"
"fmt"
"github.com/antihax/optional"
"github.com/tencentad/marketing-api-go-sdk/pkg/ads"
"github.com/tencentad/marketing-api-go-sdk/pkg/api"
"github.com/tencentad/marketing-api-go-sdk/pkg/model"
"github.com/tencentad/marketing-api-go-sdk/pkg/config"
"github.com/tencentad/marketing-api-go-sdk/pkg/errors"
)
func main() {
accessToken := "YOUR ACCESS TOKEN"
tads := ads.Init(&config.SDKConfig{
AccessToken: accessToken,
})
// your account id
accountId := int64(0)
field := "promoted_object_type"
operator := "EQUALS"
campaignsGetOpts := &api.CampaignsGetOpts{
Filtering: optional.NewInterface([]model.FilteringStruct{model.FilteringStruct{
Field:&field,
Operator:&operator,
Values:[]string{"PROMOTED_OBJECT_TYPE_APP_IOS"},
}}),
}
ctx := *tads.Ctx
// oauth/token接口即对应Campaigns().Get()方法
response, _, err := tads.Campaigns().Get(ctx, accountId, campaignsGetOpts)
if err != nil {
if resErr, ok := err.(errors.ResponseError); ok {
// When Api returns an error
errStr, _ := json.Marshal(resErr)
// TODO for api error
fmt.Println("Response error:", string(errStr))
} else {
// When validation fails or other local issues
// TODO for other error
fmt.Println("Error:", err)
}
}
fmt.Println(response)
}package main
import (
"github.com/tencentad/marketing-api-go-sdk/pkg/ads"
"github.com/tencentad/marketing-api-go-sdk/pkg/config"
)
func main() {
accessToken := "YOUR ACCESS TOKEN"
ads.Init(&config.SDKConfig{
AccessToken: accessToken,
IsDebug: true,
DebugFile: "YOUR LOG FILE PATH",
})
}package main
import (
"github.com/tencentad/marketing-api-go-sdk/pkg/ads"
"github.com/tencentad/marketing-api-go-sdk/pkg/config"
)
func main() {
accessToken := "YOUR ACCESS TOKEN"
ads.Init(&config.SDKConfig{
AccessToken: accessToken,
IsStrictMode: true
})
}如果返回值中包含不认识的属性，会抛ResponseStrictError
package main
import (
"github.com/tencentad/marketing-api-go-sdk/pkg/ads"
"github.com/tencentad/marketing-api-go-sdk/pkg/config"
)
func main() {
accessToken := "YOUR ACCESS TOKEN"
ads.Init(&config.SDKConfig{
AccessToken: accessToken,
SkipMonitor: true,
})
}如果您在使用SDK过程中有任何问题与建议，请随时登录开发者官网，点击右下角的"咨询"按钮，与我们的客服支持人员联系
- 丰富各类场景示例
- 推出其他语言的SDK
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent