The following properties can be used to handle a Google AdWords ad whose type is "Local business ad":
|Name ||Type used ||Effect |
|Address||Character string||Postal address of the ad. This property is optional.|
If this property is specified, it must correspond to the address of the company identified by BusinessKey.
|BusinessKey||Character string||Key corresponding to the targeted company. This property must be specified only when creating the ad (this property is not specified when modifying an existing ad.|
The business keys can be retrieved by GglAdWListBusiness.
|CountryCode||Character string||Country of the ad. This property is mandatory: it must correspond to the country of the company identified by BusinessKey.|
|PostalCode||Character string||Zip code of the ad. This property is optional.|
If this property is specified, it must correspond to the zip code of the company identified by BusinessKey.
|ExemptionRequest||Character string||Text used to explain why the ad does not comply with the use conditions of the service (up to 300 characters). This text can also be used to ask for an exception to this violation.|
- True if the ad was disapproved by Google,
- False otherwise. This property is available in read-only.
|DescriptionLine1||Character string||First line of ad text (up to 35 characters).|
|DescriptionLine2||Character string||Second line of ad text (up to 35 characters).|
|State||String constant||Current status of ad.|
The available values are:
- gglActive: The ad is active.
- gglPaused: The ad is paused.
- gglDeleted: The ad is deleted.
|CustomIcon||gglAdWImage||Characteristics of custom icon associated with the ad. This icon corresponds to an image whose size is 16x16 pixels.|
This property is used when creating a new ad only. To modify this icon, the add must be deleted then re-created.
|StockIcon||Character string||Indicates the preset icon that will be used in the ad.|
The possible values are:
Note: To identify the ad on a map, you must specify one of the following properties: StockIcon, CustomIcon and CustomIconIdentifier. These three properties are exclusive: a single one must be specified.
|Identifier||Character string||Identifier of the ad. This identifier is associated with the ad by the Google AdWords service when creating the ad. This property is available in read-only.|
|GroupIdentifier||Character string||Identifier of ad group to which the ad belongs. This property can be used in write mode when creating the ad only. In the other cases, this property is available in read-only.|
|CustomIconIdentifier||Character string||Identifier of custom icon.|
When creating a new ad, this property can be used to specify an existing image associated with the Google AdWords account.
When modifying an ad, this property corresponds to the identifier that is provided to the custom icon by the Google marketing service (if a custom icon is used).
|BusinessImage||gglAdWImage||Characteristics of image associated with the company in the ad. The maximum size of this image is set to 125 x 125 pixels.|
|Latitude||Real||Latitude of company address expressed in degrees. This property is available in read-only.|
|Longitude||Real||Longitude of company address expressed in degrees. This property is available in read-only.|
|BusinessName||Character string||Name of company affected by the ad (up to 25 characters). This property is optional.|
If this property is specified, it must correspond to the name of the company identified by BusinessKey.
|FullBusinessName||Character string||Full name of company that may have been truncated in BusinessName. This property is available in read-only.|
|TargetRadius||Real||Radius for targeting the ad. This radius is expressed in kilometers and it must be included between 16,09344 and 160,9344.|
|Region||Character string||Region of the ad. This property is optional.|
If this property is specified, it must correspond to the region of the company identified by BusinessKey.
|PhoneNumber||Character string||Phone number associated with the ad. This property is optional.|
|Type||Character string||Type of ad. This property is available in read-only.|
The type of a local business ad is "LocalBusinessAd".
|DisplayedURL||Character string||URL displayed in the ad (up to 35 characters). In this URL, there is no need to specify "http://". For example: "mysite.com".|
|DestinationURL||Character string||URL associated with the ad (up to 1024 characters). This URL must have the following format: http://Name-of-domain. For example: "http://www.mysite.com". When the URL is clicked, the corresponding page will be displayed in the browser of the Web user.|
|City||Character string||City of company. This property is optional.|
If this property is specified, it must correspond to the city of the company identified by BusinessKey.