InsertionOrderPendingChanges データ オブジェクト - 顧客の課金

  • [アーティクル]

承認された挿入順序の変更を管理するために使用できるオブジェクトを定義します。

InsertionOrder の Status 要素が PendingUserReview に設定されている場合、InsertionOrderPendingChanges オブジェクトを使用して挿入順序を更新することはできません。 最初に、InsertionOrder の Status 要素を使用して承認、辞退、または取り消す必要があります。 挿入順序 の状態 が [アクティブ]、[枯渇]、[期限切れ]、または [未開始] になったら、 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
名前 空間： https://bingads.microsoft.com/Customer/v13/Entities

Used By

InsertionOrder