Bilddatensatz – Massenvorgang
Definiert ein Bild, das in eine Massendatei hochgeladen und heruntergeladen werden kann.
Sie können alle Imagedatensätze im Konto herunterladen, indem Sie den DownloadEntity-Wert von Images in die Serviceanforderung DownloadCampaignsByAccountIds oder DownloadCampaignsByCampaignIds einschließen. Darüber hinaus muss die Downloadanforderung den EntityData-Bereich enthalten. Weitere Informationen zum Massendienst, einschließlich bewährter Methoden, finden Sie unter Massendownload und -upload.
Im folgenden Massen-CSV-Beispiel wird ein neues Image hinzugefügt.
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,
Wenn Sie die Bing Ads SDKs für .NET, Java oder Python verwenden, können Sie Zeit sparen, indem Sie bulkServiceManager zum Hochladen und Herunterladen des BulkImage-Objekts verwenden, anstatt die Dienstvorgänge direkt aufzurufen und benutzerdefinierten Code zum Analysieren der einzelnen Felder in der Massendatei zu schreiben.
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();
Für einen Bilddatensatz sind die folgenden Attributfelder im Massendateischema verfügbar.
Client-ID
Wird verwendet, um Datensätze in der Massenuploaddatei datensätzen in der Ergebnisdatei zuzuordnen. Der Wert dieses Felds wird vom Server nicht verwendet oder gespeichert. es wird einfach aus dem hochgeladenen Datensatz in den entsprechenden Ergebnisdatensatz kopiert. Es kann eine beliebige gültige Zeichenfolge sein, die eine Länge von bis zu 100 hat.
Hinzufügen: Wahlfrei
Löschen: Schreibgeschützt
Height
Die Höhe des in Ihrer Medienbibliothek gespeicherten Bilds.
Die angezeigten Bilddimensionen hängen teilweise von den Seitenverhältnissen Ihrer Medienobjektverknüpfung ab, z. B. wie im Feld Bilder einer responsiven Anzeige definiert.
Hinzufügen: Schreibgeschützt
Löschen: Schreibgeschützt
Id
Der vom System generierte Bezeichner des Images.
Hinzufügen: Wahlfrei. Sie müssen dieses Feld entweder leer lassen oder einen negativen Bezeichner angeben. Auf einen negativen Bezeichner für das Bild kann dann in abhängigen Datensatztypen verwiesen werden, z. B . im Feld Bilder einer reaktionsfähigen Anzeige. Dies wird empfohlen, wenn Sie ein neues Image und neue abhängige Datensätze in derselben Massendatei hinzufügen. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
Löschen: Schreibgeschützt und erforderlich
Änderungszeit
Das Datum und die Uhrzeit der letzten Aktualisierung der Entität. Der Wert wird in UTC (Coordinated Universal Time) angegeben.
Hinweis
Der Datums- und Uhrzeitwert gibt das Datum und die Uhrzeit auf dem Server und nicht auf dem Client an. Informationen zum Format von Datum und Uhrzeit finden Sie unter dateTime-Eintrag in Primitive XML-Datentypen.
Hinzufügen: Schreibgeschützt
Löschen: Schreibgeschützt
Übergeordnete ID
Der vom System generierte Bezeichner des Kontos, das das Image enthält.
Dieses Massenfeld wird dem Feld Id des Kontodatensatzes zugeordnet.
Hinzufügen: Schreibgeschützt
Löschen: Schreibgeschützt
Status
Der Status des Images.
Mögliche Werte sind Aktiv oder Gelöscht.
Hinzufügen: Wahlfrei. Der Standardwert ist Aktiv.
Löschen: Erforderlich. Der Status muss auf Gelöscht festgelegt werden.
Untertyp
Der Bilduntertyp gibt das unterstützte Seitenverhältnis des hochgeladenen Bilds an.
Wir empfehlen das "GenericImage" mit Abmessungen von 703 Breite x 368 Höhe oder höher in Pixeln.
Der Untertyp muss auf "Logo" festgelegt werden, wenn das Bild einer Anzeige als "LandscapeLogoMedia" oder "SquareLogoMedia" zugeordnet ist.
Alle unterstützten Untertypwerte mit entsprechenden Dimensions- und Seitenverhältniseinschränkungen werden unten beschrieben.
| Untertyp | Seitenverhältnis | Mindestdimension |
|---|---|---|
| GenericImage | Variiert | 40 Breite x 40 Höhe, in Pixel |
| LandscapeLogoMedia | 4:1 | 512 Breite x 128 Höhe, in Pixel |
| SquareLogoMedia | 1:1 | 128 Breite x 128 Höhe, in Pixel |
| Bild 16x9 | 16:9 | 640 Breite x 360 Höhe, in Pixel |
| Bild 15x10 | 1.5:1 | 300 Breite x 200 Höhe, in Pixel |
| Image4x3 | 4:3 | 100 Breite x 75 Höhe, in Pixel |
| Bild 1x1 | 1:1 | 128 Breite x 128 Höhe, in Pixel |
| Bild 191x100 | 1.91:1 | 703 Breite x 368 Höhe, in Pixel |
| Image4x1 | 4:1 | 512 Breite x 128 Höhe, in Pixel |
Hinweis
Die maximale Breite und Höhe in Pixel beträgt unabhängig voneinander 2592 und 2048, und Sie müssen weiterhin eines der unterstützten Seitenverhältnisse beibehalten. Wenn der Untertyp beispielsweise Image191x100 und die Breite 2592 ist, muss die Höhe 1357 sein.
Bilder mit Animation werden nicht unterstützt. Die folgenden MIME-Typen werden unterstützt.
- GIF
- JPEG
- PNG
Tipp
Die PNG-Bilder werden in JPEG konvertiert. Wenn Sie mit der Qualität nach der Konvertierung nicht zufrieden sind, empfehlen wir Ihnen, JPEG direkt bereitzustellen.
Hinzufügen: Erforderlich
Löschen: Schreibgeschützt
Text
Der benutzerdefinierte Text oder die Beschriftung des Bilds, das in Ihrer Medienbibliothek gespeichert ist.
Hinzufügen: Wahlfrei
Löschen: Schreibgeschützt
Url
Die URL, auf die auf das Bild zugegriffen werden kann.
Um ein neues Bild hochzuladen, müssen Sie eine temporäre URL angeben, über die der Massendienst auf Ihr Bild zugreifen und es abrufen kann.
Wenn Sie das Bild herunterladen, enthält dieses Feld eine URL, die vom Massendienst bereitgestellt wird, über den Sie nach Bedarf auf das gespeicherte Bild zugreifen und es abrufen können.
Sie können ein PNG- oder JPEG-Bild hochladen. Bilder mit Animation werden nicht unterstützt. Die PNG-Bilder werden in JPEG konvertiert. Wenn Sie mit der Qualität nach der Konvertierung nicht zufrieden sind, empfehlen wir Ihnen, JPEG direkt bereitzustellen.
Hinzufügen: Erforderlich
Löschen: Schreibgeschützt
Width
Die Breite des bildes, das in Ihrer Medienbibliothek gespeichert ist.
Die angezeigten Bilddimensionen hängen teilweise von den Seitenverhältnissen Ihrer Medienobjektverknüpfung ab, z. B. wie im Feld Bilder einer responsiven Anzeige definiert.
Hinzufügen: Schreibgeschützt
Löschen: Schreibgeschützt