Opération de service UpdateCustomer - Gestion des clients

Mises à jour les détails du client spécifié.

Étant donné que l’opération de mise à jour nécessite l’horodatage de l’opération d’écriture client la plus récente, vous devez d’abord appeler l’opération GetCustomer . L’opération GetCustomer retourne les données du client, qui incluent l’horodatage. L’appel de mise à jour échoue si vous utilisez un ancien horodatage, par exemple, les données client sont mises à jour par votre application ou une autre application après avoir obtenu l’horodatage.

Étant donné que l’opération de mise à jour remplace complètement les données client existantes, les données client doivent contenir toutes les données requises ; sinon, l’opération échoue.

Éléments de demande

L’objet UpdateCustomerRequest définit les éléments body et header de la demande d’opération de service. Les éléments doivent être dans le même ordre que celui indiqué dans la requête SOAP.

Éléments du corps de la requête

Éléments d’en-tête de requête

Éléments Response

L’objet UpdateCustomerResponse définit les éléments body et header de la réponse de l’opération de service. Les éléments sont retournés dans le même ordre que celui indiqué dans la réponse SOAP.

Response Body, éléments

Éléments d’en-tête de réponse

Requête SOAP

Ce modèle a été généré par un outil pour afficher l’ordre des éléments body et header pour la requête SOAP. Pour connaître les types pris en charge que vous pouvez utiliser avec cette opération de service, consultez la référence Éléments du corps de la demande ci-dessus.

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

Soap de réponse

Ce modèle a été généré par un outil pour afficher l’ordre des éléments de corps et d’en-tête pour la réponse SOAP.

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

Syntaxe du code

L’exemple de syntaxe peut être utilisé avec les Kits de développement logiciel (SDK) Bing Ads. Pour plus d’exemples, consultez Exemples de code de l’API Bing Ads .

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)

Configuration requise

Service : CustomerManagementService.svc v13
Noms: https://bingads.microsoft.com/Customer/v13