Enregistrement d’image - En bloc

Définit une image qui peut être chargée et téléchargée dans un fichier en bloc.

Vous pouvez télécharger tous les enregistrements Image dans le compte en incluant la valeur DownloadEntityd’Images dans la demande de service DownloadCampaignsByAccountIds ou DownloadCampaignsByCampaignIds . En outre, la demande de téléchargement doit inclure l’étendue EntityData . Pour plus d’informations sur le service en bloc, y compris les meilleures pratiques, consultez Téléchargement et chargement en bloc.

L’exemple CSV en bloc suivant ajoute une nouvelle image.

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 vous utilisez les Kits de développement logiciel (SDK) Bing Ads pour .NET, Java ou Python, vous pouvez gagner du temps à l’aide de BulkServiceManager pour charger et télécharger l’objet BulkImage , au lieu d’appeler directement les opérations de service et d’écrire du code personnalisé pour analyser chaque champ dans le fichier en bloc.

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

Pour un enregistrement Image , les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc.

• Client Id
• Height
• Id
• Heure de modification
• Parent Id
• État
• Sous-type
• Texte
• Url
• Width

ID client

Permet d’associer des enregistrements du fichier de chargement en bloc aux enregistrements du fichier de résultats. La valeur de ce champ n’est pas utilisée ou stockée par le serveur ; il est simplement copié de l’enregistrement chargé vers l’enregistrement de résultat correspondant. Il peut s’agir d’une chaîne valide d’une longueur maximale de 100.

Ajouter: Optionnel
Supprimer: En lecture seule

Hauteur

Hauteur de l’image stockée dans votre bibliothèque multimédia.

Les dimensions de l’image affichée dépendent en partie des proportions de votre lien de ressource, par exemple, comme défini dans le champ Images d’une annonce réactive.

Ajouter: En lecture seule
Supprimer: En lecture seule

ID

Identificateur généré par le système de l’image.

Ajouter: Optionnel. Vous devez laisser ce champ vide ou spécifier un identificateur négatif. Un identificateur négatif défini pour l’image peut ensuite être référencé dans des types d’enregistrements dépendants tels que le champ Images d’une annonce réactive. Cette option est recommandée si vous ajoutez une nouvelle image et de nouveaux enregistrements dépendants dans le même fichier en bloc. Pour plus d’informations, consultez Clés de référence de schéma de fichier en bloc.
Supprimer: Lecture seule et Obligatoire

Heure de modification

Date et heure de la dernière mise à jour de l’entité. La valeur est exprimée au format UTC (temps universel coordonné).

Remarque

La valeur de date et d’heure reflète la date et l’heure sur le serveur, et non le client. Pour plus d’informations sur le format de la date et de l’heure, consultez l’entrée dateTime dans Types de données XML primitifs.

Ajouter: En lecture seule
Supprimer: En lecture seule

Parent Id

Identificateur généré par le système du compte qui contient l’image.

Ce champ en bloc est mappé au champ Id de l’enregistrement de compte .

Ajouter: En lecture seule
Supprimer: En lecture seule

Statut

Status de l’image.

Les valeurs possibles sont Active ou Deleted.

Ajouter: Optionnel. La valeur par défaut est Active.
Supprimer: Obligatoire. L’état doit être défini sur Supprimé.

Sous-type

Le sous-type image indique les proportions prises en charge de l’image chargée.

Nous vous recommandons la « GenericImage » avec des dimensions de 703 largeur x 368 hauteur ou plus, en pixels.

Toutes les valeurs de sous-type prises en charge avec des restrictions de dimension et de proportion correspondantes sont décrites ci-dessous.

Sous-type	Proportions	Dimension minimale
GenericImage	Variables	40 largeur x 40 hauteur, en pixels
Image16x9	16:9	640 largeur x 360 hauteur, en pixels
Image15x10	1.5:1	300 largeur x 200 hauteur, en pixels
Image4x3	4:3	100 largeur x 75 hauteur, en pixels
Image1x1	1:1	128 largeur x 128 hauteur, en pixels
Image191x100	1.91:1	703 largeur x 368 hauteur, en pixels
Image4x1	4:1	512 largeur x 128 hauteur, en pixels

Remarque

La largeur et la hauteur maximales en pixels sont de 2592 et 2048 indépendamment, et vous devez toujours conserver l’un des proportions prises en charge. Par exemple, si le sous-type est Image191x100 et que la largeur est 2592, la hauteur doit être 1357.

Les images avec animation ne sont pas prises en charge. Les types MIME suivants sont pris en charge.

• GIF
• JPEG
• PNG

Conseil

Les images PNG sont converties en JPEG. Si vous n’êtes pas satisfait de la qualité après la conversion, nous vous recommandons de fournir jpeg directement.

Ajouter: Obligatoire
Supprimer: En lecture seule

Texte

Texte ou étiquette personnalisé de l’image stockée dans votre bibliothèque multimédia.

Ajouter: Optionnel
Supprimer: En lecture seule

Url

URL où l’image est accessible.

Pour charger une nouvelle image, vous devez fournir une URL temporaire à laquelle le service en bloc peut accéder et récupérer votre image.

Lorsque vous téléchargez l’image, ce champ contient une URL fournie par le service en bloc, à partir de laquelle vous pouvez accéder à l’image stockée et la récupérer si nécessaire.

Vous pouvez charger une image PNG ou JPEG. Les images avec animation ne sont pas prises en charge. Les images PNG sont converties en JPEG. Si vous n’êtes pas satisfait de la qualité après la conversion, nous vous recommandons de fournir jpeg directement.

Ajouter: Obligatoire
Supprimer: En lecture seule

Largeur

Largeur de l’image stockée dans votre bibliothèque multimédia.

Les dimensions de l’image affichée dépendent en partie des proportions de votre lien de ressource, par exemple, comme défini dans le champ Images d’une annonce réactive.

Ajouter: En lecture seule
Supprimer: En lecture seule