卡片提取
GET accounts/:account_id/cards/all¶
通过 card_uri
检索与当前账号关联的多张卡片。
资源 URL¶
https://ads-api.twitter.com/10/accounts/:account_id/cards/all
参数¶
名称 | 说明 |
---|---|
account_id 必需 |
所使用账号的标识符。出现在资源路径中,通常是所有广告商 API 请求的必要参数,不包含 GET accounts。指定账号必须与已验证的用户关联。 类型:string 示例: |
card_uris 必需 |
通过指定以逗号分隔的标识符列表,将响应范围限定至所需的卡片。可最多提供 200 个卡片 URI 值。 类型:string 示例: |
with_deleted 可选 |
在请求中包含已删除的结果。 类型:boolean 默认值: false 可能值: true 、false |
请求示例¶
GET https://ads-api.twitter.com/10/accounts/18ce54d4x5t/cards/all?card_uris=card://1044294149527166979,card://1044301099031658496
响应示例¶
{
"request": {
"params": {
"card_uris": [
"card://1044294149527166979",
"card://1044301099031658496"
],
"account_id": "18ce54d4x5t"
}
},
"data": [
{
"name": "Twitter App",
"googleplay_app_id": "com.twitter.android",
"image_display_height": "836",
"country_code": "US",
"id": "692xn",
"wide_app_image": "https://pbs.twimg.com/media/Dc263l9VwAAAeEH.jpg",
"created_at": "2018-09-24T18:35:01Z",
"image_display_width": "1600",
"card_uri": "card://1044294149527166979",
"updated_at": "2018-09-24T18:35:01Z",
"app_cta": "INSTALL",
"deleted": false,
"card_type": "IMAGE_APP_DOWNLOAD"
},
{
"video_poster_height": "9",
"name": "Developer Platform",
"website_shortened_url": "https://t.co/zadeUSVD18",
"video_height": "9",
"video_url": "https://video.twimg.com/amplify_video/vmap/991374284135137280.vmap",
"content_duration_seconds": "24",
"video_owner_id": "756201191646691328",
"video_content_id": "13_991374284135137280",
"website_display_url": "developer.twitter.com",
"id": "6933h",
"video_width": "16",
"video_hls_url": "https://video.twimg.com/amplify_video/991374284135137280/pl/sQrBsE9mFvNep9Cx.m3u8?tag=2",
"website_dest_url": "https://developer.twitter.com",
"created_at": "2018-09-24T19:02:38Z",
"card_uri": "card://1044301099031658496",
"title": "Developer Platform",
"website_url": "https://developer.twitter.com",
"updated_at": "2018-09-24T19:02:38Z",
"video_poster_url": "https://pbs.twimg.com/amplify_video_thumb/991374284135137280/img/YbbGQHvWRjoFgrLz.jpg",
"video_poster_width": "16",
"deleted": false,
"card_type": "VIDEO_WEBSITE"
}
]
}
GET accounts/:account_id/cards/all/:card_id¶
通过 card_id
检索与当前账号关联的指定卡片。
资源 URL¶
https://ads-api.twitter.com/10/accounts/:account_id/cards/all/:card_id
参数¶
名称 | 说明 |
---|---|
account_id 必需 |
所使用账号的标识符。出现在资源路径中,通常是所有广告商 API 请求的必要参数,不包含 GET accounts。指定账号必须与已验证的用户关联。 类型:string 示例: |
card_id 必需 |
请求中对正在操作的卡片的引用。 类型:string 示例: |
with_deleted 可选 |
在请求中包含已删除的结果。 类型:boolean 默认值: false 可能值: true 、false |
请求示例¶
GET https://ads-api.twitter.com/10/accounts/18ce54d4x5t/cards/all/508pf
响应示例¶
{
"request": {
"params": {
"card_id": "508pf",
"account_id": "18ce54d4x5t"
}
},
"data": {
"video_poster_height": "9",
"name": "video website card",
"video_height": "9",
"video_url": "https://video.twimg.com/amplify_video/vmap/867520357225418752.vmap",
"content_duration_seconds": "21",
"video_owner_id": "756201191646691328",
"video_content_id": "13_867520357225418752",
"website_display_url": "developer.twitter.com",
"id": "508pf",
"video_width": "16",
"video_hls_url": "https://video.twimg.com/amplify_video/867520357225418752/pl/TPHeH5ZlHFCa2TeJ.m3u8",
"website_dest_url": "https://developer.twitter.com/en/docs/ads/creatives/api-reference/video-website#post-accounts-account-id-cards-video-website",
"created_at": "2017-11-10T09:00:35Z",
"card_uri": "card://928910245920829440",
"title": "VWC",
"website_url": "https://t.co/F81hp59pUF",
"updated_at": "2018-01-05T05:43:31Z",
"video_poster_url": "https://pbs.twimg.com/amplify_video_thumb/867520357225418752/img/E3pnXM0sCKnRsFih.jpg",
"video_poster_width": "16",
"deleted": false,
"card_type": "VIDEO_WEBSITE"
}
}