頻度データ オブジェクト - キャンペーン管理
インポート ジョブを 1 回実行するか、定期的にスケジュールするかを決定します。
"毎週日曜日の午後 4:00" など、定期的なインポートをスケジュールすることも、インポートを 1 回実行することもできます。
- 自動: Microsoft Advertising は、キャンペーンを最適に最適化するさまざまなスケジュールでインポートを実行します。
- 今すぐ: AddImportJobs 操作を呼び出すとすぐに 1 回インポートします。
- 1 回: 指定した時刻に 1 回インポートします。
- 毎日: 指定した時刻に 1 日に 1 回インポートします。
- 週単位: 指定した時刻に週に 1 回インポートします。
- 月単位: 指定した時点で 1 か月に 1 回インポートします。
インポート "now" を実行するには、Google インポート ジョブ Frequency 要素を nil または空のままにします。 その他のすべてのスケジューリング オプションについては、頻度 の [種類] と [ 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 時にインポートを実行する場合は、文字列を "0 16 * * 3 *" に設定します。 サポートされている頻度の値の詳細については、「 備考」を参照してください。 追加:Type が "Scheduling" に設定され、それ以外の場合は cron 値が無視される場合は必須です。 |
string |
タイムゾーン | インポート スケジュールに使用されるタイム ゾーン。 使用可能な値については、「 タイム ゾーン」を参照してください。 追加: オプション。 この要素を設定しない場合は、"GreenwichMeanTimeDublinEdinburghLisbonLondon" (UTC+0) が既定で使用されます。 |
string |
型 | スケジューリング頻度の種類。 特定の Cron 値を選択する場合は、インポート ジョブを 1 回実行するか、定期的に実行するかを選択する場合は、この要素を "スケジュール" に設定します。 Microsoft Advertising で、キャンペーンを最適に最適化するさまざまなスケジュールでインポートを実行する場合は、この要素を "Auto" に設定します。 インポートを今すぐ実行する場合は、この要素を "RunNow" に設定するか、Google インポート ジョブ Frequency 要素をまったく設定しないでください。 追加: 必須 |
string |
注釈
スケジュールされたインポートでは、最大 6 つの順序付けされたコンポーネントを含む 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 時に 1 回実行 |
"0 16 * * * *" | 毎日午後 4:00 に実行 |
"0 16 * * 3 *" | 毎週、毎週水曜日の午後 4:00 に実行されます |
"0 16 1 * * *" | 毎月 1 日の午後 4:00 に実行されます |
要件
サービス: CampaignManagementService.svc v13
名前 空間: https://bingads.microsoft.com/CampaignManagement/v13