Freigeben über

GoogleImportJob-Datenobjekt – Kampagnenverwaltung

  • Artikel

Definiert einen Google-Importauftrag, der einmal ausgeführt oder regelmäßig geplant werden kann.

Hinweis

  • Ab dem 1. Februar 2023 können Sie keine erweiterten Textanzeigen mehr aus Google Ads importieren. Alle erweiterten Textanzeigen, die zuvor importiert wurden, können erneut importiert werden, und wir werden weiterhin status Änderungen (z. B. Anhalten, Pausen aufheben) aus Google Ads importieren.
  • Erfahren Sie mehr über diese Änderung.

Ein Konto kann über bis zu 100 geplante Google-Importaufträge verfügen.

Tipp

Eine Übersicht über die Implementierung finden Sie im technischen Leitfaden zum Google Ads-Import .

<xs:complexType name="GoogleImportJob" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ImportJob">
      <xs:sequence>
        <xs:element minOccurs="0" name="CampaignAdGroupIds" nillable="true" type="tns:ArrayOfCampaignAdGroupIds" />
        <xs:element name="CredentialId" nillable="true" type="xs:string" />
        <xs:element name="GoogleAccountId" nillable="true" type="xs:long" />
        <xs:element minOccurs="0" name="GoogleUserName" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elemente

Das GoogleImportJob-Objekt weist die folgenden Elemente auf: CampaignAdGroupIds, CredentialId, GoogleAccountId, GoogleUserName.

Element Beschreibung Datentyp
CampaignAdGroupIds Die Liste der Kampagnen und deren Anzeigengruppen, die aus Google Ads importiert werden sollen.

Die Bezeichner werden gespeichert, aber nicht überprüft, wenn Sie einen Importauftrag erstellen. Wenn Sie ungültige Kampagnen- oder Anzeigengruppen-IDs einschließen oder ungültig werden, z. B. wenn die Entitäten später aus Google Ads gelöscht werden, werden die ungültigen Entitäten beim Import übersprungen.

Hinzufügen: Wahlfrei. Wenn dieses Element nicht festgelegt ist, können alle Kampagnen und Anzeigengruppen im Google Ads-Konto importiert werden. Der Satz importierter Entitäten hängt auch von Ihren Importoptionen ab.
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 CampaignAdGroupIds-Array
CredentialId Autorisiert einen Google Ads-Benutzer, Konten in Microsoft Advertising zu importieren.

Dieses Element wird nicht zurückgegeben, wenn Sie den GoogleImportJob erhalten.

Weitere Informationen finden Sie im Leitfaden Abrufen einer Import-Anmeldeinformations-ID .

Hinzufügen: Erforderlich
Aktualisieren: Schreibgeschützt		 Zeichenfolge
GoogleAccountId Das zu importierende Google Ads-Konto.

Hinzufügen: Erforderlich
Aktualisieren: Schreibgeschützt		 lang
GoogleUserName Das Google-Konto, d.h. die Google-Nutzeranmeldeinformationen mit Zugriff auf das Google Ads-Konto.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 Zeichenfolge

Das GoogleImportJob-Objekt verfügt über geerbte Elemente.

Geerbte Elemente

Geerbte Elemente von ImportJob

Das GoogleImportJob-Objekt wird vom ImportJob-Objekt abgeleitet und erbt die folgenden Elemente: CreatedByUserId, CreatedByUserName, CreatedDateTimeInUTC, Frequency, Id, ImportOption, LastRunTimeInUTC, Name, NotificationEmail, NotificationType, Status, Type. Die folgenden Beschreibungen gelten spezifisch für GoogleImportJob und gelten möglicherweise nicht für andere Objekte, die dieselben Elemente vom ImportJob-Objekt erben.

Element Beschreibung Datentyp
CreatedByUserId Der eindeutige Bezeichner des Microsoft Advertising-Benutzers, der den Importauftrag erstellt hat.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 lang
CreatedByUserName Der Anmeldebenutzername des Microsoft Advertising-Benutzers, der den Importauftrag erstellt hat.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 Zeichenfolge
CreatedDateTimeInUTC Das Datum und die Uhrzeit der Erstellung des Importauftrags.

Das Datum und die Uhrzeit werden in koordinierter Weltzeit (UTC) ausgedrückt.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 dateTime
Häufigkeit Bestimmt, ob der Importauftrag einmal ausgeführt oder regelmäßig geplant werden soll.

Um den Importauftrag jetzt auszuführen, muss dieses Element null oder leer sein.

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 Frequency
Id Der eindeutige Microsoft Advertising-Bezeichner des Importauftrags.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 lang
ImportOption Die Google-Importoptionen, die über die API verfügbar sind.

Zum Anpassen der Google-Importoptionen können Sie ein GoogleImportOption-Objekt einschließen. Andernfalls können Sie dieses Element null oder leer lassen, um die Standardmäßigen Google-Importoptionen zu verwenden. Weitere Informationen zu Standardoptionen finden Sie unter GoogleImportOption.

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 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.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 dateTime
Name Der Name des Importauftrags.

Der Name kann zwischen 1 und 255 Zeichen lang sein.

Hinzufügen: Erforderlich
Aktualisieren: Schreibgeschützt		 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.

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 Zeichenfolge
NotificationType Bestimmt, ob und wie oft Sie E-Mail-Benachrichtigungen zu den Ergebnissen des Importauftrags erhalten möchten.

Die unterstützten Werte sind "None" (No email), "Changes" (Only if changes or errors), "Errors" (Only if there there errors) und "EveryTime" (bei jeder Ausführung dieses Imports).

Hinzufügen: Wahlfrei. Wenn nicht festgelegt, legt der Dienst dieses Element standardmäßig auf "None" fest.
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 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: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 Zeichenfolge
Typ Der Typ des Importauftrags.

Dieser Wert ist GoogleImportJob , wenn Sie einen Google-Importauftrag abrufen.

Weitere Informationen zu Importauftragstypen finden Sie in den Hinweisen zum ImportJob-Datenobjekt.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 Zeichenfolge

Anforderungen

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