AdsApp.AccountSitelink

Represents a sitelink that has been added to an account as an ad sitelink extension. Visit our Ad Extensions page for more information on sitelinks and other types of ad extensions.

Methods:

Member	Type	Description
clearDescription1	`void`	Clears the first description line of the account-level sitelink description.
clearDescription2	`void`	Clears the second description line of the account-level sitelink description.
clearEndDate	`void`	Clears the account-level sitelink's end date.
clearLinkUrl	`void`	Clears the link URL of the account-level sitelink.
clearStartDate	`void`	Clears the account-level sitelink's start date.
getDescription1	`String`	Returns the first description line of the account-level sitelink description.
getDescription2	`String`	Returns the second description line of the account-level sitelink description.
getEndDate	`AdsApp.GoogleAdsDate`	Returns the end date of the account-level sitelink, or `null` if no end date is set.
getEntityType	`String`	Returns the type of this entity as a `String`, in this case, `"AccountSitelink"`.
getId	`long`	Returns the ID of the account-level sitelink.
getLinkText	`String`	Returns the link text of the account-level sitelink.
getSchedules	`AdsApp.ExtensionSchedule[]`	Returns the scheduling of the account-level sitelink.
getStartDate	`AdsApp.GoogleAdsDate`	Returns the start date of the account-level sitelink, or `null` if no start date is set.
getStatsFor	`AdsApp.Stats`	Returns stats for the specified date range.
getStatsFor	`AdsApp.Stats`	Returns stats for the specified custom date range.
isMobilePreferred	`boolean`	Returns `true` if the account-level sitelink specifies mobile device preference.
setDescription1	`void`	Sets the first description line of the account-level sitelink description.
setDescription2	`void`	Sets the second description line of the account-level sitelink description.
setEndDate	`void`	Sets the account-level sitelink's end date from either an object containing year, month, and day fields, or an 8-digit string in `YYYYMMDD` format.
setLinkText	`void`	Sets the link text of the account-level sitelink.
setMobilePreferred	`void`	Sets the account-level sitelink's device preference.
setSchedules	`void`	Sets the account-level sitelink scheduling.
setStartDate	`void`	Sets the account-level sitelink's start date from either an object containing year, month, and day fields, or an 8-digit string in `YYYYMMDD` format.
urls	`AdsApp.SitelinkUrls`	Provides access to the URL fields of this account-level sitelink.

`clearDescription1()`

Clears the first description line of the account-level sitelink description.

Returns nothing.

`clearDescription2()`

Clears the second description line of the account-level sitelink description.

Returns nothing.

`clearEndDate()`

Clears the account-level sitelink's end date.

Returns nothing.

`clearLinkUrl()`

Clears the link URL of the account-level sitelink. To upgrade account-level sitelinks to final URL, first clear the link URL, then set the final URL with SitelinkUrls.setFinalUrl.

Returns nothing.

`clearStartDate()`

Clears the account-level sitelink's start date.

Returns nothing.

`getDescription1()`

Returns the first description line of the account-level sitelink description.

Return values:

Type	Description
`String`	Description line 1 of the account-level sitelink.

`getDescription2()`

Returns the second description line of the account-level sitelink description.

Return values:

Type	Description
`String`	Description line 2 of the account-level sitelink.

`getEndDate()`

Returns the end date of the account-level sitelink, or null if no end date is set.

For instance, if the end date of the account-level sitelink is May 3, 2013, this would return the following object: {year: 2013, month: 5, day: 3}.

Return values:

Type	Description
`AdsApp.GoogleAdsDate`	The account-level sitelink's end date, or `null` if there's no end date.

`getEntityType()`

Returns the type of this entity as a String, in this case, "AccountSitelink".

Return values:

Type	Description
`String`	Type of this entity: `"AccountSitelink"`.

`getId()`

Returns the ID of the account-level sitelink.

Return values:

Type	Description
`long`	The ID of the account-level sitelink.

`getLinkText()`

Returns the link text of the account-level sitelink.

Return values:

Type	Description
`String`	Link text of the account-level sitelink.

`getSchedules()`

Returns the scheduling of the account-level sitelink.

Return values:

Type	Description
`AdsApp.ExtensionSchedule[]`	The scheduling of the account-level sitelink.

`getStartDate()`

Returns the start date of the account-level sitelink, or null if no start date is set.

For instance, if the start date of the account-level sitelink is May 3, 2013, this would return the following object: {year: 2013, month: 5, day: 3}.

Return values:

Type	Description
`AdsApp.GoogleAdsDate`	The account-level sitelink's start date, or `null` if there's no start date.

`getStatsFor(dateRange)`

Returns stats for the specified date range. Supported values:

TODAY, YESTERDAY, LAST_7_DAYS, THIS_WEEK_SUN_TODAY, LAST_WEEK, LAST_14_DAYS, LAST_30_DAYS, LAST_BUSINESS_WEEK, LAST_WEEK_SUN_SAT, THIS_MONTH, LAST_MONTH, ALL_TIME.

Example:

 var stats = accountSitelink.getStatsFor("THIS_MONTH");

Arguments:

Name	Type	Description
dateRange	`String`	Date range for which the stats are requested.

Return values:

Type	Description
`AdsApp.Stats`	The stats for the specified date range.

`getStatsFor(dateFrom, dateTo)`

Returns stats for the specified custom date range. Both parameters can be either an object containing year, month, and day fields, or an 8-digit string in YYYYMMDD form. For instance, March 24th, 2013 is represented as either

{year: 2013, month: 3, day:
 24}

or "20130324". The date range is inclusive on both ends, so forDateRange("20130324", "20130324") defines a range of a single day.

Arguments:

Name	Type	Description
dateFrom	`Object`	Start date of the date range. Must be either a string in `YYYYMMDD` form, or an object with `year`, `month` and `day` properties.
dateTo	`Object`	End date of the date range. Must be either a string in `YYYYMMDD` form, or an object with `year`, `month` and `day` properties.

Return values:

Type	Description
`AdsApp.Stats`	The stats for the specified date range.

`isMobilePreferred()`

Returns true if the account-level sitelink specifies mobile device preference.

Return values:

Type	Description
`boolean`	`true` if the account-level sitelink specifies mobile device preference.

`setDescription1(description1)`

Sets the first description line of the account-level sitelink description.

Returns nothing.

Arguments:

Name	Type	Description
description1	`String`	The first description line.

`setDescription2(description2)`

Sets the second description line of the account-level sitelink description.

Returns nothing.

Arguments:

Name	Type	Description
description2	`String`	The second description line.

`setEndDate(date)`

Sets the account-level sitelink's end date from either an object containing year, month, and day fields, or an 8-digit string in YYYYMMDD format.

For instance, accountSitelink.setEndDate("20130503"); is equivalent to accountSitelink.setEndDate({year: 2013, month: 5, day: 3});.

The change will fail and report an error if:

the given date is invalid (e.g., {year: 2013, month: 5, day: 55}),
the start date now comes after the end date, or
it's a date in the past.

Returns nothing.

Arguments:

Name	Type	Description
date	`Object`	The new account-level sitelink end date.

`setLinkText(linkText)`

Sets the link text of the account-level sitelink.

Returns nothing.

Arguments:

Name	Type	Description
linkText	`String`	The link text.

`setMobilePreferred(isMobilePreferred)`

Sets the account-level sitelink's device preference.

Returns nothing.

Arguments:

Name	Type	Description
isMobilePreferred	`boolean`	`true` sets the device preference to mobile. `false` clears the device preference.

`setSchedules(schedules)`

Sets the account-level sitelink scheduling. Scheduling of a account-level sitelink allows you to control the days of week and times of day during which the account-level sitelink will show alongside your ads.

Passing in an empty array clears the scheduling field, causing the account-level sitelink to run at all times.

The following example sets the account-level sitelink to run on Mondays and Tuesday from 8:00 to 11:00.

 var mondayMorning = {
   dayOfWeek: "MONDAY",
   startHour: 8,
   startMinute: 0,
   endHour: 11,
   endMinute: 0
 };
 var tuesdayMorning = {
   dayOfWeek: "TUESDAY",
   startHour: 8,
   startMinute: 0,
   endHour: 11,
   endMinute: 0
 };

 accountSitelink.setSchedules([mondayMorning, tuesdayMorning]);

Returns nothing.

Arguments:

Name	Type	Description
schedules	`AdsApp.ExtensionSchedule[]`	The new account-level sitelink schedules.

`setStartDate(date)`

Sets the account-level sitelink's start date from either an object containing year, month, and day fields, or an 8-digit string in YYYYMMDD format.

For instance, accountSitelink.setStartDate("20130503"); is equivalent to accountSitelink.setStartDate({year: 2013, month: 5, day: 3});.

The change will fail and report an error if:

the given date is invalid (e.g., {year: 2013, month: 5, day: 55}),
the given date is after the account-level sitelink's end date.

Returns nothing.

Arguments:

Name	Type	Description
date	`Object`	The new account-level sitelink start date.

`urls()`

Provides access to the URL fields of this account-level sitelink. See Using Upgraded URLs for more information.

Return values:

Type	Description
`AdsApp.SitelinkUrls`	Access to the URL fields of this account-level sitelink.

AdsApp.​AccountSitelink

Methods:

clearDescription1()

clearDescription2()

clearEndDate()

clearLinkUrl()

clearStartDate()

getDescription1()

Return values:

getDescription2()

Return values:

getEndDate()

Return values:

getEntityType()

Return values:

getId()

Return values:

getLinkText()

Return values:

getSchedules()

Return values:

getStartDate()

Return values:

getStatsFor(dateRange)

Arguments:

Return values:

getStatsFor(dateFrom, dateTo)

Arguments:

Return values:

isMobilePreferred()

Return values:

setDescription1(description1)

Arguments:

setDescription2(description2)

Arguments:

setEndDate(date)

Arguments:

setLinkText(linkText)

Arguments:

setMobilePreferred(isMobilePreferred)

Arguments:

setSchedules(schedules)

Arguments:

setStartDate(date)

Arguments:

urls()

Return values:

AdsApp.AccountSitelink

`clearDescription1()`

`clearDescription2()`

`clearEndDate()`

`clearLinkUrl()`

`clearStartDate()`

`getDescription1()`

`getDescription2()`

`getEndDate()`

`getEntityType()`

`getId()`

`getLinkText()`

`getSchedules()`

`getStartDate()`

`getStatsFor(dateRange)`

`getStatsFor(dateFrom, dateTo)`

`isMobilePreferred()`

`setDescription1(description1)`

`setDescription2(description2)`

`setEndDate(date)`

`setLinkText(linkText)`

`setMobilePreferred(isMobilePreferred)`

`setSchedules(schedules)`

`setStartDate(date)`

`urls()`