AdSense Management API . accounts . adunits

Instance Methods

customchannels()

Returns the customchannels Resource.

get(accountId, adClientId, adUnitId)

Gets the specified ad unit in the specified ad client for the specified account.

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

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

list_next(previous_request, previous_response)

Retrieves the next page of results.

Method Details

get(accountId, adClientId, adUnitId)
Gets the specified ad unit in the specified ad client for the specified account.

Args:
  accountId: string, Account to which the ad client belongs. (required)
  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:

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

Args:
  accountId: string, Account to which the ad client belongs. (required)
  adClientId: string, Ad client for which to list ad units. (required)
  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.
  includeInactive: boolean, Whether to include inactive ad units. Default: true.
  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.
      {
        "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.
        "kind": "adsense#adUnit", # Kind of resource this is, in this case adsense#adUnit.
        "code": "A String", # Identity code of this ad unit, not necessarily unique across ad clients.
        "name": "A String", # Name of this ad unit.
        "feedAdsSettings": { # Settings specific to feed ads (AFF).
          "minimumWordCount": 42, # The minimum length an entry should be in order to have attached ads.
          "frequency": 42, # The frequency at which ads should appear in the feed (i.e. every N entries).
          "adPosition": "A String", # The position of the ads relative to the feed entries.
          "type": "A String", # The type of ads which should appear.
        },
        "savedStyleId": "A String", # ID of the saved ad style which holds this ad unit's style information.
        "contentAdsSettings": { # Settings specific to content ads (AFC) and highend mobile content ads (AFMC).
          "type": "A String", # Type of this ad unit.
          "backupOption": { # The backup option to be used in instances where no ad is available.
            "color": "A String", # Color to use when type is set to COLOR.
            "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.
          },
          "size": "A String", # Size 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.
        "mobileContentAdsSettings": { # Settings specific to WAP mobile content ads (AFMC).
          "scriptingLanguage": "A String", # The scripting language to use for this ad unit.
          "type": "A String", # Type of this ad unit.
          "markupLanguage": "A String", # The markup language to use for this ad unit.
          "size": "A String", # Size of this ad unit.
        },
        "customStyle": { # Custom style information specific to this ad unit.
          "corners": "A String", # The style of the corners in the ad.
          "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.
            "url": "A String", # The color of the ad url.
            "text": "A String", # The color of the ad text.
            "border": "A String", # The color of the ad border.
            "background": "A String", # The color of the ad background.
            "title": "A String", # The color of the ad title.
          },
          "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.
          },
          "kind": "adsense#adStyle", # Kind this is, in this case adsense#adStyle.
        },
      },
    ],
    "kind": "adsense#adUnits", # Kind of list this is, in this case adsense#adUnits.
    "etag": "A String", # ETag of this response for caching purposes.
  }
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.