Freigeben über

InsertionOrderPendingChanges-Datenobjekt – Kundenabrechnung

  • Artikel

Definiert ein -Objekt, das zum Verwalten von Änderungen für eine genehmigte Einfügereihenfolge verwendet werden kann.

Wenn das Status-Element der InsertionOrder auf PendingUserReview festgelegt ist, können Sie die Einfügereihenfolge nicht über das InsertionOrderPendingChanges-Objekt aktualisieren. Sie müssen zunächst über das Status-Element der InsertionOrder genehmigen, ablehnen oder abbrechen. Sobald der Status der Einfügereihenfolge Aktiv, Erschöpft, Abgelaufen oder NotStarted lautet, können Sie entweder neue Änderungen vornehmen oder die aktuellen ausstehenden Änderungen über das InsertionOrderPendingChanges-Objekt genehmigen oder ablehnen.

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

Elemente

Das InsertionOrderPendingChanges-Objekt verfügt über die folgenden Elemente: ChangeStatus, Comment, EndDate, ModifiedDateTime, Name, NotificationThreshold, PurchaseOrder, ReferenceId, RequestedByUserId, SpendCapAmount, StartDate.

Element Beschreibung Datentyp
ChangeStatus Kann verwendet werden, um die Einfügereihenfolge mit ausstehenden Änderungen zu akzeptieren oder abzulehnen.

Wenn Sie UpdateInsertionOrder aufrufen, können Sie entweder dieses ChangeStatus-Element festlegen oder andere Elemente dieses Objekts ändern, aber Sie können die status nicht parallel zu anderen Eigenschaftenaktualisierungen ändern.		 InsertionOrderPendingChangesStatus
Kommentar Eine Beschreibung der Einfügereihenfolge. Die Beschreibung ist auf 100 Zeichen beschränkt.

Hinzufügen: Schreibgeschützt
Aktualisieren: Wahlfrei		 Zeichenfolge
EndDate Das Datum, an dem die Einfügereihenfolge abläuft. Das Enddatum muss nach dem Startdatum sein.

Das Datum wird in koordinierter Weltzeit (UTC) gespeichert. Es werden nur der Monat, der Tag und das Jahr der angegebenen Zeichenfolge verwendet. Wenn Sie die Stunde, Minuten und Sekunden eines Datums angeben, werden diese ignoriert.

Informationen zum Format von Datum und Uhrzeit finden Sie unter dateTime-Eintrag in Primitive XML-Datentypen.

Dieses Element ist leer, wenn die Einfügereihenfolge kein Enddatum aufweist.

Hinzufügen: Schreibgeschützt
Aktualisieren: Wahlfrei		 dateTime
ModifiedDateTime Das Datum und die Uhrzeit der Übermittlung der Änderungsanforderung für die Einfügereihenfolge.

Das Datum wird in koordinierter Weltzeit (UTC) gespeichert.

Informationen zum Format von Datum und Uhrzeit finden Sie unter dateTime-Eintrag in Primitive XML-Datentypen.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 dateTime
Name Der Anzeigename, der verwendet werden kann, um auf diese Einfügereihenfolge zu verweisen.

Der Name darf maximal 100 Zeichen enthalten.

Der Name muss im Vergleich zu anderen Einfügeaufträgen für den Kunden nicht eindeutig sein.

Hinzufügen: Schreibgeschützt
Aktualisieren: Wahlfrei		 Zeichenfolge
NotificationThreshold Ein Prozentsatz des ausgegebenen Budgets. Geben Sie den Prozentsatz als Wert zwischen 0 und 100 an. Die Benachrichtigung wird gesendet, wenn der Schwellenwert erreicht wird. Wenn Sie beispielsweise den Schwellenwert auf 70 festlegen, sendet der Abrechnungsdienst eine Benachrichtigung, wenn Sie 70 Prozent des Budgets ausgegeben haben.

Wenn Sie keine Benachrichtigung erhalten möchten, legen Sie auf NULL fest.

Für die interne Verwendung reserviert.

Hinzufügen: Schreibgeschützt
Aktualisieren: Wahlfrei		 doppelt
PurchaseOrder Ein Bestellwert, der verwendet werden kann, um auf diesen Einfügeauftrag in monatlichen Rechnungen zu verweisen. Dieser Wert wird als Bestellung in den monatlichen Rechnungen ausgegeben.

Die Bestellung darf maximal 50 Zeichen enthalten.

Hinzufügen: Schreibgeschützt
Aktualisieren: Wahlfrei		 Zeichenfolge
ReferenceId Wird nur intern verwendet.

Hinzufügen: Schreibgeschützt
Aktualisieren: Wahlfrei		 lang
RequestedByUserId Ein Bezeichner des letzten Benutzers, der eine Änderung an der Einfügereihenfolge anzufordern hat.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 int
SpendCapAmount Das Budget für diese Einfügereihenfolge. Das Budget ist eine harte Grenze. Wenn das Konto diesen Grenzwert erreicht und keine weitere Einfügereihenfolge verfügbar ist, wird der Lebenszyklus status Wert des Kontos auf Anhalten festgelegt.

Dieses Element ist leer, wenn der Einfügeauftrag über ein unbegrenztes Budget verfügt.

Hinzufügen: Schreibgeschützt
Aktualisieren: Wahlfrei		 doppelt
StartDate Das Datum, an dem der Einfügeauftrag mit dem Anrechnen von Gebühren beginnen kann. Das Startdatum muss nach dem aktuellen Datum sein.

Das Datum wird in koordinierter Weltzeit (UTC) gespeichert. Es werden nur der Monat, der Tag und das Jahr der angegebenen Zeichenfolge verwendet. Wenn Sie die Stunde, Minuten und Sekunden eines Datums angeben, werden diese ignoriert.

Informationen zum Format von Datum und Uhrzeit finden Sie unter dateTime-Eintrag in Primitive XML-Datentypen.

Hinzufügen: Schreibgeschützt
Aktualisieren: Wahlfrei. Sie können das Startdatum über dieses Element nur aktualisieren, wenn das Status-Element der InsertionOrder den Wert NotStarted aufweist. Wenn das Startdatum bereits abgelaufen ist, können Sie ihn nicht ändern.		 dateTime

Anforderungen

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

Verwendet von

InsertionOrder