UpdateCustomer Hizmet İşlemi - Müşteri Yönetimi

Makale
12/21/2023

Belirtilen müşterinin ayrıntılarını Güncelleştirmeler.

Not

Yalnızca Süper Yönetici kimlik bilgilerine sahip bir kullanıcı müşterileri güncelleştirebilir. Daha fazla bilgi için bkz. Kullanıcı Rolleri teknik kılavuzu.

Güncelleştirme işlemi en son müşteri yazma işleminin zaman damgasını gerektirdiğinden, önce GetCustomer işlemini çağırmanız gerekir. GetCustomer işlemi, zaman damgasını içeren müşterinin verilerini döndürür. Eski bir zaman damgası kullanırsanız ( örneğin, müşteri verileri uygulamanız veya zaman damgasını aldıktan sonra başka bir uygulama tarafından güncelleştirilir) güncelleştirme çağrısı başarısız olur.

Güncelleştirme işlemi mevcut müşteri verilerinin üzerine tamamen yazdığından, müşteri verilerinin tüm gerekli verileri içermesi gerekir; aksi takdirde işlem başarısız olur.

İstek Öğeleri

UpdateCustomerRequest 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ü
Müşteri	Güncelleştirilmiş müşteri bilgilerini içeren bir müşteri nesnesi. Bu işlem, geçirdiğiniz müşteri nesnesinin içeriğiyle mevcut müşteri verilerinin üzerine yazar. Bu işlem kısmi bir güncelleştirme değil tam güncelleştirme gerçekleştirir. Customer nesnesi, Customer nesnesinin son yazıldığı zamana ait zaman damgası değerini içermelidir. Zaman damgasının doğru değeri içerdiğinden emin olmak için GetCustomer işlemini çağırın. Ardından müşteri verilerini uygun şekilde güncelleştirebilir ve UpdateCustomer'ı çağırabilirsiniz.	Müşteri

İ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

UpdateCustomerResponse 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ü
LastModifiedTime	Müşterinin son güncelleştirildiği tarih ve saat. Değer Eşgüdümlü Evrensel Saat (UTC) içindedir. Tarih ve saat değeri, istemcide değil sunucudaki tarih ve saati yansıtır. Tarih ve saatin biçimi hakkında bilgi için temel XML Veri Türleri'ndeki dateTime girdisine bakın.	Datetime

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">UpdateCustomer</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <UpdateCustomerRequest xmlns="https://bingads.microsoft.com/Customer/v13">
      <Customer xmlns:e281="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
        <e281:CustomerFinancialStatus i:nil="false">ValueHere</e281:CustomerFinancialStatus>
        <e281:Id i:nil="false">ValueHere</e281:Id>
        <e281:Industry i:nil="false">ValueHere</e281:Industry>
        <e281:LastModifiedByUserId i:nil="false">ValueHere</e281:LastModifiedByUserId>
        <e281:LastModifiedTime i:nil="false">ValueHere</e281:LastModifiedTime>
        <e281:MarketCountry i:nil="false">ValueHere</e281:MarketCountry>
        <e281:ForwardCompatibilityMap xmlns:e282="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
          <e282:KeyValuePairOfstringstring>
            <e282:key i:nil="false">ValueHere</e282:key>
            <e282:value i:nil="false">ValueHere</e282:value>
          </e282:KeyValuePairOfstringstring>
        </e281:ForwardCompatibilityMap>
        <e281:MarketLanguage i:nil="false">ValueHere</e281:MarketLanguage>
        <e281:Name i:nil="false">ValueHere</e281:Name>
        <e281:ServiceLevel i:nil="false">ValueHere</e281:ServiceLevel>
        <e281:CustomerLifeCycleStatus i:nil="false">ValueHere</e281:CustomerLifeCycleStatus>
        <e281:TimeStamp i:nil="false">ValueHere</e281:TimeStamp>
        <e281:Number i:nil="false">ValueHere</e281:Number>
        <e281:CustomerAddress i:nil="false">
          <e281:City i:nil="false">ValueHere</e281:City>
          <e281:CountryCode i:nil="false">ValueHere</e281:CountryCode>
          <e281:Id i:nil="false">ValueHere</e281:Id>
          <e281:Line1 i:nil="false">ValueHere</e281:Line1>
          <e281:Line2 i:nil="false">ValueHere</e281:Line2>
          <e281:Line3 i:nil="false">ValueHere</e281:Line3>
          <e281:Line4 i:nil="false">ValueHere</e281:Line4>
          <e281:PostalCode i:nil="false">ValueHere</e281:PostalCode>
          <e281:StateOrProvince i:nil="false">ValueHere</e281:StateOrProvince>
          <e281:TimeStamp i:nil="false">ValueHere</e281:TimeStamp>
          <e281:BusinessName i:nil="false">ValueHere</e281:BusinessName>
        </e281:CustomerAddress>
      </Customer>
    </UpdateCustomerRequest>
  </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>
    <UpdateCustomerResponse xmlns="https://bingads.microsoft.com/Customer/v13">
      <LastModifiedTime>ValueHere</LastModifiedTime>
    </UpdateCustomerResponse>
  </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<UpdateCustomerResponse> UpdateCustomerAsync(
	Customer customer)
{
	var request = new UpdateCustomerRequest
	{
		Customer = customer
	};

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

static UpdateCustomerResponse updateCustomer(
	Customer customer) throws RemoteException, Exception
{
	UpdateCustomerRequest request = new UpdateCustomerRequest();

	request.setCustomer(customer);

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

static function UpdateCustomer(
	$customer)
{

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

	$request = new UpdateCustomerRequest();

	$request->Customer = $customer;

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

response=customermanagement_service.UpdateCustomer(
	Customer=Customer)

Gereksinimler

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

Aracılığıyla paylaş