共用方式為

InsertionOrderPendingChanges 數據物件 - 客戶計費

  • 發行項

定義物件，這個物件可用來管理已核准插入順序的變更。

如果 InsertionOrder 的 Status 元素設定為 PendingUserReview，則您無法透過 InsertionOrderPendingChanges 物件更新插入順序。 您一開始必須透過 InsertionOrder 的 Status 元素來核准、拒絕或取消。 一旦插入順序 Status 為 Active、Exhausted、Expired 或 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 僅供內部使用。

加： 唯讀
更新： 自選		 長
RequestedByUserId 最後一個要求變更插入順序之用戶的標識碼。

加： 唯讀
更新： 唯讀		 int
SpendCapAmount 此插入順序的預算。 預算是硬性限制。 當帳戶達到此限制且沒有其他插入順序可用時，帳戶的生命週期狀態值會設定為 [暫停]。

如果插入順序有無限制的預算，則此元素是空的。

加： 唯讀
更新： 自選		 雙
StartDate 插入順序可以開始產生費用的日期。 開始日期必須晚於目前的日期。

日期會儲存在國際標準時間 (UTC) 。 只會使用指定字串的月份、日期和年份。 如果您指定日期的小時、分鐘和秒，則會忽略它們。

如需日期和時間格式的相關信息，請參閱基本 XML 數據類型中的 dateTime 專案。

加： 唯讀
更新： 自選。 只有在 InsertionOrder 的 Status 元素為 NotStarted 時，才能透過此元素更新開始日期。 如果開始日期已經過，您就無法加以變更。		 dateTime

需求

服務： CustomerBillingService.svc v13
命名空間： https://bingads.microsoft.com/Customer/v13/Entities

消費者

InsertionOrder