功能
GET accounts/:account_id/features¶
检索此广告账号可访问的授权功能集合。功能以描述性功能键表示,仅当功能在测试版本或其他限制版本中推出且在广告 API 中可用时,它们才会在此端点上公开。不符合上述条件的功能不会在此端点上公开。
注意:此端点旨在通过提高客户端对测试版本访问权限的可见度,为广告 API 生态系统开发提供帮助。API 开发者不能代表广告商请求访问此类功能。此类请求只能由广告商向其 Twitter 账号管理员提出。
资源 URL¶
https://ads-api.twitter.com/10/accounts/:account_id/features
参数¶
名称 | 说明 |
---|---|
account_id 必需 |
所使用账号的标识符。出现在资源路径中,通常是所有广告商 API 请求的必要参数,不包含 GET accounts。指定账号必须与已验证的用户关联。 类型:string 示例: |
feature_keys 可选 |
可选参数,支持查询特定功能键。请求可以包含多个键,以逗号分隔。 注意:只有此账号可以访问的功能才会纳入响应中。 类型:enum 可能值: |
请求示例¶
GET https://ads-api.twitter.com/10/accounts/18ce54d4x5t/features
响应示例¶
{
"request": {
"params": {
"account_id": "18ce54d4x5t"
}
},
"data": [
"CITY_TARGETING",
"CONVERSATION_CARD",
"PROMOTED_MEDIA_POLLS",
"REACH_AND_FREQUENCY_ANALYTICS",
"REACH_FREQUENCY_CAP",
"UNIVERSAL_LOOKALIKE"
]
}
POST accounts/:account_id/features¶
仅限沙盒
向沙盒账号添加功能。
可通过 GET accounts/:account_id/features 端点来检索最新的账号功能列表。
资源 URL¶
https://ads-api-sandbox.twitter.com/10/accounts/:account_id/features
参数¶
名称 | 说明 |
---|---|
account_id 必需 |
所使用账号的标识符。出现在资源路径中,通常是所有广告商 API 请求的必要参数,不包含 GET accounts。指定账号必须与已验证的用户关联。 类型:string 示例: |
feature_keys 必需 |
要添加至账号的账号功能的列表,以逗号分隔。 类型:enum 可能值: |
请求示例¶
POST https://ads-api-sandbox.twitter.com/10/accounts/gq180y/features?feature_keys=VALIDATED_AGE_TARGETING
响应示例¶
{
"request": {
"params": {
"account_id": "gq180y",
"feature_keys": [
"VALIDATED_AGE_TARGETING"
]
}
},
"data": [
"ALLOW_SKIPPABLE_VIDEOS_FOR_PREROLL_VIEWS_OBJECTIVE",
"AWARENESS_OBJECTIVE",
"CPI_CHARGING",
"EVENT_TARGETING",
"INSTALLED_APP_CATEGORY_TARGETING",
"MOBILE_CONVERSION_TRANSACTION_VALUE",
"OPTIMIZED_ACTION_BIDDING",
"VALIDATED_AGE_TARGETING",
"VIDEO_APP_DOWNLOAD_CARD"
]
}
DELETE accounts/:account_id/features¶
仅限沙盒
将功能从沙盒账号中删除。
可通过 GET accounts/:account_id/features 端点来检索最新的账号功能列表。
资源 URL¶
https://ads-api-sandbox.twitter.com/10/accounts/:account_id/features
参数¶
名称 | 说明 |
---|---|
account_id 必需 |
所使用账号的标识符。出现在资源路径中,通常是所有广告商 API 请求的必要参数,不包含 GET accounts。指定账号必须与已验证的用户关联。 类型:string 示例: |
feature_keys 必需 |
要从账号中删除的账号功能的列表,以逗号分隔。 类型:enum 可能值: |
请求示例¶
DELETE https://ads-api-sandbox.twitter.com/10/accounts/gq180y/features?feature_keys=PREROLL_VIEWS_OBJECTIVE
响应示例¶
{
"request": {
"params": {
"account_id": "gq180y",
"feature_keys": [
"PREROLL_VIEWS_OBJECTIVE"
]
}
},
"data": [
"CPI_CHARGING",
"EVENT_TARGETING",
"INSTALLED_APP_CATEGORY_TARGETING",
"MOBILE_CONVERSION_TRANSACTION_VALUE",
"OPTIMIZED_ACTION_BIDDING",
"VIDEO_APP_DOWNLOAD_CARD"
]
}