Registro de imagen: masivo
Define una imagen que se puede cargar y descargar en un archivo masivo.
Puede descargar todos los registros de imagen de la cuenta incluyendo el valor DownloadEntity de Images en la solicitud de servicio DownloadCampaignsByAccountIds o DownloadCampaignsByCampaignIds . Además, la solicitud de descarga debe incluir el ámbito EntityData . Para obtener más información sobre el servicio masivo, incluidos los procedimientos recomendados, consulte Descarga y carga masivas.
En el siguiente ejemplo de CSV masivo se agregaría una nueva imagen.
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,
Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkImage , en lugar de llamar directamente a las operaciones del servicio y escribir código personalizado para analizar cada campo en el archivo masivo.
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();
Para un registro Image , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.
Identificador de cliente
Se usa para asociar registros en el archivo de carga masiva con registros en el archivo de resultados. El servidor no usa ni almacena el valor de este campo; simplemente se copia del registro cargado en el registro de resultados correspondiente. Puede ser cualquier cadena válida de hasta 100 en longitud.
Agregar: Opcional
Borrar: Solo lectura
Height
Alto de la imagen almacenada en la biblioteca multimedia.
Las dimensiones de imagen mostradas dependerán en parte de las relaciones de aspecto del vínculo de recursos, por ejemplo, como se define en el campo Imágenes de un anuncio dinámico.
Agregar: Solo lectura
Borrar: Solo lectura
Id
Identificador generado por el sistema de la imagen.
Agregar: Opcional. Debe dejar este campo vacío o especificar un identificador negativo. A continuación, se puede hacer referencia a un identificador negativo establecido para la imagen en tipos de registro dependientes, como el campo Imágenes de un anuncio con capacidad de respuesta. Esto se recomienda si va a agregar nueva imagen y nuevos registros dependientes en el mismo archivo masivo. Para obtener más información, vea Claves de referencia de esquema de archivos masivos.
Borrar: Solo lectura y Obligatorio
Tiempo de modificación
Fecha y hora en que se actualizó por última vez la entidad. El valor se encuentra en la hora UTC (hora universal coordinada).
Nota:
El valor de fecha y hora refleja la fecha y hora en el servidor, no en el cliente. Para obtener información sobre el formato de la fecha y hora, vea la entrada dateTime en Tipos de datos XML primitivos.
Agregar: Solo lectura
Borrar: Solo lectura
Parent Id
Identificador generado por el sistema de la cuenta que contiene la imagen.
Este campo masivo se asigna al campo Id del registro de cuenta .
Agregar: Solo lectura
Borrar: Solo lectura
Estado
Estado de la imagen.
Los valores posibles son Active o Deleted.
Agregar: Opcional. El valor predeterminado es Active.
Borrar: Obligatorio. El estado debe establecerse en Eliminado.
Subtipo
El subtipo de imagen indica la relación de aspecto admitida de la imagen cargada.
Se recomienda "GenericImage" con dimensiones de 703 ancho x 368 de alto o superior, en píxeles.
El subtipo debe establecerse en "Logo" si la imagen está asociada a un anuncio como "LandscapeLogoMedia" o "SquareLogoMedia".
A continuación se describen todos los valores de subtipo admitidos con las restricciones de dimensión y relación de aspecto correspondientes.
| Subtipo | Relación de aspecto | Dimensión mínima |
|---|---|---|
| GenericImage | Varía | 40 ancho x 40 de alto, en píxeles |
| LandscapeLogoMedia | 4:1 | 512 ancho x 128 de alto, en píxeles |
| SquareLogoMedia | 1:1 | 128 ancho x 128 de alto, en píxeles |
| Imagen16x9 | 16:9 | 640 ancho x 360 de alto, en píxeles |
| Imagen15x10 | 1.5:1 | 300 ancho x 200 de alto, en píxeles |
| Image4x3 | 4:3 | 100 ancho x 75 de alto, en píxeles |
| Imagen1x1 | 1:1 | 128 ancho x 128 de alto, en píxeles |
| Imagen191x100 | 1.91:1 | 703 ancho x 368 de alto, en píxeles |
| Image4x1 | 4:1 | 512 ancho x 128 de alto, en píxeles |
Nota:
El ancho y alto máximos en píxeles son 2592 y 2048 de forma independiente, y debe mantener una de las relaciones de aspecto admitidas. Por ejemplo, si el subtipo es Image191x100 y el ancho es 2592, el alto debe ser 1357.
No se admiten imágenes con animación. Se admiten los siguientes tipos MIME.
- GIF
- JPEG
- PNG
Sugerencia
Las imágenes PNG se convierten en JPEG. Si no está satisfecho con la calidad después de la conversión, le recomendamos que proporcione JPEG directamente.
Agregar: Obligatorio
Borrar: Solo lectura
Texto
Texto o etiqueta personalizados de la imagen almacenada en la biblioteca multimedia.
Agregar: Opcional
Borrar: Solo lectura
Url
Dirección URL a la que se puede acceder a la imagen.
Para cargar una nueva imagen, debe proporcionar una dirección URL temporal donde el servicio masivo pueda acceder a la imagen y recuperarla.
Al descargar la imagen, este campo contiene una dirección URL proporcionada por el servicio bulk, donde puede acceder a la imagen almacenada y recuperarla según sea necesario.
Puede cargar una imagen PNG o JPEG. No se admiten imágenes con animación. Las imágenes PNG se convierten en JPEG. Si no está satisfecho con la calidad después de la conversión, le recomendamos que proporcione JPEG directamente.
Agregar: Obligatorio
Borrar: Solo lectura
Width
Ancho de la imagen almacenada en la biblioteca multimedia.
Las dimensiones de imagen mostradas dependerán en parte de las relaciones de aspecto del vínculo de recursos, por ejemplo, como se define en el campo Imágenes de un anuncio dinámico.
Agregar: Solo lectura
Borrar: Solo lectura