Frequency Data Object – Kampagnenverwaltung
Bestimmt, ob ein Importauftrag einmal oder regelmäßig geplant werden soll.
Sie können einen wiederkehrenden Import planen, z. B. "Jeden Sonntag um 16:00 Uhr", oder Sie können den Import einmal ausführen.
- Automatisch: Microsoft Advertising führt Importe nach einem unterschiedlichen Zeitplan aus, der Ihre Kampagnen am besten optimiert.
- Jetzt: Importieren Sie einmal, sobald Sie den AddImportJobs-Vorgang aufrufen.
- Einmal: Importieren Sie einmal zum angegebenen Zeitpunkt.
- Täglich: Importieren Sie einmal pro Tag zu dem von Ihnen angegebenen Zeitpunkt.
- Wöchentlich: Importieren Sie einmal pro Woche zu dem von Ihnen angegebenen Zeitpunkt.
- Monatlich: Importieren Sie einmal pro Monat zu dem von Ihnen angegebenen Zeitpunkt.
Um den Import "jetzt" auszuführen, können Sie das Frequency-Element des Google-Importauftrags null oder leer lassen. Legen Sie für alle anderen Planungsoptionen die Werte für Häufigkeitstyp und Cron fest. Ausführliche Informationen zu unterstützten Häufigkeitswerten finden Sie in den nachstehenden Hinweisen .
<xs:complexType name="Frequency" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<xs:element minOccurs="0" name="Cron" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="TimeZone" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="Type" nillable="true" type="xs:string" />
</xs:sequence>
</xs:complexType>
Elemente
Das Frequency-Objekt weist die folgenden Elemente auf: Cron, TimeZone, Type.
Element | Beschreibung | Datentyp |
---|---|---|
Cron | Stellt eine vereinfachte Implementierung der Cron-Häufigkeit dar. Legen Sie beispielsweise die Zeichenfolge auf "0 16 * * 3 *" fest, wenn der Import wöchentlich ausgeführt werden soll, jeden Mittwoch um 16:00 Uhr. Ausführliche Informationen zu unterstützten Häufigkeitswerten finden Sie in den Hinweisen. Hinzufügen: Erforderlich, wenn der Typ auf "Scheduling" festgelegt ist und andernfalls der Cron-Wert ignoriert wird. |
Zeichenfolge |
Zeitzone | Die Zeitzone, die für den Importzeitplan verwendet wird. Mögliche Werte finden Sie unter Zeitzonen. Hinzufügen: Wahlfrei. Wenn Sie dieses Element nicht festlegen, wird standardmäßig "GreenwichMeanTimeDublinEdinburghLisbonLondon" (UTC+0) verwendet. |
Zeichenfolge |
Typ | Der Planungshäufigkeitstyp. Legen Sie dieses Element auf "Scheduling" fest, wenn Sie einen bestimmten Cron-Wert auswählen möchten, unabhängig davon, ob der Importauftrag einmal oder wiederholt ausgeführt werden soll. Legen Sie dieses Element auf "Auto" fest, wenn Sie möchten, dass Microsoft Advertising Importe nach einem unterschiedlichen Zeitplan ausführen soll, der Ihre Kampagnen am besten optimiert. Wenn der Import jetzt ausgeführt werden soll, können Sie dieses Element entweder auf "RunNow" festlegen oder das Häufigkeitselement des Google-Importauftrags überhaupt nicht festlegen. Hinzufügen: Erforderlich |
Zeichenfolge |
Hinweise
Geplante Importe unterstützen eine vereinfachte Implementierung von Cron mit bis zu sechs geordneten Komponenten.
* * * * * *
- - - - - -
| | | | | |
| | | | | +----- year (1 - 9999)
| | | | +----- day of week (0 - 6) (Sunday=0)
| | | +------- month (1 - 12)
| | +--------- day of month (1 - 31)
| +----------- hour (0 - 23)
+------------- min (0)
Hier sind einige gültige Beispiele.
Cron-Zeichenfolge | Importhäufigkeit |
---|---|
"0 2 15 09 * 2020" | Ausführung einmalig am 15. September 2020 um 2:00 Uhr |
"0 16 * * * *" | Täglich um 16:00 Uhr ausgeführt |
"0 16 * * 3 *" | Wöchentlich, jeden Mittwoch um 16:00 Uhr |
"0 16 1 * * *" | Monatliche Ausführung am 1. Tag jedes Monats um 16:00 Uhr |
Anforderungen
Dienst: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13