通过

优惠券数据对象 - 客户计费

  • 项目

定义优惠券。

语法

<xs:complexType name="Coupon" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="CouponCode" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ClassName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="CouponType" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Amount" type="xs:double" />
    <xs:element minOccurs="0" name="SpendThreshold" type="xs:double" />
    <xs:element minOccurs="0" name="CurrencyCode" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="PercentOff" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="ActiveDuration" nillable="true" type="xs:int" />
    <xs:element minOccurs="0" name="ExpirationDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="EndDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="SendToEmail" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="SendToDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="IsRedeemed" type="xs:boolean" />
    <xs:element minOccurs="0" name="RedemptionInfo" nillable="true" type="tns:CouponRedemption" />
    <xs:element minOccurs="0" name="ClaimInfo" nillable="true" type="tns:CouponClaimInfo">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>

元素

优惠券对象具有以下元素：ActiveDuration、Amount、ClaimInfo、ClassName、CouponCode、CouponType、CurrencyCode、EndDate、ExpirationDate、IsRedeemed、PercentOff、RedemptionInfo、SendToDate、SendToEmail、SpendThreshold、StartDate。

元素 说明 数据类型
ActiveDuration 自优惠券兑换以来的有效天数。

这些天之后，无法使用优惠券。		 int
Amount 优惠券的值量。

CurrencyCode 元素确定货币。		 双
ClaimInfo 声明的 AccountId、 AccountNumber 和 ClaimDate 。 CouponClaimInfo
ClassName 从中优惠券的类名称。 string
CouponCode 可用于兑换优惠券的代码。 string
CouponType 优惠券的类型。

支持的类型包括：
收购：获取优惠券用于获取新客户。 只有新客户才能兑换此优惠券。
保留： 新客户和现有客户都可以使用保留优惠券。		 string
CurrencyCode 优惠券金额和支出阈值的货币。

有关可能的值，请参阅 货币。		 string
EndDate 可兑换优惠券的最后日期。 dateTime
ExpirationDate 优惠券到期日期。

在此日期之后，无法使用优惠券。		 dateTime
IsRedeemed 是否已兑换优惠券。

如果已兑换优惠券，则值为 true，否则值为 false。		 boolean
PercentOff 优惠券值的百分比。

这仅适用于百分比优惠券。
例如，10.0 表示 10% 的折扣。		 双
RedemptionInfo 包含兑换和使用详细信息。

仅当优惠券兑换账单给优惠券所有者客户的帐户时才返回。		 CouponRedemption
SendToDate DispatchCoupons 操作通过电子邮件发送优惠券的日期。 dateTime
SendToEmail DispatchCoupons 操作已通过电子邮件发送优惠券的电子邮件地址。 string
SpendThreshold 在帐户的支出达到此阈值（从兑换优惠券起）之前，不能使用优惠券。

CurrencyCode 元素确定货币。		 双
StartDate 优惠券不能在开始日期之前兑换。 dateTime

要求

服务： CustomerBillingService.svc v13
Namespace： https://bingads.microsoft.com/Customer/v13/Entities

使用者

SearchCoupons