Documentation for the requested version is not available.Documentation for the requested diff is not available.
Data associated with a mobile ad. This data is used by
AdService.
A mobile ad can contain a click-to-call phone number, a link to a website, or both. You specify which features you want by setting certain fields, as shown in the following table. For example, to create a click-to-call mobile ad, set the fields in the Click-to-call column. A hyphen means don't set the corresponding field.
| Click-to-call | Website | Both |
|---|---|---|
| headline description mobileCarriers phoneNumber countryCode businessName - - - |
headline description mobileCarriers - - - displayUrl destinationUrl markupLanguages |
headline description mobileCarriers phoneNumber countryCode - displayUrl destinationUrl markupLanguages |
Note:
For statically typed languages, such as Java, create an instance of MobileAd.
For dynamically typed languages such as Perl and Python,
create an Ad data object. Then either specify the xsi:type
attribute as MobileAd or set the adType field to MobileAd.
| Field name | Field type | Field description |
|---|---|---|
| adGroupId | long |
ID of the ad group associated with this ad.
This field is not mutable. |
| adType | AdType |
Concrete type of this ad. Generally, this field is
read-only, but may be set by scripting languages to indicate a concrete
type.
Values are:
|
| businessName | string |
The business name of the mobile ad.
Must not exceed 20 characters except for ads targeted
to Japan which must not exceed 10 Japanese characters. |
| countryCode | string |
The country code
for the phone number in the click-to-call mobile ad.
The click-to-call ad will appear only in this country.
The countryCode will be used to verify the phone number
format, as well validate the targeted mobile carriers. |
| description | string |
The description of the mobile ad.
Must not exceed 18 characters or 9 Japanese characters
except for campaigns targeted only to Japan where
the field must not exceed 12 Japanese characters. |
| destinationUrl | string |
Destination URL associated with this ad. May be overridden
on a per-keyword basis by Keyword.destinationUrl.
Must less than 1024 characters (or 200 characters for mobile ads).
Must use the http://your-domain-name format (for example,
http://www.google.com). |
| disapproved | boolean |
True if this ad has been disapproved by Google.
Disapproved ads will not be served.
Ads might be disapproved for a variety of reasons, see the
AdWords Help Center for more information about
disapproved ads. |
| displayUrl | string |
URL shown in this ad. Must not exceed 35 characters (or
20 characters for mobile ads). Mobile
ads targeted to Japan must not exceed 10 Japanese characters.
http:// is not required (for examle,
www.google.com). |
| exemptionRequest | string |
Reason for allowing submission of an ad that violates the ad
policies described by Google's AdWords Editorial Guidelines. Must be no
longer than 300 characters.
Set this field only if this ad violates policy. Unnecessarily specifying an exemption request will cause any add or update operation to fail. For more information, see Policy Checking in the Web Services overview. |
| headline | string |
The headline of the mobile ad.
Must not exceed 18 characters or 9 Japanese characters
except for campaigns targeted only to Japan where
the field must not exceed 12 Japanese characters. |
| id | long |
ID of this ad. This field is set by AdService when
the ad is created and it is not mutable. |
| markupLanguages | string[] |
The list of markup languages to use for the mobile ad.
Values are:
|
| mobileCarriers | string[] |
The list of mobile carriers to use for the mobile ad. Each string
must be of the form 'CarrierName@CountryCode'. To specify that
all available carriers are to be used, use the reserved keyword
'ALLCARRIERS'.
Values are:
CarrierName CountryCode
NTT DoCoMo JP
KDDI/au JP
Vodafone JP
T-Mobile DE
Vodafone DE
E-Plus DE
O2 DE
T-Mobile GB
Vodafone GB
O2 GB
Orange GB
Cingular US
Sprint US
Verizon US
T-Mobile US
Nextel US
China Mobile CN |
| phoneNumber | string |
The phone number for use in click-to-call.
Must not exceed 20 characters. |
| status | AdStatus |
Current status of this ad.
Values are:
|
|
