Record immagine - Bulk

Definisce un'immagine che può essere caricata e scaricata in un file bulk.

È possibile scaricare tutti i record image nell'account includendo il valore DownloadEntity di Images nella richiesta del servizio DownloadCampaignsByAccountIds o DownloadCampaignsByCampaignIds . Inoltre, la richiesta di download deve includere l'ambito EntityData . Per altre informazioni sul servizio bulk, incluse le procedure consigliate, vedere Download e caricamento in blocco.

Nell'esempio csv bulk seguente viene aggiunta una nuova immagine.

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 si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkImage , anziché chiamare direttamente le operazioni del servizio e scrivere codice personalizzato per analizzare ogni campo nel file bulk.

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();

Per un record Immagine , i campi dell'attributo seguenti sono disponibili nello schema file bulk.

• Client Id
• Altezza
• Id
• Ora modifica
• Parent Id
• Stato
• Sottotipo
• Testo
• Url
• Larghezza

ID Client

Usato per associare i record nel file di caricamento bulk ai record nel file dei risultati. Il valore di questo campo non viene utilizzato o archiviato dal server; viene semplicemente copiato dal record caricato nel record di risultati corrispondente. Può essere qualsiasi stringa valida fino a 100 di lunghezza.

Aggiungere: Opzionale
Cancellare: Sola lettura

Altezza

Altezza dell'immagine archiviata nella libreria multimediale.

Le dimensioni dell'immagine visualizzate dipendono in parte dalle proporzioni del collegamento di asset, ad esempio, come definito nel campo Immagini di un annuncio reattivo.

Aggiungere: Sola lettura
Cancellare: Sola lettura

Id

Identificatore generato dal sistema dell'immagine.

Aggiungere: Opzionale. È necessario lasciare vuoto questo campo o specificare un identificatore negativo. È quindi possibile fare riferimento a un identificatore negativo impostato per l'immagine nei tipi di record dipendenti, ad esempio il campo Immagini di un annuncio reattivo. Questa operazione è consigliata se si aggiungono nuova immagine e nuovi record dipendenti nello stesso file bulk. Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Cancellare: Sola lettura e Obbligatorio

Ora modifica

Data e ora dell'ultimo aggiornamento dell'entità. Il valore è espresso nell'ora UTC (Coordinated Universal Time).

Nota

Il valore di data e ora riflette la data e l'ora nel server, non nel client. Per informazioni sul formato della data e dell'ora, vedere la voce dateTime in Tipi di dati XML primitivi.

Aggiungere: Sola lettura
Cancellare: Sola lettura

Parent Id

Identificatore generato dal sistema dell'account che contiene l'immagine.

Questo campo bulk esegue il mapping al campo ID del record account .

Aggiungere: Sola lettura
Cancellare: Sola lettura

Stato

Stato dell'immagine.

I valori possibili sono Attivo o Eliminato.

Aggiungere: Opzionale. Il valore predefinito è Attivo.
Cancellare: Obbligatorio. Lo stato deve essere impostato su Eliminato.

Sottotipo

Il sottotipo dell'immagine indica le proporzioni supportate dell'immagine caricata.

È consigliabile usare "GenericImage" con dimensioni di 703 larghezza x 368 altezza o superiore, in pixel.

Il sottotipo deve essere impostato su "Logo" se l'immagine è associata a un annuncio come "LandscapeLogoMedia" o "SquareLogoMedia".

Di seguito sono descritti tutti i valori di sottotipo supportati con le restrizioni relative alle dimensioni e alle proporzioni corrispondenti.

Sottotipo	Proporzioni	Dimensione minima
GenericImage	Variabili	40 larghezza x 40 altezza, in pixel
LandscapeLogoMedia	4:1	512 larghezza x 128 altezza, in pixel
SquareLogoMedia	1:1	128 larghezza x 128 altezza, in pixel
Image16x9	16:9	640 larghezza x 360 altezza, in pixel
Image15x10	1.5:1	300 larghezza x 200 altezza, in pixel
Image4x3	4:3	100 larghezza x 75 altezza, in pixel
Image1x1	1:1	128 larghezza x 128 altezza, in pixel
Image191x100	1.91:1	703 larghezza x 368 altezza, in pixel
Image4x1	4:1	512 larghezza x 128 altezza, in pixel

Nota

La larghezza e l'altezza massime in pixel sono 2592 e 2048 in modo indipendente ed è comunque necessario mantenere una delle proporzioni supportate. Ad esempio, se il sottotipo è Image191x100 e la larghezza è 2592, l'altezza deve essere 1357.

Le immagini con animazione non sono supportate. Sono supportati i tipi MIME seguenti.

• GIF
• JPEG
• PNG

Consiglio

Le immagini PNG vengono convertite in JPEG. Se non si è soddisfatti della qualità dopo la conversione, è consigliabile fornire direttamente JPEG.

Aggiungere: Obbligatorio
Cancellare: Sola lettura

Testo

Testo o etichetta personalizzata dell'immagine archiviata nella libreria multimediale.

Aggiungere: Opzionale
Cancellare: Sola lettura

Url

URL in cui è possibile accedere all'immagine.

Per caricare una nuova immagine, è necessario specificare un URL temporaneo in cui il servizio bulk può accedere e recuperare l'immagine.

Quando si scarica l'immagine, questo campo contiene un URL fornito dal servizio bulk in cui è possibile accedere e recuperare l'immagine archiviata in base alle esigenze.

È possibile caricare un'immagine PNG o JPEG. Le immagini con animazione non sono supportate. Le immagini PNG vengono convertite in JPEG. Se non si è soddisfatti della qualità dopo la conversione, è consigliabile fornire direttamente JPEG.

Aggiungere: Obbligatorio
Cancellare: Sola lettura

Larghezza

Larghezza dell'immagine archiviata nella libreria multimediale.

Le dimensioni dell'immagine visualizzate dipendono in parte dalle proporzioni del collegamento di asset, ad esempio, come definito nel campo Immagini di un annuncio reattivo.

Aggiungere: Sola lettura
Cancellare: Sola lettura