Frequency 數據物件 - 營銷活動管理
判斷匯入作業應該定期執行一次或排程一次。
您可以排程週期性匯入,例如「每個星期日下午 4:00」,或者您可以執行匯入一次。
- 自動:Microsoft Advertising 會依不同的排程執行匯入,以將您的行銷活動優化。
- 現在:一旦呼叫 AddImportJobs 作業,立即匯入一次。
- 一次:在您指定時匯入一次。
- 每日:在您指定時每天匯入一次。
- 每周:在您指定時每周匯入一次。
- 每月:在您指定時每月匯入一次。
若要「立即」執行匯入,您可以將Google匯入作業 Frequency 元素保留為 nil 或空白。 針對所有其他排程選項,設定 frequency Type 和 Cron 值。 For details about supported frequency values, see the Remarks below.
<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>
元素
Frequency 物件具有下列元素:Cron、TimeZone、Type。
元素 | 描述 | 資料類型 |
---|---|---|
Cron | 表示 Cron 頻率的簡化實作。 例如,如果您想要每周在每週三下午 4:00 執行匯入,請將字串設定為 “0 16 * * 3 *”。 如需支持頻率值的詳細資訊,請參閱。 加: 如果 Type 設定為 「排程」,則為必要項,否則會忽略 cron 值。 |
string |
TimeZone | 用於匯入排程的時區。 如需可能的值,請參閱 時區。 加: 自選。 如果您未設定此元素,則預設會使用 「GreenwichMeanTimeDublinEdinburghLisbonLondon」 (UTC+0) 。 |
string |
類型 | 排程頻率類型。 如果您想要選擇特定 的 Cron 值,請將此元素設定為 「排程」,匯入作業應該執行一次或週期性執行一次。 如果您想要Microsoft Advertising 以最適合您營銷活動的不同排程執行匯入,請將此元素設定為 「自動」。 如果您想要立即執行匯入,您可以將此元素設定為 “RunNow”,或完全不要設定 Google 匯入作業 Frequency 元素。 加: 必填 |
string |
註解
排程匯入支援 Cron 的簡化實作,最多有六個已排序的元件。
* * * * * *
- - - - - -
| | | | | |
| | | | | +----- year (1 - 9999)
| | | | +----- day of week (0 - 6) (Sunday=0)
| | | +------- month (1 - 12)
| | +--------- day of month (1 - 31)
| +----------- hour (0 - 23)
+------------- min (0)
以下是一些有效的範例。
Cron 字串 | 匯入頻率 |
---|---|
"0 2 15 09 * 2020" | 在 2020 年 9 月 15 日上午 2:00 執行一次 |
"0 16 * * * *" | 每天下午 4:00 執行 |
"0 16 * * 3 *" | 每周執行,每周星期三下午 4:00 執行 |
"0 16 1 * * *" | 每月執行,每月第 1 天,下午 4:00 |
需求
服務: CampaignManagementService.svc v13
命名空間: https://bingads.microsoft.com/CampaignManagement/v13