Objeto de datos de predicado: administración de clientes
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 |
Observaciones
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. |
Predicados de SearchClientLinks
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. |
| Nombre_cliente | 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
Nombres: https://bingads.microsoft.com/Customer/v13/Entities
Usado por
SearchAccounts
SearchClientLinks
SearchCustomers
SearchUserInvitations