免責聲明記錄 - 大量

發行項
11/13/2024

定義可在大量檔案中下載及上傳的免責聲明。

您可以將免責聲明與帳戶中的行銷活動產生關聯。使用活動免責聲明記錄來管理免責聲明關聯。

您可以在DownloadCampaignsByAccountIds或DownloadCampaignsByCampaignIds服務要求中包含DisclaimerAdExtensions的DownloadEntity值，以下載帳戶中的所有免責聲明 Ad 擴充功能記錄。此外，下載要求必須包含 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();

對於 免責聲明 記錄，大量檔案架構中提供下列屬性欄位。

廣告排程
用戶端識別碼
免責聲明版面配置
編輯位置
編輯原因代碼
編輯狀態
編輯詞彙
結束日期
最終 URL
Id
行動裝置最終 URL
修改時間
名稱
父項識別碼
快顯文字
發行者國家/地區
開始日期
狀態
Title
使用搜尋人員時區
版本

廣告排程

您希望記錄與廣告一起顯示的日期和時間範圍清單。每一天和時間範圍包括排程的星期幾、開始/結束時間，以及開始/結束分鐘。每一天和時間範圍都會以左括弧和右括弧括住，並以分號 (;) 分隔符號來分隔其他日期和時間範圍。在每天和時間範圍內，格式為 Day[StartHour：StartMinue-EndHour：EndMinute]。

StartHour的可能值範圍從 00 到 23，其中00相當於上午 12：00，而 12則是 12：00PM。

EndHour的可能值範圍從 00 到 24，其中00相當於上午 12：00，而 12 則是 12：00PM。

StartMinute和EndMinute的可能值範圍從 00 到 60。

下列範例示範工作日從上午 9：00 到下午 9：00 的日期和時間範圍： (Monday[09：00-21：00]) ; (Tuesday[09：00-21：00]) ; (Wednesday[09：00-21：00]) ; (Thursday[09：00-21：00]) ; (Friday[09：00-21：00])

添加： 選。如果您未設定此欄位，記錄將可隨時在行事曆開始和結束日期期間排程。
更新： 選。無法更新個別的日期和時間範圍。您可以藉由傳送應該取代先前集合的新集合，有效地更新日期和時間範圍。 [廣告排程]、[結束日期]、[開始日期] 和 [使用搜尋工具時區] 欄位彼此相依，並一起更新。如果您在更新期間將所有這些欄位保留空白，則不會更新這些欄位。如果您包含任何這些欄位的值，則會移除或取代所有這些欄位的先前值。若要移除所有先前的排程設定，請將每個欄位設定 為 delete_value。
刪除： 唯讀

用戶端識別碼

用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。它可以是長度上限為 100 的任何有效字串。

添加： 選
更新： 選
刪除： 唯讀

免責聲明版面配置

免責聲明的版面配置。可以是 additionalLine 或 popup。

編輯位置

編輯檢閱失敗之記錄的元件或屬性。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

編輯原因代碼

識別失敗原因的程式碼。如需可能的原因代碼清單，請參閱編輯原因代碼。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

編輯狀態

記錄的編輯狀態。

下表說明可能的值。

值	描述
作用中	通過編輯檢閱的記錄。
ActiveLimited	在一或多個市場中通過編輯檢閱的記錄，以及記錄的一或多個元素正在另一個市場中進行編輯檢閱。例如，加拿大的編輯檢閱已通過記錄，且仍在美國中暫止檢閱。
反對	記錄失敗的編輯檢閱。
非作用中	記錄的一或多個元素正在進行編輯檢閱。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

編輯詞彙

失敗的編輯檢閱詞彙。

如果字片語合造成失敗，或失敗是以原則違規為基礎，則不會設定此欄位。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

結束日期

格式為 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 必須是格式正確的 URL，開頭為 HTTP:// 或 HTTPs://。
如果您指定 [行動最終 URL]，則也必須指定 [最終 URL]。

添加： 必填
更新： 選。如果未設定更新的值，則此設定不會變更。
刪除： 唯讀

識別碼

系統產生的記錄識別碼。

添加： 選。您必須將此欄位保留空白，或指定負識別碼。然後可以在相依記錄類型的 [ 標識符] 欄位中參考記錄的負識別碼集，例如和 [行銷活動免責聲明]。如果您要在相同的大量檔案中新增新記錄和新的相依記錄，建議使用此方法。如需詳細資訊，請參閱大量檔案架構參考金鑰。
更新： 唯讀和必要
刪除： 唯讀和必要

行動裝置最終 URL

行動裝置的登陸頁面 URL。

下列驗證規則適用于最終 URL 和最終行動 URL。

URL 的長度限制為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。
您最多可以為最終 URL 和行動裝置最終 URL指定 10 個清單專案;不過，只有每個清單中的第一個專案會用於傳遞。此服務最多可允許 10 個清單專案，以獲得潛在的正向相容性。
每個 URL 都會以分號和空格分隔 (」;「) 。
僅允許使用 '{' 和 '}' 來描述標記，例如 {lpurl}。
最後一個 URL 必須是格式正確的 URL，開頭為 HTTP:// 或 HTTPs://。
如果您指定 [行動最終 URL]，則也必須指定 [最終 URL]。

添加： 選
更新： 選。如果未設定更新的值，則此設定不會變更。如果您將此欄位設定為 delete_value 字串，則會移除先前的設定。
刪除： 唯讀

修改時間

上次更新實體的日期和時間。值為國際標準時間 (UTC)。

注意事項

日期和時間值會反映伺服器上的日期和時間，而不是用戶端。如需日期和時間格式的相關資訊，請參閱基本 XML 資料類型中的 dateTime 專案。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

名稱

免責聲明的名稱。這僅用於報告，以協助識別記錄。

最大值 length：35 個字元。

父項識別碼

系統產生的帳戶識別碼，其中包含記錄。

此大量欄位會對應至客戶紀錄的 [ 標識符 ] 字段。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

快顯文字

如果免責聲明位於快顯版面配置中，則為必要的文字。

最大值 length：500 個字元。

發行者國家/地區

發行者國家或地區的清單，其編輯指導方針不允許指定的詞彙。

在大量檔案中，發行者國家或地區的清單會以分號分隔 (;) 。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

開始日期

格式為 MM/DD/YYYY 的記錄排程開始日期字串。

開始日期包含在內。例如，如果您將 StartDate 設定為 5/5/2020，則記錄會在 2020 年 5 月 5 日上午 12：00 開始顯示。

添加： 選。如果您未指定開始日期，則記錄會立即符合排程的資格。
更新： 選。只要結束日期為 Null 或發生在新的開始日期之後，就可以縮短或延長開始日期。如果您將此欄位設定 為delete_value 字串，則您實際上會移除開始日期，而且記錄立即符合排程的資格。 [廣告排程]、[結束日期]、[開始日期] 和 [使用搜尋工具時區] 欄位彼此相依，並一起更新。如果您在更新期間將所有這些欄位保留空白，則不會更新這些欄位。如果您包含任何這些欄位的值，則會移除或取代所有這些欄位的先前值。若要移除所有先前的排程設定，請將每個欄位設定 為 delete_value。
刪除： 唯讀

狀態

記錄的狀態。

可能的值為 [作用中 ] 或 [已刪除]。

添加： 選。預設值為 Active。
更新： 選。如果未設定更新的值，則此設定不會變更。
刪除： 必填。 [狀態] 必須設定為 [ 已刪除]。

標題

快顯版面配置中的快顯標題。

最大值 length：75 個字元。

使用搜尋人員時區

判斷是要使用帳戶時區，還是廣告可傳遞之搜尋使用者的時區。

如果您想要在搜尋使用者的時區中顯示記錄，請將此屬性設定為 TRUE ，否則將它設定為 FALSE。

添加： 選。如果您未指定此欄位或將其保留空白，則會設定 FALSE 的預設值，並使用帳戶時區。
更新： 選。如果您將此欄位設定為 delete_value 字串，則實際上會重設為預設值 FALSE。 [廣告排程]、[結束日期]、[開始日期] 和 [使用搜尋工具時區] 欄位彼此相依，並一起更新。如果您在更新期間將所有這些欄位保留空白，則不會更新這些欄位。如果您包含任何這些欄位的值，則會移除或取代所有這些欄位的先前值。若要移除所有先前的排程設定，請將每個欄位設定 為 delete_value。
刪除： 唯讀

版本

記錄內容已更新的次數。當您新增記錄時，版本會設定為 1，而且每次修訂時都會遞增。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

共用方式為

免責聲明記錄 - 大量

廣告排程

用戶端識別碼

免責聲明版面配置

編輯位置

編輯原因代碼

編輯狀態

編輯詞彙

結束日期

最終 URL

識別碼

行動裝置最終 URL

修改時間

名稱

父項識別碼

快顯文字

發行者國家/地區

開始日期

狀態

標題

使用搜尋人員時區

版本

意見反應

其他資源