Partager via

Objet de données InsertionOrderPendingChanges - Facturation client

  • Article

Définit un objet qui peut être utilisé pour gérer les modifications d’un ordre d’insertion approuvé.

Si l’élément Status de l’InsertionOrder est défini sur PendingUserReview, vous ne pouvez pas mettre à jour l’ordre d’insertion via l’objet InsertionOrderPendingChanges . Vous devez initialement approuver, refuser ou annuler via l’élément Status de l’InsertionOrder. Une fois que l’état de l’ordre d’insertion est Actif, Épuisé, Expiré ou NotStarted, vous pouvez apporter de nouvelles modifications ou approuver ou refuser les modifications en attente actuelles via l’objet InsertionOrderPendingChanges .

Syntaxe

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

Éléments

L’objet InsertionOrderPendingChanges contient les éléments suivants : ChangeStatus, Comment, EndDate, ModifiedDateTime, Name, NotificationThreshold, PurchaseOrder, ReferenceId, RequestedByUserId, SpendCapAmount, StartDate.

Élément Description Type de données
ChangeStatus Peut être utilisé pour accepter ou refuser l’ordre d’insertion en attente de modifications.

Lorsque vous appelez UpdateInsertionOrder, vous pouvez définir cet élément ChangeStatus ou modifier d’autres éléments de cet objet, mais vous ne pouvez pas modifier le status en parallèle avec d’autres mises à jour de propriétés.		 InsertionOrderPendingChangesStatus
Commentaire Description de l’ordre d’insertion. La description est limitée à 100 caractères.

Ajouter: En lecture seule
Mettre à jour: Optionnel		 chaîne
EndDate Date d’expiration de l’ordre d’insertion. La date de fin doit être postérieure à la date de début.

La date est stockée en temps universel coordonné (UTC). Seuls le mois, le jour et l’année de la chaîne spécifiée sont utilisés. Si vous spécifiez l’heure, les minutes et les secondes d’une date, ils seront ignorés.

Pour plus d’informations sur le format de la date et de l’heure, consultez l’entrée dateTime dans Types de données XML primitifs.

Cet élément est vide si l’ordre d’insertion n’a pas de date de fin.

Ajouter: En lecture seule
Mettre à jour: Optionnel		 dateTime
ModifiedDateTime Date et heure auxquelles la demande de modification d’ordre d’insertion a été envoyée.

La date est stockée en temps universel coordonné (UTC).

Pour plus d’informations sur le format de la date et de l’heure, consultez l’entrée dateTime dans Types de données XML primitifs.

Ajouter: En lecture seule
Mettre à jour: En lecture seule		 dateTime
Nom Nom convivial qui peut être utilisé pour référencer cet ordre d’insertion.

Le nom peut contenir un maximum de 100 caractères.

Le nom n’a pas besoin d’être unique par rapport à d’autres commandes d’insertion pour le client.

Ajouter: En lecture seule
Mettre à jour: Optionnel		 chaîne
NotificationThreshold Pourcentage du budget qui a été dépensé. Spécifiez le pourcentage sous la forme d’une valeur comprise entre 0 et 100. Une notification est envoyée lorsque le seuil est atteint. Par exemple, si vous définissez le seuil sur 70, le service de facturation envoie une notification lorsque vous avez dépensé 70 % du budget.

Si vous ne souhaitez pas recevoir de notification, définissez sur NULL.

Réservé à une utilisation interne.

Ajouter: En lecture seule
Mettre à jour: Optionnel		 Double
PurchaseOrder Valeur de bon de commande qui peut être utilisée pour référencer cet ordre d’insertion dans des factures mensuelles. Cette valeur est imprimée en tant que bon de commande dans les factures mensuelles.

Le bon de commande peut contenir un maximum de 50 caractères.

Ajouter: En lecture seule
Mettre à jour: Optionnel		 chaîne
ReferenceId Utilisation interne uniquement.

Ajouter: En lecture seule
Mettre à jour: Optionnel		 Long
RequestedByUserId Identificateur du dernier utilisateur à demander une modification de l’ordre d’insertion.

Ajouter: En lecture seule
Mettre à jour: En lecture seule		 int
SpendCapAmount Budget de cet ordre d’insertion. Le budget est une limite difficile. Lorsque le compte atteint cette limite et qu’aucun autre ordre d’insertion n’est disponible, la valeur du cycle de vie status du compte est définie sur Suspendre.

Cet élément est vide si l’ordre d’insertion a un budget illimité.

Ajouter: En lecture seule
Mettre à jour: Optionnel		 Double
Startdate Date à laquelle l’ordre d’insertion peut commencer à accumuler des frais. La date de début doit être ultérieure à la date actuelle.

La date est stockée en temps universel coordonné (UTC). Seuls le mois, le jour et l’année de la chaîne spécifiée sont utilisés. Si vous spécifiez l’heure, les minutes et les secondes d’une date, ils seront ignorés.

Pour plus d’informations sur le format de la date et de l’heure, consultez l’entrée dateTime dans Types de données XML primitifs.

Ajouter: En lecture seule
Mettre à jour: Optionnel. Vous pouvez uniquement mettre à jour la date de début via cet élément si l’élément Status de l’InsertionOrder est NotStarted. Si la date de début est déjà dépassée, vous ne pouvez pas la modifier.		 dateTime

Configuration requise

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

Utilisé par

InsertionOrder