Address Data Object - Customer Management

Defines a postal address.

Syntax

<xs:complexType name="Address" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="City" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="CountryCode" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Line1" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Line2" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Line3" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Line4" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="PostalCode" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="StateOrProvince" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="TimeStamp" nillable="true" type="xs:base64Binary" />
    <xs:element minOccurs="0" name="BusinessName" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

Elements

Element Description Data Type
BusinessName The legal business name, which can contain a maximum of 100 characters.

Add: Required
Update: Optional. If no value is set for the update, this setting is not changed.
string
City The city, which can contain a maximum of 35 characters.

Add: Required
Update: Optional. If no value is set for the update, this setting is not changed.
string
CountryCode The country/region code. For possible values, see Geographical Location Codes.

Add: Required
Update: Optional. If no value is set for the update, this setting is not changed.
string
Id The system generated identifier of the address object.

Add: Read-only
Update: Required
long
Line1 The first line of the address, which can contain a maximum of 35 characters.

Add: Required
Update: Optional. If no value is set for the update, this setting is not changed.
string
Line2 The second line of the address, which can contain a maximum of 35 characters.

Add: Optional
Update: Optional. If no value is set for the update, this setting is not changed.
string
Line3 The third line of the address, which can contain a maximum of 35 characters.

Add: Optional
Update: Optional. If no value is set for the update, this setting is not changed.
string
Line4 The fourth line of the address, which can contain a maximum of 35 characters.

Add: Optional
Update: Optional. If no value is set for the update, this setting is not changed.
string
PostalCode The Postal or ZIP Code, which can contain a maximum of 10 characters.

Add: Required
Update: Optional. If no value is set for the update, this setting is not changed.
string
StateOrProvince The state or province.

For possible values, see Geographical Location Codes.

You must use the state or province code without country prefix. For example given US-WA, you should use only the WA suffix for Washington state.

Add: Required for countries that define sub geographies, but should be set to null for countries that do not define sub geographies, such as Singapore.
Update: Optional. If no value is set for the update, this setting is not changed.
string
TimeStamp The date and time that the address 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.
base64Binary

Requirements

Service: CustomerManagementService.svc v12
Namespace: https://bingads.microsoft.com/Customer/v12/Entities

Used By

AdvertiserAccount
ContactInfo
Customer
ValidateAddress