Miscellaneous information about MCC Managed Accounts.
Methods:
applyLabel(name)
Applies an account label to the managed account. The label name is case-sensitive. The
operation will fail if the account label with the specified name does not already exist in the
MCC account.
Note that an account-level label cannot be applied to more than 1,000 accounts.
Returns nothing.
Arguments:
Name | Type | Description |
name |
String |
Name of the account label to apply. |
getCurrencyCode()
Returns the currency code of the account. The returned values are in the three-letter ISO 4217
format, e.g.
'USD'
,
'CAD'
,
'JPY'
, etc.
Please refer to AdWords API Currency
Codes for the full list of possible return values.
Return values:
Type | Description |
String |
The currency code of the account. |
getCustomerId()
Returns the customer ID of the account.
The returned value is in the standard Google Ads format, e.g. '123-456-7890'
.
Return values:
Type | Description |
String |
The customer ID of the account. |
getEntityType()
Returns the type of this entity as a
String
, in this case,
"Account"
.
Return values:
Type | Description |
String |
Type of this entity: "Account" . |
getName()
Returns the name of the account.
Return values:
Type | Description |
String |
The account descriptive name, or null if one doesn't exist. |
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 = account.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. |
getTimeZone()
Returns the POSIX time zone of the account.
Returned values are in the standard time zone identifier form, such as 'America/Los_Angeles'
.
Please refer to AdWords API Timezones for
the full list of possible return values.
Return values:
Type | Description |
String |
The time zone of the account. |
labels()
Creates a selector of all account labels that exist in the MCC account.
Return values:
removeLabel(name)
Removes an account label from the managed account. The label name is case-sensitive. The
operation will fail if the account label with the specified name does not already exist in the
MCC account.
Returns nothing.
Arguments:
Name | Type | Description |
name |
String |
Name of the account label to remove. |