Compartir vía

Objeto de datos de predicado: administración de clientes

  • Artículo

Define un predicado para la lista de entidades solicitadas mediante una de las operaciones de búsqueda, por ejemplo SearchAccounts, SearchClientLinks, SearchCustomers o SearchUserInvitations.

Sintaxis

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

Elementos

El objeto Predicate tiene los siguientes elementos: Field, Operator, Value.

Elemento Descripción Tipo de datos
Campo Nombre del elemento para el objeto que está buscando.

Para ver los valores posibles, consulte los comentarios siguientes.		 string
Operador Define la relación entre el campo y el valor. PredicadoOperator
Valor Cadena que se va a buscar en el campo especificado.

La longitud de esta cadena debe ser cuatro o mayor, a menos que el campo esté establecido en MarketCountry o MarketLanguage.		 string

Comentarios

A continuación se proporcionan los elementos Field y Operator admitidos de un objeto Predicate para cada operación de servicio.

Predicados searchaccounts

Para la operación de servicio SearchAccounts , se admiten los siguientes elementos Field y Operator de un objeto Predicate.

Campo Operador Descripción
AccountId Igual a

En		 Use este campo para buscar en el elemento Id de AdvertiserAccount.
AccountLifeCycleStatus Igual a Use este campo para buscar en el elemento AccountLifeCycleStatus de AdvertiserAccount.

Entre los valores posibles se incluyen "Active", "Draft", "Inactive", "Pause", "Pending" y "Suspended".
- Cuando se solicitan cuentas por estado "Activo", la operación devuelve cuentas con AccountLifeCycleStatus establecido en Activo. La operación también devuelve cuentas con AccountLifeCycleStatus establecido en Pausa, donde el valor pauseReason es 2 (el servicio de facturación ha pausado la cuenta).
- Cuando se solicitan cuentas por el estado "Pausar", la operación devuelve las cuentas con AccountLifeCycleStatus establecido en Pausa, donde el valor pauseReason es 1 (el usuario ha pausado la cuenta) o 4 (el servicio de usuario y facturación ha pausado la cuenta).
AccountName Contains

Igual a		 Use este campo para buscar en el elemento Name de AdvertiserAccount.
AccountNumber Contains

Igual a

En		 Use este campo para buscar en el elemento Number de AdvertiserAccount.
CustomerId Igual a Use este campo para buscar en el elemento Id del cliente.
UserId Igual a Use este campo para buscar en el elemento UserId del usuario.

Para la operación de servicio SearchClientLinks , se admiten los siguientes elementos Field y Operator de un objeto Predicate.

Campo Operador Descripción
ClientAccountId Igual a

En		 Busque los objetos ClientLink de la cuenta de anunciante por el identificador de cuenta de anunciante del cliente.
ClientCustomerId Igual a

En		 Busque objetos ClientLink del cliente por el identificador de cliente.
DirectManagingCustomerId Igual a Busque los objetos ClientLink de la cuenta de cliente y anunciante por el identificador de cliente de administración de la agencia. Si otros clientes también se vinculan al cliente cliente, los resultados no incluirán esos vínculos de cliente.
ManagingCustomerId Igual a Busque objetos ClientLink de la cuenta de anunciante según el identificador de cliente de administración de la agencia. Si otros clientes también vinculan a la cuenta de anunciante del cliente, los resultados incluirán esos vínculos de cliente. Este valor de predicado está en desuso en favor del predicado DirectManagingCustomerId.

Tenga en cuenta las siguientes reglas de predicado para SearchClientLinks.

  • No puede incluir DirectManagingCustomerId y ManagingCustomerId.
  • No puede incluir ClientAccountId y ClientCustomerId.
  • Si incluye los predicados ClientAccountId y ManagingCustomerId en la misma llamada de servicio, se omitirá ManagingCustomerId.
  • Si incluye los predicados ClientCustomerId y DirectManagingCustomerId en la misma llamada de servicio, los resultados solo incluirán vínculos de cliente de cliente que cumplan ambas condiciones de predicado.
  • Si incluye los predicados ClientAccountId y DirectManagingCustomerId en la misma llamada de servicio, los resultados solo incluirán vínculos de cliente de cuenta de anunciante que cumplan ambas condiciones de predicado.

Predicados de SearchCustomers

Para la operación de servicio SearchCustomers , se admiten los siguientes elementos Field y Operator de un objeto Predicate.

Campo Operador Descripción
AccountId Igual a Use este campo para buscar en el elemento Id de AdvertiserAccount.
AccountName Contains

Igual a		 Use este campo para buscar en el elemento Name de AdvertiserAccount.
AccountNumber Contains

Igual a		 Use este campo para buscar en el elemento Number de AdvertiserAccount.
ApplicationScope Igual a Únicamente para uso interno.
CreatedDate GreaterThanEquals

LessThanEquals		 Use este campo para buscar la fecha en que se creó o registró el cliente.

La fecha se almacena en hora universal coordinada (UTC). Solo se usan el mes, el día y el año de la cadena especificada para la búsqueda. Si especifica la hora, los minutos y los segundos de una fecha, se omitirán.

Para obtener información sobre el formato de la fecha y hora, vea la entrada dateTime en Tipos de datos XML primitivos.
CustomerId Igual a

En		 Use este campo para buscar en el elemento Id del cliente.
CustomerName Contains

Igual a		 Use este campo para buscar en el elemento Name del cliente.
MarketCountry Igual a Use este campo para buscar en el elemento MarketCountry del cliente.

Los campos de predicado MarketCountry y MarketLanguage no son necesarios; sin embargo, si se especifica cualquiera de ellas, ambos son necesarios.
MarketLanguage Igual a Use este campo para buscar en el elemento MarketLanguage del cliente.

Los campos de predicado MarketCountry y MarketLanguage no son necesarios; sin embargo, si se especifica cualquiera de ellas, ambos son necesarios.
UserName Igual a Use este campo para buscar en el elemento UserName del usuario.

Predicados SearchUserInvitations

Para la operación de servicio SearchUserInvitations , se admiten los siguientes elementos Field y Operator de un objeto Predicate.

Campo Operador Descripción
CustomerId Igual a Use este campo para buscar en el elemento CustomerId de UserInvitation.

Requisitos

Servicio: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13/Entities

Usado por

SearchAccounts
SearchClientLinks
SearchCustomers
SearchUserInvitations