Aracılığıyla paylaş


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