FindAccountsOrCustomersInfo Hizmeti İşlemi - Müşteri Yönetimi

Makale
12/21/2023

Belirtilen filtre ölçütlerine uyan hesapların ve müşterilerin listesini alır.

İstek Öğeleri

FindAccountsOrCustomersInfoRequest nesnesi, hizmet işlemi isteğinin gövde ve üst bilgi öğelerini tanımlar. Öğelerin İstek SOAP'sinde gösterildiği gibi aynı sırada olması gerekir.

Not

Aşağıda aksi belirtilmedikçe, tüm istek öğeleri gereklidir.

İstek Gövdesi Öğeleri

Öğe	Açıklama	Veri Türü
Filtrele	Hesap ve müşteri listesini filtrelemek için kullanılacak ölçüt. Bir hesap adı, hesap numarası veya müşteri adı belirtebilirsiniz. Filtre değeri kısmi veya tam bir ad veya sayı içerebilir. Ad veya sayı belirtilen filtre değeriyle başlıyorsa işlem sonucuna hesabı veya müşteriyi içerir. İşlem, filtre değerinizi ad veya sayıyla karşılaştırdığında büyük/küçük harfe duyarlı olmayan bir karşılaştırma gerçekleştirir. Örneğin, filtre değeri olarak "t" belirtirseniz, listede adları "t" veya "T" ile başlayan hesaplar ve müşteriler yer alır. İşlem önce filtre ölçütlerine uyan hesaplar için filtre uygular. Filtre ölçütüyle eşleşen hesap sayısı belirtilen TopN değerinden küçükse, işlem adı filtre ölçütlerine uyan müşterileri arar. Bu öğeyi boş bir dizeye ayarlamak , GetAccountsInfo'nun çağrılmasıyla ve ardından GetCustomersInfo'nun çağrılmasıyla aynıdır.	Dize
ReturnAdditionalFields	Döndürülen her hesaba eklenmesini istediğiniz ek özelliklerin listesi. Ek alan değerleri, Müşteri Yönetimi API'sinin geçerli sürümünü kullanarak en son özellikleri almanıza olanak tanır ve sonraki sürümde karşılık gelen öğeler varsayılan olarak eklenir. Bu istek öğesi isteğe bağlıdır.	AccountAdditionalField
Topn	Sonuçta döndürülecek hesap sayısını belirten sıfır olmayan pozitif bir tamsayı. 1 ile 5.000 arasında bir değer belirtmeniz gerekir.	Int

İstek Üst Bilgisi Öğeleri

Öğe	Açıklama	Veri Türü
AuthenticationToken	Microsoft Advertising hesaplarına izinleri olan bir kullanıcının kimlik bilgilerini temsil eden OAuth erişim belirteci. Daha fazla bilgi için bkz. OAuth ile kimlik doğrulaması.	Dize
DeveloperToken	Bing Ads API'sine erişmek için kullanılan geliştirici belirteci. Daha fazla bilgi için bkz . Geliştirici Belirteci Alma.	Dize
Password	Bu öğe iç kullanım için ayrılmıştır ve API'nin gelecekteki bir sürümünden kaldırılacaktır. Kullanıcı kimlik bilgilerini ayarlamak için AuthenticationToken öğesini kullanmanız gerekir.	Dize
Username	Bu öğe iç kullanım için ayrılmıştır ve API'nin gelecekteki bir sürümünden kaldırılacaktır. Kullanıcı kimlik bilgilerini ayarlamak için AuthenticationToken öğesini kullanmanız gerekir.	Dize

Yanıt Öğeleri

FindAccountsOrCustomersInfoResponse nesnesi, hizmet işlemi yanıtının gövde ve üst bilgi öğelerini tanımlar. Öğeler , Yanıt SOAP'sinde gösterildiği gibi aynı sırada döndürülür.

Yanıt Gövdesi Öğeleri

Öğe	Açıklama	Veri Türü
AccountInfoWithCustomerData	Hesapların ve müşterilerin belirtilen filtre ölçütlerine uyan AccountInfoWithCustomerData nesnelerinin listesi. Nesneler, hesabı ve müşteriyi tanımlayan bilgiler içerir. Listedeki bir hesabın tüm ayrıntılarını almak için AccountInfoWithCustomerData nesnesinin AccountId öğesine erişin ve GetAccount işlemini çağırmak için kullanın. Listedeki bir müşterinin tüm ayrıntılarını almak için AccountInfoWithCustomerData nesnesinin CustomerId öğesine erişin ve GetCustomer'ı çağırmak için kullanın.	AccountInfoWithCustomerData dizisi

Yanıt Üst Bilgisi Öğeleri

Öğe	Açıklama	Veri Türü
TrackingId	API çağrısının ayrıntılarını içeren günlük girdisinin tanımlayıcısı.	Dize

SOAP isteme

Bu şablon, SOAP isteği için gövde ve üst bilgi öğelerinin sırasını gösteren bir araç tarafından oluşturulmuştur. Bu hizmet işlemiyle kullanabileceğiniz desteklenen türler için yukarıdaki İstek Gövdesi Öğeleri başvurusuna bakın.

<s:Envelope xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/Customer/v13">
    <Action mustUnderstand="1">FindAccountsOrCustomersInfo</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <FindAccountsOrCustomersInfoRequest xmlns="https://bingads.microsoft.com/Customer/v13">
      <Filter i:nil="false">ValueHere</Filter>
      <TopN>ValueHere</TopN>
      <ReturnAdditionalFields i:nil="false">ValueHere</ReturnAdditionalFields>
    </FindAccountsOrCustomersInfoRequest>
  </s:Body>
</s:Envelope>

Yanıt SOAP

Bu şablon, SOAP yanıtı için gövde ve üst bilgi öğelerinin sırasını gösteren bir araç tarafından oluşturulmuştur.

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/Customer/v13">
    <TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
  </s:Header>
  <s:Body>
    <FindAccountsOrCustomersInfoResponse xmlns="https://bingads.microsoft.com/Customer/v13">
      <AccountInfoWithCustomerData xmlns:e227="https://bingads.microsoft.com/Customer/v13/Entities" d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <e227:AccountInfoWithCustomerData>
          <e227:CustomerId d4p1:nil="false">ValueHere</e227:CustomerId>
          <e227:CustomerName d4p1:nil="false">ValueHere</e227:CustomerName>
          <e227:AccountId>ValueHere</e227:AccountId>
          <e227:AccountName d4p1:nil="false">ValueHere</e227:AccountName>
          <e227:AccountNumber d4p1:nil="false">ValueHere</e227:AccountNumber>
          <e227:AccountLifeCycleStatus>ValueHere</e227:AccountLifeCycleStatus>
          <e227:PauseReason d4p1:nil="false">ValueHere</e227:PauseReason>
          <e227:AccountMode d4p1:nil="false">ValueHere</e227:AccountMode>
        </e227:AccountInfoWithCustomerData>
      </AccountInfoWithCustomerData>
    </FindAccountsOrCustomersInfoResponse>
  </s:Body>
</s:Envelope>

Kod Söz Dizimi

Örnek söz dizimi Bing Reklam SDK'ları ile kullanılabilir. Daha fazla örnek için bkz . Bing Ads API Kod Örnekleri .

public async Task<FindAccountsOrCustomersInfoResponse> FindAccountsOrCustomersInfoAsync(
	string filter,
	int topN,
	AccountAdditionalField? returnAdditionalFields)
{
	var request = new FindAccountsOrCustomersInfoRequest
	{
		Filter = filter,
		TopN = topN,
		ReturnAdditionalFields = returnAdditionalFields
	};

	return (await CustomerManagementService.CallAsync((s, r) => s.FindAccountsOrCustomersInfoAsync(r), request));
}

static FindAccountsOrCustomersInfoResponse findAccountsOrCustomersInfo(
	java.lang.String filter,
	int topN,
	ArrayList<AccountAdditionalField> returnAdditionalFields) throws RemoteException, Exception
{
	FindAccountsOrCustomersInfoRequest request = new FindAccountsOrCustomersInfoRequest();

	request.setFilter(filter);
	request.setTopN(topN);
	request.setReturnAdditionalFields(returnAdditionalFields);

	return CustomerManagementService.getService().findAccountsOrCustomersInfo(request);
}

static function FindAccountsOrCustomersInfo(
	$filter,
	$topN,
	$returnAdditionalFields)
{

	$GLOBALS['Proxy'] = $GLOBALS['CustomerManagementProxy'];

	$request = new FindAccountsOrCustomersInfoRequest();

	$request->Filter = $filter;
	$request->TopN = $topN;
	$request->ReturnAdditionalFields = $returnAdditionalFields;

	return $GLOBALS['CustomerManagementProxy']->GetService()->FindAccountsOrCustomersInfo($request);
}

response=customermanagement_service.FindAccountsOrCustomersInfo(
	Filter=Filter,
	TopN=TopN,
	ReturnAdditionalFields=ReturnAdditionalFields)

Gereksinimler

Hizmet: CustomerManagementService.svc v13
Ad alanı: https://bingads.microsoft.com/Customer/v13

Aracılığıyla paylaş