Banner

An object describing a campaign ad.

Used in resources: Banners, Banner

Used in objects: AdGroup

Field nameTypeConditionsDescription
iduint32readable default_fieldAd identifier
createddatetimereadableCreation time
updateddatetimereadableLast update time
namestringreadable writableBanner name
statusstringreadable writable
choices =
  • active - Active
  • deleted - Deleted
  • blocked - Blocked
Ad status. The deleted status may also be returned for deleted banners. For an ad with status deleted, only the status can be changed.
ad_group_iduint32readable default_fieldAd group identifier
contentobject with BannerContent as valuesreadable writableBanner content. Must match the content structure of the banner field in the ad group’s package.
deliverystringreadableBanner delivery status. Possible values: pending — banner is awaiting moderation; delivering — banner can be shown; not_delivering — banner cannot be shown; reasons are described in the issues field.
issueslist of objectreadableDescription of reasons why the ad is not being shown:
  • ACCOUNT_INACTIVE - Account is inactive.
  • BANNER_STOPPED - The banner is stopped.
  • BANNER_ARCHIVED - The banner is removed.
  • CAMPAIGN_STOPPED - The campaign is stopped.
  • CAMPAIGN_ARCHIVED - The campaign is removed.
  • BANNER_BANNED - The banner is rejected by moderation.
  • BANNER_ON_MODERATION - The banner is on moderation.
moderation_reasonslist of ModerationReasonreadableReasons why the ad was banned
moderation_statusstringreadable default_fieldAd moderation status. Possible values: pending — not moderated; allowed — approved; banned — rejected.
textblocksobject with Textblock as valuesreadable writableText content blocks. Must match the textblocks structure of the banner field in the ad group’s package.
urlsobject with Urls as valuesreadable writableLink objects. Must match the urls structure of the banner field in the ad group’s package.
ord_markerstringreadable max_length=32 default_fieldCreative labeling token