频率数据对象 - 市场活动管理
确定导入作业应运行一次还是定期计划。
可以计划定期导入,例如“每周日下午 4:00”,也可以运行导入一次。
- 自动:Microsoft广告将按不同的计划运行导入,以最好地优化你的市场活动。
- 现在:调用 AddImportJobs 操作后立即导入一次。
- 一次:指定时导入一次。
- 每日:在指定时每天导入一次。
- 每周:在指定时每周导入一次。
- 每月:在指定时每月导入一次。
若要“立即”运行导入,可以将 Google import job Frequency 元素保留为零或为空。 对于所有其他计划选项,请设置频率 Type 和 Cron 值。 有关支持的频率值的详细信息,请参阅下面的 备注 。
语法
<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 设置为“Schedule”,则是必需的,否则忽略 cron 值。 |
string |
TimeZone | 用于导入计划的时区。 有关可能的值,请参阅 时区。 加: 自选。 如果未设置此元素,则默认情况下将使用“GreenwichMeanTimeDublinEdinburghLisbonLondon” (UTC+0) 。 |
string |
类型 | 计划频率类型。 如果要选择特定的 Cron 值(导入作业应运行一次还是定期运行),请将此元素设置为“计划”。 如果希望Microsoft广告以最佳优化市场活动的不同计划运行导入,请将此元素设置为“自动”。 如果希望导入现在运行,可以将此元素设置为“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 * * *" | 每月运行,每月第一天下午 4:00 |
要求
服务: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13