通过

预算记录 - 批量

  • 项目

定义可在批量文件中上传和下载的预算。

可以设置单个每日预算，供同一帐户中的任何市场活动使用。 这样，就可以跨所有市场活动或 Microsoft Advertising 帐户中定义的一组市场活动有效地分配单个每日预算。

假设你的预算为 20 美元，每天在两个竞选活动之间统一使用。 在给定的一天，市场活动 A 只花费 8 (10 美元的预算) ，因为它获得的印象和点击量比平时要少。 使用共享预算，如果市场活动 B 表现良好，则 Microsoft Advertising 将自动获取剩余的 2 美元，并将其分配给市场活动 B。这将增加剩余预算用于向你发送更多流量的机会。

可以通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 Budgets 的 DownloadEntity 值来下载帐户中的所有预算记录。 此外，下载请求必须包括 EntityData 范围。 有关批量服务的更多详细信息（包括最佳做法），请参阅 批量下载和上传。

以下批量 CSV 示例将添加新预算。

Type,Status,Id,Parent Id,Client Id,Modified Time,Budget Id,Budget Name,Budget,Budget Type,Name
Format Version,,,,,,,,,,6.0
Budget,Active,-20,0,ClientIdGoesHere,,,My Shared Budget,50,DailyBudgetStandard,

如果使用用于 .NET、Java 或 Python 的必应广告 SDK ，则可以使用 BulkServiceManager 来节省时间来上传和下载 BulkBudget 对象，而无需直接调用服务操作和编写自定义代码来分析批量文件中的每个字段。

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkBudget
var bulkBudget = new BulkBudget
{
    // 'Parent Id' column header in the Bulk file
    AccountId = 0,
                
    // Map properties in the Bulk file to the 
    // Budget object of the Campaign Management service.
    Budget = new Budget
    {
        // 'Budget' column header in the Bulk file
        Amount = 50,
        // 'Budget Type' column header in the Bulk file
        BudgetType = BudgetLimitType.DailyBudgetStandard,
        // 'Budget Name' column header in the Bulk file
        Name = "My Shared Budget",
        // 'Id' column header in the Bulk file
        Id = budgetIdKey,
    },

    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkBudget);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

对于 预算 记录，批量 文件架构中提供了以下属性字段。

预算

在共享预算的所有市场活动中每天花费的金额。

添加： 必填
更新： 选。 如果未为更新设置任何值，则不会更改此设置。
删除： 只读

预算名称

预算的名称。 该名称在帐户中的所有预算中必须唯一。 名称最多可以包含 255 个字符。

该服务在将名称与现有预算名称进行比较时，会执行不区分大小写的比较。

添加： 必填
更新： 选。 如果未为更新设置任何值，则不会更改此设置。
删除： 只读

预算类型

预算类型确定预算在一天中的使用速度。

可以设置的唯一有效预算类型是 DailyBudgetStandard。

添加： 必填
更新： 选。 如果未为更新设置任何值，则不会更改此设置。
删除： 只读

客户端 ID

用于将批量上传文件中的记录与结果文件中的记录相关联。 服务器不使用或存储此字段的值;它只是从上传的记录复制到相应的结果记录。 它可以是长度最大为 100 的任何有效字符串。

添加： 选
更新： 选
删除： 只读

Id

预算的系统生成的标识符。

添加： 选。 必须将此字段留空，或指定负标识符。 然后，可以在相关记录类型（如市场活动）的“预算 ID”字段中引用为预算设置的负标识符。 如果要在同一批量文件中添加新预算和新的依赖记录，则建议这样做。 有关详细信息，请参阅 批量文件架构引用密钥。
更新： 只读和必需
删除： 只读和必需

修改时间

上次更新实体的日期和时间。 该值以协调世界时 (UTC) 表示。

注意

日期和时间值反映服务器的日期和时间，而不是客户端。 有关日期和时间格式的信息，请参阅 基元 XML 数据类型中的 dateTime 条目。

添加： 只读
更新： 只读
删除： 只读

父 ID

包含预算的帐户的系统生成的标识符。

此批量字段映射到帐户记录的 ID 字段。

添加： 只读
更新： 只读
删除： 只读

状态

预算的状态。

可能的值为 Active 或 Deleted。

添加： 选。 默认值为 Active。
更新： 选。 如果未为更新设置任何值，则不会更改此设置。
删除： 必填。 “状态”必须设置为 “已删除”。