通过

InsertionOrderPendingChanges 数据对象 - 客户计费

  • 项目

定义一个对象，该对象可用于管理已批准的插入订单的更改。

如果 InsertionOrder 的 Status 元素设置为 PendingUserReview，则无法通过插入OrderPendingChanges 对象更新插入顺序。 必须首先通过插入Order 的 Status 元素批准、拒绝或取消。 插入顺序 “状态” 为“活动”、“已用”、“已过期”或“NotStarted”后，你可以进行新的更改，或者通过 InsertionOrderPendingChanges 对象批准或拒绝当前挂起的更改。

语法

<xs:complexType name="InsertionOrderPendingChanges" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Comment" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="EndDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="RequestedByUserId" nillable="true" type="xs:int" />
    <xs:element minOccurs="0" name="ModifiedDateTime" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="NotificationThreshold" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="ReferenceId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="SpendCapAmount" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="PurchaseOrder" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ChangeStatus" nillable="true" type="tns:InsertionOrderPendingChangesStatus" />
  </xs:sequence>
</xs:complexType>

元素

InsertionOrderPendingChanges 对象具有以下元素：ChangeStatus、Comment、EndDate、ModifiedDateTime、Name、NotificationThreshold、PurchaseOrder、ReferenceId、RequestedByUserId、SpendCapAmount、StartDate。

元素 说明 数据类型
ChangeStatus 可用于接受或拒绝等待更改的插入订单。

调用 UpdateInsertionOrder 时，可以设置此 ChangeStatus 元素或修改此对象的其他元素，但不能与其他属性更新并行更改状态。		 InsertionOrderPendingChangesStatus
评论 插入顺序的说明。 说明限制为 100 个字符。

加： 只读
更新： 自选		 string
EndDate 插入订单到期的日期。 结束日期必须晚于开始日期。

该日期存储在协调世界时 (UTC) 中。 仅使用指定字符串的月份、日和年。 如果指定日期的小时、分钟和秒，它们将被忽略。

有关日期和时间格式的信息，请参阅基元 XML 数据类型中的 dateTime 条目。

如果插入顺序没有结束日期，则此元素为空。

加： 只读
更新： 自选		 dateTime
ModifiedDateTime 提交插入订单更改请求的日期和时间。

该日期存储在协调世界时 (UTC) 中。

有关日期和时间格式的信息，请参阅基元 XML 数据类型中的 dateTime 条目。

加： 只读
更新： 只读		 dateTime
名称 可用于引用此插入顺序的友好名称。

名称最多可以包含 100 个字符。

与客户的其他插入订单相比，名称不需要是唯一的。

加： 只读
更新： 自选		 string
NotificationThreshold 已花费预算的百分比。 将百分比指定为 0 到 100 的值。 达到阈值时发送通知。 例如，如果将阈值设置为 70，计费服务会在你花费了预算的 70% 时发送通知。

如果不想接收通知，请将 设置为 NULL。

仅供内部使用。

加： 只读
更新： 自选		 双
PurchaseOrder 可用于在每月发票中引用此插入订单的采购订单值。 此值将打印为每月发票中的采购订单。

采购订单最多可以包含 50 个字符。

加： 只读
更新： 自选		 string
ReferenceId 仅供内部使用。

加： 只读
更新： 自选		 long
RequestedByUserId 请求更改插入顺序的最后一个用户的标识符。

加： 只读
更新： 只读		 int
SpendCapAmount 此插入订单的预算。 预算是硬性限制。 当帐户达到此限制并且没有其他可用的插入顺序时，帐户的生命周期状态值将设置为“暂停”。

如果插入订单具有无限制的预算，则此元素为空。

加： 只读
更新： 自选		 双
StartDate 插入订单可以开始产生费用的日期。 开始日期必须晚于当前日期。

该日期存储在协调世界时 (UTC) 中。 仅使用指定字符串的月份、日和年。 如果指定日期的小时、分钟和秒，它们将被忽略。

有关日期和时间格式的信息，请参阅基元 XML 数据类型中的 dateTime 条目。

加： 只读
更新： 自选。 如果 InsertionOrder 的 Status 元素为 NotStarted，则只能通过此元素更新开始日期。 如果开始日期已过，则无法更改它。		 dateTime

要求

服务： CustomerBillingService.svc v13
Namespace： https://bingads.microsoft.com/Customer/v13/Entities

使用者

InsertionOrder