Konto-App-Erweiterungsdatensatz – Massenvorgang
Definiert einen Zuordnungsdatensatz zwischen einem Konto und einer App Ad-Erweiterung , der in eine Massendatei hochgeladen und heruntergeladen werden kann. Verwenden Sie zum Hochladen oder Herunterladen des Kontos oder der App-Anzeigenerweiterung den Eintrag Konto oder App-Anzeigenerweiterung .
Sie können alle Einträge für Konto-App-Anzeigenerweiterungen im Konto herunterladen, indem Sie den DownloadEntity-Wert von AccountAppAdExtensions 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 eine App-Anzeigenerweiterung einem Konto zugeordnet, wenn die gültige ID angegeben wird.
Type,Status,Id,Parent Id,Client Id,Modified Time,Name
Format Version,,,,,,6.0
Account App Ad Extension,Active,-11,,ClientIdGoesHere,,
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 BulkAccountAppAdExtension-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 BulkAccountAppAdExtension
var bulkAccountAppAdExtension = new BulkAccountAppAdExtension
{
// Map properties in the Bulk file to the
// AdExtensionIdToEntityIdAssociation object of the Campaign Management service.
AdExtensionIdToEntityIdAssociation = new AdExtensionIdToEntityIdAssociation
{
// 'Id' column header in the Bulk file
AdExtensionId = appAdExtensionIdKey,
// 'Parent Id' column header in the Bulk file
EntityId = accountIdKey,
},
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// 'Status' column header in the Bulk file
Status = Status.Active,
};
uploadEntities.Add(bulkAccountAppAdExtension);
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 Account App Ad Extension-Datensatz sind die folgenden Attributfelder im Massendateischema verfügbar.
- Client-ID
- Redaktioneller Ort
- Redaktioneller Grundcode
- Redaktioneller Status
- Redaktionsbegriff
- Id
- Änderungszeit
- Übergeordnete ID
- Herausgeberländer
- Status
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: Optional
Löschen: Schreibgeschützt
Redaktioneller Ort
Die Komponente oder Eigenschaft der Anzeigenerweiterung, bei der die redaktionelle Überprüfung fehlgeschlagen ist.
Hinzufügen: Schreibgeschützt
Löschen: Schreibgeschützt
Redaktioneller Grundcode
Ein Code, der die Ursache für den Fehler identifiziert. Eine Liste der möglichen Ursachencodes finden Sie unter Redaktionelle Ursachencodes.
Hinzufügen: Schreibgeschützt
Löschen: Schreibgeschützt
Redaktioneller Status
Die redaktionelle status der Anzeigenerweiterung.
Mögliche Werte werden in der folgenden Tabelle beschrieben.
Hinzufügen: Schreibgeschützt
Löschen: Schreibgeschützt
Redaktionsbegriff
Der Begriff, der bei der redaktionellen Überprüfung nicht erfolgreich war.
Dieses Feld wird nicht festgelegt, wenn eine Kombination von Begriffen den Fehler verursacht hat oder wenn der Fehler auf einem Richtlinienverstoß basiert.
Hinzufügen: Schreibgeschützt
Löschen: Schreibgeschützt
Id
Der Bezeichner der Anzeigenerweiterung, die dem Konto zugeordnet oder daraus entfernt wird.
Dieses Massenfeld wird dem Id-Feld des App Ad-Erweiterungsdatensatzes zugeordnet.
Hinzufügen: Schreibgeschützt und Erforderlich. Sie müssen entweder einen vorhandenen Bezeichner für die Anzeigenerweiterung oder einen negativen Bezeichner angeben, der dem Id-Feld des übergeordneten App Ad Extension-Datensatzes entspricht. Dies wird empfohlen, wenn Sie neue Anzeigenerweiterungen und Zuordnungen 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 Bezeichner des Kontos, dem diese Anzeigenerweiterung zugeordnet oder entfernt wird.
Dieses Massenfeld wird dem Feld Id des Kontodatensatzes zugeordnet.
Hinzufügen: Schreibgeschützt
Löschen: Schreibgeschützt
Herausgeberländer
Die Liste der Herausgeberländer oder -regionen, deren redaktionelle Richtlinien den angegebenen Begriff nicht zulassen.
In einer Massendatei wird die Liste der Herausgeberländer oder -regionen durch ein Semikolon (;).
Hinzufügen: Schreibgeschützt
Löschen: Schreibgeschützt
Status
Stellt die Zuordnung status zwischen dem Konto und der Anzeigenerweiterung dar.
Mögliche Werte sind Aktiv und Gelöscht. Wenn die Anzeigenerweiterung dem Konto zugeordnet ist, ist der Wert dieses Felds Aktiv.
Hinzufügen: Schreibgeschützt
Löschen: Erforderlich. Der Status muss auf Gelöscht festgelegt werden.