PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Properties specific to the description of gglAdWLocalBusinessAd variables
  • Codes of countries
  • Codes of regions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
gglAdWLocalBusinessAd (Type of variable)
In French: gglAdWAnnonceLocalisée (Type de variable)
Warning
From version 17, this feature is not available anymore. To use Google AdWords, see the corresponding Google API: https://developers.google.com/adwords/api/docs/guides/start
The gglAdWLocalBusinessAd type is used to describe a Google AdWords marketing ad whose type is "Local business ad". The local business ads are AdWords ads that are associated with a specific business location. They are displayed on Google, on Google Maps and on the entire Google ad network.
The characteristics of this local business ad can be defined and modified by several WLanguage properties.
Note: See Declaring a variable for more details.
Example
// Connection to Google AdWords
Cnt is gglAdWConnection
Cnt..Email = "vince@gmail.com"
Cnt..Password = "azerty"
Cnt..UserAgent = "MyApp-01"
Cnt..DeveloperToken = "ABcdeFGH93KL-NOPQ_STUv"
Cnt..ApplicationToken = "ZYXwvu-TSR123_456ABCDE"
Cnt..SandboxMode = True

// Retrieve an ad according to its identifier
MyVariant is Variant
MyVariant = GglAdWGetAd(Cnt, "5544")
MyAd is gglAdWLocalBusinessAd = MyVariant

// Modify the ad
MyAd..DestinationURL = "http://newurl.com"
// Apply the changes to the server
MyArray is array of Variant
Add(MyArray, MyAd)
GglWrite(Cnt, MyArray)
Remarks

Properties specific to the description of gglAdWLocalBusinessAd variables

The following properties can be used to handle a Google AdWords ad whose type is "Local business ad":
Name Type used Effect
AddressCharacter stringPostal 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.
BusinessKeyCharacter stringKey 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.
CountryCodeCharacter stringCountry of the ad. This property is mandatory: it must correspond to the country of the company identified by BusinessKey.
PostalCodeCharacter stringZip 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.
ExemptionRequestCharacter stringText 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.
DisapprovedBoolean
  • True if the ad was disapproved by Google,
  • False otherwise. This property is available in read-only.
DescriptionLine1Character stringFirst line of ad text (up to 35 characters).
DescriptionLine2Character stringSecond line of ad text (up to 35 characters).
StateString constantCurrent status of ad.
The available values are:
  • gglActive: The ad is active.
  • gglPaused: The ad is paused.
  • gglDeleted: The ad is deleted.
CustomIcongglAdWImageCharacteristics 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.
StockIconCharacter stringIndicates 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.
IdentifierCharacter stringIdentifier 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.
GroupIdentifierCharacter stringIdentifier 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.
CustomIconIdentifierCharacter stringIdentifier 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).
BusinessImagegglAdWImageCharacteristics of image associated with the company in the ad. The maximum size of this image is set to 125 x 125 pixels.
LatitudeRealLatitude of company address expressed in degrees. This property is available in read-only.
LongitudeRealLongitude of company address expressed in degrees. This property is available in read-only.
BusinessNameCharacter stringName 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.
FullBusinessNameCharacter stringFull name of company that may have been truncated in BusinessName. This property is available in read-only.
TargetRadiusRealRadius for targeting the ad. This radius is expressed in kilometers and it must be included between 16,09344 and 160,9344.
RegionCharacter stringRegion of the ad. This property is optional.
If this property is specified, it must correspond to the region of the company identified by BusinessKey.
PhoneNumberCharacter stringPhone number associated with the ad. This property is optional.
TypeCharacter stringType of ad. This property is available in read-only.
The type of a local business ad is "LocalBusinessAd".
DisplayedURLCharacter stringURL displayed in the ad (up to 35 characters). In this URL, there is no need to specify "http://". For example: "mysite.com".
DestinationURLCharacter stringURL 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.
CityCharacter stringCity of company. This property is optional.
If this property is specified, it must correspond to the city of the company identified by BusinessKey.
Note: These properties can be handled by using one of the following syntaxes:
  • <Variable Name>..<Property Name>
  • <Variable Name>.<Property Name>

Codes of countries

The codes of the countries are as follows (ISO 3166-1 standard):
Identifier - CountryIdentifier - CountryIdentifier - Country
AD - AndorraAE - United Arab EmiratesAF - Afghanistan
AG - Antigua and BarbudaAI - AnguillaAL - Albania
AM - ArmeniaAN - Netherlands AntillesAO - Angola
AQ - AntarcticAR - ArgentinaAS - American Samoa Islands
AT - AustriaAU - AustraliaAW - Aruba
AZ - AzerbaijanBA - Bosnia-HerzegovinaBB - Barbados
BD - BangladeshBE - BelgiumBF - Burkina Faso
BG - BulgariaBH - BahrainBI - Burundi
BJ - BeninBM - BermudaBN - Brunei
BO - BoliviaBR - BrazilBS - The Bahamas
BT - BhutanBV - Bouvet IslandBW - Botswana
BY - BelarusBZ - BelizeCA - Canada
CC - Cocos IslandsCD - Democratic Republic of CongoCF - Central African Republic
CG - CongoCH - SwitzerlandCI - Ivory Coast
CK - Cook IslandsCL - ChileCM - Cameroon
CN - ChinaCO - ColombiaCR - Costa Rica
CS - Serbia and MontenegroCV - Cape VerdeCX - Christmas Island
CY - CyprusCZ - Czech RepublicDE - Germany
DJ - DjiboutiDK - DenmarkDM - Dominica
DO - Dominican RepublicDZ - AlgeriaEC - Ecuador
EE - EstoniaEG - EgyptEH - West Sahara
ER - EritreaES - SpainET - Ethiopia
FI - FinlandFJ - FijiFK - Falkland Islands
FM - MicronesiaFO - Faroe IslandsFR - France
GA - GabonGB - Great BritainGD - Grenada
GE - GeorgiaGF - French GuyanaGH - Ghana
GI - GibraltarGL - GreenlandGM - Gambia
GN - GuineaGP - GuadeloupeGQ - Equatorial Guinea
GR - GreeceGS - South Georgia and the South Sandwich IslandsGT - Guatemala
GU - GuamGW - Guinea-BissauGY - Guyana
HK - Hong KongHM - Heard Island and MacDonald IslandsHN - Honduras
HR - CroatiaHT - HaitiHU - Hungary
ID - IndonesiaIE - IrelandIL - Israel
IN - IndiaIO - British Indian Ocean TerritoryIQ - Iraq
IS - IcelandIT - ItalyJM - Jamaica
JO - JordanJP - JapanKE - Kenya
KG - KyrgyzstanKH - CambodiaKI - Kiribati
KM - ComorosKN - St. Kitts and NevisKR - South Korea
KW - KuwaitKY - Cayman IslandsKZ - Kazakhstan
LA - Democratic Republic of LaosLB - LebanonLC - St. Lucia
LI - LiechtensteinLK - Sri LankaLR - Liberia
LS - LesothoLT - LithuaniaLU - Luxembourg
LV - LatviaLY - LibyaMA - Morocco
MC - MonacoMD - MoldovaMG - Madagascar
MH - Marshall IslandsMK - MacedoniaML - Mali
MO - MacauMP - Northern Mariana IslandsMQ - Martinique
MR - MauritaniaMS - MontserratMT - Malta
MU - Mauritius IslandMV - MaldivesMW- Malawi
MX - MexicoMY - MalaysiaMZ - Mozambique
NA - NamibiaNC - New CaledoniaNE - Niger
NF - Norfolk IslandNG - NigeriaNI - Nicaragua
NL - NetherlandsNO - NorwayNP - Nepal
NR - NauruNU - NiueNZ - New Zealand
OM - OmanPA - PanamaPE - Peru
PF - French PolynesiaPG - Papua New GuineaPH - Philippines
PK - PakistanPL - PolandPM - St. Pierre and Miquelon
PN - Pitcairn IslandsPR - Puerto RicoPS - Palestinian Territory
PT - PortugalPW - PalauPY - Paraguay
QA - QatarRE - ReunionRO - Romania
RU - RussianRW - RwandaSA - Saudi Arabia
SB - Solomon IslandsSC - SeychellesSE - Sweden
SG - SingaporeSH - St. HelenaSI - Slovenia
SJ - Svalbard and Jan MayenSK - SlovakiaSL - Sierra Leone
SM - San MarinoSN - SenegalSO - Somalia
SR - SurinameST - Sao Tome and PrincipeSV - El Salvadore
SZ - SwazilandTC - Turks and Caicos IslandsTD - Chad
TF - French Southern LandsTG - TogoTH - Thailand
TJ - TajikistanTK - TokelauTL - East Timor
TM - TurkmenistanTN - TunisiaTO - Tonga
TR - TurkeyTT - Trinidad and TobagoTV - Tuvalu
TW - TaiwanTZ - TanzaniaUA - Ukraine
UG - UgandaUM - United States Minor Outlying IslandsUS - Unites States
UY - UruguayUZ - UzbekistanVA - Vatican City
VC - St. Vincent and the GrenadinesVE - VenezuelaVG - British Virgin Islands
VI - US Virgin IslandsVN - Viet NamVU - Vanuatu
WF - Wallis and FutunaWS - SamoaYE - Yemen
YT - MayotteZA - South AfricaZM - Zambia
ZW - Zimbabwe
This list is the one supported when this documentation was published. To find out the exhaustive list of supported countries, see http://code.google.com/intl/en/apis/adwords/docs/developer/adwords_api_countries.html.

Codes of regions

To find out the exhaustive list of supported regions, see http://code.google.com/intl/en/apis/adwords/docs/developer/adwords_api_regions.html.
Minimum required version
  • Version 14
This page is also available for…
Comments
Click [Add] to post a comment