ImportJob-Datenobjekt – Kampagnenverwaltung

Artikel
12/21/2023

Definiert das Basisobjekt eines Importauftrags.

Hinweis

Aktualisieren Sie Ihre erweiterten Textanzeigen bis zum 1. Februar 2023 auf reaktionsfähige Suchanzeigen. Nach diesem Datum können Sie keine neuen erweiterten Textanzeigen mehr erstellen oder bearbeiten. Weitere Informationen finden Sie unter Informationen zu reaktionsfähigen Suchanzeigen.
Vorhandene erweiterte Textanzeigen werden weiterhin bereitgestellt, und Sie können Berichte zu deren Leistung anzeigen.
Sie können Ihre erweiterten Textanzeigen weiterhin anhalten, aktivieren oder entfernen.
Erfahren Sie mehr über diese Änderung.

Versuchen Sie nicht, einen ImportJob zu instanziieren. Sie können eines oder mehrere der folgenden Objekte erstellen, die daraus abgeleitet werden.

Syntax

<xs:complexType name="ImportJob" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="CreatedByUserId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="CreatedByUserName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="CreatedDateTimeInUTC" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Frequency" nillable="true" type="tns:Frequency" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="ImportOption" nillable="true" type="tns:ImportOption" />
    <xs:element minOccurs="0" name="LastRunTimeInUTC" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="NotificationEmail" nillable="true" type="xs:string">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="NotificationType" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Type" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

Elemente

Das ImportJob-Objekt weist die folgenden Elemente auf: CreatedByUserId, CreatedByUserName, CreatedDateTimeInUTC, Frequency, Id, ImportOption, LastRunTimeInUTC, Name, NotificationEmail, NotificationType, Status, Type.

Element	Beschreibung	Datentyp
CreatedByUserId	Der eindeutige Bezeichner des Microsoft Advertising-Benutzers, der den Importauftrag erstellt hat.	Lange
CreatedByUserName	Der Anmeldebenutzername des Microsoft Advertising-Benutzers, der den Importauftrag erstellt hat.	Zeichenfolge
CreatedDateTimeInUTC	Das Datum und die Uhrzeit der Erstellung des Importauftrags. Das Datum und die Uhrzeit werden in koordinierter Weltzeit (UTC) ausgedrückt.	dateTime
Häufigkeit	Bestimmt, ob der Importauftrag einmal ausgeführt oder regelmäßig geplant werden soll. Um den Importauftrag jetzt auszuführen, sollte dieses Element null oder leer sein.	Frequency
Id	Der eindeutige Microsoft Advertising-Bezeichner des Importauftrags.	Lange
ImportOption	Die Importoptionen, die über die API verfügbar sind.	ImportOption
LastRunTimeInUTC	Das letzte Importdatum und die letzte Uhrzeit für diesen Auftrag. Das Datum und die Uhrzeit werden in koordinierter Weltzeit (UTC) ausgedrückt.	dateTime
Name	Der Name des Importauftrags	Zeichenfolge
NotificationEmail	Die E-Mail-Adresse, an die Importergebnisse gesendet werden sollen. Dieses Element wird standardmäßig nicht zurückgegeben. Um dieses Element abzurufen, schließen Sie den NotificationEmail-Wert in das ReturnAdditionalFields-Element ein, wenn Sie die GetImportJobsByIds - und GetImportResults-Dienstvorgänge aufrufen.	Zeichenfolge
Notificationtype	Bestimmt, ob und wie oft Sie E-Mail-Benachrichtigungen zu den Ergebnissen des Importauftrags erhalten möchten.	Zeichenfolge
Status	Die status des Importauftrags. Die möglichen Werte sind Aktiv, Pause und Deleted. Geplante Importe verfügen über eine aktive status, unabhängig davon, ob der Auftrag einmal oder in zukunft regelmäßig geplant wird. Angehaltene Importaufträge verfügen über eine pause status. Die status von Importaufträgen, die nur einmal ausgeführt werden, wird nach dem Import auf Gelöscht festgelegt. Hinzufügen: Schreibgeschützt Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.	Zeichenfolge
Typ	Der Typ des Importauftrags. Weitere Informationen zu Importauftragstypen finden Sie in den Hinweisen.	Zeichenfolge

Hinweise

Wenn Sie das SOAP manuell generieren, verwenden Sie das type-Attribut des <ImportJob> Knotens, wie im folgenden Beispiel gezeigt, um den Typ des Importzeitplans anzugeben.

<ImportJob i:type="GoogleImportJob" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <Id i:nil="true" />
    <Status i:nil="true" />
      . . .
</ImportJob>

Anforderungen

Dienst: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Verwendet von

AddImportJobs
GetImportJobsByIds
ImportResult
UpdateImportJobs

Freigeben über