影像記錄 - 大量
定義可在大量檔案中上傳和下載的映像。
您可以在 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 的 Bing Ads 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();
針對 影像 記錄， 大量檔案架構中提供下列屬性欄位。
用戶端識別碼
用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。 伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。 它可以是長度上限為100的任何有效字串。
加： 自選
刪除： 唯讀
高度
儲存在媒體櫃中的影像高度。
顯示的影像維度會部分取決於您的資產鏈接外觀比例，例如，如響應式廣告的 [影像] 欄位中所定義。
加： 唯讀
刪除： 唯讀
識別碼
系統產生的映像標識碼。
加： 自選。 您必須將此欄位保留空白，或指定負識別碼。 接著，影像的負標識符集就可以在相依的記錄類型中參考，例如響應式廣告的 [影像] 字段。 如果您要在相同的大量檔案中新增新的影像和新的相依記錄，建議您這麼做。 如需詳細資訊，請 參閱大量檔案架構參考密鑰。
刪除： 唯讀和必要
修改時間
上次更新實體的日期和時間。 值為國際標準時間 (UTC)。
注意事項
日期和時間值會反映伺服器上的日期和時間，而不是用戶端。 如需日期和時間格式的相關信息，請參閱 基本 XML 數據類型中的 dateTime 專案。
加： 唯讀
刪除： 唯讀
父項識別碼
系統產生的包含映像之帳戶的標識碼。
此大量欄位會對應至帳戶記錄的 [ 標識 符 ] 欄位 。
加： 唯讀
刪除： 唯讀
狀態
影像的狀態。
可能的值為 [作用中 ] 或 [已刪除]。
加： 自選。 預設值為 Active。
刪除： 必填。 [狀態] 必須設定為 [ 已刪除]。
子類型
影像子類型表示已上傳影像的支持外觀比例。
我們建議使用維度為 703 寬度 x 368 高或以上的 “GenericImage”，以像素為單位。
如果影像與廣告關聯為 「LandscapeLogoMedia」 或 「SquareLogoMedia」，則子類型必須設定為 「Logo」。
以下是所有支援且具有對應維度和外觀比例限制的子類型值。
| 子類型 | 縱橫比 | 最小維度 |
|---|---|---|
| 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。
加： 必填
刪除： 唯讀
寬度
儲存在媒體櫃中的影像寬度。
顯示的影像維度會部分取決於您的資產鏈接外觀比例，例如，如響應式廣告的 [影像] 欄位中所定義。
加： 唯讀
刪除： 唯讀