Get
|
|||||
|
|
||||
Gets the specified ad unit in the specified ad client
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 2 input parameters
| Name | Format | Description |
|---|---|---|
adClientId Required |
STRING |
Ad client for which to get the ad unit |
adUnitId Required |
STRING |
Ad unit to retrieve |
= Parameter name
= Format
|
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 |