Prädikatdatenobjekt – Kundenverwaltung
Definiert ein Prädikat für die Liste der Entitäten, die mithilfe eines der Suchvorgänge angefordert werden, z. B. SearchAccounts, SearchClientLinks, SearchCustomers oder SearchUserInvitations.
<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>
Elemente
Das Prädikatobjekt verfügt über die folgenden Elemente: Field, Operator, Value.
| Element | Beschreibung | Datentyp |
|---|---|---|
| Feld | Der Name des Elements für das Objekt, das Sie suchen. Mögliche Werte finden Sie in den nachstehenden Hinweisen . |
Zeichenfolge |
| Operator | Definiert die Beziehung zwischen dem Feld und dem Wert. | PredicateOperator |
| Wert | Die Zeichenfolge, die im angegebenen Feld gesucht werden soll. Die Länge dieser Zeichenfolge muss vier oder höher sein, es sei denn, das Feld ist auf MarketCountry oder MarketLanguage festgelegt. |
Zeichenfolge |
Hinweise
Die unterstützten Field-Elemente und Operator-Elemente eines Prädikatobjekts für jeden Dienstvorgang werden unten ausführlich bereitgestellt.
SearchAccounts-Prädikate
Für den SearchAccounts-Dienstvorgang werden die folgenden Field-Elemente und Operator-Elemente eines Prädikatobjekts unterstützt.
| Feld | Operator | Beschreibung |
|---|---|---|
| AccountId | Gleich In |
Verwenden Sie dieses Feld, um das Id-Element des AdvertiserAccount zu durchsuchen. |
| AccountLifeCycleStatus | Gleich | Verwenden Sie dieses Feld, um das AccountLifeCycleStatus-Element des AdvertiserAccount zu durchsuchen. Mögliche Werte sind "Active", "Draft", "Inactive", "Pause", "Pending" und "Suspended". – Wenn Sie Konten durch "Active" status anfordern, gibt der Vorgang Konten zurück, deren AccountLifeCycleStatus auf Aktiv festgelegt ist. Der Vorgang gibt auch Konten zurück, bei denen AccountLifeCycleStatus auf Pause festgelegt ist, wobei der PauseReason-Wert 2 ist (der Abrechnungsdienst hat das Konto angehalten). - Wenn Sie Konten durch "Anhalten" status anfordern, gibt der Vorgang Konten zurück, bei denen AccountLifeCycleStatus auf Anhalten festgelegt ist, wobei der PauseReason-Wert 1 (der Benutzer hat das Konto angehalten) oder 4 (der Benutzer und der Abrechnungsdienst hat das Konto angehalten). |
| AccountName | Enthält Gleich |
Verwenden Sie dieses Feld, um das Name-Element des AdvertiserAccount zu durchsuchen. |
| AccountNumber | Enthält Gleich In |
Verwenden Sie dieses Feld, um das Number-Element des AdvertiserAccount zu durchsuchen. |
| CustomerId | Gleich | Verwenden Sie dieses Feld, um das Id-Element des Kunden zu durchsuchen. |
| UserId | Gleich | Verwenden Sie dieses Feld, um das UserId-Element des Benutzers zu durchsuchen. |
SearchClientLinks-Prädikate
Für den SearchClientLinks-Dienstvorgang werden die folgenden Field-Elemente und Operator-Elemente eines Prädikatobjekts unterstützt.
| Feld | Operator | Beschreibung |
|---|---|---|
| ClientAccountId | Gleich In |
Suchen Sie nach ClientLink-Objekten des Werbetreibendenkontos anhand des Kontobezeichners des Clientkunden. |
| ClientCustomerId | Gleich In |
Suchen Sie nach ClientLink-Objekten des Kunden nach der Client-Kunden-ID. |
| DirectManagingCustomerId | Gleich | Suchen Sie nach ClientLink-Objekten des Kunden- und Werbetreibendenkontos anhand der verwaltende Kunden-ID der Agentur. Wenn andere Kunden ebenfalls eine Verbindung mit dem Kunden herstellen, enthalten die Ergebnisse diese Clientlinks nicht. |
| ManagingCustomerId | Gleich | Suchen Sie nach ClientLink-Objekten des Advertiser-Kontos anhand der verwaltende Kunden-ID der Agentur. Wenn andere Kunden ebenfalls eine Verknüpfung mit dem Kundenkundenkonto herstellen, enthalten die Ergebnisse diese Clientlinks. Dieser Prädikatwert ist zugunsten des Prädikats DirectManagingCustomerId veraltet. |
Beachten Sie die folgenden Prädikatregeln für SearchClientLinks.
- Sie können nicht sowohl DirectManagingCustomerId als auch ManagingCustomerId einschließen.
- ClientAccountId und ClientCustomerId können nicht eingeschlossen werden.
- Wenn Sie sowohl ClientAccountId als auch ManagingCustomerId-Prädikate in denselben Dienstaufruf einschließen, wird ManagingCustomerId ignoriert.
- Wenn Sie sowohl ClientCustomerId- als auch DirectManagingCustomerId-Prädikate in den gleichen Dienstaufruf einschließen, enthalten die Ergebnisse nur Kundenclientlinks, die beide Prädikatbedingungen erfüllen.
- Wenn Sie sowohl ClientAccountId- als auch DirectManagingCustomerId-Prädikate in den gleichen Dienstaufruf einschließen, enthalten die Ergebnisse nur Clientlinks für Werbekundenkonten, die beide Prädikatbedingungen erfüllen.
SearchCustomers-Prädikate
Für den SearchCustomers-Dienstvorgang werden die folgenden Field-Elemente und Operator-Elemente eines Prädikatobjekts unterstützt.
| Feld | Operator | Beschreibung |
|---|---|---|
| AccountId | Gleich | Verwenden Sie dieses Feld, um das Id-Element des AdvertiserAccount zu durchsuchen. |
| AccountName | Enthält Gleich |
Verwenden Sie dieses Feld, um das Name-Element des AdvertiserAccount zu durchsuchen. |
| AccountNumber | Enthält Gleich |
Verwenden Sie dieses Feld, um das Number-Element des AdvertiserAccount zu durchsuchen. |
| ApplicationScope | Gleich | Ausschließlich für interne Zwecke. |
| CreatedDate | GreaterThanEquals LessThanEquals |
Verwenden Sie dieses Feld, um das Datum zu durchsuchen, an dem der Kunde erstellt oder registriert wurde. Das Datum wird in koordinierter Weltzeit (UTC) gespeichert. Nur der Monat, der Tag und das Jahr der angegebenen Zeichenfolge werden für die Suche verwendet. Wenn Sie die Stunde, Minuten und Sekunden eines Datums angeben, werden diese ignoriert. Informationen zum Format von Datum und Uhrzeit finden Sie unter dateTime-Eintrag in Primitive XML-Datentypen. |
| CustomerId | Gleich In |
Verwenden Sie dieses Feld, um das Id-Element des Kunden zu durchsuchen. |
| CustomerName | Enthält Gleich |
Verwenden Sie dieses Feld, um das Name-Element des Kunden zu durchsuchen. |
| MarketCountry | Gleich | Verwenden Sie dieses Feld, um das MarketCountry-Element des Kunden zu durchsuchen. Die Felder MarketCountry und MarketLanguage-Prädikat sind nicht erforderlich. Wenn jedoch beides angegeben ist, sind beide erforderlich. |
| MarketLanguage | Gleich | Verwenden Sie dieses Feld, um das MarketLanguage-Element des Kunden zu durchsuchen. Die Felder MarketCountry und MarketLanguage-Prädikat sind nicht erforderlich. Wenn jedoch beides angegeben ist, sind beide erforderlich. |
| UserName | Gleich | Verwenden Sie dieses Feld, um das UserName-Element des Benutzers zu durchsuchen. |
SearchUserInvitations-Prädikate
Für den SearchUserInvitations-Dienstvorgang werden die folgenden Field-Elemente und Operator-Elemente eines Prädikatobjekts unterstützt.
| Feld | Operator | Beschreibung |
|---|---|---|
| CustomerId | Gleich | Verwenden Sie dieses Feld, um das CustomerId-Element der UserInvitation zu durchsuchen. |
Anforderungen
Service: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13/Entities
Verwendet von
SearchAccounts
SearchClientLinks
SearchCustomers
SearchUserInvitations