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

Makale
12/21/2023

Microsoft Advertising kullanıcısı hakkındaki kişisel ve iş iletişim bilgilerini Güncelleştirmeler.

Not

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

Güncelleştirme işlemi en son kullanıcı yazma işleminin zaman damgasını gerektirdiğinden, önce GetUser işlemini çağırmanız gerekir. GetUser işlemi, zaman damgasını içeren kullanıcının verilerini döndürür. Eski bir zaman damgası kullanırsanız (örneğin, kullanıcı 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.

İstek Öğeleri

UpdateUserRequest 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ü
Kullanıcı	Güncelleştirilmiş kullanıcı bilgilerini içeren kullanıcı nesnesi. Bu işlem, geçirdiğiniz kullanıcı nesnesinin içeriğiyle var olan kullanıcı verilerinin üzerine yazar. Bu işlem kısmi bir güncelleştirme değil tam güncelleştirme gerçekleştirir. User nesnesi, User 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 GetUser işlemini çağırın. Ardından kullanıcı verilerini uygun şekilde güncelleştirebilir ve UpdateUser'ı çağırabilirsiniz.	Kullanıcı

İ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

UpdateUserResponse 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	Kullanıcının 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">UpdateUser</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <UpdateUserRequest xmlns="https://bingads.microsoft.com/Customer/v13">
      <User xmlns:e283="https://bingads.microsoft.com/Customer/v13/Entities" i:nil="false">
        <e283:ContactInfo i:nil="false">
          <e283:Address i:nil="false">
            <e283:City i:nil="false">ValueHere</e283:City>
            <e283:CountryCode i:nil="false">ValueHere</e283:CountryCode>
            <e283:Id i:nil="false">ValueHere</e283:Id>
            <e283:Line1 i:nil="false">ValueHere</e283:Line1>
            <e283:Line2 i:nil="false">ValueHere</e283:Line2>
            <e283:Line3 i:nil="false">ValueHere</e283:Line3>
            <e283:Line4 i:nil="false">ValueHere</e283:Line4>
            <e283:PostalCode i:nil="false">ValueHere</e283:PostalCode>
            <e283:StateOrProvince i:nil="false">ValueHere</e283:StateOrProvince>
            <e283:TimeStamp i:nil="false">ValueHere</e283:TimeStamp>
            <e283:BusinessName i:nil="false">ValueHere</e283:BusinessName>
          </e283:Address>
          <e283:ContactByPhone i:nil="false">ValueHere</e283:ContactByPhone>
          <e283:ContactByPostalMail i:nil="false">ValueHere</e283:ContactByPostalMail>
          <e283:Email i:nil="false">ValueHere</e283:Email>
          <e283:EmailFormat i:nil="false">ValueHere</e283:EmailFormat>
          <e283:Fax i:nil="false">ValueHere</e283:Fax>
          <e283:HomePhone i:nil="false">ValueHere</e283:HomePhone>
          <e283:Id i:nil="false">ValueHere</e283:Id>
          <e283:Mobile i:nil="false">ValueHere</e283:Mobile>
          <e283:Phone1 i:nil="false">ValueHere</e283:Phone1>
          <e283:Phone2 i:nil="false">ValueHere</e283:Phone2>
        </e283:ContactInfo>
        <e283:CustomerId i:nil="false">ValueHere</e283:CustomerId>
        <e283:Id i:nil="false">ValueHere</e283:Id>
        <e283:JobTitle i:nil="false">ValueHere</e283:JobTitle>
        <e283:LastModifiedByUserId i:nil="false">ValueHere</e283:LastModifiedByUserId>
        <e283:LastModifiedTime i:nil="false">ValueHere</e283:LastModifiedTime>
        <e283:Lcid i:nil="false">ValueHere</e283:Lcid>
        <e283:Name i:nil="false">
          <e283:FirstName i:nil="false">ValueHere</e283:FirstName>
          <e283:LastName i:nil="false">ValueHere</e283:LastName>
          <e283:MiddleInitial i:nil="false">ValueHere</e283:MiddleInitial>
        </e283:Name>
        <e283:Password i:nil="false">ValueHere</e283:Password>
        <e283:SecretAnswer i:nil="false">ValueHere</e283:SecretAnswer>
        <e283:SecretQuestion>ValueHere</e283:SecretQuestion>
        <e283:UserLifeCycleStatus i:nil="false">ValueHere</e283:UserLifeCycleStatus>
        <e283:TimeStamp i:nil="false">ValueHere</e283:TimeStamp>
        <e283:UserName i:nil="false">ValueHere</e283:UserName>
        <e283:ForwardCompatibilityMap xmlns:e284="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
          <e284:KeyValuePairOfstringstring>
            <e284:key i:nil="false">ValueHere</e284:key>
            <e284:value i:nil="false">ValueHere</e284:value>
          </e284:KeyValuePairOfstringstring>
        </e283:ForwardCompatibilityMap>
        <e283:AuthenticationToken i:nil="false">ValueHere</e283:AuthenticationToken>
      </User>
    </UpdateUserRequest>
  </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>
    <UpdateUserResponse xmlns="https://bingads.microsoft.com/Customer/v13">
      <LastModifiedTime>ValueHere</LastModifiedTime>
    </UpdateUserResponse>
  </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<UpdateUserResponse> UpdateUserAsync(
	User user)
{
	var request = new UpdateUserRequest
	{
		User = user
	};

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

static UpdateUserResponse updateUser(
	User user) throws RemoteException, Exception
{
	UpdateUserRequest request = new UpdateUserRequest();

	request.setUser(user);

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

static function UpdateUser(
	$user)
{

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

	$request = new UpdateUserRequest();

	$request->User = $user;

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

response=customermanagement_service.UpdateUser(
	User=User)

Gereksinimler

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

Aracılığıyla paylaş