Koşul Veri Nesnesi - Müşteri Yönetimi
Arama işlemlerinden biri kullanılarak istenen varlıkların listesi için searchAccounts, SearchClientLinks, SearchCustomers veya SearchUserInvitations gibi bir koşul tanımlar.
Sözdizimi
<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>
Öğe
Koşul nesnesi şu öğelere sahiptir: Alan, İşleç, Değer.
| Öğe | Açıklama | Veri Türü |
|---|---|---|
| Alan | Aradığınız nesnenin öğesinin adı. Olası değerler için aşağıdaki Açıklamalar'a bakın. |
dize |
| Operatör | Alan ile değer arasındaki ilişkiyi tanımlar. | PredicateOperator |
| Değer | Belirtilen alanda aranacak dize. Alan MarketCountry veya MarketLanguage olarak ayarlanmadığı sürece bu dizenin uzunluğu dört veya daha büyük olmalıdır. |
dize |
Açıklamalar
Her hizmet işlemi için bir Koşul nesnesinin desteklenen Alan öğesi ve İşleç öğeleri aşağıda ayrıntılı olarak verilmiştir.
SearchAccounts Önkoşulları
SearchAccounts hizmeti işlemi için, aşağıdakiler bir Koşul nesnesinin Field öğesi ve İşleç öğeleridir.
| Alan | Operatör | Açıklama |
|---|---|---|
| AccountId | Eşit -tir İçinde |
ReklamverenHesap'ın Id öğesinde arama yapmak için bu alanı kullanın. |
| AccountLifeCycleStatus | Eşit -tir |
ReklamverenHesap'ın AccountLifeCycleStatus öğesinde arama yapmak için bu alanı kullanın. Olası değerler "Etkin", "Taslak", "Etkin Değil", "Duraklat", "Beklemede" ve "Askıya Alındı" değerlerini içerir. - "Etkin" durumuna göre hesap istediğinizde, işlem AccountLifeCycleStatus etkin olarak ayarlanmış hesapları döndürür. İşlem ayrıca, PauseReason değerinin 2 olduğu (faturalama hizmeti hesabı duraklattı) Pause olarak ayarlanmış AccountLifeCycleStatus olan hesapları döndürür. - Hesapları "Duraklat" durumuna göre istediğinizde, işlem, PauseReason değerinin 1 (kullanıcı hesabı duraklattı) veya 4 (kullanıcı ve faturalama hizmeti hesabı duraklattı) olduğu, AccountLifeCycleStatus'unPause olarak ayarlandığı hesapları döndürür. |
| AccountName | Içerir Eşit -tir |
ReklamverenHesap'ın Name öğesinde arama yapmak için bu alanı kullanın. |
| AccountNumber | Içerir Eşit -tir İçinde |
ReklamverenHesap'ın Sayı öğesinde arama yapmak için bu alanı kullanın. |
| CustomerId | Eşit -tir | Bu alanı, Müşterinin Kimlik öğesinde arama yapmak için kullanın. |
| UserId | Eşit -tir | Kullanıcı'nın UserId öğesinde arama yapmak için bu alanı kullanın. |
SearchClientLinks Önkoşulları
SearchClientLinks hizmeti işlemi için, aşağıdakiler bir Koşul nesnesinin Field öğesi ve İşleci öğeleridir.
| Alan | Operatör | Açıklama |
|---|---|---|
| ClientAccountId | Eşit -tir İçinde |
İstemci reklamveren hesabı tanımlayıcısı tarafından reklamveren hesabı ClientLink nesneleri için arama yapma. |
| ClientCustomerId | Eşit -tir İçinde |
İstemci müşteri tanımlayıcısı tarafından customer ClientLink nesnelerini arayın. |
| DirectManagingCustomerId | Eşit -tir | Kuruluşun yönetici müşteri tanımlayıcısı tarafından hem müşteri hem de reklamveren hesabı ClientLink nesnelerini arayın. Diğer müşteriler de istemci müşteriye bağlanırsa, sonuçlar bu istemci bağlantılarını içermez. |
| ManagingCustomerId | Eşit -tir | Ajansın yönetici müşteri tanımlayıcısı tarafından reklamveren hesabı ClientLink nesnelerini arayın. Diğer müşteriler de müşteri reklamveren hesabına bağlanırsa sonuçlar bu istemci bağlantılarını içerir. Bu koşul değeri DirectManagingCustomerId koşuluna göre kullanım dışı bırakılmıştır. |
SearchClientLinks için aşağıdaki koşul kurallarını lütfen unutmayın.
- Hem DirectManagingCustomerId hem de ManagingCustomerId ekleyemezsiniz.
- Hem ClientAccountId hem de ClientCustomerId ekleyemezsiniz.
- Aynı hizmet çağrısına hem ClientAccountId hem de ManagingCustomerId koşullarını eklerseniz, ManagingCustomerId yok sayılır.
- Aynı hizmet çağrısına hem ClientCustomerId hem de DirectManagingCustomerId koşullarını eklerseniz, sonuçlar yalnızca her iki koşul koşulunu da karşılayan müşteri istemci bağlantılarını içerir.
- Aynı hizmet çağrısına hem ClientAccountId hem de DirectManagingCustomerId koşullarını eklerseniz, sonuçlar yalnızca her iki koşul koşulunu da karşılayan reklamveren hesabı istemci bağlantılarını içerir.
SearchCustomers Koşulu
SearchCustomers hizmeti işlemi için, aşağıdakiler bir Koşul nesnesinin Desteklenen Alan öğesi ve İşleç öğeleridir.
| Alan | Operatör | Açıklama |
|---|---|---|
| AccountId | Eşit -tir | ReklamverenHesap'ın Id öğesinde arama yapmak için bu alanı kullanın. |
| AccountName | Içerir Eşit -tir |
ReklamverenHesap'ın Name öğesinde arama yapmak için bu alanı kullanın. |
| AccountNumber | Içerir Eşit -tir |
ReklamverenHesap'ın Sayı öğesinde arama yapmak için bu alanı kullanın. |
| ApplicationScope | Eşit -tir | Yalnızca dahili kullanım için. |
| CreatedDate | GreaterThanEquals LessThanEquals |
Müşterinin oluşturulduğu veya kaydolduğunda tarihi aramak için bu alanı kullanın. Tarih Eşgüdümlü Evrensel Saat (UTC) içinde depolanır. Arama için yalnızca belirtilen dizenin ay, gün ve yılı kullanılır. Bir tarihin saatini, dakikalarını ve saniyelerini belirtirseniz bunlar yoksayılır. Tarih ve saatin biçimi hakkında bilgi için temel XML Veri Türleri'ndeki dateTime girdisine bakın. |
| CustomerId | Eşit -tir İçinde |
Bu alanı, Müşterinin Kimlik öğesinde arama yapmak için kullanın. |
| CustomerName | Içerir Eşit -tir |
Bu alanı, Müşterinin Name öğesinde arama yapmak için kullanın. |
| MarketCountry | Eşit -tir |
Müşterinin MarketCountry öğesini aramak için bu alanı kullanın. MarketCountry ve MarketLanguage koşul alanları gerekli değildir; ancak, herhangi biri belirtilirse her ikisi de gereklidir. |
| MarketLanguage | Eşit -tir |
Müşterinin MarketLanguage öğesini aramak için bu alanı kullanın. MarketCountry ve MarketLanguage koşul alanları gerekli değildir; ancak, herhangi biri belirtilirse her ikisi de gereklidir. |
| Kullanıcı adı | Eşit -tir | Bu alanı, Kullanıcının UserName öğesinde arama yapmak için kullanın. |
SearchUserInvitations Koşulları
SearchUserInvitations hizmeti işlemi için, aşağıdakiler bir Koşul nesnesinin Alan öğesi ve İşleç öğeleri desteklenir.
| Alan | Operatör | Açıklama |
|---|---|---|
| CustomerId | Eşit -tir | UserInvitation öğesinin CustomerId öğesini aramak için bu alanı kullanın. |
Gereksinimler
Hizmet: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13/Entities
Kullanan
AramaHesapları
SearchClientLinks
SearchCustomers
SearchUserInvitations