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 Google
Ads 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 Google Ads
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. |