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

消費者

ImportJob