图像记录 - 批量
定义可以在批量文件中上传和下载的图像。
通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 Images 的 DownloadEntity 值，可以下载帐户中的所有图像记录。 此外，下载请求必须包括 EntityData 范围。 有关批量服务的更多详细信息（包括最佳做法），请参阅 批量下载和上传。
以下批量 CSV 示例将添加新映像。
Type,Status,Id,Parent Id,Client Id,Modified Time,Text,Url,Name
Format Version,,,,,,,,,,6.0
Image,Active,-20,0,ClientIdGoesHere,,My Image,https://contoso.com/PhotoStock_123.jpg,
如果使用用于 .NET、Java 或 Python 的必应广告 SDK ，则可以使用 BulkServiceManager 来节省时间来上传和下载 BulkImage 对象，而无需直接调用服务操作和编写自定义代码来分析批量文件中的每个字段。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkImage
var bulkImage = new BulkImage
{
// 'Id' column header in the Bulk file
Id = imageIdKey,
// 'Parent Id' column header in the Bulk file
AccountId = 0,
// 'Height' column header in the Bulk file
Height = null,
// 'Width' column header in the Bulk file
Width = null,
// 'Url' column header in the Bulk file
Url = "https://contoso.com/PhotoStock_123.jpg",
// 'Sub Type' column header in the Bulk file
SubType = "GenericImage",
// 'Text' column header in the Bulk file
Text = "My Image",
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// 'Status' column header in the Bulk file
Status = Status.Active
};
uploadEntities.Add(bulkImage);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
对于 映像 记录， 批量文件架构中提供了以下属性字段。
客户端 ID
用于将批量上传文件中的记录与结果文件中的记录相关联。 服务器不使用或存储此字段的值;它只是从上传的记录复制到相应的结果记录。 它可以是长度最大为 100 的任何有效字符串。
加： 自选
删除： 只读
Height
存储在媒体库中的图像的高度。
显示的图像尺寸将部分取决于资产链接纵横比，例如，响应式广告的“图像”字段中定义。
加： 只读
删除： 只读
Id
映像的系统生成的标识符。
加： 自选。 必须将此字段留空，或指定负标识符。 然后，可以在相关记录类型中引用为图像设置的负标识符，例如响应式广告的“图像”字段。 如果要在同一批量文件中添加新映像和新的依赖记录，则建议这样做。 有关详细信息，请参阅 批量文件架构引用密钥。
删除： 只读和必需
修改时间
上次更新实体的日期和时间。 该值以协调世界时 (UTC) 表示。
注意
日期和时间值反映服务器的日期和时间，而不是客户端。 有关日期和时间格式的信息，请参阅 基元 XML 数据类型中的 dateTime 条目。
加： 只读
删除： 只读
父 ID
包含映像的帐户的系统生成的标识符。
此批量字段映射到帐户记录的 ID 字段。
加： 只读
删除： 只读
状态
映像的状态。
可能的值为 Active 或 Deleted。
加： 自选。 默认值为 Active。
删除： 必填。 “状态”必须设置为 “已删除”。
子类型
图像子类型指示上传的图像支持的纵横比。
建议使用尺寸为 703 宽度 x 368 或更高（以像素为单位）的“GenericImage”。
如果图像与广告关联为“LandscapeLogoMedia”或“SquareLogoMedia”，则必须将子类型设置为“徽标”。
下面介绍了具有相应维度和纵横比限制的所有受支持的子类型值。
| 子类型 | 纵横比 | 最小维度 |
|---|---|---|
| GenericImage | 各不相同 | 40 宽度 x 40 高度（以像素为单位） |
| LandscapeLogoMedia | 4:1 | 512 宽 x 128 高，以像素为单位 |
| SquareLogoMedia | 1:1 | 128 宽度 x 128 高度，以像素为单位 |
| 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。
加： 必填
删除： 只读
Text
存储在媒体库中的图像的自定义文本或标签。
加： 自选
删除： 只读
URL
可以访问图像的 URL。
若要上传新映像，必须提供一个临时 URL，供批量服务访问和检索映像。
下载映像时，此字段包含批量服务提供的 URL，你可以在其中根据需要访问和检索存储的图像。
可以上传 PNG 或 JPEG 图像。 不支持具有动画的图像。 PNG 图像将转换为 JPEG。 如果对转换后的质量不满意，建议直接提供 JPEG。
加： 必填
删除： 只读
Width
存储在媒体库中的图像的宽度。
显示的图像尺寸将部分取决于资产链接纵横比，例如，响应式广告的“图像”字段中定义。
加： 只读
删除： 只读