图像数据对象 - 市场活动管理
定义可添加到帐户媒体库的图像。
语法
<xs:complexType name="Image" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:complexContent mixed="false">
<xs:extension base="tns:Media">
<xs:sequence>
<xs:element minOccurs="0" name="Data" nillable="true" type="xs:string" />
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
元素
元素 | 说明 | 数据类型 |
---|---|---|
数据 | 一个 base64 字符串,表示要添加到库的图像或图标。 base64 字符串最多可以包含 102,400 个字符。 有关限制和支持的数据类型的信息,请参阅下面的 “备注 ”。 |
string |
Image 对象具有 Inherited Elements。
继承的元素
从媒体继承的元素
Image 对象派生自 Media 对象,并继承以下元素:Id、MediaType、Text、Type。 以下说明特定于 Image,可能不适用于从 Media 对象继承相同元素的其他对象。
元素 | 说明 | 数据类型 |
---|---|---|
ID | 媒体的唯一Microsoft广告标识符。 加: 只读 |
long |
MediaType | 要添加到库的媒体类型。 建议的媒体类型为“GenericImage”。 对于将与 ImageAdExtension 一起使用的媒体,支持的值为 GenericImage、 Image16x9、 Image15x10、 Image4x3 和 Image12x10。 对于将与 ResponsiveAd 一起使用的媒体,支持的值为 GenericImage、 Image1x1、 Image191x100 和 Image4x1。 有关支持的纵横比的详细信息,请参阅下面的 “备注 ”部分。 加: 必填 |
string |
发短信 | 图像替换文字。 | string |
类型 | 媒体类型。 有关媒体类型的详细信息,请参阅 媒体数据对象备注。 加: 只读 |
string |
备注
图像媒体类型指示上传的图像支持的纵横比。
建议使用尺寸为 703 宽度 x 368 或更高(以像素为单位)的“GenericImage”。
下面介绍了具有相应维度和纵横比限制的所有受支持的子类型值。
子类型 | 纵横比 | 最小维度 |
---|---|---|
GenericImage | 各不相同 | 40 宽度 x 20 高度(以像素为单位) |
Image16x9 | 16:9 | 640 宽 x 360 高,以像素为单位 |
Image15x10 | 1.5:1 | 300 宽度 x 200 高(以像素为单位) |
Image4x3 | 4:3 | 100 宽 x 75 高,以像素为单位 |
Image1x1 | 1:1 | 128 宽度 x 128 高度,以像素为单位 |
Image191x100 | 1.91:1 | 703 宽 x 368 高,以像素为单位 |
Image4x1 | 4:1 | 512 宽 x 128 高,以像素为单位 |
注意
最大宽度和高度(以像素为单位)分别为 2592 和 2048,并且仍必须保持受支持的纵横比之一。 例如,如果子类型为 Image191x100,宽度为 2592,则高度必须为 1357。
不支持具有动画的图像。 支持以下 MIME 类型。
- GIF
- JPEG
- PNG
提示
PNG 图像将转换为 JPEG。 如果对转换后的质量不满意,建议直接提供 JPEG。
要求
服务: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13