Edit

Share via

Address Data Object - Customer Management

  • Article

Defines a postal address for accounts and user contact information.

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

The Address object has the following elements: BusinessName, City, CountryCode, Id, Line1, Line2, Line3, Line4, PostalCode, StateOrProvince, TimeStamp.

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 e.g., "US", 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.

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

Add: Required for countries or regions that define sub geographies, but should be set to null for countries or regions 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.

Add: Read-only
Update: Read-only		 base64Binary

Requirements

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

Used By

AdvertiserAccount
ContactInfo
Customer
ValidateAddress