Registo de Imagem - Em Massa
Define uma imagem que pode ser carregada e transferida num ficheiro em massa.
Pode transferir todos os Registos de imagens na conta ao incluir o valor DownloadEntity de Imagens no pedido de serviço DownloadCampaignsByAccountIds ou DownloadCampaignsByCampaignIds . Além disso, o pedido de transferência tem de incluir o âmbito EntityData . Para obter mais detalhes sobre o Serviço em massa, incluindo as melhores práticas, veja Transferência e Carregamento em Massa.
O seguinte exemplo de CSV em Massa adicionaria uma nova imagem.
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,
Se estiver a utilizar os SDKs de Anúncios do Bing para .NET, Java ou Python, pode poupar tempo ao utilizar o BulkServiceManager para carregar e transferir o objeto BulkImage , em vez de chamar diretamente as operações do serviço e escrever código personalizado para analisar cada campo no ficheiro em massa.
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 um registo de Imagem , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.
ID de Cliente
Utilizado para associar registos no ficheiro de carregamento em massa a registos no ficheiro de resultados. O valor deste campo não é utilizado ou armazenado pelo servidor; é simplesmente copiado do registo carregado para o registo de resultados correspondente. Pode ser qualquer cadeia válida até 100 de comprimento.
Adicionar: Opcional
Eliminar: Só de leitura
Altura
A altura da imagem armazenada na sua biblioteca de multimédia.
As dimensões de imagem apresentadas irão depender, em parte, das proporções da ligação do elemento, por exemplo, conforme definido no campo Imagens de um Anúncio Reativo.
Adicionar: Só de leitura
Eliminar: Só de leitura
ID
O identificador gerado pelo sistema da imagem.
Adicionar: Opcional. Tem de deixar este campo vazio ou especificar um identificador negativo. Um conjunto de identificador negativo para a imagem pode ser referenciado em tipos de registo dependentes, como o campo Imagens de um Anúncio Reativo. Isto é recomendado se estiver a adicionar uma nova imagem e novos registos dependentes no mesmo ficheiro em massa. Para obter mais informações, veja Chaves de Referência do Esquema de Ficheiro em Massa.
Eliminar: Só de leitura e Obrigatório
Hora da Modificação
A data e hora em que a entidade foi atualizada pela última vez. O valor está em Hora Universal Coordenada (UTC).
Nota
O valor de data e hora reflete a data e hora no servidor, não o cliente. Para obter informações sobre o formato da data e hora, veja a entrada dateTime em Tipos de Dados XML Primitivos.
Adicionar: Só de leitura
Eliminar: Só de leitura
ID principal
O identificador gerado pelo sistema da conta que contém a imagem.
Este campo em massa mapeia para o campo ID do registo conta .
Adicionar: Só de leitura
Eliminar: Só de leitura
Estado
O estado da imagem.
Os valores possíveis são Ativos ou Eliminados.
Adicionar: Opcional. O valor predefinido é Ativo.
Eliminar: Necessário. O Estado tem de ser definido como Eliminado.
Subtipo
O subtipo de imagem indica a proporção suportada da imagem carregada.
Recomendamos o "GenericImage" com dimensões de 703 largura x 368 de altura ou superior, em píxeis.
O subtipo tem de ser definido como "Logótipo" se a imagem estiver associada a um anúncio como "LandscapeLogoMedia" ou "SquareLogoMedia".
Todos os valores de subtipo suportados com restrições de dimensão e proporção correspondentes são descritos abaixo.
| Subtipo | Proporção | Dimensão Mínima |
|---|---|---|
| GenericImage | Varia | 40 largura x 40 altura, em píxeis |
| LandscapeLogoMedia | 4:1 | 512 largura x 128 alturas, em píxeis |
| SquareLogoMedia | 1:1 | 128 largura x 128 alturas, em píxeis |
| Imagem16x9 | 16:9 | 640 largura x 360 altura, em píxeis |
| Imagem15x10 | 1.5:1 | 300 largura x 200 alturas, em píxeis |
| Imagem4x3 | 4:3 | 100 largura x 75 alturas, em píxeis |
| Imagem1x1 | 1:1 | 128 largura x 128 alturas, em píxeis |
| Imagem191x100 | 1.91:1 | 703 largura x 368 altura, em píxeis |
| Imagem4x1 | 4:1 | 512 largura x 128 alturas, em píxeis |
Nota
A largura e altura máximas em píxeis são 2592 e 2048 de forma independente e tem de manter uma das proporções suportadas. Por exemplo, se o subtipo for Image191x100 e a largura for 2592, a altura tem de ser 1357.
As imagens com animação não são suportadas. São suportados os seguintes tipos de MIME.
- GIF
- JPEG
- PNG
Sugestão
As imagens PNG são convertidas em JPEG. Se não estiver satisfeito com a qualidade após a conversão, recomendamos que forneça o JPEG diretamente.
Adicionar: Necessário
Eliminar: Só de leitura
Text
O texto personalizado ou a etiqueta da imagem armazenada na sua biblioteca de multimédia.
Adicionar: Opcional
Eliminar: Só de leitura
URL
O URL onde a imagem pode ser acedida.
Para carregar uma nova imagem, tem de fornecer um URL temporário no qual o Serviço em massa pode aceder e obter a sua imagem.
Quando transfere a imagem, este campo contém um URL fornecido pelo Serviço em massa, ao qual pode aceder e obter a imagem armazenada conforme necessário.
Pode carregar uma imagem PNG ou JPEG. As imagens com animação não são suportadas. As imagens PNG são convertidas em JPEG. Se não estiver satisfeito com a qualidade após a conversão, recomendamos que forneça o JPEG diretamente.
Adicionar: Necessário
Eliminar: Só de leitura
Largura
A largura da imagem armazenada na sua biblioteca de multimédia.
As dimensões de imagem apresentadas irão depender, em parte, das proporções da ligação do elemento, por exemplo, conforme definido no campo Imagens de um Anúncio Reativo.
Adicionar: Só de leitura
Eliminar: Só de leitura