通过

谓词数据对象 - 客户计费

  • 项目

定义使用搜索操作之一返回的插入顺序列表的谓词，例如 SearchCoupons 或 SearchInsertionOrders。

语法

<xs:complexType name="Predicate" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Field" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Operator" type="tns:PredicateOperator" />
    <xs:element minOccurs="0" name="Value" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

元素

Predicate 对象具有以下元素：Field、Operator、Value。

元素 说明 数据类型
字段 要搜索的对象元素的名称。

有关可能的值，请参阅 SearchInsertionOrders 操作。		 string
运算符 定义字段和值之间的关系。 PredicateOperator
值 在指定字段中搜索的字符串。

此字符串的长度必须为 4 或更大，除非字段设置为 MarketCountry 或 MarketLanguage。		 string

备注

下面详细介绍了每个服务操作的谓词对象支持的 Field 元素和 Operator 元素。

SearchCoupons 谓词

对于 SearchCoupons 服务操作，以下是 Predicate 对象的 Field 元素和 Operator 元素。

字段 运算符 说明
CustomerId 等于 使用此字段按优惠券类的所有者客户进行搜索。

此谓词字段是必需的。
CouponClassName 等于 使用此字段按优惠券类名称进行搜索。
IsRedeemed 等于 使用此字段按优惠券的 IsRedeemed 元素进行搜索。
StartDate GreaterThanEquals 使用此字段可按开始日期优惠券进行搜索。

该日期存储在协调世界时 (UTC) 中。 仅使用指定字符串的月份、日和年份进行搜索。 如果指定日期的小时、分钟和秒，它们将被忽略。

有关日期和时间格式的信息，请参阅 基元 XML 数据类型中的 dateTime 条目。

SearchInsertionOrders Predicates

对于 SearchInsertionOrders 服务操作，以下是 Predicate 对象的 Field 元素和 Operator 元素。

字段 运算符 说明
AccountId 等于 使用此字段按插入订单的帐户标识符进行搜索。

此谓词字段是必需的。
EndDate GreaterThanEquals

LessThanEquals		 使用此字段可按插入订单结束日期进行搜索。 该日期存储在协调世界时 (UTC) 中。 仅使用指定字符串的月份、日和年份进行搜索。 如果指定日期的小时、分钟和秒，它们将被忽略。

有关日期和时间格式的信息，请参阅 基元 XML 数据类型中的 dateTime 条目。
InsertionOrderId 等于

位置		 使用此字段按插入订单 ID 进行搜索。
StartDate GreaterThanEquals

LessThanEquals		 使用此字段按插入顺序开始日期进行搜索。

该日期存储在协调世界时 (UTC) 中。 仅使用指定字符串的月份、日和年份进行搜索。 如果指定日期的小时、分钟和秒，它们将被忽略。

有关日期和时间格式的信息，请参阅 基元 XML 数据类型中的 dateTime 条目。

要求

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

使用者

SearchCoupons
SearchInsertionOrders