Get
|
|||||
|
|
||||
Gets the specified ad unit in the specified ad client for the specified account
Authorization
To use this building block you will have to grant access to at least one of the following scopes:
- View and manage your AdSense data
- View your AdSense data
Input
This building block consumes 3 input parameters
| Name | Format | Description |
|---|---|---|
accountId Required |
STRING |
Account to which the ad client belongs |
adClientId Required |
STRING |
Ad client for which to get the ad unit |
adUnitId Required |
STRING |
Ad unit to retrieve |
= Parameter name
= Format
|
accountId STRING Required Account to which the ad client belongs |
|
adClientId STRING Required Ad client for which to get the ad unit |
|
adUnitId STRING Required Ad unit to retrieve |
Output
This building block provides 35 output parameters
| Name | Format | Description |
|---|---|---|
code |
STRING |
Identity code of this ad unit, not necessarily unique across ad clients |
contentAdsSettings |
OBJECT |
Settings specific to content ads (AFC) and highend mobile content ads (AFMC - deprecated) |
contentAdsSettings.backupOption |
OBJECT |
The backup option to be used in instances where no ad is available |
contentAdsSettings.backupOption.color |
STRING |
Color to use when type is set to COLOR |
contentAdsSettings.backupOption.type |
STRING |
Type of the backup option. Possible values are BLANK, COLOR and URL |
contentAdsSettings.backupOption.url |
STRING |
URL to use when type is set to URL |
contentAdsSettings.size |
STRING |
Size of this ad unit |
contentAdsSettings.type |
STRING |
Type of this ad unit |
customStyle |
OBJECT |
|
customStyle.colors |
OBJECT |
The colors which are included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash |
customStyle.colors.background |
STRING |
The color of the ad background |
customStyle.colors.border |
STRING |
The color of the ad border |
customStyle.colors.text |
STRING |
The color of the ad text |
customStyle.colors.title |
STRING |
The color of the ad title |
customStyle.colors.url |
STRING |
The color of the ad url |
customStyle.corners |
STRING |
The style of the corners in the ad (deprecated: never populated, ignored) |
customStyle.font |
OBJECT |
The font which is included in the style |
customStyle.font.family |
STRING |
The family of the font |
customStyle.font.size |
STRING |
The size of the font |
customStyle.kind |
STRING |
Kind this is, in this case adsense#adStyle |
feedAdsSettings |
OBJECT |
Settings specific to feed ads (AFF) - deprecated |
feedAdsSettings.adPosition |
STRING |
The position of the ads relative to the feed entries |
feedAdsSettings.frequency |
INTEGER |
The frequency at which ads should appear in the feed (i.e. every N entries) |
feedAdsSettings.minimumWordCount |
INTEGER |
The minimum length an entry should be in order to have attached ads |
feedAdsSettings.type |
STRING |
The type of ads which should appear |
id |
STRING |
Unique identifier of this ad unit. This should be considered an opaque identifier; it is not safe to rely on it being in any particular format |
kind |
STRING |
Kind of resource this is, in this case adsense#adUnit |
mobileContentAdsSettings |
OBJECT |
Settings specific to WAP mobile content ads (AFMC) - deprecated |
mobileContentAdsSettings.markupLanguage |
STRING |
The markup language to use for this ad unit |
mobileContentAdsSettings.scriptingLanguage |
STRING |
The scripting language to use for this ad unit |
mobileContentAdsSettings.size |
STRING |
Size of this ad unit |
mobileContentAdsSettings.type |
STRING |
Type of this ad unit |
name |
STRING |
Name of this ad unit |
savedStyleId |
STRING |
ID of the saved ad style which holds this ad unit's style information |
status |
STRING |
Status of this ad unit. Possible values are: NEW: Indicates that the ad unit was created within the last seven days and does not yet have any activity associated with it. ACTIVE: Indicates that there has been activity on this ad unit in the last seven days. INACTIVE: Indicates that there has been no activity on this ad unit in the last seven days |
= Parameter name
= Format
|
code STRING Identity code of this ad unit, not necessarily unique across ad clients |
|
contentAdsSettings OBJECT Settings specific to content ads (AFC) and highend mobile content ads (AFMC - deprecated) |
|
contentAdsSettings.backupOption OBJECT The backup option to be used in instances where no ad is available |
|
contentAdsSettings.backupOption.color STRING Color to use when type is set to COLOR |
|
contentAdsSettings.backupOption.type STRING Type of the backup option. Possible values are BLANK, COLOR and URL |
|
contentAdsSettings.backupOption.url STRING URL to use when type is set to URL |
|
contentAdsSettings.size STRING Size of this ad unit |
|
contentAdsSettings.type STRING Type of this ad unit |
|
customStyle OBJECT |
|
customStyle.colors OBJECT The colors which are included in the style. These are represented as six hexadecimal characters, similar to HTML color codes, but without the leading hash |
|
customStyle.colors.background STRING The color of the ad background |
|
customStyle.colors.border STRING The color of the ad border |
|
customStyle.colors.text STRING The color of the ad text |
|
customStyle.colors.title STRING The color of the ad title |
|
customStyle.colors.url STRING The color of the ad url |
|
customStyle.corners STRING The style of the corners in the ad (deprecated: never populated, ignored) |
|
customStyle.font OBJECT The font which is included in the style |
|
customStyle.font.family STRING The family of the font |
|
customStyle.font.size STRING The size of the font |
|
customStyle.kind STRING Kind this is, in this case adsense#adStyle |
|
feedAdsSettings OBJECT Settings specific to feed ads (AFF) - deprecated |
|
feedAdsSettings.adPosition STRING The position of the ads relative to the feed entries |
|
feedAdsSettings.frequency INTEGER The frequency at which ads should appear in the feed (i.e. every N entries) |
|
feedAdsSettings.minimumWordCount INTEGER The minimum length an entry should be in order to have attached ads |
|
feedAdsSettings.type STRING The type of ads which should appear |
|
id STRING Unique identifier of this ad unit. This should be considered an opaque identifier; it is not safe to rely on it being in any particular format |
|
kind STRING Kind of resource this is, in this case adsense#adUnit |
|
mobileContentAdsSettings OBJECT Settings specific to WAP mobile content ads (AFMC) - deprecated |
|
mobileContentAdsSettings.markupLanguage STRING The markup language to use for this ad unit |
|
mobileContentAdsSettings.scriptingLanguage STRING The scripting language to use for this ad unit |
|
mobileContentAdsSettings.size STRING Size of this ad unit |
|
mobileContentAdsSettings.type STRING Type of this ad unit |
|
name STRING Name of this ad unit |
|
savedStyleId STRING ID of the saved ad style which holds this ad unit's style information |
|
status STRING Status of this ad unit. Possible values are: NEW: Indicates that the ad unit was created within the last seven days and does not yet have any activity associated with it. ACTIVE: Indicates that there has been activity on this ad unit in the last seven days. INACTIVE: Indicates that there has been no activity on this ad unit in the last seven days |