授予广告账号 TikTok Shop 的专属授权
您可以使用本接口授予某个广告账号使用某个 TikTok Shop 创建 GMV Max 推广系列的专属授权。
对于每个 TikTok Shop,只能授权一个广告账户使用该 TikTok Shop 创建 GMV Max 推广系列,以优化收入和销售活动。
重要提示
使用此接口,即代表您同意并认可 GMV Max 指南中列出的潜在影响。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/gmv_max/exclusive_authorization/create/
方法 POST
Header
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。<br>可以通过[获取访问令牌](1738373164380162.html)接口获取。|
|Content-Type {必填}|string|请求信息类型。<br>允许格式:`application/json`。|
参数
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
| store_id {必填} | string | TikTok Shop ID。<br><br> 若想获取可用于 GMV Max 推广系列的 TikTok Shop,可使用 [/gmv_max/store/list/](1822001044479041.html) 并确认返回的 `is_gmv_max_available` 为 `true`。 |
| store_authorized_bc_id {必填} | string | 拥有该 TikTok Shop(`store_id`)的商务中心的 ID。<br><br>若想确认某个商务中心拥有某个 TikTok Shop,可使用[/gmv_max/store/list/](1822001044479041.html)并检查返回的`store_authorized_bc_id` ID 值对应的 `is_owner_bc` 是否为 `true`。 |
| advertiser_id {必填}| string | 广告账号 ID,用于授予其使用某个 TikTok Shop 创建 GMV Max 推广 系列的专属授权。<br><br>若想获取某个商务中心中的广告账户列表,使用[/bc/asset/get/](1739432717798401.html)并将 `asset_type` 设置为 `ADVERTISER`。 |
示例
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/gmv_max/exclusive_authorization/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"store_id": "{{store_id}}",
"store_authorized_bc_id":"{{store_authorized_bc_id}}",
"advertiser_id": "{{advertiser_id}}"
}'
(/code)
返回
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number| 返回码。完整返回码列表及描述,参见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string| 返回信息。更多信息参见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 |
|request_id |string| 请求的日志 ID,唯一标识一个请求。 |
|data |object| 返回数据。 |
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {}
}
(/code)