Customer Data Object

 

Defines a customer.

<xs:complexType name="Customer">
  <xs:sequence>
    <xs:element minOccurs="0" name="CustomerAddress" nillable="true" type="tns:Address" />
    <xs:element minOccurs="0" name="CustomerFinancialStatus" nillable="true" type="tns:CustomerFinancialStatus" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xsd:long" />
    <xs:element minOccurs="0" name="Industry" nillable="true" type="tns:Industry" />
    <xs:element minOccurs="0" name="LastModifiedByUserId" nillable="true" type="xsd:long" />
    <xs:element minOccurs="0" name="LastModifiedTime" nillable="true" type="xsd:dateTime" />
    <xs:element minOccurs="0" name="MarketCountry" nillable="true" type="tns:String" />
    <xs:element minOccurs="0" name="ForwardCompatibilityMap" xmlns:q2="http://schemas.datacontract.org/2004/07/System.Collections.Generic" nillable="true" type="q2:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="MarketLanguage" nillable="true" type="tns:LanguageType" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xsd:string" />
    <xs:element minOccurs="0" name="ServiceLevel" nillable="true" type="tns:ServiceLevel" />
    <xs:element minOccurs="0" name="CustomerLifeCycleStatus" nillable="true" type="tns:CustomerLifeCycleStatus" />
    <xs:element minOccurs="0" name="TimeStamp" nillable="true" type="xs:base64Binary" />
    <xs:element minOccurs="0" name="Number" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

ElementDescriptionData TypeAddUpdate
CustomerAddressThe customer's business address.AddressRequiredRequired
CustomerFinancialStatusThe financial status of the customer. For example, the status indicates whether the customer is in good standing or one or more of the accounts are past due.CustomerFinancialStatusRead-onlyRead-only
CustomerLifeCycleStatusThe status of the customer. When you create the customer, the status is set to Active. You cannot change the status.CustomerLifeCycleStatusRead-onlyRead-only
ForwardCompatibilityMapThe list of key and value strings for forward compatibility. This element can be used to avoid otherwise breaking changes when new elements are added in future releases.

Note: Forward compatibility changes will be noted here in future releases. There are currently no forward compatibility changes for the Customer object.
KeyValuePairOfstringstring arrayRead-onlyRead-only
IdThe system generated customer identifier.

Use this identifier with operation requests that require a CustomerId SOAP header element.
longRead-onlyRequired
IndustryThe primary business segment of the customer, for example, automotive, food, or entertainment.IndustryRequiredRequired
LastModifiedByUserIdThe identifier of the last user to update the customer’s information.longRead-onlyRead-only
LastModifiedTimeThe date and time that the customer information was last updated. The value is in Coordinated Universal Time (UTC).

The date and time value reflects the date and time at the server, not the client. For information about the format of the date and time, see the dateTime entry in Primitive XML Data Types.
dateTimeRead-onlyRead-only
MarketCountryThe primary country where the customer operates. This country will be the default country for ad groups in the customer’s campaigns. For a list of customer market country code values, see Ad Languages.stringRequiredRead-only
MarketLanguageThe primary language that the customer uses. This language will be the default language for ad groups in the customer’s campaigns. For a list of customer market language code values, see Ad Languages.LanguageTypeRequiredRead-only
NameThe name of the customer. The name can contain a maximum of 100 characters.stringRequiredRequired
NumberA system-generated customer number that is used in the Bing Ads web application. The customer number is of the form, Cnnnnnnn, where nnnnnnn is a series of digits.stringRead-onlyRead-only
ServiceLevelFor internal use only. If this element is set when calling SignupCustomer an error will be returned. If this element is set when calling UpdateCustomer the element will be ignored.ServiceLevelRead-onlyRead-only
TimeStampA time-stamp value that the system uses internally to reconcile updates when you call the UpdateCustomer and DeleteCustomer operations.base64BinaryRead-onlyRequired

CustomerManagementService.svc v11

Namespace: https://bingads.microsoft.com/Customer/v11

GetCustomer
SignupCustomer
UpdateCustomer

Show: