免責事項レコード - 一括
一括ファイルでダウンロードおよびアップロードできる免責事項を定義します。
免責事項は、アカウント内のキャンペーンに関連付けることができます。 免責事項の関連付けを管理するには、 キャンペーン免責事項 レコードを使用します。
アカウント内のすべての免責事項広告拡張機能レコードをダウンロードできます。この場合、DownloadCampaignsByAccountIds または DownloadCampaignsByCampaignIds サービス要求に DisclaimerAdExtensions の DownloadEntity 値を含めることができます。 さらに、ダウンロード要求には EntityData スコープを含める必要があります。 ベスト プラクティスを含む一括サービスの詳細については、「 一括ダウンロードとアップロード」を参照してください。
次の一括 CSV の例では、アカウントの共有ライブラリに新しい免責事項を追加します。
Type,Status,Id,Parent Id,Campaign,Client Id,Modified Time,Start Date,End Date,Ad Schedule,Use Searcher Time Zone,Disclaimer Layout,Name,Popup Text,Title,Final Url,Mobile Final Url
Format Version,,,,,,,,,,,6.0,,,,,,
Disclaimer Ad Extension,Active,-18,0,,,ClientIdGoesHere,,,12/31/2020,English,,(Monday[09:00-21:00]),FALSE,Amenities,ValueOne;ValueTwo;ValueThree,https://www.contoso.com/one; https://www.contoso.com/two; https://www.contoso.com/three,https://mobile.contoso.com/one; https://mobile.contoso.com/two; https://mobile.contoso.com/three
.NET、Java、または Python 用 の Bing Ads SDK を 使用している場合は、 BulkServiceManager を使用して、サービス操作を直接呼び出し、カスタム コードを記述してバルク ファイル内の各フィールドを解析する代わりに、 BulkDisclaimerAdExtension オブジェクトをアップロードしてダウンロードする時間を節約できます。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkDisclaimerAdExtension
var bulkDisclaimerAdExtension = new BulkDisclaimerAdExtension
{
// 'Parent Id' column header in the Bulk file
AccountId = 0,
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// DisclaimerAdExtension object of the Campaign Management service.
DisclaimerAdExtension = new DisclaimerAdExtension
{
// 'DisclaimerLayout' column header in the Bulk file
DisclaimerLayout = "additionalLine",
// 'Id' column header in the Bulk file
Id = disclaimerAdExtensionIdKey,
// 'Final Url' column header in the Bulk file
FinalUrls = new[] {
// Each Url is delimited by a semicolon (;) in the Bulk file
"https://www.contoso.com/one",
"https://www.contoso.com/two",
"https://www.contoso.com/three"
},
// 'Mobile Final Url' column header in the Bulk file
FinalMobileUrls = new[] {
// Each Url is delimited by a semicolon (;) in the Bulk file
"https://mobile.contoso.com/one",
"https://mobile.contoso.com/two",
"https://mobile.contoso.com/three"
},
// 'Name' column header in the Bulk file
Name = "DisclaimerName",
// 'PopupText' column header in the Bulk file
PopupText = "DisclaimerPopupText",
// 'Title' column header in the Bulk file
Title = "Disclaimer info",
// 'Tracking Template' column header in the Bulk file
TrackingUrlTemplate = null,
// 'Custom Parameter' column header in the Bulk file
UrlCustomParameters = new CustomParameters
{
// Each custom parameter is delimited by a semicolon (;) in the Bulk file
Parameters = new[] {
new CustomParameter(){
Key = "promoCode",
Value = "PROMO1"
},
new CustomParameter(){
Key = "season",
Value = "summer"
},
}
},
// 'Ad Schedule' column header in the Bulk file
Scheduling = new Schedule
{
// Each day and time range is delimited by a semicolon (;) in the Bulk file
DayTimeRanges = new[]
{
// Within each day and time range the format is Day[StartHour:StartMinue-EndHour:EndMinute].
new DayTime
{
Day = Day.Monday,
StartHour = 9,
StartMinute = Minute.Zero,
EndHour = 21,
EndMinute = Minute.Zero,
},
},
// 'End Date' column header in the Bulk file
EndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
{
Month = 12,
Day = 31,
Year = DateTime.UtcNow.Year + 1
},
// 'Start Date' column header in the Bulk file
StartDate = null,
// 'Use Searcher Time Zone' column header in the Bulk file
UseSearcherTimeZone = false,
},
// 'Status' column header in the Bulk file
Status = AdExtensionStatus.Active,
},
};
uploadEntities.Add(bulkDisclaimerAdExtension);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
免責事項レコードの場合、一括ファイル スキーマでは、次の属性フィールドを使用できます。
- 広告スケジュール
- クライアント ID
- 免責事項のレイアウト
- 編集場所
- 編集理由コード
- 編集状態
- 編集用語
- 終了日
- 最終 URL
- Id
- モバイルの最終 URL
- 変更時刻
- 名前
- Parent Id
- ポップアップ テキスト
- 発行元の国
- 開始日
- 状態
- Title
- Searcher タイム ゾーンを使用する
- バージョン
広告スケジュール
広告でレコードを表示する日付と時刻の範囲の一覧。 各曜日と時間範囲には、スケジュールされた曜日、開始時刻/終了時間、開始/終了分が含まれます。 各日と時刻の範囲は左と右のかっこで囲み、他の日と時刻の範囲からセミコロン (;)区切り記号で区切られます。 日付と時刻の範囲内の形式は 、Day[StartHour:StartMinue-EndHour:EndMinute] です。
StartHour の値の範囲は 00 から 23 です。00 は午前 12:00 に相当し、12 は午後 12 時です。
EndHour の値の範囲は 00 から 24 です。00 は午前 12:00 に相当し、12 は午後 12:00 です。
StartMinute と EndMinute の使用可能な値の範囲は 00 から 60 です。
次の例では、平日の午前 9:00 から午後 9:00 までの曜日と時間の範囲を示します 。(月曜日[09:00-21:00]);(火曜日[09:00-21:00]);(水曜日[09:00-21:00]);(木曜日[09:00-21:00]);(金曜日[09:00-21:00])
追加： オプション。 このフィールドを設定しない場合、カレンダーの 開始日 と 終了日 の間は、いつでもレコードをスケジュールできます。
更新： オプション。 個々の日と時刻の範囲を更新することはできません。 前のセットを置き換える必要がある新しいセットを送信することで、日と時刻の範囲を効果的に更新できます。
[広告スケジュール]、[終了日]、[開始日]、[検索者のタイム ゾーンを使用する] フィールドは互いに依存し、まとめて更新されます。 更新中にこれらのフィールドをすべて空のままにした場合、更新されません。 これらのフィールドのいずれかに値を含める場合、これらのすべてのフィールドの以前の値が削除または置換されます。 以前のすべてのスケジュール設定を削除するには、これらの各フィールドを delete_valueに設定します。
削除： 読み 取り 専用
クライアント ID
一括アップロード ファイル内のレコードを結果ファイル内のレコードに関連付けるために使用されます。 このフィールドの値は、サーバーによって使用または格納されません。アップロードされたレコードから対応する結果レコードにコピーされます。 最大 100 の長さの任意の有効な文字列を指定できます。
追加： オプション
更新： オプション
削除： 読み 取り 専用
免責事項のレイアウト
免責事項のレイアウト。 additionalLine またはポップアップを指定できます。
編集場所
編集レビューに失敗したレコードのコンポーネントまたはプロパティ。
追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用
編集理由コード
エラーの理由を識別するコード。 考えられる理由コードの一覧については、「 編集理由コード」を参照してください。
追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用
編集状態
レコードの編集状態。
使用可能な値については、次の表を参照してください。
追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用
編集用語
編集レビューに失敗した用語。
用語の組み合わせによってエラーが発生した場合、またはポリシー違反に基づいて失敗した場合、このフィールドは設定されません。
追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用
終了日
MM/DD/YYYY として書式設定されたレコードスケジュールされた終了日文字列。
終了日は包括的です。 たとえば、このフィールドを 2020 年 12 月 31 日に設定した場合、レコードは 2020 年 12 月 31 日午後 11 時 59 分に表示されなくなります。
追加： オプション。 終了日を指定しない場合、関連するキャンペーン、広告グループ、または広告を一時停止しない限り、レコードは引き続き配信されます。
更新： オプション。 開始日が null であるか、新しい終了日より前に発生する限り、終了日は短縮または延長できます。 このフィールドを delete_value 文字列に設定すると、実質的に終了日が削除されます。
[広告スケジュール]、[終了日]、[開始日]、[検索者のタイム ゾーンを使用する] フィールドは互いに依存し、まとめて更新されます。 更新中にこれらのフィールドをすべて空のままにした場合、更新されません。 これらのフィールドのいずれかに値を含める場合、これらのすべてのフィールドの以前の値が削除または置換されます。 以前のすべてのスケジュール設定を削除するには、これらの各フィールドを delete_valueに設定します。
削除： 読み 取り 専用
最終 URL
ランディング ページの URL。
次の検証規則は、最終 URL と最終モバイル URL に適用されます。
- URL の長さは 2,048 文字に制限されています。 HTTP または HTTPS プロトコル文字列は、2,048 文字の制限にカウントされます。
- 最終 URL とモバイル最終 URL の両方に最大 10 個のリスト 項目を指定できます。ただし、各一覧の最初の項目のみが配信に使用されます。 このサービスでは、前方互換性の可能性があるリスト アイテムを最大 10 個まで許可します。
- 各 URL は、セミコロンとスペース ("; ") で区切られます。
- '{' と '}' の使用は、 {lpurl} などのタグのみを示すために許可されます。
- 最終的な URL はそれぞれ、http:// または https:// で始まる整形式の URL である必要があります。
- Mobile Final Url を指定する場合は、Final Url も指定する必要があります。
追加： 必須
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用
Id
レコードのシステム生成識別子。
追加： オプション。 このフィールドは空のままにするか、負の識別子を指定する必要があります。 その後、レコードに対して設定された負の識別子は、依存するレコードの種類の [Id ] フィールド ([ キャンペーンの免責事項] など) で参照できます。 これは、同じ Bulk ファイルに新しいレコードと新しい依存レコードを追加する場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
更新： 読み取り専用と必須
削除： 読み取り専用と必須
モバイルの最終 URL
モバイル デバイスのランディング ページ URL。
次の検証規則は、最終 URL と最終モバイル URL に適用されます。
- URL の長さは 2,048 文字に制限されています。 HTTP または HTTPS プロトコル文字列は、2,048 文字の制限にカウントされます。
- 最終 URL とモバイル最終 URL の両方に最大 10 個のリスト 項目を指定できます。ただし、各一覧の最初の項目のみが配信に使用されます。 このサービスでは、前方互換性の可能性があるリスト アイテムを最大 10 個まで許可します。
- 各 URL は、セミコロンとスペース ("; ") で区切られます。
- '{' と '}' の使用は、 {lpurl} などのタグのみを示すために許可されます。
- 最終的な URL はそれぞれ、http:// または https:// で始まる整形式の URL である必要があります。
- Mobile Final Url を指定する場合は、Final Url も指定する必要があります。
追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。
削除： 読み 取り 専用
変更時刻
エンティティが最後に更新された日付と時刻。 値は、世界協定時刻 (UTC) です。
注:
日付と時刻の値は、クライアントではなく、サーバーでの日付と時刻を反映します。 日付と時刻の形式については、「 プリミティブ XML データ型」の dateTime エントリを参照してください。
追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用
名前
免責事項の名前。 これは、レコードの識別に役立つレポートにのみ使用されます。
最大 length: 35 文字。
Parent Id
レコードを含むアカウントのシステム生成識別子。
この一括フィールドは、取引先企業レコードの Id フィールドにマップされます。
追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用
ポップアップ テキスト
免責事項が ポップアップ レイアウトにある場合に必要なテキスト。
最大 length: 500 文字。
発行元の国
編集ガイドラインで指定した 用語が許可されていない発行元の国または地域の一覧。
一括ファイルでは、発行元の国またはリージョンの一覧はセミコロン (;)で区切られます。
追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用
開始日
MM/DD/YYYY として書式設定されたレコードスケジュールされた開始日文字列。
開始日は包括的です。 たとえば、 StartDate を 2020 年 5 月 5 日に設定した場合、レコードは 2020 年 5 月 5 日午前 12 時 00 分に表示されます。
追加： オプション。 開始日を指定しない場合、レコードはすぐに スケジュールされる資格があります。
更新： オプション。 終了日が null であるか、新しい開始日の後に発生する限り、開始日は短縮または延長できます。 このフィールドを delete_value 文字列に設定すると、実質的に開始日が削除され、レコードはすぐに スケジュールされる資格があります。
[広告スケジュール]、[終了日]、[開始日]、[検索者のタイム ゾーンを使用する] フィールドは互いに依存し、まとめて更新されます。 更新中にこれらのフィールドをすべて空のままにした場合、更新されません。 これらのフィールドのいずれかに値を含める場合、これらのすべてのフィールドの以前の値が削除または置換されます。 以前のすべてのスケジュール設定を削除するには、これらの各フィールドを delete_valueに設定します。
削除： 読み 取り 専用
状態
レコードの状態。
使用可能な値は [アクティブ] または [削除済み] です。
追加： オプション。 既定値は [アクティブ] です。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 必須。 [状態] を [削除済み] に設定する必要があります。
Title
ポップアップ レイアウト内のポップアップのタイトル。
最大 length: 75 文字。
Searcher タイム ゾーンを使用する
広告を配信できる検索ユーザーのアカウント タイム ゾーンとタイム ゾーンのどちらを使用するかを指定します。
検索ユーザーのタイム ゾーンにレコードを表示する場合は、このプロパティを TRUE に設定し、それ以外の場合は FALSE に設定 します。
追加： オプション。 このフィールドを指定しない場合、または空のままにした場合は、既定値の FALSE が設定され、アカウントのタイム ゾーンが使用されます。
更新： オプション。 このフィールドを delete_value 文字列に設定すると、実質的に FALSE の既定値にリセットされます。
[広告スケジュール]、[終了日]、[開始日]、[検索者のタイム ゾーンを使用する] フィールドは互いに依存し、まとめて更新されます。 更新中にこれらのフィールドをすべて空のままにした場合、更新されません。 これらのフィールドのいずれかに値を含める場合、これらのすべてのフィールドの以前の値が削除または置換されます。 以前のすべてのスケジュール設定を削除するには、これらの各フィールドを delete_valueに設定します。
削除： 読み 取り 専用
バージョン
レコードの内容が更新された回数。 レコードを追加すると、バージョンは 1 に設定され、変更されるたびにインクリメントされます。
追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用