AdSense Management API . adunits

Instance Methods

customchannels()

Returns the customchannels Resource.

close()

Close httplib2 connections.

get(adClientId, adUnitId)

Gets the specified ad unit in the specified ad client.

getAdCode(adClientId, adUnitId)

Get ad code for the specified ad unit.

list(adClientId, includeInactive=None, pageToken=None, maxResults=None)

List all ad units in the specified ad client for this AdSense account.

list_next(previous_request, previous_response)

Retrieves the next page of results.

Method Details

close()
Close httplib2 connections.
get(adClientId, adUnitId)
Gets the specified ad unit in the specified ad client.

Args:
  adClientId: string, Ad client for which to get the ad unit. (required)
  adUnitId: string, Ad unit to retrieve. (required)

Returns:
  An object of the form:

    {
    "kind": "adsense#adUnit", # Kind of resource this is, in this case adsense#adUnit.
    "customStyle": { # Custom style information specific to this ad unit.
      "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
      "font": { # The font which is included in the style.
        "family": "A String", # The family of the font.
        "size": "A String", # The size of the font.
      },
      "colors": { # 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.
        "text": "A String", # The color of the ad text.
        "url": "A String", # The color of the ad url.
        "border": "A String", # The color of the ad border.
        "title": "A String", # The color of the ad title.
        "background": "A String", # The color of the ad background.
      },
      "kind": "adsense#adStyle", # Kind this is, in this case adsense#adStyle.
    },
    "contentAdsSettings": { # Settings specific to content ads (AFC) and highend mobile content ads (AFMC - deprecated).
      "size": "A String", # Size of this ad unit.
      "backupOption": { # The backup option to be used in instances where no ad is available.
        "url": "A String", # URL to use when type is set to URL.
        "type": "A String", # Type of the backup option. Possible values are BLANK, COLOR and URL.
        "color": "A String", # Color to use when type is set to COLOR.
      },
      "type": "A String", # Type of this ad unit.
    },
    "status": "A 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.
    "savedStyleId": "A String", # ID of the saved ad style which holds this ad unit's style information.
    "name": "A String", # Name of this ad unit.
    "feedAdsSettings": { # Settings specific to feed ads (AFF) - deprecated.
      "minimumWordCount": 42, # The minimum length an entry should be in order to have attached ads.
      "adPosition": "A String", # The position of the ads relative to the feed entries.
      "type": "A String", # The type of ads which should appear.
      "frequency": 42, # The frequency at which ads should appear in the feed (i.e. every N entries).
    },
    "code": "A String", # Identity code of this ad unit, not necessarily unique across ad clients.
    "mobileContentAdsSettings": { # Settings specific to WAP mobile content ads (AFMC) - deprecated.
      "scriptingLanguage": "A String", # The scripting language to use for this ad unit.
      "markupLanguage": "A String", # The markup language to use for this ad unit.
      "size": "A String", # Size of this ad unit.
      "type": "A String", # Type of this ad unit.
    },
    "id": "A 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.
  }
getAdCode(adClientId, adUnitId)
Get ad code for the specified ad unit.

Args:
  adClientId: string, Ad client with contains the ad unit. (required)
  adUnitId: string, Ad unit to get the code for. (required)

Returns:
  An object of the form:

    {
    "kind": "adsense#adCode", # Kind this is, in this case adsense#adCode.
    "ampHead": "A String", # The AMP Auto ad code snippet that goes in the head of an AMP page.
    "adCode": "A String", # The Auto ad code snippet. The ad code snippet.
    "ampBody": "A String", # The AMP Auto ad code snippet that goes in the body of an AMP page.
  }
list(adClientId, includeInactive=None, pageToken=None, maxResults=None)
List all ad units in the specified ad client for this AdSense account.

Args:
  adClientId: string, Ad client for which to list ad units. (required)
  includeInactive: boolean, Whether to include inactive ad units. Default: true.
  pageToken: string, A continuation token, used to page through ad units. To retrieve the next page, set this parameter to the value of "nextPageToken" from the previous response.
  maxResults: integer, The maximum number of ad units to include in the response, used for paging.

Returns:
  An object of the form:

    {
    "nextPageToken": "A String", # Continuation token used to page through ad units. To retrieve the next page of results, set the next request's "pageToken" value to this.
    "items": [ # The ad units returned in this list response.
      {
        "kind": "adsense#adUnit", # Kind of resource this is, in this case adsense#adUnit.
        "customStyle": { # Custom style information specific to this ad unit.
          "corners": "A String", # The style of the corners in the ad (deprecated: never populated, ignored).
          "font": { # The font which is included in the style.
            "family": "A String", # The family of the font.
            "size": "A String", # The size of the font.
          },
          "colors": { # 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.
            "text": "A String", # The color of the ad text.
            "url": "A String", # The color of the ad url.
            "border": "A String", # The color of the ad border.
            "title": "A String", # The color of the ad title.
            "background": "A String", # The color of the ad background.
          },
          "kind": "adsense#adStyle", # Kind this is, in this case adsense#adStyle.
        },
        "contentAdsSettings": { # Settings specific to content ads (AFC) and highend mobile content ads (AFMC - deprecated).
          "size": "A String", # Size of this ad unit.
          "backupOption": { # The backup option to be used in instances where no ad is available.
            "url": "A String", # URL to use when type is set to URL.
            "type": "A String", # Type of the backup option. Possible values are BLANK, COLOR and URL.
            "color": "A String", # Color to use when type is set to COLOR.
          },
          "type": "A String", # Type of this ad unit.
        },
        "status": "A 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.
        "savedStyleId": "A String", # ID of the saved ad style which holds this ad unit's style information.
        "name": "A String", # Name of this ad unit.
        "feedAdsSettings": { # Settings specific to feed ads (AFF) - deprecated.
          "minimumWordCount": 42, # The minimum length an entry should be in order to have attached ads.
          "adPosition": "A String", # The position of the ads relative to the feed entries.
          "type": "A String", # The type of ads which should appear.
          "frequency": 42, # The frequency at which ads should appear in the feed (i.e. every N entries).
        },
        "code": "A String", # Identity code of this ad unit, not necessarily unique across ad clients.
        "mobileContentAdsSettings": { # Settings specific to WAP mobile content ads (AFMC) - deprecated.
          "scriptingLanguage": "A String", # The scripting language to use for this ad unit.
          "markupLanguage": "A String", # The markup language to use for this ad unit.
          "size": "A String", # Size of this ad unit.
          "type": "A String", # Type of this ad unit.
        },
        "id": "A 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.
      },
    ],
    "etag": "A String", # ETag of this response for caching purposes.
    "kind": "adsense#adUnits", # Kind of list this is, in this case adsense#adUnits.
  }
list_next(previous_request, previous_response)
Retrieves the next page of results.

Args:
  previous_request: The request for the previous page. (required)
  previous_response: The response from the request for the previous page. (required)

Returns:
  A request object that you can call 'execute()' on to request the next
  page. Returns None if there are no more items in the collection.