Condividi tramite


Oggetto dati InsertionOrderPendingChanges - Fatturazione del cliente

Definisce un oggetto che può essere usato per gestire le modifiche per un ordine di inserimento approvato.

Se l'elemento Status dell'oggetto InsertionOrder è impostato su PendingUserReview, non è possibile aggiornare l'ordine di inserimento tramite l'oggetto InsertionOrderPendingChanges . È necessario approvare, rifiutare o annullare inizialmente tramite l'elemento Status dell'oggetto InsertionOrder. Quando lo stato dell'ordine di inserimento è Attivo, Esaurito, Scaduto o NotStarted, puoi apportare nuove modifiche o approvare o rifiutare le modifiche in sospeso correnti tramite l'oggetto InsertionOrderPendingChanges .

Sintassi

<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>

Elementi

L'oggetto InsertionOrderPendingChanges include gli elementi seguenti: ChangeStatus, Comment, EndDate, ModifiedDateTime, Name, NotificationThreshold, PurchaseOrder, ReferenceId, RequestedByUserId, SpendCapAmount, StartDate.

Elemento Descrizione Tipo di dati
ChangeStatus Può essere usato per accettare o rifiutare l'ordine di inserimento in attesa di modifiche.

Quando chiami UpdateInsertionOrder puoi impostare questo elemento ChangeStatus o modificare altri elementi di questo oggetto, ma non puoi modificare lo stato in parallelo con altri aggiornamenti delle proprietà.
InsertionOrderPendingChangesStatus
Comment Descrizione dell'ordine di inserimento. La descrizione è limitata a 100 caratteri.

Aggiungere: Sola lettura
Aggiornare: Opzionale
corda
EndDate Data di scadenza dell'ordine di inserimento. La data di fine deve essere successiva alla data di inizio.

La data viene archiviata in formato UTC (Coordinated Universal Time). Vengono usati solo il mese, il giorno e l'anno della stringa specificata. Se si specificano l'ora, i minuti e i secondi di una data, verranno ignorati.

Per informazioni sul formato della data e dell'ora, vedere la voce dateTime in Tipi di dati XML primitivi.

Questo elemento è vuoto se l'ordine di inserimento non ha una data di fine.

Aggiungere: Sola lettura
Aggiornare: Opzionale
dateTime
ModifiedDateTime Data e ora in cui è stata inviata la richiesta di modifica dell'ordine di inserimento.

La data viene archiviata in formato UTC (Coordinated Universal Time).

Per informazioni sul formato della data e dell'ora, vedere la voce dateTime in Tipi di dati XML primitivi.

Aggiungere: Sola lettura
Aggiornare: Sola lettura
dateTime
Nome Nome descrittivo che può essere usato per fare riferimento a questo ordine di inserimento.

Il nome può contenere un massimo di 100 caratteri.

Il nome non deve essere univoco rispetto ad altri ordini di inserimento per il cliente.

Aggiungere: Sola lettura
Aggiornare: Opzionale
corda
NotificationThreshold Percentuale del budget speso. Specificare la percentuale come valore compreso tra 0 e 100. La notifica viene inviata quando viene raggiunta la soglia. Ad esempio, se si imposta la soglia su 70, il servizio di fatturazione invia una notifica quando è stato speso il 70% del budget.

Se non si vuole ricevere la notifica, impostare su NULL.

Riservato per uso interno.

Aggiungere: Sola lettura
Aggiornare: Opzionale
doppio
PurchaseOrder Valore dell'ordine di acquisto che può essere usato per fare riferimento a questo ordine di inserimento nelle fatture mensili. Questo valore verrà stampato come ordine di acquisto nelle fatture mensili.

L'ordine di acquisto può contenere un massimo di 50 caratteri.

Aggiungere: Sola lettura
Aggiornare: Opzionale
corda
ReferenceId Solo per uso interno.

Aggiungere: Sola lettura
Aggiornare: Opzionale
long
RequestedByUserId Identificatore dell'ultimo utente per richiedere una modifica all'ordine di inserimento.

Aggiungere: Sola lettura
Aggiornare: Sola lettura
int
SpendCapAmount Budget per questo ordine di inserimento. Il budget è un limite rigido. Quando l'account raggiunge questo limite e non è disponibile un altro ordine di inserimento, il valore dello stato del ciclo di vita dell'account è impostato su Sospendi.

Questo elemento è vuoto se l'ordine di inserimento ha un budget illimitato.

Aggiungere: Sola lettura
Aggiornare: Opzionale
doppio
StartDate Data in cui l'ordine di inserimento può iniziare ad accumulare addebiti. La data di inizio deve essere successiva alla data corrente.

La data viene archiviata in formato UTC (Coordinated Universal Time). Vengono usati solo il mese, il giorno e l'anno della stringa specificata. Se si specificano l'ora, i minuti e i secondi di una data, verranno ignorati.

Per informazioni sul formato della data e dell'ora, vedere la voce dateTime in Tipi di dati XML primitivi.

Aggiungere: Sola lettura
Aggiornare: Opzionale. È possibile aggiornare la data di inizio tramite questo elemento solo se l'elemento Status di InsertionOrder è NotStarted. Se la data di inizio è già passata, non è possibile modificarla.
dateTime

Requisiti

Servizio: CustomerBillingService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13/Entities

Usato da

InsertionOrder