1<html><body> 2<style> 3 4body, h1, h2, h3, div, span, p, pre, a { 5 margin: 0; 6 padding: 0; 7 border: 0; 8 font-weight: inherit; 9 font-style: inherit; 10 font-size: 100%; 11 font-family: inherit; 12 vertical-align: baseline; 13} 14 15body { 16 font-size: 13px; 17 padding: 1em; 18} 19 20h1 { 21 font-size: 26px; 22 margin-bottom: 1em; 23} 24 25h2 { 26 font-size: 24px; 27 margin-bottom: 1em; 28} 29 30h3 { 31 font-size: 20px; 32 margin-bottom: 1em; 33 margin-top: 1em; 34} 35 36pre, code { 37 line-height: 1.5; 38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; 39} 40 41pre { 42 margin-top: 0.5em; 43} 44 45h1, h2, h3, p { 46 font-family: Arial, sans serif; 47} 48 49h1, h2, h3 { 50 border-bottom: solid #CCC 1px; 51} 52 53.toc_element { 54 margin-top: 0.5em; 55} 56 57.firstline { 58 margin-left: 2 em; 59} 60 61.method { 62 margin-top: 1em; 63 border: solid 1px #CCC; 64 padding: 1em; 65 background: #EEE; 66} 67 68.details { 69 font-weight: bold; 70 font-size: 14px; 71} 72 73</style> 74 75<h1><a href="dfareporting_v3_2.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v3_2.creatives.html">creatives</a></h1> 76<h2>Instance Methods</h2> 77<p class="toc_element"> 78 <code><a href="#get">get(profileId, id)</a></code></p> 79<p class="firstline">Gets one creative by ID.</p> 80<p class="toc_element"> 81 <code><a href="#insert">insert(profileId, body)</a></code></p> 82<p class="firstline">Inserts a new creative.</p> 83<p class="toc_element"> 84 <code><a href="#list">list(profileId, campaignId=None, advertiserId=None, sizeIds=None, archived=None, pageToken=None, sortOrder=None, renderingIds=None, maxResults=None, active=None, companionCreativeIds=None, types=None, searchString=None, ids=None, studioCreativeId=None, sortField=None, creativeFieldIds=None)</a></code></p> 85<p class="firstline">Retrieves a list of creatives, possibly filtered. This method supports paging.</p> 86<p class="toc_element"> 87 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> 88<p class="firstline">Retrieves the next page of results.</p> 89<p class="toc_element"> 90 <code><a href="#patch">patch(profileId, id, body)</a></code></p> 91<p class="firstline">Updates an existing creative. This method supports patch semantics.</p> 92<p class="toc_element"> 93 <code><a href="#update">update(profileId, body)</a></code></p> 94<p class="firstline">Updates an existing creative.</p> 95<h3>Method Details</h3> 96<div class="method"> 97 <code class="details" id="get">get(profileId, id)</code> 98 <pre>Gets one creative by ID. 99 100Args: 101 profileId: string, User profile ID associated with this request. (required) 102 id: string, Creative ID. (required) 103 104Returns: 105 An object of the form: 106 107 { # Contains properties of a Creative. 108 "thirdPartyUrls": [ # Third-party URLs for tracking in-stream creative events. Applicable to the following creative types: all INSTREAM_VIDEO, all INSTREAM_AUDIO, and all VPAID. 109 { # Third-party Tracking URL. 110 "url": "A String", # URL for the specified third-party URL type. 111 "thirdPartyUrlType": "A String", # Third-party URL type for in-stream video and in-stream audio creatives. 112 }, 113 ], 114 "artworkType": "A String", # Type of artwork used for the creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 115 "latestTraffickedCreativeId": "A String", # Latest Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 116 "politeLoadAssetId": "A String", # The asset ID of the polite load image asset. Applicable to the creative type: DISPLAY. 117 "advertiserId": "A String", # Advertiser ID of this creative. This is a required field. Applicable to all creative types. 118 "requiredFlashPluginVersion": "A String", # The minimum required Flash plugin version for this creative. For example, 11.2.202.235. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 119 "thirdPartyBackupImageImpressionsUrl": "A String", # Third-party URL used to record backup image impressions. Applicable to the following creative types: all RICH_MEDIA. 120 "timerCustomEvents": [ # List of timer events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset is not HTML_IMAGE. 121 { # Creative Custom Event. 122 "targetType": "A String", # Target type used by the event. 123 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 124 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 125 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 126 # - If landingPageId is specified then that landing page's URL is assigned to this field. 127 # - Otherwise, the customClickThroughUrl is assigned to this field. 128 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 129 "landingPageId": "A String", # ID of the landing page for the click-through URL. 130 }, 131 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 132 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 133 "showStatusBar": True or False, # Whether to display the browser status bar. 134 "showScrollBar": True or False, # Whether to display the browser scroll bar. 135 "showAddressBar": True or False, # Whether to display the browser address bar. 136 "showMenuBar": True or False, # Whether to display the browser menu bar. 137 "title": "A String", # Title of popup window. 138 "showToolBar": True or False, # Whether to display the browser tool bar. 139 "positionType": "A String", # Popup window position either centered or at specific coordinate. 140 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 141 "top": 42, # Offset distance from top side of an asset or a window. 142 "left": 42, # Offset distance from left side of an asset or a window. 143 }, 144 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 145 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 146 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 147 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 148 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 149 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 150 }, 151 }, 152 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 153 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 154 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 155 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 156 "advertiserCustomEventName": "A String", # User-entered name for the event. 157 }, 158 ], 159 "renderingIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the rendering ID of this creative. This is a read-only field. Applicable to all creative types. 160 "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue. 161 "value": "A String", # The value of the dimension. 162 "dimensionName": "A String", # The name of the dimension. 163 "etag": "A String", # The eTag of this response for caching purposes. 164 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 165 "id": "A String", # The ID associated with the value if available. 166 }, 167 "additionalSizes": [ # Additional sizes associated with a responsive creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. Applicable to DISPLAY creatives when the primary asset type is HTML_IMAGE. 168 { # Represents the dimensions of ads, placements, creatives, or creative assets. 169 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 170 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 171 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 172 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 173 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 174 }, 175 ], 176 "fsCommand": { # FsCommand. # OpenWindow FSCommand of this creative. This lets the SWF file communicate with either Flash Player or the program hosting Flash Player, such as a web browser. This is only triggered if allowScriptAccess field is true. Applicable to the following creative types: FLASH_INPAGE. 177 "windowHeight": 42, # Height of the window. 178 "top": 42, # Distance from the top of the browser. Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER. 179 "windowWidth": 42, # Width of the window. 180 "positionOption": "A String", # Position in the browser where the window will open. 181 "left": 42, # Distance from the left of the browser.Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER. 182 }, 183 "dynamicAssetSelection": True or False, # Set this to true to enable the use of rules to target individual assets in this creative. When set to true creativeAssetSelection must be set. This also controls asset-level companions. When this is true, companion creatives should be assigned to creative assets. Learn more. Applicable to INSTREAM_VIDEO creatives. 184 "id": "A String", # ID of this creative. This is a read-only, auto-generated field. Applicable to all creative types. 185 "progressOffset": { # Video Offset # Amount of time to play the video before counting a view. Applicable to the following creative types: all INSTREAM_VIDEO. 186 "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set. Acceptable values are 0 to 100, inclusive. 187 "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set. Acceptable values are 0 to 86399, inclusive. 188 }, 189 "accountId": "A String", # Account ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types. 190 "studioTraffickedCreativeId": "A String", # Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 191 "archived": True or False, # Whether the creative is archived. Applicable to all creative types. 192 "overrideCss": "A String", # Override CSS value for rich media creatives. Applicable to the following creative types: all RICH_MEDIA. 193 "authoringSource": "A String", # Source application where creative was authored. Presently, only DBM authored creatives will have this field set. Applicable to all creative types. 194 "requiredFlashVersion": 42, # The internal Flash version for this creative as calculated by Studio. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 195 "exitCustomEvents": [ # List of exit events configured for the creative. For DISPLAY and DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags, For DISPLAY, an event is also created from the backupImageReportingLabel. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 196 { # Creative Custom Event. 197 "targetType": "A String", # Target type used by the event. 198 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 199 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 200 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 201 # - If landingPageId is specified then that landing page's URL is assigned to this field. 202 # - Otherwise, the customClickThroughUrl is assigned to this field. 203 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 204 "landingPageId": "A String", # ID of the landing page for the click-through URL. 205 }, 206 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 207 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 208 "showStatusBar": True or False, # Whether to display the browser status bar. 209 "showScrollBar": True or False, # Whether to display the browser scroll bar. 210 "showAddressBar": True or False, # Whether to display the browser address bar. 211 "showMenuBar": True or False, # Whether to display the browser menu bar. 212 "title": "A String", # Title of popup window. 213 "showToolBar": True or False, # Whether to display the browser tool bar. 214 "positionType": "A String", # Popup window position either centered or at specific coordinate. 215 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 216 "top": 42, # Offset distance from top side of an asset or a window. 217 "left": 42, # Offset distance from left side of an asset or a window. 218 }, 219 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 220 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 221 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 222 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 223 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 224 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 225 }, 226 }, 227 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 228 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 229 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 230 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 231 "advertiserCustomEventName": "A String", # User-entered name for the event. 232 }, 233 ], 234 "renderingId": "A String", # ID of current rendering version. This is a read-only field. Applicable to all creative types. 235 "counterCustomEvents": [ # List of counter events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. 236 { # Creative Custom Event. 237 "targetType": "A String", # Target type used by the event. 238 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 239 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 240 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 241 # - If landingPageId is specified then that landing page's URL is assigned to this field. 242 # - Otherwise, the customClickThroughUrl is assigned to this field. 243 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 244 "landingPageId": "A String", # ID of the landing page for the click-through URL. 245 }, 246 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 247 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 248 "showStatusBar": True or False, # Whether to display the browser status bar. 249 "showScrollBar": True or False, # Whether to display the browser scroll bar. 250 "showAddressBar": True or False, # Whether to display the browser address bar. 251 "showMenuBar": True or False, # Whether to display the browser menu bar. 252 "title": "A String", # Title of popup window. 253 "showToolBar": True or False, # Whether to display the browser tool bar. 254 "positionType": "A String", # Popup window position either centered or at specific coordinate. 255 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 256 "top": 42, # Offset distance from top side of an asset or a window. 257 "left": 42, # Offset distance from left side of an asset or a window. 258 }, 259 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 260 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 261 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 262 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 263 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 264 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 265 }, 266 }, 267 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 268 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 269 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 270 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 271 "advertiserCustomEventName": "A String", # User-entered name for the event. 272 }, 273 ], 274 "skipOffset": { # Video Offset # Amount of time to play the video before the skip button appears. Applicable to the following creative types: all INSTREAM_VIDEO. 275 "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set. Acceptable values are 0 to 100, inclusive. 276 "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set. Acceptable values are 0 to 86399, inclusive. 277 }, 278 "backupImageReportingLabel": "A String", # Reporting label used for HTML5 banner backup image. Applicable to the following creative types: DISPLAY when the primary asset type is not HTML_IMAGE. 279 "version": 42, # The version number helps you keep track of multiple versions of your creative in your reports. The version number will always be auto-generated during insert operations to start at 1. For tracking creatives the version cannot be incremented and will always remain at 1. For all other creative types the version can be incremented only by 1 during update operations. In addition, the version will be automatically incremented by 1 when undergoing Rich Media creative merging. Applicable to all creative types. 280 "creativeFieldAssignments": [ # Creative field assignments for this creative. Applicable to all creative types. 281 { # Creative Field Assignment. 282 "creativeFieldId": "A String", # ID of the creative field. 283 "creativeFieldValueId": "A String", # ID of the creative field value. 284 }, 285 ], 286 "backgroundColor": "A String", # The 6-character HTML color code, beginning with #, for the background of the window area where the Flash file is displayed. Default is white. Applicable to the following creative types: FLASH_INPAGE. 287 "customKeyValues": [ # Custom key-values for a Rich Media creative. Key-values let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use key-values to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 288 "A String", 289 ], 290 "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this creative. This is a read-only field. Applicable to all creative types. 291 "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue. 292 "value": "A String", # The value of the dimension. 293 "dimensionName": "A String", # The name of the dimension. 294 "etag": "A String", # The eTag of this response for caching purposes. 295 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 296 "id": "A String", # The ID associated with the value if available. 297 }, 298 "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. This is a required field when applicable; however for IMAGE, FLASH_INPAGE creatives, and for DISPLAY creatives with a primary asset of type HTML_IMAGE, if left blank, this field will be automatically set using the actual size of the associated image assets. Applicable to the following creative types: DISPLAY, DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA. 299 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 300 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 301 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 302 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 303 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 304 }, 305 "type": "A String", # Type of this creative. This is a required field. Applicable to all creative types. 306 # 307 # Note: FLASH_INPAGE, HTML5_BANNER, and IMAGE are only used for existing creatives. New creatives should use DISPLAY as a replacement for these types. 308 "totalFileSize": "A String", # Combined size of all creative assets. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 309 "mediaDuration": 3.14, # Creative audio or video duration in seconds. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO, INSTREAM_AUDIO, all RICH_MEDIA, and all VPAID. 310 "thirdPartyRichMediaImpressionsUrl": "A String", # Third-party URL used to record rich media impressions. Applicable to the following creative types: all RICH_MEDIA. 311 "studioAdvertiserId": "A String", # Studio advertiser ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 312 "creativeAssets": [ # Assets associated with a creative. Applicable to all but the following creative types: INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and REDIRECT 313 { # Creative Asset. 314 "mimeType": "A String", # Detected MIME type for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 315 "artworkType": "A String", # Artwork type of rich media creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 316 "positionLeftUnit": "A String", # Offset left unit for an asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 317 "collapsedSize": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size of an asset when collapsed. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN. 318 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 319 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 320 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 321 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 322 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 323 }, 324 "flashVersion": 42, # Flash version of the asset. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 325 "additionalSizes": [ # Additional sizes associated with this creative asset. HTML5 asset generated by compatible software such as GWD will be able to support more sizes this creative asset can render. 326 { # Represents the dimensions of ads, placements, creatives, or creative assets. 327 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 328 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 329 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 330 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 331 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 332 }, 333 ], 334 "hideFlashObjects": True or False, # Whether to hide Flash objects flag for an asset. Applicable to the following creative types: all RICH_MEDIA. 335 "detectedFeatures": [ # List of feature dependencies for the creative asset that are detected by Campaign Manager. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative correctly. This is a read-only, auto-generated field. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 336 "A String", 337 ], 338 "originalBackup": True or False, # Whether the backup asset is original or changed by the user in Campaign Manager. Applicable to the following creative types: all RICH_MEDIA. 339 "duration": 42, # Duration in seconds for which an asset will be displayed. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and VPAID_LINEAR_VIDEO. Value must be greater than or equal to 1. 340 "positionTopUnit": "A String", # Offset top unit for an asset. This is a read-only field if the asset displayType is ASSET_DISPLAY_TYPE_OVERLAY. Applicable to the following creative types: all RICH_MEDIA. 341 "id": "A String", # Numeric ID of this creative asset. This is a required field and should not be modified. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 342 "alignment": "A String", # Possible alignments for an asset. This is a read-only field. Applicable to the following creative types: RICH_MEDIA_DISPLAY_MULTI_FLOATING_INTERSTITIAL. 343 "orientation": "A String", # Orientation of video asset. This is a read-only, auto-generated field. 344 "position": { # Offset Position. # Offset position for an asset. Applicable to the following creative types: all RICH_MEDIA. 345 "top": 42, # Offset distance from top side of an asset or a window. 346 "left": 42, # Offset distance from left side of an asset or a window. 347 }, 348 "horizontallyLocked": True or False, # Whether the asset is horizontally locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 349 "startTimeType": "A String", # Initial wait time type before making the asset visible. Applicable to the following creative types: all RICH_MEDIA. 350 "displayType": "A String", # Type of rich media asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 351 "expandedDimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Detected expanded dimension for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID. 352 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 353 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 354 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 355 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 356 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 357 }, 358 "verticallyLocked": True or False, # Whether the asset is vertically locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 359 "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the asset. This is a read-only, auto-generated field. 360 "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue. 361 "value": "A String", # The value of the dimension. 362 "dimensionName": "A String", # The name of the dimension. 363 "etag": "A String", # The eTag of this response for caching purposes. 364 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 365 "id": "A String", # The ID associated with the value if available. 366 }, 367 "role": "A String", # Role of the asset in relation to creative. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. This is a required field. 368 # PRIMARY applies to DISPLAY, FLASH_INPAGE, HTML5_BANNER, IMAGE, DISPLAY_IMAGE_GALLERY, all RICH_MEDIA (which may contain multiple primary assets), and all VPAID creatives. 369 # BACKUP_IMAGE applies to FLASH_INPAGE, HTML5_BANNER, all RICH_MEDIA, and all VPAID creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 370 # ADDITIONAL_IMAGE and ADDITIONAL_FLASH apply to FLASH_INPAGE creatives. 371 # OTHER refers to assets from sources other than Campaign Manager, such as Studio uploaded assets, applicable to all RICH_MEDIA and all VPAID creatives. 372 # PARENT_VIDEO refers to videos uploaded by the user in Campaign Manager and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives. 373 # TRANSCODED_VIDEO refers to videos transcoded by Campaign Manager from PARENT_VIDEO assets and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives. 374 # ALTERNATE_VIDEO refers to the Campaign Manager representation of child asset videos from Studio, and is applicable to VPAID_LINEAR_VIDEO creatives. These cannot be added or removed within Campaign Manager. 375 # For VPAID_LINEAR_VIDEO creatives, PARENT_VIDEO, TRANSCODED_VIDEO and ALTERNATE_VIDEO assets that are marked active serve as backup in case the VPAID creative cannot be served. Only PARENT_VIDEO assets can be added or removed for an INSTREAM_VIDEO or VPAID_LINEAR_VIDEO creative. 376 # PARENT_AUDIO refers to audios uploaded by the user in Campaign Manager and is applicable to INSTREAM_AUDIO creatives. 377 # TRANSCODED_AUDIO refers to audios transcoded by Campaign Manager from PARENT_AUDIO assets and is applicable to INSTREAM_AUDIO creatives. 378 "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative asset. This is a required field when applicable; however for IMAGE and FLASH_INPAGE, creatives if left blank, this field will be automatically set using the actual size of the associated image asset. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 379 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 380 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 381 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 382 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 383 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 384 }, 385 "bitRate": 42, # Detected bit-rate for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 386 "windowMode": "A String", # Window mode options for flash assets. Applicable to the following creative types: FLASH_INPAGE, RICH_MEDIA_DISPLAY_EXPANDING, RICH_MEDIA_IM_EXPAND, RICH_MEDIA_DISPLAY_BANNER, and RICH_MEDIA_INPAGE_FLOATING. 387 "pushdown": True or False, # Whether the asset pushes down other content. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable when the asset offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height. 388 "progressiveServingUrl": "A String", # Progressive URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID. 389 "durationType": "A String", # Duration type for which an asset will be displayed. Applicable to the following creative types: all RICH_MEDIA. 390 "zIndex": 42, # zIndex value of an asset. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable to assets whose displayType is NOT one of the following types: ASSET_DISPLAY_TYPE_INPAGE or ASSET_DISPLAY_TYPE_OVERLAY. Acceptable values are -999999999 to 999999999, inclusive. 391 "fileSize": "A String", # File size associated with this creative asset. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 392 "zipFilename": "A String", # File name of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER. 393 "offset": { # Offset Position. # Offset position for an asset in collapsed mode. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, only applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN. 394 "top": 42, # Offset distance from top side of an asset or a window. 395 "left": 42, # Offset distance from left side of an asset or a window. 396 }, 397 "active": True or False, # Whether the video or audio asset is active. This is a read-only field for VPAID_NON_LINEAR_VIDEO assets. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 398 "companionCreativeIds": [ # List of companion creatives assigned to an in-stream video creative asset. Acceptable values include IDs of existing flash and image creatives. Applicable to INSTREAM_VIDEO creative type with dynamicAssetSelection set to true. 399 "A String", 400 ], 401 "hideSelectionBoxes": True or False, # Whether to hide selection boxes flag for an asset. Applicable to the following creative types: all RICH_MEDIA. 402 "streamingServingUrl": "A String", # Streaming URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID. 403 "zipFilesize": "A String", # Size of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER. 404 "childAssetType": "A String", # Rich media child asset type. This is a read-only field. Applicable to the following creative types: all VPAID. 405 "backupImageExit": { # Creative Custom Event. # Exit event configured for the backup image. Applicable to the following creative types: all RICH_MEDIA. 406 "targetType": "A String", # Target type used by the event. 407 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 408 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 409 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 410 # - If landingPageId is specified then that landing page's URL is assigned to this field. 411 # - Otherwise, the customClickThroughUrl is assigned to this field. 412 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 413 "landingPageId": "A String", # ID of the landing page for the click-through URL. 414 }, 415 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 416 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 417 "showStatusBar": True or False, # Whether to display the browser status bar. 418 "showScrollBar": True or False, # Whether to display the browser scroll bar. 419 "showAddressBar": True or False, # Whether to display the browser address bar. 420 "showMenuBar": True or False, # Whether to display the browser menu bar. 421 "title": "A String", # Title of popup window. 422 "showToolBar": True or False, # Whether to display the browser tool bar. 423 "positionType": "A String", # Popup window position either centered or at specific coordinate. 424 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 425 "top": 42, # Offset distance from top side of an asset or a window. 426 "left": 42, # Offset distance from left side of an asset or a window. 427 }, 428 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 429 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 430 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 431 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 432 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 433 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 434 }, 435 }, 436 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 437 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 438 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 439 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 440 "advertiserCustomEventName": "A String", # User-entered name for the event. 441 }, 442 "actionScript3": True or False, # Whether ActionScript3 is enabled for the flash asset. This is a read-only field. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 443 "pushdownDuration": 3.14, # Pushdown duration in seconds for an asset. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable when the asset pushdown field is true, the offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height. Acceptable values are 0 to 9.99, inclusive. 444 "assetIdentifier": { # Creative Asset ID. # Identifier of this asset. This is the same identifier returned during creative asset insert operation. This is a required field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 445 "type": "A String", # Type of asset to upload. This is a required field. FLASH and IMAGE are no longer supported for new uploads. All image assets should use HTML_IMAGE. 446 "name": "A String", # Name of the creative asset. This is a required field while inserting an asset. After insertion, this assetIdentifier is used to identify the uploaded asset. Characters in the name must be alphanumeric or one of the following: ".-_ ". Spaces are allowed. 447 }, 448 "transparency": True or False, # Whether the asset is transparent. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable to HTML5 assets. 449 "sslCompliant": True or False, # Whether the asset is SSL-compliant. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 450 "mediaDuration": 3.14, # Detected duration for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 451 "customStartTimeValue": 42, # Custom start time in seconds for making the asset visible. Applicable to the following creative types: all RICH_MEDIA. Value must be greater than or equal to 0. 452 }, 453 ], 454 "redirectUrl": "A String", # URL of hosted image or hosted video or another ad tag. For INSTREAM_VIDEO_REDIRECT creatives this is the in-stream video redirect URL. The standard for a VAST (Video Ad Serving Template) ad response allows for a redirect link to another VAST 2.0 or 3.0 call. This is a required field when applicable. Applicable to the following creative types: DISPLAY_REDIRECT, INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO_REDIRECT 455 "autoAdvanceImages": True or False, # Whether images are automatically advanced for image gallery creatives. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY. 456 "htmlCodeLocked": True or False, # Whether HTML code is generated by Campaign Manager or manually entered. Set to true to ignore changes to htmlCode. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. 457 "convertFlashToHtml5": True or False, # Whether Flash assets associated with the creative need to be automatically converted to HTML5. This flag is enabled by default and users can choose to disable it if they don't want the system to generate and use HTML5 asset for this creative. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 458 "clickTags": [ # Click tags of the creative. For DISPLAY, FLASH_INPAGE, and HTML5_BANNER creatives, this is a subset of detected click tags for the assets associated with this creative. After creating a flash asset, detected click tags will be returned in the creativeAssetMetadata. When inserting the creative, populate the creative clickTags field using the creativeAssetMetadata.clickTags field. For DISPLAY_IMAGE_GALLERY creatives, there should be exactly one entry in this list for each image creative asset. A click tag is matched with a corresponding creative asset by matching the clickTag.name field with the creativeAsset.assetIdentifier.name field. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 459 { # Creative Click Tag. 460 "eventName": "A String", # Advertiser event name associated with the click tag. This field is used by DISPLAY_IMAGE_GALLERY and HTML5_BANNER creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 461 "clickThroughUrl": { # Click-through URL # Parameter value for the specified click tag. This field contains a click-through url. 462 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 463 # - If landingPageId is specified then that landing page's URL is assigned to this field. 464 # - Otherwise, the customClickThroughUrl is assigned to this field. 465 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 466 "landingPageId": "A String", # ID of the landing page for the click-through URL. 467 }, 468 "name": "A String", # Parameter name for the specified click tag. For DISPLAY_IMAGE_GALLERY creative assets, this field must match the value of the creative asset's creativeAssetId.name field. 469 }, 470 ], 471 "commercialId": "A String", # Industry standard ID assigned to creative for reach and frequency. Applicable to INSTREAM_VIDEO_REDIRECT creatives. 472 "active": True or False, # Whether the creative is active. Applicable to all creative types. 473 "compatibility": [ # Compatibilities associated with this creative. This is a read-only field. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering either on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are for rendering in mobile apps. Only pre-existing creatives may have these compatibilities since new creatives will either be assigned DISPLAY or DISPLAY_INTERSTITIAL instead. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. IN_STREAM_AUDIO refers to rendering in in-stream audio ads developed with the VAST standard. Applicable to all creative types. 474 # 475 # Acceptable values are: 476 # - "APP" 477 # - "APP_INTERSTITIAL" 478 # - "IN_STREAM_VIDEO" 479 # - "IN_STREAM_AUDIO" 480 # - "DISPLAY" 481 # - "DISPLAY_INTERSTITIAL" 482 "A String", 483 ], 484 "universalAdId": { # A Universal Ad ID as per the VAST 4.0 spec. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and VPAID. # A Universal Ad ID as per the VAST 4.0 spec. Applicable to the following creative types: INSTREAM_AUDIO and INSTREAM_VIDEO and VPAID. 485 "registry": "A String", # Registry used for the Ad ID value. 486 "value": "A String", # ID value for this creative. Only alphanumeric characters and the following symbols are valid: "_/\-". Maximum length is 64 characters. Read only when registry is DCM. 487 }, 488 "adParameters": "A String", # Ad parameters user for VPAID creative. This is a read-only field. Applicable to the following creative types: all VPAID. 489 "adTagKeys": [ # Keywords for a Rich Media creative. Keywords let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use keywords to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 490 "A String", 491 ], 492 "kind": "dfareporting#creative", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creative". 493 "subaccountId": "A String", # Subaccount ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types. 494 "name": "A String", # Name of the creative. This is a required field and must be less than 256 characters long. Applicable to all creative types. 495 "sslOverride": True or False, # Whether creative should be treated as SSL compliant even if the system scan shows it's not. Applicable to all creative types. 496 "lastModifiedInfo": { # Modification timestamp. # Creative last modification information. This is a read-only field. Applicable to all creative types. 497 "time": "A String", # Timestamp of the last change in milliseconds since epoch. 498 }, 499 "backupImageClickThroughUrl": { # Click-through URL # Click-through URL for backup image. Applicable to ENHANCED_BANNER when the primary asset type is not HTML_IMAGE. 500 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 501 # - If landingPageId is specified then that landing page's URL is assigned to this field. 502 # - Otherwise, the customClickThroughUrl is assigned to this field. 503 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 504 "landingPageId": "A String", # ID of the landing page for the click-through URL. 505 }, 506 "sslCompliant": True or False, # Whether the creative is SSL-compliant. This is a read-only field. Applicable to all creative types. 507 "studioCreativeId": "A String", # Studio creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 508 "authoringTool": "A String", # Authoring tool for HTML5 banner creatives. This is a read-only field. Applicable to the following creative types: HTML5_BANNER. 509 "allowScriptAccess": True or False, # Whether script access is allowed for this creative. This is a read-only and deprecated field which will automatically be set to true on update. Applicable to the following creative types: FLASH_INPAGE. 510 "companionCreatives": [ # List of companion creatives assigned to an in-Stream video creative. Acceptable values include IDs of existing flash and image creatives. Applicable to the following creative types: all VPAID, all INSTREAM_AUDIO and all INSTREAM_VIDEO with dynamicAssetSelection set to false. 511 "A String", 512 ], 513 "creativeAssetSelection": { # Encapsulates the list of rules for asset selection and a default asset in case none of the rules match. Applicable to INSTREAM_VIDEO creatives. # Required if dynamicAssetSelection is true. 514 "rules": [ # Rules determine which asset will be served to a viewer. Rules will be evaluated in the order in which they are stored in this list. This list must contain at least one rule. Applicable to INSTREAM_VIDEO creatives. 515 { # A rule associates an asset with a targeting template for asset-level targeting. Applicable to INSTREAM_VIDEO creatives. 516 "assetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative. This is a required field. 517 "targetingTemplateId": "A String", # A targeting template ID. The targeting from the targeting template will be used to determine whether this asset should be served. This is a required field. 518 "name": "A String", # A user-friendly name for this rule. This is a required field. 519 }, 520 ], 521 "defaultAssetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative, and will be served if none of the rules match. This is a required field. 522 }, 523 "htmlCode": "A String", # HTML code for the creative. This is a required field when applicable. This field is ignored if htmlCodeLocked is true. Applicable to the following creative types: all CUSTOM, FLASH_INPAGE, and HTML5_BANNER, and all RICH_MEDIA. 524 "backupImageFeatures": [ # List of feature dependencies that will cause a backup image to be served if the browser that serves the ad does not support them. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative asset correctly. This field is initially auto-generated to contain all features detected by Campaign Manager for all the assets of this creative and can then be modified by the client. To reset this field, copy over all the creativeAssets' detected features. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 525 "A String", 526 ], 527 "backupImageTargetWindow": { # Target Window. # Target window for backup image. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 528 "customHtml": "A String", # User-entered value. 529 "targetWindowOption": "A String", # Type of browser window for which the backup image of the flash creative can be displayed. 530 }, 531 "mediaDescription": "A String", # Description of the audio or video ad. Applicable to the following creative types: all INSTREAM_VIDEO, INSTREAM_AUDIO, and all VPAID. 532 "skippable": True or False, # Whether the user can choose to skip the creative. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID. 533 }</pre> 534</div> 535 536<div class="method"> 537 <code class="details" id="insert">insert(profileId, body)</code> 538 <pre>Inserts a new creative. 539 540Args: 541 profileId: string, User profile ID associated with this request. (required) 542 body: object, The request body. (required) 543 The object takes the form of: 544 545{ # Contains properties of a Creative. 546 "thirdPartyUrls": [ # Third-party URLs for tracking in-stream creative events. Applicable to the following creative types: all INSTREAM_VIDEO, all INSTREAM_AUDIO, and all VPAID. 547 { # Third-party Tracking URL. 548 "url": "A String", # URL for the specified third-party URL type. 549 "thirdPartyUrlType": "A String", # Third-party URL type for in-stream video and in-stream audio creatives. 550 }, 551 ], 552 "artworkType": "A String", # Type of artwork used for the creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 553 "latestTraffickedCreativeId": "A String", # Latest Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 554 "politeLoadAssetId": "A String", # The asset ID of the polite load image asset. Applicable to the creative type: DISPLAY. 555 "advertiserId": "A String", # Advertiser ID of this creative. This is a required field. Applicable to all creative types. 556 "requiredFlashPluginVersion": "A String", # The minimum required Flash plugin version for this creative. For example, 11.2.202.235. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 557 "thirdPartyBackupImageImpressionsUrl": "A String", # Third-party URL used to record backup image impressions. Applicable to the following creative types: all RICH_MEDIA. 558 "timerCustomEvents": [ # List of timer events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset is not HTML_IMAGE. 559 { # Creative Custom Event. 560 "targetType": "A String", # Target type used by the event. 561 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 562 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 563 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 564 # - If landingPageId is specified then that landing page's URL is assigned to this field. 565 # - Otherwise, the customClickThroughUrl is assigned to this field. 566 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 567 "landingPageId": "A String", # ID of the landing page for the click-through URL. 568 }, 569 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 570 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 571 "showStatusBar": True or False, # Whether to display the browser status bar. 572 "showScrollBar": True or False, # Whether to display the browser scroll bar. 573 "showAddressBar": True or False, # Whether to display the browser address bar. 574 "showMenuBar": True or False, # Whether to display the browser menu bar. 575 "title": "A String", # Title of popup window. 576 "showToolBar": True or False, # Whether to display the browser tool bar. 577 "positionType": "A String", # Popup window position either centered or at specific coordinate. 578 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 579 "top": 42, # Offset distance from top side of an asset or a window. 580 "left": 42, # Offset distance from left side of an asset or a window. 581 }, 582 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 583 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 584 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 585 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 586 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 587 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 588 }, 589 }, 590 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 591 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 592 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 593 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 594 "advertiserCustomEventName": "A String", # User-entered name for the event. 595 }, 596 ], 597 "renderingIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the rendering ID of this creative. This is a read-only field. Applicable to all creative types. 598 "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue. 599 "value": "A String", # The value of the dimension. 600 "dimensionName": "A String", # The name of the dimension. 601 "etag": "A String", # The eTag of this response for caching purposes. 602 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 603 "id": "A String", # The ID associated with the value if available. 604 }, 605 "additionalSizes": [ # Additional sizes associated with a responsive creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. Applicable to DISPLAY creatives when the primary asset type is HTML_IMAGE. 606 { # Represents the dimensions of ads, placements, creatives, or creative assets. 607 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 608 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 609 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 610 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 611 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 612 }, 613 ], 614 "fsCommand": { # FsCommand. # OpenWindow FSCommand of this creative. This lets the SWF file communicate with either Flash Player or the program hosting Flash Player, such as a web browser. This is only triggered if allowScriptAccess field is true. Applicable to the following creative types: FLASH_INPAGE. 615 "windowHeight": 42, # Height of the window. 616 "top": 42, # Distance from the top of the browser. Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER. 617 "windowWidth": 42, # Width of the window. 618 "positionOption": "A String", # Position in the browser where the window will open. 619 "left": 42, # Distance from the left of the browser.Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER. 620 }, 621 "dynamicAssetSelection": True or False, # Set this to true to enable the use of rules to target individual assets in this creative. When set to true creativeAssetSelection must be set. This also controls asset-level companions. When this is true, companion creatives should be assigned to creative assets. Learn more. Applicable to INSTREAM_VIDEO creatives. 622 "id": "A String", # ID of this creative. This is a read-only, auto-generated field. Applicable to all creative types. 623 "progressOffset": { # Video Offset # Amount of time to play the video before counting a view. Applicable to the following creative types: all INSTREAM_VIDEO. 624 "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set. Acceptable values are 0 to 100, inclusive. 625 "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set. Acceptable values are 0 to 86399, inclusive. 626 }, 627 "accountId": "A String", # Account ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types. 628 "studioTraffickedCreativeId": "A String", # Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 629 "archived": True or False, # Whether the creative is archived. Applicable to all creative types. 630 "overrideCss": "A String", # Override CSS value for rich media creatives. Applicable to the following creative types: all RICH_MEDIA. 631 "authoringSource": "A String", # Source application where creative was authored. Presently, only DBM authored creatives will have this field set. Applicable to all creative types. 632 "requiredFlashVersion": 42, # The internal Flash version for this creative as calculated by Studio. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 633 "exitCustomEvents": [ # List of exit events configured for the creative. For DISPLAY and DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags, For DISPLAY, an event is also created from the backupImageReportingLabel. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 634 { # Creative Custom Event. 635 "targetType": "A String", # Target type used by the event. 636 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 637 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 638 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 639 # - If landingPageId is specified then that landing page's URL is assigned to this field. 640 # - Otherwise, the customClickThroughUrl is assigned to this field. 641 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 642 "landingPageId": "A String", # ID of the landing page for the click-through URL. 643 }, 644 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 645 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 646 "showStatusBar": True or False, # Whether to display the browser status bar. 647 "showScrollBar": True or False, # Whether to display the browser scroll bar. 648 "showAddressBar": True or False, # Whether to display the browser address bar. 649 "showMenuBar": True or False, # Whether to display the browser menu bar. 650 "title": "A String", # Title of popup window. 651 "showToolBar": True or False, # Whether to display the browser tool bar. 652 "positionType": "A String", # Popup window position either centered or at specific coordinate. 653 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 654 "top": 42, # Offset distance from top side of an asset or a window. 655 "left": 42, # Offset distance from left side of an asset or a window. 656 }, 657 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 658 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 659 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 660 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 661 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 662 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 663 }, 664 }, 665 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 666 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 667 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 668 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 669 "advertiserCustomEventName": "A String", # User-entered name for the event. 670 }, 671 ], 672 "renderingId": "A String", # ID of current rendering version. This is a read-only field. Applicable to all creative types. 673 "counterCustomEvents": [ # List of counter events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. 674 { # Creative Custom Event. 675 "targetType": "A String", # Target type used by the event. 676 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 677 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 678 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 679 # - If landingPageId is specified then that landing page's URL is assigned to this field. 680 # - Otherwise, the customClickThroughUrl is assigned to this field. 681 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 682 "landingPageId": "A String", # ID of the landing page for the click-through URL. 683 }, 684 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 685 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 686 "showStatusBar": True or False, # Whether to display the browser status bar. 687 "showScrollBar": True or False, # Whether to display the browser scroll bar. 688 "showAddressBar": True or False, # Whether to display the browser address bar. 689 "showMenuBar": True or False, # Whether to display the browser menu bar. 690 "title": "A String", # Title of popup window. 691 "showToolBar": True or False, # Whether to display the browser tool bar. 692 "positionType": "A String", # Popup window position either centered or at specific coordinate. 693 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 694 "top": 42, # Offset distance from top side of an asset or a window. 695 "left": 42, # Offset distance from left side of an asset or a window. 696 }, 697 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 698 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 699 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 700 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 701 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 702 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 703 }, 704 }, 705 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 706 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 707 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 708 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 709 "advertiserCustomEventName": "A String", # User-entered name for the event. 710 }, 711 ], 712 "skipOffset": { # Video Offset # Amount of time to play the video before the skip button appears. Applicable to the following creative types: all INSTREAM_VIDEO. 713 "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set. Acceptable values are 0 to 100, inclusive. 714 "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set. Acceptable values are 0 to 86399, inclusive. 715 }, 716 "backupImageReportingLabel": "A String", # Reporting label used for HTML5 banner backup image. Applicable to the following creative types: DISPLAY when the primary asset type is not HTML_IMAGE. 717 "version": 42, # The version number helps you keep track of multiple versions of your creative in your reports. The version number will always be auto-generated during insert operations to start at 1. For tracking creatives the version cannot be incremented and will always remain at 1. For all other creative types the version can be incremented only by 1 during update operations. In addition, the version will be automatically incremented by 1 when undergoing Rich Media creative merging. Applicable to all creative types. 718 "creativeFieldAssignments": [ # Creative field assignments for this creative. Applicable to all creative types. 719 { # Creative Field Assignment. 720 "creativeFieldId": "A String", # ID of the creative field. 721 "creativeFieldValueId": "A String", # ID of the creative field value. 722 }, 723 ], 724 "backgroundColor": "A String", # The 6-character HTML color code, beginning with #, for the background of the window area where the Flash file is displayed. Default is white. Applicable to the following creative types: FLASH_INPAGE. 725 "customKeyValues": [ # Custom key-values for a Rich Media creative. Key-values let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use key-values to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 726 "A String", 727 ], 728 "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this creative. This is a read-only field. Applicable to all creative types. 729 "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue. 730 "value": "A String", # The value of the dimension. 731 "dimensionName": "A String", # The name of the dimension. 732 "etag": "A String", # The eTag of this response for caching purposes. 733 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 734 "id": "A String", # The ID associated with the value if available. 735 }, 736 "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. This is a required field when applicable; however for IMAGE, FLASH_INPAGE creatives, and for DISPLAY creatives with a primary asset of type HTML_IMAGE, if left blank, this field will be automatically set using the actual size of the associated image assets. Applicable to the following creative types: DISPLAY, DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA. 737 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 738 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 739 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 740 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 741 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 742 }, 743 "type": "A String", # Type of this creative. This is a required field. Applicable to all creative types. 744 # 745 # Note: FLASH_INPAGE, HTML5_BANNER, and IMAGE are only used for existing creatives. New creatives should use DISPLAY as a replacement for these types. 746 "totalFileSize": "A String", # Combined size of all creative assets. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 747 "mediaDuration": 3.14, # Creative audio or video duration in seconds. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO, INSTREAM_AUDIO, all RICH_MEDIA, and all VPAID. 748 "thirdPartyRichMediaImpressionsUrl": "A String", # Third-party URL used to record rich media impressions. Applicable to the following creative types: all RICH_MEDIA. 749 "studioAdvertiserId": "A String", # Studio advertiser ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 750 "creativeAssets": [ # Assets associated with a creative. Applicable to all but the following creative types: INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and REDIRECT 751 { # Creative Asset. 752 "mimeType": "A String", # Detected MIME type for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 753 "artworkType": "A String", # Artwork type of rich media creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 754 "positionLeftUnit": "A String", # Offset left unit for an asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 755 "collapsedSize": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size of an asset when collapsed. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN. 756 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 757 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 758 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 759 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 760 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 761 }, 762 "flashVersion": 42, # Flash version of the asset. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 763 "additionalSizes": [ # Additional sizes associated with this creative asset. HTML5 asset generated by compatible software such as GWD will be able to support more sizes this creative asset can render. 764 { # Represents the dimensions of ads, placements, creatives, or creative assets. 765 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 766 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 767 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 768 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 769 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 770 }, 771 ], 772 "hideFlashObjects": True or False, # Whether to hide Flash objects flag for an asset. Applicable to the following creative types: all RICH_MEDIA. 773 "detectedFeatures": [ # List of feature dependencies for the creative asset that are detected by Campaign Manager. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative correctly. This is a read-only, auto-generated field. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 774 "A String", 775 ], 776 "originalBackup": True or False, # Whether the backup asset is original or changed by the user in Campaign Manager. Applicable to the following creative types: all RICH_MEDIA. 777 "duration": 42, # Duration in seconds for which an asset will be displayed. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and VPAID_LINEAR_VIDEO. Value must be greater than or equal to 1. 778 "positionTopUnit": "A String", # Offset top unit for an asset. This is a read-only field if the asset displayType is ASSET_DISPLAY_TYPE_OVERLAY. Applicable to the following creative types: all RICH_MEDIA. 779 "id": "A String", # Numeric ID of this creative asset. This is a required field and should not be modified. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 780 "alignment": "A String", # Possible alignments for an asset. This is a read-only field. Applicable to the following creative types: RICH_MEDIA_DISPLAY_MULTI_FLOATING_INTERSTITIAL. 781 "orientation": "A String", # Orientation of video asset. This is a read-only, auto-generated field. 782 "position": { # Offset Position. # Offset position for an asset. Applicable to the following creative types: all RICH_MEDIA. 783 "top": 42, # Offset distance from top side of an asset or a window. 784 "left": 42, # Offset distance from left side of an asset or a window. 785 }, 786 "horizontallyLocked": True or False, # Whether the asset is horizontally locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 787 "startTimeType": "A String", # Initial wait time type before making the asset visible. Applicable to the following creative types: all RICH_MEDIA. 788 "displayType": "A String", # Type of rich media asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 789 "expandedDimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Detected expanded dimension for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID. 790 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 791 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 792 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 793 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 794 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 795 }, 796 "verticallyLocked": True or False, # Whether the asset is vertically locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 797 "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the asset. This is a read-only, auto-generated field. 798 "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue. 799 "value": "A String", # The value of the dimension. 800 "dimensionName": "A String", # The name of the dimension. 801 "etag": "A String", # The eTag of this response for caching purposes. 802 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 803 "id": "A String", # The ID associated with the value if available. 804 }, 805 "role": "A String", # Role of the asset in relation to creative. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. This is a required field. 806 # PRIMARY applies to DISPLAY, FLASH_INPAGE, HTML5_BANNER, IMAGE, DISPLAY_IMAGE_GALLERY, all RICH_MEDIA (which may contain multiple primary assets), and all VPAID creatives. 807 # BACKUP_IMAGE applies to FLASH_INPAGE, HTML5_BANNER, all RICH_MEDIA, and all VPAID creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 808 # ADDITIONAL_IMAGE and ADDITIONAL_FLASH apply to FLASH_INPAGE creatives. 809 # OTHER refers to assets from sources other than Campaign Manager, such as Studio uploaded assets, applicable to all RICH_MEDIA and all VPAID creatives. 810 # PARENT_VIDEO refers to videos uploaded by the user in Campaign Manager and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives. 811 # TRANSCODED_VIDEO refers to videos transcoded by Campaign Manager from PARENT_VIDEO assets and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives. 812 # ALTERNATE_VIDEO refers to the Campaign Manager representation of child asset videos from Studio, and is applicable to VPAID_LINEAR_VIDEO creatives. These cannot be added or removed within Campaign Manager. 813 # For VPAID_LINEAR_VIDEO creatives, PARENT_VIDEO, TRANSCODED_VIDEO and ALTERNATE_VIDEO assets that are marked active serve as backup in case the VPAID creative cannot be served. Only PARENT_VIDEO assets can be added or removed for an INSTREAM_VIDEO or VPAID_LINEAR_VIDEO creative. 814 # PARENT_AUDIO refers to audios uploaded by the user in Campaign Manager and is applicable to INSTREAM_AUDIO creatives. 815 # TRANSCODED_AUDIO refers to audios transcoded by Campaign Manager from PARENT_AUDIO assets and is applicable to INSTREAM_AUDIO creatives. 816 "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative asset. This is a required field when applicable; however for IMAGE and FLASH_INPAGE, creatives if left blank, this field will be automatically set using the actual size of the associated image asset. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 817 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 818 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 819 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 820 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 821 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 822 }, 823 "bitRate": 42, # Detected bit-rate for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 824 "windowMode": "A String", # Window mode options for flash assets. Applicable to the following creative types: FLASH_INPAGE, RICH_MEDIA_DISPLAY_EXPANDING, RICH_MEDIA_IM_EXPAND, RICH_MEDIA_DISPLAY_BANNER, and RICH_MEDIA_INPAGE_FLOATING. 825 "pushdown": True or False, # Whether the asset pushes down other content. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable when the asset offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height. 826 "progressiveServingUrl": "A String", # Progressive URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID. 827 "durationType": "A String", # Duration type for which an asset will be displayed. Applicable to the following creative types: all RICH_MEDIA. 828 "zIndex": 42, # zIndex value of an asset. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable to assets whose displayType is NOT one of the following types: ASSET_DISPLAY_TYPE_INPAGE or ASSET_DISPLAY_TYPE_OVERLAY. Acceptable values are -999999999 to 999999999, inclusive. 829 "fileSize": "A String", # File size associated with this creative asset. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 830 "zipFilename": "A String", # File name of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER. 831 "offset": { # Offset Position. # Offset position for an asset in collapsed mode. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, only applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN. 832 "top": 42, # Offset distance from top side of an asset or a window. 833 "left": 42, # Offset distance from left side of an asset or a window. 834 }, 835 "active": True or False, # Whether the video or audio asset is active. This is a read-only field for VPAID_NON_LINEAR_VIDEO assets. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 836 "companionCreativeIds": [ # List of companion creatives assigned to an in-stream video creative asset. Acceptable values include IDs of existing flash and image creatives. Applicable to INSTREAM_VIDEO creative type with dynamicAssetSelection set to true. 837 "A String", 838 ], 839 "hideSelectionBoxes": True or False, # Whether to hide selection boxes flag for an asset. Applicable to the following creative types: all RICH_MEDIA. 840 "streamingServingUrl": "A String", # Streaming URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID. 841 "zipFilesize": "A String", # Size of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER. 842 "childAssetType": "A String", # Rich media child asset type. This is a read-only field. Applicable to the following creative types: all VPAID. 843 "backupImageExit": { # Creative Custom Event. # Exit event configured for the backup image. Applicable to the following creative types: all RICH_MEDIA. 844 "targetType": "A String", # Target type used by the event. 845 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 846 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 847 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 848 # - If landingPageId is specified then that landing page's URL is assigned to this field. 849 # - Otherwise, the customClickThroughUrl is assigned to this field. 850 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 851 "landingPageId": "A String", # ID of the landing page for the click-through URL. 852 }, 853 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 854 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 855 "showStatusBar": True or False, # Whether to display the browser status bar. 856 "showScrollBar": True or False, # Whether to display the browser scroll bar. 857 "showAddressBar": True or False, # Whether to display the browser address bar. 858 "showMenuBar": True or False, # Whether to display the browser menu bar. 859 "title": "A String", # Title of popup window. 860 "showToolBar": True or False, # Whether to display the browser tool bar. 861 "positionType": "A String", # Popup window position either centered or at specific coordinate. 862 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 863 "top": 42, # Offset distance from top side of an asset or a window. 864 "left": 42, # Offset distance from left side of an asset or a window. 865 }, 866 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 867 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 868 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 869 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 870 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 871 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 872 }, 873 }, 874 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 875 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 876 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 877 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 878 "advertiserCustomEventName": "A String", # User-entered name for the event. 879 }, 880 "actionScript3": True or False, # Whether ActionScript3 is enabled for the flash asset. This is a read-only field. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 881 "pushdownDuration": 3.14, # Pushdown duration in seconds for an asset. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable when the asset pushdown field is true, the offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height. Acceptable values are 0 to 9.99, inclusive. 882 "assetIdentifier": { # Creative Asset ID. # Identifier of this asset. This is the same identifier returned during creative asset insert operation. This is a required field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 883 "type": "A String", # Type of asset to upload. This is a required field. FLASH and IMAGE are no longer supported for new uploads. All image assets should use HTML_IMAGE. 884 "name": "A String", # Name of the creative asset. This is a required field while inserting an asset. After insertion, this assetIdentifier is used to identify the uploaded asset. Characters in the name must be alphanumeric or one of the following: ".-_ ". Spaces are allowed. 885 }, 886 "transparency": True or False, # Whether the asset is transparent. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable to HTML5 assets. 887 "sslCompliant": True or False, # Whether the asset is SSL-compliant. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 888 "mediaDuration": 3.14, # Detected duration for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 889 "customStartTimeValue": 42, # Custom start time in seconds for making the asset visible. Applicable to the following creative types: all RICH_MEDIA. Value must be greater than or equal to 0. 890 }, 891 ], 892 "redirectUrl": "A String", # URL of hosted image or hosted video or another ad tag. For INSTREAM_VIDEO_REDIRECT creatives this is the in-stream video redirect URL. The standard for a VAST (Video Ad Serving Template) ad response allows for a redirect link to another VAST 2.0 or 3.0 call. This is a required field when applicable. Applicable to the following creative types: DISPLAY_REDIRECT, INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO_REDIRECT 893 "autoAdvanceImages": True or False, # Whether images are automatically advanced for image gallery creatives. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY. 894 "htmlCodeLocked": True or False, # Whether HTML code is generated by Campaign Manager or manually entered. Set to true to ignore changes to htmlCode. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. 895 "convertFlashToHtml5": True or False, # Whether Flash assets associated with the creative need to be automatically converted to HTML5. This flag is enabled by default and users can choose to disable it if they don't want the system to generate and use HTML5 asset for this creative. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 896 "clickTags": [ # Click tags of the creative. For DISPLAY, FLASH_INPAGE, and HTML5_BANNER creatives, this is a subset of detected click tags for the assets associated with this creative. After creating a flash asset, detected click tags will be returned in the creativeAssetMetadata. When inserting the creative, populate the creative clickTags field using the creativeAssetMetadata.clickTags field. For DISPLAY_IMAGE_GALLERY creatives, there should be exactly one entry in this list for each image creative asset. A click tag is matched with a corresponding creative asset by matching the clickTag.name field with the creativeAsset.assetIdentifier.name field. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 897 { # Creative Click Tag. 898 "eventName": "A String", # Advertiser event name associated with the click tag. This field is used by DISPLAY_IMAGE_GALLERY and HTML5_BANNER creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 899 "clickThroughUrl": { # Click-through URL # Parameter value for the specified click tag. This field contains a click-through url. 900 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 901 # - If landingPageId is specified then that landing page's URL is assigned to this field. 902 # - Otherwise, the customClickThroughUrl is assigned to this field. 903 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 904 "landingPageId": "A String", # ID of the landing page for the click-through URL. 905 }, 906 "name": "A String", # Parameter name for the specified click tag. For DISPLAY_IMAGE_GALLERY creative assets, this field must match the value of the creative asset's creativeAssetId.name field. 907 }, 908 ], 909 "commercialId": "A String", # Industry standard ID assigned to creative for reach and frequency. Applicable to INSTREAM_VIDEO_REDIRECT creatives. 910 "active": True or False, # Whether the creative is active. Applicable to all creative types. 911 "compatibility": [ # Compatibilities associated with this creative. This is a read-only field. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering either on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are for rendering in mobile apps. Only pre-existing creatives may have these compatibilities since new creatives will either be assigned DISPLAY or DISPLAY_INTERSTITIAL instead. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. IN_STREAM_AUDIO refers to rendering in in-stream audio ads developed with the VAST standard. Applicable to all creative types. 912 # 913 # Acceptable values are: 914 # - "APP" 915 # - "APP_INTERSTITIAL" 916 # - "IN_STREAM_VIDEO" 917 # - "IN_STREAM_AUDIO" 918 # - "DISPLAY" 919 # - "DISPLAY_INTERSTITIAL" 920 "A String", 921 ], 922 "universalAdId": { # A Universal Ad ID as per the VAST 4.0 spec. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and VPAID. # A Universal Ad ID as per the VAST 4.0 spec. Applicable to the following creative types: INSTREAM_AUDIO and INSTREAM_VIDEO and VPAID. 923 "registry": "A String", # Registry used for the Ad ID value. 924 "value": "A String", # ID value for this creative. Only alphanumeric characters and the following symbols are valid: "_/\-". Maximum length is 64 characters. Read only when registry is DCM. 925 }, 926 "adParameters": "A String", # Ad parameters user for VPAID creative. This is a read-only field. Applicable to the following creative types: all VPAID. 927 "adTagKeys": [ # Keywords for a Rich Media creative. Keywords let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use keywords to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 928 "A String", 929 ], 930 "kind": "dfareporting#creative", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creative". 931 "subaccountId": "A String", # Subaccount ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types. 932 "name": "A String", # Name of the creative. This is a required field and must be less than 256 characters long. Applicable to all creative types. 933 "sslOverride": True or False, # Whether creative should be treated as SSL compliant even if the system scan shows it's not. Applicable to all creative types. 934 "lastModifiedInfo": { # Modification timestamp. # Creative last modification information. This is a read-only field. Applicable to all creative types. 935 "time": "A String", # Timestamp of the last change in milliseconds since epoch. 936 }, 937 "backupImageClickThroughUrl": { # Click-through URL # Click-through URL for backup image. Applicable to ENHANCED_BANNER when the primary asset type is not HTML_IMAGE. 938 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 939 # - If landingPageId is specified then that landing page's URL is assigned to this field. 940 # - Otherwise, the customClickThroughUrl is assigned to this field. 941 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 942 "landingPageId": "A String", # ID of the landing page for the click-through URL. 943 }, 944 "sslCompliant": True or False, # Whether the creative is SSL-compliant. This is a read-only field. Applicable to all creative types. 945 "studioCreativeId": "A String", # Studio creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 946 "authoringTool": "A String", # Authoring tool for HTML5 banner creatives. This is a read-only field. Applicable to the following creative types: HTML5_BANNER. 947 "allowScriptAccess": True or False, # Whether script access is allowed for this creative. This is a read-only and deprecated field which will automatically be set to true on update. Applicable to the following creative types: FLASH_INPAGE. 948 "companionCreatives": [ # List of companion creatives assigned to an in-Stream video creative. Acceptable values include IDs of existing flash and image creatives. Applicable to the following creative types: all VPAID, all INSTREAM_AUDIO and all INSTREAM_VIDEO with dynamicAssetSelection set to false. 949 "A String", 950 ], 951 "creativeAssetSelection": { # Encapsulates the list of rules for asset selection and a default asset in case none of the rules match. Applicable to INSTREAM_VIDEO creatives. # Required if dynamicAssetSelection is true. 952 "rules": [ # Rules determine which asset will be served to a viewer. Rules will be evaluated in the order in which they are stored in this list. This list must contain at least one rule. Applicable to INSTREAM_VIDEO creatives. 953 { # A rule associates an asset with a targeting template for asset-level targeting. Applicable to INSTREAM_VIDEO creatives. 954 "assetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative. This is a required field. 955 "targetingTemplateId": "A String", # A targeting template ID. The targeting from the targeting template will be used to determine whether this asset should be served. This is a required field. 956 "name": "A String", # A user-friendly name for this rule. This is a required field. 957 }, 958 ], 959 "defaultAssetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative, and will be served if none of the rules match. This is a required field. 960 }, 961 "htmlCode": "A String", # HTML code for the creative. This is a required field when applicable. This field is ignored if htmlCodeLocked is true. Applicable to the following creative types: all CUSTOM, FLASH_INPAGE, and HTML5_BANNER, and all RICH_MEDIA. 962 "backupImageFeatures": [ # List of feature dependencies that will cause a backup image to be served if the browser that serves the ad does not support them. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative asset correctly. This field is initially auto-generated to contain all features detected by Campaign Manager for all the assets of this creative and can then be modified by the client. To reset this field, copy over all the creativeAssets' detected features. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 963 "A String", 964 ], 965 "backupImageTargetWindow": { # Target Window. # Target window for backup image. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 966 "customHtml": "A String", # User-entered value. 967 "targetWindowOption": "A String", # Type of browser window for which the backup image of the flash creative can be displayed. 968 }, 969 "mediaDescription": "A String", # Description of the audio or video ad. Applicable to the following creative types: all INSTREAM_VIDEO, INSTREAM_AUDIO, and all VPAID. 970 "skippable": True or False, # Whether the user can choose to skip the creative. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID. 971 } 972 973 974Returns: 975 An object of the form: 976 977 { # Contains properties of a Creative. 978 "thirdPartyUrls": [ # Third-party URLs for tracking in-stream creative events. Applicable to the following creative types: all INSTREAM_VIDEO, all INSTREAM_AUDIO, and all VPAID. 979 { # Third-party Tracking URL. 980 "url": "A String", # URL for the specified third-party URL type. 981 "thirdPartyUrlType": "A String", # Third-party URL type for in-stream video and in-stream audio creatives. 982 }, 983 ], 984 "artworkType": "A String", # Type of artwork used for the creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 985 "latestTraffickedCreativeId": "A String", # Latest Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 986 "politeLoadAssetId": "A String", # The asset ID of the polite load image asset. Applicable to the creative type: DISPLAY. 987 "advertiserId": "A String", # Advertiser ID of this creative. This is a required field. Applicable to all creative types. 988 "requiredFlashPluginVersion": "A String", # The minimum required Flash plugin version for this creative. For example, 11.2.202.235. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 989 "thirdPartyBackupImageImpressionsUrl": "A String", # Third-party URL used to record backup image impressions. Applicable to the following creative types: all RICH_MEDIA. 990 "timerCustomEvents": [ # List of timer events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset is not HTML_IMAGE. 991 { # Creative Custom Event. 992 "targetType": "A String", # Target type used by the event. 993 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 994 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 995 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 996 # - If landingPageId is specified then that landing page's URL is assigned to this field. 997 # - Otherwise, the customClickThroughUrl is assigned to this field. 998 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 999 "landingPageId": "A String", # ID of the landing page for the click-through URL. 1000 }, 1001 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 1002 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 1003 "showStatusBar": True or False, # Whether to display the browser status bar. 1004 "showScrollBar": True or False, # Whether to display the browser scroll bar. 1005 "showAddressBar": True or False, # Whether to display the browser address bar. 1006 "showMenuBar": True or False, # Whether to display the browser menu bar. 1007 "title": "A String", # Title of popup window. 1008 "showToolBar": True or False, # Whether to display the browser tool bar. 1009 "positionType": "A String", # Popup window position either centered or at specific coordinate. 1010 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 1011 "top": 42, # Offset distance from top side of an asset or a window. 1012 "left": 42, # Offset distance from left side of an asset or a window. 1013 }, 1014 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 1015 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 1016 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 1017 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 1018 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 1019 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 1020 }, 1021 }, 1022 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 1023 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 1024 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 1025 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 1026 "advertiserCustomEventName": "A String", # User-entered name for the event. 1027 }, 1028 ], 1029 "renderingIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the rendering ID of this creative. This is a read-only field. Applicable to all creative types. 1030 "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue. 1031 "value": "A String", # The value of the dimension. 1032 "dimensionName": "A String", # The name of the dimension. 1033 "etag": "A String", # The eTag of this response for caching purposes. 1034 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1035 "id": "A String", # The ID associated with the value if available. 1036 }, 1037 "additionalSizes": [ # Additional sizes associated with a responsive creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. Applicable to DISPLAY creatives when the primary asset type is HTML_IMAGE. 1038 { # Represents the dimensions of ads, placements, creatives, or creative assets. 1039 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 1040 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 1041 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 1042 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 1043 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 1044 }, 1045 ], 1046 "fsCommand": { # FsCommand. # OpenWindow FSCommand of this creative. This lets the SWF file communicate with either Flash Player or the program hosting Flash Player, such as a web browser. This is only triggered if allowScriptAccess field is true. Applicable to the following creative types: FLASH_INPAGE. 1047 "windowHeight": 42, # Height of the window. 1048 "top": 42, # Distance from the top of the browser. Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER. 1049 "windowWidth": 42, # Width of the window. 1050 "positionOption": "A String", # Position in the browser where the window will open. 1051 "left": 42, # Distance from the left of the browser.Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER. 1052 }, 1053 "dynamicAssetSelection": True or False, # Set this to true to enable the use of rules to target individual assets in this creative. When set to true creativeAssetSelection must be set. This also controls asset-level companions. When this is true, companion creatives should be assigned to creative assets. Learn more. Applicable to INSTREAM_VIDEO creatives. 1054 "id": "A String", # ID of this creative. This is a read-only, auto-generated field. Applicable to all creative types. 1055 "progressOffset": { # Video Offset # Amount of time to play the video before counting a view. Applicable to the following creative types: all INSTREAM_VIDEO. 1056 "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set. Acceptable values are 0 to 100, inclusive. 1057 "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set. Acceptable values are 0 to 86399, inclusive. 1058 }, 1059 "accountId": "A String", # Account ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types. 1060 "studioTraffickedCreativeId": "A String", # Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 1061 "archived": True or False, # Whether the creative is archived. Applicable to all creative types. 1062 "overrideCss": "A String", # Override CSS value for rich media creatives. Applicable to the following creative types: all RICH_MEDIA. 1063 "authoringSource": "A String", # Source application where creative was authored. Presently, only DBM authored creatives will have this field set. Applicable to all creative types. 1064 "requiredFlashVersion": 42, # The internal Flash version for this creative as calculated by Studio. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 1065 "exitCustomEvents": [ # List of exit events configured for the creative. For DISPLAY and DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags, For DISPLAY, an event is also created from the backupImageReportingLabel. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 1066 { # Creative Custom Event. 1067 "targetType": "A String", # Target type used by the event. 1068 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 1069 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 1070 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 1071 # - If landingPageId is specified then that landing page's URL is assigned to this field. 1072 # - Otherwise, the customClickThroughUrl is assigned to this field. 1073 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 1074 "landingPageId": "A String", # ID of the landing page for the click-through URL. 1075 }, 1076 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 1077 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 1078 "showStatusBar": True or False, # Whether to display the browser status bar. 1079 "showScrollBar": True or False, # Whether to display the browser scroll bar. 1080 "showAddressBar": True or False, # Whether to display the browser address bar. 1081 "showMenuBar": True or False, # Whether to display the browser menu bar. 1082 "title": "A String", # Title of popup window. 1083 "showToolBar": True or False, # Whether to display the browser tool bar. 1084 "positionType": "A String", # Popup window position either centered or at specific coordinate. 1085 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 1086 "top": 42, # Offset distance from top side of an asset or a window. 1087 "left": 42, # Offset distance from left side of an asset or a window. 1088 }, 1089 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 1090 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 1091 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 1092 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 1093 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 1094 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 1095 }, 1096 }, 1097 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 1098 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 1099 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 1100 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 1101 "advertiserCustomEventName": "A String", # User-entered name for the event. 1102 }, 1103 ], 1104 "renderingId": "A String", # ID of current rendering version. This is a read-only field. Applicable to all creative types. 1105 "counterCustomEvents": [ # List of counter events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. 1106 { # Creative Custom Event. 1107 "targetType": "A String", # Target type used by the event. 1108 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 1109 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 1110 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 1111 # - If landingPageId is specified then that landing page's URL is assigned to this field. 1112 # - Otherwise, the customClickThroughUrl is assigned to this field. 1113 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 1114 "landingPageId": "A String", # ID of the landing page for the click-through URL. 1115 }, 1116 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 1117 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 1118 "showStatusBar": True or False, # Whether to display the browser status bar. 1119 "showScrollBar": True or False, # Whether to display the browser scroll bar. 1120 "showAddressBar": True or False, # Whether to display the browser address bar. 1121 "showMenuBar": True or False, # Whether to display the browser menu bar. 1122 "title": "A String", # Title of popup window. 1123 "showToolBar": True or False, # Whether to display the browser tool bar. 1124 "positionType": "A String", # Popup window position either centered or at specific coordinate. 1125 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 1126 "top": 42, # Offset distance from top side of an asset or a window. 1127 "left": 42, # Offset distance from left side of an asset or a window. 1128 }, 1129 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 1130 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 1131 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 1132 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 1133 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 1134 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 1135 }, 1136 }, 1137 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 1138 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 1139 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 1140 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 1141 "advertiserCustomEventName": "A String", # User-entered name for the event. 1142 }, 1143 ], 1144 "skipOffset": { # Video Offset # Amount of time to play the video before the skip button appears. Applicable to the following creative types: all INSTREAM_VIDEO. 1145 "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set. Acceptable values are 0 to 100, inclusive. 1146 "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set. Acceptable values are 0 to 86399, inclusive. 1147 }, 1148 "backupImageReportingLabel": "A String", # Reporting label used for HTML5 banner backup image. Applicable to the following creative types: DISPLAY when the primary asset type is not HTML_IMAGE. 1149 "version": 42, # The version number helps you keep track of multiple versions of your creative in your reports. The version number will always be auto-generated during insert operations to start at 1. For tracking creatives the version cannot be incremented and will always remain at 1. For all other creative types the version can be incremented only by 1 during update operations. In addition, the version will be automatically incremented by 1 when undergoing Rich Media creative merging. Applicable to all creative types. 1150 "creativeFieldAssignments": [ # Creative field assignments for this creative. Applicable to all creative types. 1151 { # Creative Field Assignment. 1152 "creativeFieldId": "A String", # ID of the creative field. 1153 "creativeFieldValueId": "A String", # ID of the creative field value. 1154 }, 1155 ], 1156 "backgroundColor": "A String", # The 6-character HTML color code, beginning with #, for the background of the window area where the Flash file is displayed. Default is white. Applicable to the following creative types: FLASH_INPAGE. 1157 "customKeyValues": [ # Custom key-values for a Rich Media creative. Key-values let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use key-values to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 1158 "A String", 1159 ], 1160 "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this creative. This is a read-only field. Applicable to all creative types. 1161 "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue. 1162 "value": "A String", # The value of the dimension. 1163 "dimensionName": "A String", # The name of the dimension. 1164 "etag": "A String", # The eTag of this response for caching purposes. 1165 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1166 "id": "A String", # The ID associated with the value if available. 1167 }, 1168 "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. This is a required field when applicable; however for IMAGE, FLASH_INPAGE creatives, and for DISPLAY creatives with a primary asset of type HTML_IMAGE, if left blank, this field will be automatically set using the actual size of the associated image assets. Applicable to the following creative types: DISPLAY, DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA. 1169 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 1170 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 1171 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 1172 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 1173 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 1174 }, 1175 "type": "A String", # Type of this creative. This is a required field. Applicable to all creative types. 1176 # 1177 # Note: FLASH_INPAGE, HTML5_BANNER, and IMAGE are only used for existing creatives. New creatives should use DISPLAY as a replacement for these types. 1178 "totalFileSize": "A String", # Combined size of all creative assets. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 1179 "mediaDuration": 3.14, # Creative audio or video duration in seconds. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO, INSTREAM_AUDIO, all RICH_MEDIA, and all VPAID. 1180 "thirdPartyRichMediaImpressionsUrl": "A String", # Third-party URL used to record rich media impressions. Applicable to the following creative types: all RICH_MEDIA. 1181 "studioAdvertiserId": "A String", # Studio advertiser ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 1182 "creativeAssets": [ # Assets associated with a creative. Applicable to all but the following creative types: INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and REDIRECT 1183 { # Creative Asset. 1184 "mimeType": "A String", # Detected MIME type for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 1185 "artworkType": "A String", # Artwork type of rich media creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 1186 "positionLeftUnit": "A String", # Offset left unit for an asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 1187 "collapsedSize": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size of an asset when collapsed. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN. 1188 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 1189 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 1190 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 1191 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 1192 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 1193 }, 1194 "flashVersion": 42, # Flash version of the asset. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 1195 "additionalSizes": [ # Additional sizes associated with this creative asset. HTML5 asset generated by compatible software such as GWD will be able to support more sizes this creative asset can render. 1196 { # Represents the dimensions of ads, placements, creatives, or creative assets. 1197 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 1198 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 1199 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 1200 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 1201 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 1202 }, 1203 ], 1204 "hideFlashObjects": True or False, # Whether to hide Flash objects flag for an asset. Applicable to the following creative types: all RICH_MEDIA. 1205 "detectedFeatures": [ # List of feature dependencies for the creative asset that are detected by Campaign Manager. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative correctly. This is a read-only, auto-generated field. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 1206 "A String", 1207 ], 1208 "originalBackup": True or False, # Whether the backup asset is original or changed by the user in Campaign Manager. Applicable to the following creative types: all RICH_MEDIA. 1209 "duration": 42, # Duration in seconds for which an asset will be displayed. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and VPAID_LINEAR_VIDEO. Value must be greater than or equal to 1. 1210 "positionTopUnit": "A String", # Offset top unit for an asset. This is a read-only field if the asset displayType is ASSET_DISPLAY_TYPE_OVERLAY. Applicable to the following creative types: all RICH_MEDIA. 1211 "id": "A String", # Numeric ID of this creative asset. This is a required field and should not be modified. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 1212 "alignment": "A String", # Possible alignments for an asset. This is a read-only field. Applicable to the following creative types: RICH_MEDIA_DISPLAY_MULTI_FLOATING_INTERSTITIAL. 1213 "orientation": "A String", # Orientation of video asset. This is a read-only, auto-generated field. 1214 "position": { # Offset Position. # Offset position for an asset. Applicable to the following creative types: all RICH_MEDIA. 1215 "top": 42, # Offset distance from top side of an asset or a window. 1216 "left": 42, # Offset distance from left side of an asset or a window. 1217 }, 1218 "horizontallyLocked": True or False, # Whether the asset is horizontally locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 1219 "startTimeType": "A String", # Initial wait time type before making the asset visible. Applicable to the following creative types: all RICH_MEDIA. 1220 "displayType": "A String", # Type of rich media asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 1221 "expandedDimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Detected expanded dimension for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID. 1222 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 1223 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 1224 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 1225 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 1226 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 1227 }, 1228 "verticallyLocked": True or False, # Whether the asset is vertically locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 1229 "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the asset. This is a read-only, auto-generated field. 1230 "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue. 1231 "value": "A String", # The value of the dimension. 1232 "dimensionName": "A String", # The name of the dimension. 1233 "etag": "A String", # The eTag of this response for caching purposes. 1234 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1235 "id": "A String", # The ID associated with the value if available. 1236 }, 1237 "role": "A String", # Role of the asset in relation to creative. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. This is a required field. 1238 # PRIMARY applies to DISPLAY, FLASH_INPAGE, HTML5_BANNER, IMAGE, DISPLAY_IMAGE_GALLERY, all RICH_MEDIA (which may contain multiple primary assets), and all VPAID creatives. 1239 # BACKUP_IMAGE applies to FLASH_INPAGE, HTML5_BANNER, all RICH_MEDIA, and all VPAID creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 1240 # ADDITIONAL_IMAGE and ADDITIONAL_FLASH apply to FLASH_INPAGE creatives. 1241 # OTHER refers to assets from sources other than Campaign Manager, such as Studio uploaded assets, applicable to all RICH_MEDIA and all VPAID creatives. 1242 # PARENT_VIDEO refers to videos uploaded by the user in Campaign Manager and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives. 1243 # TRANSCODED_VIDEO refers to videos transcoded by Campaign Manager from PARENT_VIDEO assets and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives. 1244 # ALTERNATE_VIDEO refers to the Campaign Manager representation of child asset videos from Studio, and is applicable to VPAID_LINEAR_VIDEO creatives. These cannot be added or removed within Campaign Manager. 1245 # For VPAID_LINEAR_VIDEO creatives, PARENT_VIDEO, TRANSCODED_VIDEO and ALTERNATE_VIDEO assets that are marked active serve as backup in case the VPAID creative cannot be served. Only PARENT_VIDEO assets can be added or removed for an INSTREAM_VIDEO or VPAID_LINEAR_VIDEO creative. 1246 # PARENT_AUDIO refers to audios uploaded by the user in Campaign Manager and is applicable to INSTREAM_AUDIO creatives. 1247 # TRANSCODED_AUDIO refers to audios transcoded by Campaign Manager from PARENT_AUDIO assets and is applicable to INSTREAM_AUDIO creatives. 1248 "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative asset. This is a required field when applicable; however for IMAGE and FLASH_INPAGE, creatives if left blank, this field will be automatically set using the actual size of the associated image asset. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 1249 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 1250 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 1251 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 1252 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 1253 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 1254 }, 1255 "bitRate": 42, # Detected bit-rate for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 1256 "windowMode": "A String", # Window mode options for flash assets. Applicable to the following creative types: FLASH_INPAGE, RICH_MEDIA_DISPLAY_EXPANDING, RICH_MEDIA_IM_EXPAND, RICH_MEDIA_DISPLAY_BANNER, and RICH_MEDIA_INPAGE_FLOATING. 1257 "pushdown": True or False, # Whether the asset pushes down other content. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable when the asset offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height. 1258 "progressiveServingUrl": "A String", # Progressive URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID. 1259 "durationType": "A String", # Duration type for which an asset will be displayed. Applicable to the following creative types: all RICH_MEDIA. 1260 "zIndex": 42, # zIndex value of an asset. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable to assets whose displayType is NOT one of the following types: ASSET_DISPLAY_TYPE_INPAGE or ASSET_DISPLAY_TYPE_OVERLAY. Acceptable values are -999999999 to 999999999, inclusive. 1261 "fileSize": "A String", # File size associated with this creative asset. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 1262 "zipFilename": "A String", # File name of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER. 1263 "offset": { # Offset Position. # Offset position for an asset in collapsed mode. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, only applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN. 1264 "top": 42, # Offset distance from top side of an asset or a window. 1265 "left": 42, # Offset distance from left side of an asset or a window. 1266 }, 1267 "active": True or False, # Whether the video or audio asset is active. This is a read-only field for VPAID_NON_LINEAR_VIDEO assets. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 1268 "companionCreativeIds": [ # List of companion creatives assigned to an in-stream video creative asset. Acceptable values include IDs of existing flash and image creatives. Applicable to INSTREAM_VIDEO creative type with dynamicAssetSelection set to true. 1269 "A String", 1270 ], 1271 "hideSelectionBoxes": True or False, # Whether to hide selection boxes flag for an asset. Applicable to the following creative types: all RICH_MEDIA. 1272 "streamingServingUrl": "A String", # Streaming URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID. 1273 "zipFilesize": "A String", # Size of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER. 1274 "childAssetType": "A String", # Rich media child asset type. This is a read-only field. Applicable to the following creative types: all VPAID. 1275 "backupImageExit": { # Creative Custom Event. # Exit event configured for the backup image. Applicable to the following creative types: all RICH_MEDIA. 1276 "targetType": "A String", # Target type used by the event. 1277 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 1278 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 1279 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 1280 # - If landingPageId is specified then that landing page's URL is assigned to this field. 1281 # - Otherwise, the customClickThroughUrl is assigned to this field. 1282 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 1283 "landingPageId": "A String", # ID of the landing page for the click-through URL. 1284 }, 1285 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 1286 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 1287 "showStatusBar": True or False, # Whether to display the browser status bar. 1288 "showScrollBar": True or False, # Whether to display the browser scroll bar. 1289 "showAddressBar": True or False, # Whether to display the browser address bar. 1290 "showMenuBar": True or False, # Whether to display the browser menu bar. 1291 "title": "A String", # Title of popup window. 1292 "showToolBar": True or False, # Whether to display the browser tool bar. 1293 "positionType": "A String", # Popup window position either centered or at specific coordinate. 1294 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 1295 "top": 42, # Offset distance from top side of an asset or a window. 1296 "left": 42, # Offset distance from left side of an asset or a window. 1297 }, 1298 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 1299 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 1300 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 1301 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 1302 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 1303 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 1304 }, 1305 }, 1306 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 1307 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 1308 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 1309 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 1310 "advertiserCustomEventName": "A String", # User-entered name for the event. 1311 }, 1312 "actionScript3": True or False, # Whether ActionScript3 is enabled for the flash asset. This is a read-only field. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 1313 "pushdownDuration": 3.14, # Pushdown duration in seconds for an asset. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable when the asset pushdown field is true, the offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height. Acceptable values are 0 to 9.99, inclusive. 1314 "assetIdentifier": { # Creative Asset ID. # Identifier of this asset. This is the same identifier returned during creative asset insert operation. This is a required field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 1315 "type": "A String", # Type of asset to upload. This is a required field. FLASH and IMAGE are no longer supported for new uploads. All image assets should use HTML_IMAGE. 1316 "name": "A String", # Name of the creative asset. This is a required field while inserting an asset. After insertion, this assetIdentifier is used to identify the uploaded asset. Characters in the name must be alphanumeric or one of the following: ".-_ ". Spaces are allowed. 1317 }, 1318 "transparency": True or False, # Whether the asset is transparent. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable to HTML5 assets. 1319 "sslCompliant": True or False, # Whether the asset is SSL-compliant. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 1320 "mediaDuration": 3.14, # Detected duration for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 1321 "customStartTimeValue": 42, # Custom start time in seconds for making the asset visible. Applicable to the following creative types: all RICH_MEDIA. Value must be greater than or equal to 0. 1322 }, 1323 ], 1324 "redirectUrl": "A String", # URL of hosted image or hosted video or another ad tag. For INSTREAM_VIDEO_REDIRECT creatives this is the in-stream video redirect URL. The standard for a VAST (Video Ad Serving Template) ad response allows for a redirect link to another VAST 2.0 or 3.0 call. This is a required field when applicable. Applicable to the following creative types: DISPLAY_REDIRECT, INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO_REDIRECT 1325 "autoAdvanceImages": True or False, # Whether images are automatically advanced for image gallery creatives. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY. 1326 "htmlCodeLocked": True or False, # Whether HTML code is generated by Campaign Manager or manually entered. Set to true to ignore changes to htmlCode. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. 1327 "convertFlashToHtml5": True or False, # Whether Flash assets associated with the creative need to be automatically converted to HTML5. This flag is enabled by default and users can choose to disable it if they don't want the system to generate and use HTML5 asset for this creative. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 1328 "clickTags": [ # Click tags of the creative. For DISPLAY, FLASH_INPAGE, and HTML5_BANNER creatives, this is a subset of detected click tags for the assets associated with this creative. After creating a flash asset, detected click tags will be returned in the creativeAssetMetadata. When inserting the creative, populate the creative clickTags field using the creativeAssetMetadata.clickTags field. For DISPLAY_IMAGE_GALLERY creatives, there should be exactly one entry in this list for each image creative asset. A click tag is matched with a corresponding creative asset by matching the clickTag.name field with the creativeAsset.assetIdentifier.name field. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 1329 { # Creative Click Tag. 1330 "eventName": "A String", # Advertiser event name associated with the click tag. This field is used by DISPLAY_IMAGE_GALLERY and HTML5_BANNER creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 1331 "clickThroughUrl": { # Click-through URL # Parameter value for the specified click tag. This field contains a click-through url. 1332 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 1333 # - If landingPageId is specified then that landing page's URL is assigned to this field. 1334 # - Otherwise, the customClickThroughUrl is assigned to this field. 1335 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 1336 "landingPageId": "A String", # ID of the landing page for the click-through URL. 1337 }, 1338 "name": "A String", # Parameter name for the specified click tag. For DISPLAY_IMAGE_GALLERY creative assets, this field must match the value of the creative asset's creativeAssetId.name field. 1339 }, 1340 ], 1341 "commercialId": "A String", # Industry standard ID assigned to creative for reach and frequency. Applicable to INSTREAM_VIDEO_REDIRECT creatives. 1342 "active": True or False, # Whether the creative is active. Applicable to all creative types. 1343 "compatibility": [ # Compatibilities associated with this creative. This is a read-only field. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering either on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are for rendering in mobile apps. Only pre-existing creatives may have these compatibilities since new creatives will either be assigned DISPLAY or DISPLAY_INTERSTITIAL instead. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. IN_STREAM_AUDIO refers to rendering in in-stream audio ads developed with the VAST standard. Applicable to all creative types. 1344 # 1345 # Acceptable values are: 1346 # - "APP" 1347 # - "APP_INTERSTITIAL" 1348 # - "IN_STREAM_VIDEO" 1349 # - "IN_STREAM_AUDIO" 1350 # - "DISPLAY" 1351 # - "DISPLAY_INTERSTITIAL" 1352 "A String", 1353 ], 1354 "universalAdId": { # A Universal Ad ID as per the VAST 4.0 spec. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and VPAID. # A Universal Ad ID as per the VAST 4.0 spec. Applicable to the following creative types: INSTREAM_AUDIO and INSTREAM_VIDEO and VPAID. 1355 "registry": "A String", # Registry used for the Ad ID value. 1356 "value": "A String", # ID value for this creative. Only alphanumeric characters and the following symbols are valid: "_/\-". Maximum length is 64 characters. Read only when registry is DCM. 1357 }, 1358 "adParameters": "A String", # Ad parameters user for VPAID creative. This is a read-only field. Applicable to the following creative types: all VPAID. 1359 "adTagKeys": [ # Keywords for a Rich Media creative. Keywords let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use keywords to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 1360 "A String", 1361 ], 1362 "kind": "dfareporting#creative", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creative". 1363 "subaccountId": "A String", # Subaccount ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types. 1364 "name": "A String", # Name of the creative. This is a required field and must be less than 256 characters long. Applicable to all creative types. 1365 "sslOverride": True or False, # Whether creative should be treated as SSL compliant even if the system scan shows it's not. Applicable to all creative types. 1366 "lastModifiedInfo": { # Modification timestamp. # Creative last modification information. This is a read-only field. Applicable to all creative types. 1367 "time": "A String", # Timestamp of the last change in milliseconds since epoch. 1368 }, 1369 "backupImageClickThroughUrl": { # Click-through URL # Click-through URL for backup image. Applicable to ENHANCED_BANNER when the primary asset type is not HTML_IMAGE. 1370 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 1371 # - If landingPageId is specified then that landing page's URL is assigned to this field. 1372 # - Otherwise, the customClickThroughUrl is assigned to this field. 1373 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 1374 "landingPageId": "A String", # ID of the landing page for the click-through URL. 1375 }, 1376 "sslCompliant": True or False, # Whether the creative is SSL-compliant. This is a read-only field. Applicable to all creative types. 1377 "studioCreativeId": "A String", # Studio creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 1378 "authoringTool": "A String", # Authoring tool for HTML5 banner creatives. This is a read-only field. Applicable to the following creative types: HTML5_BANNER. 1379 "allowScriptAccess": True or False, # Whether script access is allowed for this creative. This is a read-only and deprecated field which will automatically be set to true on update. Applicable to the following creative types: FLASH_INPAGE. 1380 "companionCreatives": [ # List of companion creatives assigned to an in-Stream video creative. Acceptable values include IDs of existing flash and image creatives. Applicable to the following creative types: all VPAID, all INSTREAM_AUDIO and all INSTREAM_VIDEO with dynamicAssetSelection set to false. 1381 "A String", 1382 ], 1383 "creativeAssetSelection": { # Encapsulates the list of rules for asset selection and a default asset in case none of the rules match. Applicable to INSTREAM_VIDEO creatives. # Required if dynamicAssetSelection is true. 1384 "rules": [ # Rules determine which asset will be served to a viewer. Rules will be evaluated in the order in which they are stored in this list. This list must contain at least one rule. Applicable to INSTREAM_VIDEO creatives. 1385 { # A rule associates an asset with a targeting template for asset-level targeting. Applicable to INSTREAM_VIDEO creatives. 1386 "assetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative. This is a required field. 1387 "targetingTemplateId": "A String", # A targeting template ID. The targeting from the targeting template will be used to determine whether this asset should be served. This is a required field. 1388 "name": "A String", # A user-friendly name for this rule. This is a required field. 1389 }, 1390 ], 1391 "defaultAssetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative, and will be served if none of the rules match. This is a required field. 1392 }, 1393 "htmlCode": "A String", # HTML code for the creative. This is a required field when applicable. This field is ignored if htmlCodeLocked is true. Applicable to the following creative types: all CUSTOM, FLASH_INPAGE, and HTML5_BANNER, and all RICH_MEDIA. 1394 "backupImageFeatures": [ # List of feature dependencies that will cause a backup image to be served if the browser that serves the ad does not support them. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative asset correctly. This field is initially auto-generated to contain all features detected by Campaign Manager for all the assets of this creative and can then be modified by the client. To reset this field, copy over all the creativeAssets' detected features. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 1395 "A String", 1396 ], 1397 "backupImageTargetWindow": { # Target Window. # Target window for backup image. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 1398 "customHtml": "A String", # User-entered value. 1399 "targetWindowOption": "A String", # Type of browser window for which the backup image of the flash creative can be displayed. 1400 }, 1401 "mediaDescription": "A String", # Description of the audio or video ad. Applicable to the following creative types: all INSTREAM_VIDEO, INSTREAM_AUDIO, and all VPAID. 1402 "skippable": True or False, # Whether the user can choose to skip the creative. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID. 1403 }</pre> 1404</div> 1405 1406<div class="method"> 1407 <code class="details" id="list">list(profileId, campaignId=None, advertiserId=None, sizeIds=None, archived=None, pageToken=None, sortOrder=None, renderingIds=None, maxResults=None, active=None, companionCreativeIds=None, types=None, searchString=None, ids=None, studioCreativeId=None, sortField=None, creativeFieldIds=None)</code> 1408 <pre>Retrieves a list of creatives, possibly filtered. This method supports paging. 1409 1410Args: 1411 profileId: string, User profile ID associated with this request. (required) 1412 campaignId: string, Select only creatives with this campaign ID. 1413 advertiserId: string, Select only creatives with this advertiser ID. 1414 sizeIds: string, Select only creatives with these size IDs. (repeated) 1415 archived: boolean, Select only archived creatives. Leave blank to select archived and unarchived creatives. 1416 pageToken: string, Value of the nextPageToken from the previous result page. 1417 sortOrder: string, Order of sorted results. 1418 Allowed values 1419 ASCENDING - 1420 DESCENDING - 1421 renderingIds: string, Select only creatives with these rendering IDs. (repeated) 1422 maxResults: integer, Maximum number of results to return. 1423 active: boolean, Select only active creatives. Leave blank to select active and inactive creatives. 1424 companionCreativeIds: string, Select only in-stream video creatives with these companion IDs. (repeated) 1425 types: string, Select only creatives with these creative types. (repeated) 1426 Allowed values 1427 BRAND_SAFE_DEFAULT_INSTREAM_VIDEO - 1428 CUSTOM_DISPLAY - 1429 CUSTOM_DISPLAY_INTERSTITIAL - 1430 DISPLAY - 1431 DISPLAY_IMAGE_GALLERY - 1432 DISPLAY_REDIRECT - 1433 FLASH_INPAGE - 1434 HTML5_BANNER - 1435 IMAGE - 1436 INSTREAM_AUDIO - 1437 INSTREAM_VIDEO - 1438 INSTREAM_VIDEO_REDIRECT - 1439 INTERNAL_REDIRECT - 1440 INTERSTITIAL_INTERNAL_REDIRECT - 1441 RICH_MEDIA_DISPLAY_BANNER - 1442 RICH_MEDIA_DISPLAY_EXPANDING - 1443 RICH_MEDIA_DISPLAY_INTERSTITIAL - 1444 RICH_MEDIA_DISPLAY_MULTI_FLOATING_INTERSTITIAL - 1445 RICH_MEDIA_IM_EXPAND - 1446 RICH_MEDIA_INPAGE_FLOATING - 1447 RICH_MEDIA_MOBILE_IN_APP - 1448 RICH_MEDIA_PEEL_DOWN - 1449 TRACKING_TEXT - 1450 VPAID_LINEAR_VIDEO - 1451 VPAID_NON_LINEAR_VIDEO - 1452 searchString: string, Allows searching for objects by name or ID. Wildcards (*) are allowed. For example, "creative*2015" will return objects with names like "creative June 2015", "creative April 2015", or simply "creative 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "creative" will match objects with name "my creative", "creative 2015", or simply "creative". 1453 ids: string, Select only creatives with these IDs. (repeated) 1454 studioCreativeId: string, Select only creatives corresponding to this Studio creative ID. 1455 sortField: string, Field by which to sort the list. 1456 Allowed values 1457 ID - 1458 NAME - 1459 creativeFieldIds: string, Select only creatives with these creative field IDs. (repeated) 1460 1461Returns: 1462 An object of the form: 1463 1464 { # Creative List Response 1465 "nextPageToken": "A String", # Pagination token to be used for the next list operation. 1466 "kind": "dfareporting#creativesListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creativesListResponse". 1467 "creatives": [ # Creative collection. 1468 { # Contains properties of a Creative. 1469 "thirdPartyUrls": [ # Third-party URLs for tracking in-stream creative events. Applicable to the following creative types: all INSTREAM_VIDEO, all INSTREAM_AUDIO, and all VPAID. 1470 { # Third-party Tracking URL. 1471 "url": "A String", # URL for the specified third-party URL type. 1472 "thirdPartyUrlType": "A String", # Third-party URL type for in-stream video and in-stream audio creatives. 1473 }, 1474 ], 1475 "artworkType": "A String", # Type of artwork used for the creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 1476 "latestTraffickedCreativeId": "A String", # Latest Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 1477 "politeLoadAssetId": "A String", # The asset ID of the polite load image asset. Applicable to the creative type: DISPLAY. 1478 "advertiserId": "A String", # Advertiser ID of this creative. This is a required field. Applicable to all creative types. 1479 "requiredFlashPluginVersion": "A String", # The minimum required Flash plugin version for this creative. For example, 11.2.202.235. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 1480 "thirdPartyBackupImageImpressionsUrl": "A String", # Third-party URL used to record backup image impressions. Applicable to the following creative types: all RICH_MEDIA. 1481 "timerCustomEvents": [ # List of timer events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset is not HTML_IMAGE. 1482 { # Creative Custom Event. 1483 "targetType": "A String", # Target type used by the event. 1484 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 1485 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 1486 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 1487 # - If landingPageId is specified then that landing page's URL is assigned to this field. 1488 # - Otherwise, the customClickThroughUrl is assigned to this field. 1489 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 1490 "landingPageId": "A String", # ID of the landing page for the click-through URL. 1491 }, 1492 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 1493 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 1494 "showStatusBar": True or False, # Whether to display the browser status bar. 1495 "showScrollBar": True or False, # Whether to display the browser scroll bar. 1496 "showAddressBar": True or False, # Whether to display the browser address bar. 1497 "showMenuBar": True or False, # Whether to display the browser menu bar. 1498 "title": "A String", # Title of popup window. 1499 "showToolBar": True or False, # Whether to display the browser tool bar. 1500 "positionType": "A String", # Popup window position either centered or at specific coordinate. 1501 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 1502 "top": 42, # Offset distance from top side of an asset or a window. 1503 "left": 42, # Offset distance from left side of an asset or a window. 1504 }, 1505 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 1506 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 1507 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 1508 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 1509 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 1510 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 1511 }, 1512 }, 1513 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 1514 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 1515 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 1516 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 1517 "advertiserCustomEventName": "A String", # User-entered name for the event. 1518 }, 1519 ], 1520 "renderingIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the rendering ID of this creative. This is a read-only field. Applicable to all creative types. 1521 "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue. 1522 "value": "A String", # The value of the dimension. 1523 "dimensionName": "A String", # The name of the dimension. 1524 "etag": "A String", # The eTag of this response for caching purposes. 1525 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1526 "id": "A String", # The ID associated with the value if available. 1527 }, 1528 "additionalSizes": [ # Additional sizes associated with a responsive creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. Applicable to DISPLAY creatives when the primary asset type is HTML_IMAGE. 1529 { # Represents the dimensions of ads, placements, creatives, or creative assets. 1530 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 1531 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 1532 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 1533 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 1534 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 1535 }, 1536 ], 1537 "fsCommand": { # FsCommand. # OpenWindow FSCommand of this creative. This lets the SWF file communicate with either Flash Player or the program hosting Flash Player, such as a web browser. This is only triggered if allowScriptAccess field is true. Applicable to the following creative types: FLASH_INPAGE. 1538 "windowHeight": 42, # Height of the window. 1539 "top": 42, # Distance from the top of the browser. Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER. 1540 "windowWidth": 42, # Width of the window. 1541 "positionOption": "A String", # Position in the browser where the window will open. 1542 "left": 42, # Distance from the left of the browser.Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER. 1543 }, 1544 "dynamicAssetSelection": True or False, # Set this to true to enable the use of rules to target individual assets in this creative. When set to true creativeAssetSelection must be set. This also controls asset-level companions. When this is true, companion creatives should be assigned to creative assets. Learn more. Applicable to INSTREAM_VIDEO creatives. 1545 "id": "A String", # ID of this creative. This is a read-only, auto-generated field. Applicable to all creative types. 1546 "progressOffset": { # Video Offset # Amount of time to play the video before counting a view. Applicable to the following creative types: all INSTREAM_VIDEO. 1547 "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set. Acceptable values are 0 to 100, inclusive. 1548 "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set. Acceptable values are 0 to 86399, inclusive. 1549 }, 1550 "accountId": "A String", # Account ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types. 1551 "studioTraffickedCreativeId": "A String", # Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 1552 "archived": True or False, # Whether the creative is archived. Applicable to all creative types. 1553 "overrideCss": "A String", # Override CSS value for rich media creatives. Applicable to the following creative types: all RICH_MEDIA. 1554 "authoringSource": "A String", # Source application where creative was authored. Presently, only DBM authored creatives will have this field set. Applicable to all creative types. 1555 "requiredFlashVersion": 42, # The internal Flash version for this creative as calculated by Studio. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 1556 "exitCustomEvents": [ # List of exit events configured for the creative. For DISPLAY and DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags, For DISPLAY, an event is also created from the backupImageReportingLabel. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 1557 { # Creative Custom Event. 1558 "targetType": "A String", # Target type used by the event. 1559 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 1560 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 1561 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 1562 # - If landingPageId is specified then that landing page's URL is assigned to this field. 1563 # - Otherwise, the customClickThroughUrl is assigned to this field. 1564 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 1565 "landingPageId": "A String", # ID of the landing page for the click-through URL. 1566 }, 1567 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 1568 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 1569 "showStatusBar": True or False, # Whether to display the browser status bar. 1570 "showScrollBar": True or False, # Whether to display the browser scroll bar. 1571 "showAddressBar": True or False, # Whether to display the browser address bar. 1572 "showMenuBar": True or False, # Whether to display the browser menu bar. 1573 "title": "A String", # Title of popup window. 1574 "showToolBar": True or False, # Whether to display the browser tool bar. 1575 "positionType": "A String", # Popup window position either centered or at specific coordinate. 1576 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 1577 "top": 42, # Offset distance from top side of an asset or a window. 1578 "left": 42, # Offset distance from left side of an asset or a window. 1579 }, 1580 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 1581 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 1582 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 1583 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 1584 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 1585 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 1586 }, 1587 }, 1588 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 1589 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 1590 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 1591 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 1592 "advertiserCustomEventName": "A String", # User-entered name for the event. 1593 }, 1594 ], 1595 "renderingId": "A String", # ID of current rendering version. This is a read-only field. Applicable to all creative types. 1596 "counterCustomEvents": [ # List of counter events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. 1597 { # Creative Custom Event. 1598 "targetType": "A String", # Target type used by the event. 1599 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 1600 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 1601 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 1602 # - If landingPageId is specified then that landing page's URL is assigned to this field. 1603 # - Otherwise, the customClickThroughUrl is assigned to this field. 1604 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 1605 "landingPageId": "A String", # ID of the landing page for the click-through URL. 1606 }, 1607 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 1608 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 1609 "showStatusBar": True or False, # Whether to display the browser status bar. 1610 "showScrollBar": True or False, # Whether to display the browser scroll bar. 1611 "showAddressBar": True or False, # Whether to display the browser address bar. 1612 "showMenuBar": True or False, # Whether to display the browser menu bar. 1613 "title": "A String", # Title of popup window. 1614 "showToolBar": True or False, # Whether to display the browser tool bar. 1615 "positionType": "A String", # Popup window position either centered or at specific coordinate. 1616 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 1617 "top": 42, # Offset distance from top side of an asset or a window. 1618 "left": 42, # Offset distance from left side of an asset or a window. 1619 }, 1620 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 1621 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 1622 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 1623 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 1624 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 1625 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 1626 }, 1627 }, 1628 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 1629 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 1630 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 1631 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 1632 "advertiserCustomEventName": "A String", # User-entered name for the event. 1633 }, 1634 ], 1635 "skipOffset": { # Video Offset # Amount of time to play the video before the skip button appears. Applicable to the following creative types: all INSTREAM_VIDEO. 1636 "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set. Acceptable values are 0 to 100, inclusive. 1637 "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set. Acceptable values are 0 to 86399, inclusive. 1638 }, 1639 "backupImageReportingLabel": "A String", # Reporting label used for HTML5 banner backup image. Applicable to the following creative types: DISPLAY when the primary asset type is not HTML_IMAGE. 1640 "version": 42, # The version number helps you keep track of multiple versions of your creative in your reports. The version number will always be auto-generated during insert operations to start at 1. For tracking creatives the version cannot be incremented and will always remain at 1. For all other creative types the version can be incremented only by 1 during update operations. In addition, the version will be automatically incremented by 1 when undergoing Rich Media creative merging. Applicable to all creative types. 1641 "creativeFieldAssignments": [ # Creative field assignments for this creative. Applicable to all creative types. 1642 { # Creative Field Assignment. 1643 "creativeFieldId": "A String", # ID of the creative field. 1644 "creativeFieldValueId": "A String", # ID of the creative field value. 1645 }, 1646 ], 1647 "backgroundColor": "A String", # The 6-character HTML color code, beginning with #, for the background of the window area where the Flash file is displayed. Default is white. Applicable to the following creative types: FLASH_INPAGE. 1648 "customKeyValues": [ # Custom key-values for a Rich Media creative. Key-values let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use key-values to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 1649 "A String", 1650 ], 1651 "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this creative. This is a read-only field. Applicable to all creative types. 1652 "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue. 1653 "value": "A String", # The value of the dimension. 1654 "dimensionName": "A String", # The name of the dimension. 1655 "etag": "A String", # The eTag of this response for caching purposes. 1656 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1657 "id": "A String", # The ID associated with the value if available. 1658 }, 1659 "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. This is a required field when applicable; however for IMAGE, FLASH_INPAGE creatives, and for DISPLAY creatives with a primary asset of type HTML_IMAGE, if left blank, this field will be automatically set using the actual size of the associated image assets. Applicable to the following creative types: DISPLAY, DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA. 1660 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 1661 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 1662 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 1663 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 1664 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 1665 }, 1666 "type": "A String", # Type of this creative. This is a required field. Applicable to all creative types. 1667 # 1668 # Note: FLASH_INPAGE, HTML5_BANNER, and IMAGE are only used for existing creatives. New creatives should use DISPLAY as a replacement for these types. 1669 "totalFileSize": "A String", # Combined size of all creative assets. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 1670 "mediaDuration": 3.14, # Creative audio or video duration in seconds. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO, INSTREAM_AUDIO, all RICH_MEDIA, and all VPAID. 1671 "thirdPartyRichMediaImpressionsUrl": "A String", # Third-party URL used to record rich media impressions. Applicable to the following creative types: all RICH_MEDIA. 1672 "studioAdvertiserId": "A String", # Studio advertiser ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 1673 "creativeAssets": [ # Assets associated with a creative. Applicable to all but the following creative types: INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and REDIRECT 1674 { # Creative Asset. 1675 "mimeType": "A String", # Detected MIME type for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 1676 "artworkType": "A String", # Artwork type of rich media creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 1677 "positionLeftUnit": "A String", # Offset left unit for an asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 1678 "collapsedSize": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size of an asset when collapsed. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN. 1679 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 1680 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 1681 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 1682 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 1683 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 1684 }, 1685 "flashVersion": 42, # Flash version of the asset. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 1686 "additionalSizes": [ # Additional sizes associated with this creative asset. HTML5 asset generated by compatible software such as GWD will be able to support more sizes this creative asset can render. 1687 { # Represents the dimensions of ads, placements, creatives, or creative assets. 1688 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 1689 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 1690 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 1691 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 1692 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 1693 }, 1694 ], 1695 "hideFlashObjects": True or False, # Whether to hide Flash objects flag for an asset. Applicable to the following creative types: all RICH_MEDIA. 1696 "detectedFeatures": [ # List of feature dependencies for the creative asset that are detected by Campaign Manager. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative correctly. This is a read-only, auto-generated field. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 1697 "A String", 1698 ], 1699 "originalBackup": True or False, # Whether the backup asset is original or changed by the user in Campaign Manager. Applicable to the following creative types: all RICH_MEDIA. 1700 "duration": 42, # Duration in seconds for which an asset will be displayed. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and VPAID_LINEAR_VIDEO. Value must be greater than or equal to 1. 1701 "positionTopUnit": "A String", # Offset top unit for an asset. This is a read-only field if the asset displayType is ASSET_DISPLAY_TYPE_OVERLAY. Applicable to the following creative types: all RICH_MEDIA. 1702 "id": "A String", # Numeric ID of this creative asset. This is a required field and should not be modified. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 1703 "alignment": "A String", # Possible alignments for an asset. This is a read-only field. Applicable to the following creative types: RICH_MEDIA_DISPLAY_MULTI_FLOATING_INTERSTITIAL. 1704 "orientation": "A String", # Orientation of video asset. This is a read-only, auto-generated field. 1705 "position": { # Offset Position. # Offset position for an asset. Applicable to the following creative types: all RICH_MEDIA. 1706 "top": 42, # Offset distance from top side of an asset or a window. 1707 "left": 42, # Offset distance from left side of an asset or a window. 1708 }, 1709 "horizontallyLocked": True or False, # Whether the asset is horizontally locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 1710 "startTimeType": "A String", # Initial wait time type before making the asset visible. Applicable to the following creative types: all RICH_MEDIA. 1711 "displayType": "A String", # Type of rich media asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 1712 "expandedDimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Detected expanded dimension for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID. 1713 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 1714 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 1715 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 1716 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 1717 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 1718 }, 1719 "verticallyLocked": True or False, # Whether the asset is vertically locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 1720 "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the asset. This is a read-only, auto-generated field. 1721 "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue. 1722 "value": "A String", # The value of the dimension. 1723 "dimensionName": "A String", # The name of the dimension. 1724 "etag": "A String", # The eTag of this response for caching purposes. 1725 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1726 "id": "A String", # The ID associated with the value if available. 1727 }, 1728 "role": "A String", # Role of the asset in relation to creative. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. This is a required field. 1729 # PRIMARY applies to DISPLAY, FLASH_INPAGE, HTML5_BANNER, IMAGE, DISPLAY_IMAGE_GALLERY, all RICH_MEDIA (which may contain multiple primary assets), and all VPAID creatives. 1730 # BACKUP_IMAGE applies to FLASH_INPAGE, HTML5_BANNER, all RICH_MEDIA, and all VPAID creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 1731 # ADDITIONAL_IMAGE and ADDITIONAL_FLASH apply to FLASH_INPAGE creatives. 1732 # OTHER refers to assets from sources other than Campaign Manager, such as Studio uploaded assets, applicable to all RICH_MEDIA and all VPAID creatives. 1733 # PARENT_VIDEO refers to videos uploaded by the user in Campaign Manager and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives. 1734 # TRANSCODED_VIDEO refers to videos transcoded by Campaign Manager from PARENT_VIDEO assets and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives. 1735 # ALTERNATE_VIDEO refers to the Campaign Manager representation of child asset videos from Studio, and is applicable to VPAID_LINEAR_VIDEO creatives. These cannot be added or removed within Campaign Manager. 1736 # For VPAID_LINEAR_VIDEO creatives, PARENT_VIDEO, TRANSCODED_VIDEO and ALTERNATE_VIDEO assets that are marked active serve as backup in case the VPAID creative cannot be served. Only PARENT_VIDEO assets can be added or removed for an INSTREAM_VIDEO or VPAID_LINEAR_VIDEO creative. 1737 # PARENT_AUDIO refers to audios uploaded by the user in Campaign Manager and is applicable to INSTREAM_AUDIO creatives. 1738 # TRANSCODED_AUDIO refers to audios transcoded by Campaign Manager from PARENT_AUDIO assets and is applicable to INSTREAM_AUDIO creatives. 1739 "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative asset. This is a required field when applicable; however for IMAGE and FLASH_INPAGE, creatives if left blank, this field will be automatically set using the actual size of the associated image asset. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 1740 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 1741 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 1742 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 1743 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 1744 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 1745 }, 1746 "bitRate": 42, # Detected bit-rate for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 1747 "windowMode": "A String", # Window mode options for flash assets. Applicable to the following creative types: FLASH_INPAGE, RICH_MEDIA_DISPLAY_EXPANDING, RICH_MEDIA_IM_EXPAND, RICH_MEDIA_DISPLAY_BANNER, and RICH_MEDIA_INPAGE_FLOATING. 1748 "pushdown": True or False, # Whether the asset pushes down other content. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable when the asset offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height. 1749 "progressiveServingUrl": "A String", # Progressive URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID. 1750 "durationType": "A String", # Duration type for which an asset will be displayed. Applicable to the following creative types: all RICH_MEDIA. 1751 "zIndex": 42, # zIndex value of an asset. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable to assets whose displayType is NOT one of the following types: ASSET_DISPLAY_TYPE_INPAGE or ASSET_DISPLAY_TYPE_OVERLAY. Acceptable values are -999999999 to 999999999, inclusive. 1752 "fileSize": "A String", # File size associated with this creative asset. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 1753 "zipFilename": "A String", # File name of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER. 1754 "offset": { # Offset Position. # Offset position for an asset in collapsed mode. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, only applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN. 1755 "top": 42, # Offset distance from top side of an asset or a window. 1756 "left": 42, # Offset distance from left side of an asset or a window. 1757 }, 1758 "active": True or False, # Whether the video or audio asset is active. This is a read-only field for VPAID_NON_LINEAR_VIDEO assets. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 1759 "companionCreativeIds": [ # List of companion creatives assigned to an in-stream video creative asset. Acceptable values include IDs of existing flash and image creatives. Applicable to INSTREAM_VIDEO creative type with dynamicAssetSelection set to true. 1760 "A String", 1761 ], 1762 "hideSelectionBoxes": True or False, # Whether to hide selection boxes flag for an asset. Applicable to the following creative types: all RICH_MEDIA. 1763 "streamingServingUrl": "A String", # Streaming URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID. 1764 "zipFilesize": "A String", # Size of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER. 1765 "childAssetType": "A String", # Rich media child asset type. This is a read-only field. Applicable to the following creative types: all VPAID. 1766 "backupImageExit": { # Creative Custom Event. # Exit event configured for the backup image. Applicable to the following creative types: all RICH_MEDIA. 1767 "targetType": "A String", # Target type used by the event. 1768 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 1769 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 1770 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 1771 # - If landingPageId is specified then that landing page's URL is assigned to this field. 1772 # - Otherwise, the customClickThroughUrl is assigned to this field. 1773 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 1774 "landingPageId": "A String", # ID of the landing page for the click-through URL. 1775 }, 1776 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 1777 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 1778 "showStatusBar": True or False, # Whether to display the browser status bar. 1779 "showScrollBar": True or False, # Whether to display the browser scroll bar. 1780 "showAddressBar": True or False, # Whether to display the browser address bar. 1781 "showMenuBar": True or False, # Whether to display the browser menu bar. 1782 "title": "A String", # Title of popup window. 1783 "showToolBar": True or False, # Whether to display the browser tool bar. 1784 "positionType": "A String", # Popup window position either centered or at specific coordinate. 1785 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 1786 "top": 42, # Offset distance from top side of an asset or a window. 1787 "left": 42, # Offset distance from left side of an asset or a window. 1788 }, 1789 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 1790 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 1791 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 1792 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 1793 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 1794 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 1795 }, 1796 }, 1797 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 1798 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 1799 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 1800 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 1801 "advertiserCustomEventName": "A String", # User-entered name for the event. 1802 }, 1803 "actionScript3": True or False, # Whether ActionScript3 is enabled for the flash asset. This is a read-only field. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 1804 "pushdownDuration": 3.14, # Pushdown duration in seconds for an asset. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable when the asset pushdown field is true, the offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height. Acceptable values are 0 to 9.99, inclusive. 1805 "assetIdentifier": { # Creative Asset ID. # Identifier of this asset. This is the same identifier returned during creative asset insert operation. This is a required field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 1806 "type": "A String", # Type of asset to upload. This is a required field. FLASH and IMAGE are no longer supported for new uploads. All image assets should use HTML_IMAGE. 1807 "name": "A String", # Name of the creative asset. This is a required field while inserting an asset. After insertion, this assetIdentifier is used to identify the uploaded asset. Characters in the name must be alphanumeric or one of the following: ".-_ ". Spaces are allowed. 1808 }, 1809 "transparency": True or False, # Whether the asset is transparent. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable to HTML5 assets. 1810 "sslCompliant": True or False, # Whether the asset is SSL-compliant. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 1811 "mediaDuration": 3.14, # Detected duration for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 1812 "customStartTimeValue": 42, # Custom start time in seconds for making the asset visible. Applicable to the following creative types: all RICH_MEDIA. Value must be greater than or equal to 0. 1813 }, 1814 ], 1815 "redirectUrl": "A String", # URL of hosted image or hosted video or another ad tag. For INSTREAM_VIDEO_REDIRECT creatives this is the in-stream video redirect URL. The standard for a VAST (Video Ad Serving Template) ad response allows for a redirect link to another VAST 2.0 or 3.0 call. This is a required field when applicable. Applicable to the following creative types: DISPLAY_REDIRECT, INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO_REDIRECT 1816 "autoAdvanceImages": True or False, # Whether images are automatically advanced for image gallery creatives. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY. 1817 "htmlCodeLocked": True or False, # Whether HTML code is generated by Campaign Manager or manually entered. Set to true to ignore changes to htmlCode. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. 1818 "convertFlashToHtml5": True or False, # Whether Flash assets associated with the creative need to be automatically converted to HTML5. This flag is enabled by default and users can choose to disable it if they don't want the system to generate and use HTML5 asset for this creative. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 1819 "clickTags": [ # Click tags of the creative. For DISPLAY, FLASH_INPAGE, and HTML5_BANNER creatives, this is a subset of detected click tags for the assets associated with this creative. After creating a flash asset, detected click tags will be returned in the creativeAssetMetadata. When inserting the creative, populate the creative clickTags field using the creativeAssetMetadata.clickTags field. For DISPLAY_IMAGE_GALLERY creatives, there should be exactly one entry in this list for each image creative asset. A click tag is matched with a corresponding creative asset by matching the clickTag.name field with the creativeAsset.assetIdentifier.name field. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 1820 { # Creative Click Tag. 1821 "eventName": "A String", # Advertiser event name associated with the click tag. This field is used by DISPLAY_IMAGE_GALLERY and HTML5_BANNER creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 1822 "clickThroughUrl": { # Click-through URL # Parameter value for the specified click tag. This field contains a click-through url. 1823 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 1824 # - If landingPageId is specified then that landing page's URL is assigned to this field. 1825 # - Otherwise, the customClickThroughUrl is assigned to this field. 1826 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 1827 "landingPageId": "A String", # ID of the landing page for the click-through URL. 1828 }, 1829 "name": "A String", # Parameter name for the specified click tag. For DISPLAY_IMAGE_GALLERY creative assets, this field must match the value of the creative asset's creativeAssetId.name field. 1830 }, 1831 ], 1832 "commercialId": "A String", # Industry standard ID assigned to creative for reach and frequency. Applicable to INSTREAM_VIDEO_REDIRECT creatives. 1833 "active": True or False, # Whether the creative is active. Applicable to all creative types. 1834 "compatibility": [ # Compatibilities associated with this creative. This is a read-only field. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering either on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are for rendering in mobile apps. Only pre-existing creatives may have these compatibilities since new creatives will either be assigned DISPLAY or DISPLAY_INTERSTITIAL instead. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. IN_STREAM_AUDIO refers to rendering in in-stream audio ads developed with the VAST standard. Applicable to all creative types. 1835 # 1836 # Acceptable values are: 1837 # - "APP" 1838 # - "APP_INTERSTITIAL" 1839 # - "IN_STREAM_VIDEO" 1840 # - "IN_STREAM_AUDIO" 1841 # - "DISPLAY" 1842 # - "DISPLAY_INTERSTITIAL" 1843 "A String", 1844 ], 1845 "universalAdId": { # A Universal Ad ID as per the VAST 4.0 spec. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and VPAID. # A Universal Ad ID as per the VAST 4.0 spec. Applicable to the following creative types: INSTREAM_AUDIO and INSTREAM_VIDEO and VPAID. 1846 "registry": "A String", # Registry used for the Ad ID value. 1847 "value": "A String", # ID value for this creative. Only alphanumeric characters and the following symbols are valid: "_/\-". Maximum length is 64 characters. Read only when registry is DCM. 1848 }, 1849 "adParameters": "A String", # Ad parameters user for VPAID creative. This is a read-only field. Applicable to the following creative types: all VPAID. 1850 "adTagKeys": [ # Keywords for a Rich Media creative. Keywords let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use keywords to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 1851 "A String", 1852 ], 1853 "kind": "dfareporting#creative", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creative". 1854 "subaccountId": "A String", # Subaccount ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types. 1855 "name": "A String", # Name of the creative. This is a required field and must be less than 256 characters long. Applicable to all creative types. 1856 "sslOverride": True or False, # Whether creative should be treated as SSL compliant even if the system scan shows it's not. Applicable to all creative types. 1857 "lastModifiedInfo": { # Modification timestamp. # Creative last modification information. This is a read-only field. Applicable to all creative types. 1858 "time": "A String", # Timestamp of the last change in milliseconds since epoch. 1859 }, 1860 "backupImageClickThroughUrl": { # Click-through URL # Click-through URL for backup image. Applicable to ENHANCED_BANNER when the primary asset type is not HTML_IMAGE. 1861 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 1862 # - If landingPageId is specified then that landing page's URL is assigned to this field. 1863 # - Otherwise, the customClickThroughUrl is assigned to this field. 1864 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 1865 "landingPageId": "A String", # ID of the landing page for the click-through URL. 1866 }, 1867 "sslCompliant": True or False, # Whether the creative is SSL-compliant. This is a read-only field. Applicable to all creative types. 1868 "studioCreativeId": "A String", # Studio creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 1869 "authoringTool": "A String", # Authoring tool for HTML5 banner creatives. This is a read-only field. Applicable to the following creative types: HTML5_BANNER. 1870 "allowScriptAccess": True or False, # Whether script access is allowed for this creative. This is a read-only and deprecated field which will automatically be set to true on update. Applicable to the following creative types: FLASH_INPAGE. 1871 "companionCreatives": [ # List of companion creatives assigned to an in-Stream video creative. Acceptable values include IDs of existing flash and image creatives. Applicable to the following creative types: all VPAID, all INSTREAM_AUDIO and all INSTREAM_VIDEO with dynamicAssetSelection set to false. 1872 "A String", 1873 ], 1874 "creativeAssetSelection": { # Encapsulates the list of rules for asset selection and a default asset in case none of the rules match. Applicable to INSTREAM_VIDEO creatives. # Required if dynamicAssetSelection is true. 1875 "rules": [ # Rules determine which asset will be served to a viewer. Rules will be evaluated in the order in which they are stored in this list. This list must contain at least one rule. Applicable to INSTREAM_VIDEO creatives. 1876 { # A rule associates an asset with a targeting template for asset-level targeting. Applicable to INSTREAM_VIDEO creatives. 1877 "assetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative. This is a required field. 1878 "targetingTemplateId": "A String", # A targeting template ID. The targeting from the targeting template will be used to determine whether this asset should be served. This is a required field. 1879 "name": "A String", # A user-friendly name for this rule. This is a required field. 1880 }, 1881 ], 1882 "defaultAssetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative, and will be served if none of the rules match. This is a required field. 1883 }, 1884 "htmlCode": "A String", # HTML code for the creative. This is a required field when applicable. This field is ignored if htmlCodeLocked is true. Applicable to the following creative types: all CUSTOM, FLASH_INPAGE, and HTML5_BANNER, and all RICH_MEDIA. 1885 "backupImageFeatures": [ # List of feature dependencies that will cause a backup image to be served if the browser that serves the ad does not support them. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative asset correctly. This field is initially auto-generated to contain all features detected by Campaign Manager for all the assets of this creative and can then be modified by the client. To reset this field, copy over all the creativeAssets' detected features. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 1886 "A String", 1887 ], 1888 "backupImageTargetWindow": { # Target Window. # Target window for backup image. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 1889 "customHtml": "A String", # User-entered value. 1890 "targetWindowOption": "A String", # Type of browser window for which the backup image of the flash creative can be displayed. 1891 }, 1892 "mediaDescription": "A String", # Description of the audio or video ad. Applicable to the following creative types: all INSTREAM_VIDEO, INSTREAM_AUDIO, and all VPAID. 1893 "skippable": True or False, # Whether the user can choose to skip the creative. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID. 1894 }, 1895 ], 1896 }</pre> 1897</div> 1898 1899<div class="method"> 1900 <code class="details" id="list_next">list_next(previous_request, previous_response)</code> 1901 <pre>Retrieves the next page of results. 1902 1903Args: 1904 previous_request: The request for the previous page. (required) 1905 previous_response: The response from the request for the previous page. (required) 1906 1907Returns: 1908 A request object that you can call 'execute()' on to request the next 1909 page. Returns None if there are no more items in the collection. 1910 </pre> 1911</div> 1912 1913<div class="method"> 1914 <code class="details" id="patch">patch(profileId, id, body)</code> 1915 <pre>Updates an existing creative. This method supports patch semantics. 1916 1917Args: 1918 profileId: string, User profile ID associated with this request. (required) 1919 id: string, Creative ID. (required) 1920 body: object, The request body. (required) 1921 The object takes the form of: 1922 1923{ # Contains properties of a Creative. 1924 "thirdPartyUrls": [ # Third-party URLs for tracking in-stream creative events. Applicable to the following creative types: all INSTREAM_VIDEO, all INSTREAM_AUDIO, and all VPAID. 1925 { # Third-party Tracking URL. 1926 "url": "A String", # URL for the specified third-party URL type. 1927 "thirdPartyUrlType": "A String", # Third-party URL type for in-stream video and in-stream audio creatives. 1928 }, 1929 ], 1930 "artworkType": "A String", # Type of artwork used for the creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 1931 "latestTraffickedCreativeId": "A String", # Latest Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 1932 "politeLoadAssetId": "A String", # The asset ID of the polite load image asset. Applicable to the creative type: DISPLAY. 1933 "advertiserId": "A String", # Advertiser ID of this creative. This is a required field. Applicable to all creative types. 1934 "requiredFlashPluginVersion": "A String", # The minimum required Flash plugin version for this creative. For example, 11.2.202.235. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 1935 "thirdPartyBackupImageImpressionsUrl": "A String", # Third-party URL used to record backup image impressions. Applicable to the following creative types: all RICH_MEDIA. 1936 "timerCustomEvents": [ # List of timer events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset is not HTML_IMAGE. 1937 { # Creative Custom Event. 1938 "targetType": "A String", # Target type used by the event. 1939 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 1940 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 1941 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 1942 # - If landingPageId is specified then that landing page's URL is assigned to this field. 1943 # - Otherwise, the customClickThroughUrl is assigned to this field. 1944 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 1945 "landingPageId": "A String", # ID of the landing page for the click-through URL. 1946 }, 1947 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 1948 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 1949 "showStatusBar": True or False, # Whether to display the browser status bar. 1950 "showScrollBar": True or False, # Whether to display the browser scroll bar. 1951 "showAddressBar": True or False, # Whether to display the browser address bar. 1952 "showMenuBar": True or False, # Whether to display the browser menu bar. 1953 "title": "A String", # Title of popup window. 1954 "showToolBar": True or False, # Whether to display the browser tool bar. 1955 "positionType": "A String", # Popup window position either centered or at specific coordinate. 1956 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 1957 "top": 42, # Offset distance from top side of an asset or a window. 1958 "left": 42, # Offset distance from left side of an asset or a window. 1959 }, 1960 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 1961 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 1962 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 1963 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 1964 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 1965 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 1966 }, 1967 }, 1968 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 1969 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 1970 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 1971 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 1972 "advertiserCustomEventName": "A String", # User-entered name for the event. 1973 }, 1974 ], 1975 "renderingIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the rendering ID of this creative. This is a read-only field. Applicable to all creative types. 1976 "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue. 1977 "value": "A String", # The value of the dimension. 1978 "dimensionName": "A String", # The name of the dimension. 1979 "etag": "A String", # The eTag of this response for caching purposes. 1980 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1981 "id": "A String", # The ID associated with the value if available. 1982 }, 1983 "additionalSizes": [ # Additional sizes associated with a responsive creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. Applicable to DISPLAY creatives when the primary asset type is HTML_IMAGE. 1984 { # Represents the dimensions of ads, placements, creatives, or creative assets. 1985 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 1986 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 1987 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 1988 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 1989 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 1990 }, 1991 ], 1992 "fsCommand": { # FsCommand. # OpenWindow FSCommand of this creative. This lets the SWF file communicate with either Flash Player or the program hosting Flash Player, such as a web browser. This is only triggered if allowScriptAccess field is true. Applicable to the following creative types: FLASH_INPAGE. 1993 "windowHeight": 42, # Height of the window. 1994 "top": 42, # Distance from the top of the browser. Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER. 1995 "windowWidth": 42, # Width of the window. 1996 "positionOption": "A String", # Position in the browser where the window will open. 1997 "left": 42, # Distance from the left of the browser.Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER. 1998 }, 1999 "dynamicAssetSelection": True or False, # Set this to true to enable the use of rules to target individual assets in this creative. When set to true creativeAssetSelection must be set. This also controls asset-level companions. When this is true, companion creatives should be assigned to creative assets. Learn more. Applicable to INSTREAM_VIDEO creatives. 2000 "id": "A String", # ID of this creative. This is a read-only, auto-generated field. Applicable to all creative types. 2001 "progressOffset": { # Video Offset # Amount of time to play the video before counting a view. Applicable to the following creative types: all INSTREAM_VIDEO. 2002 "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set. Acceptable values are 0 to 100, inclusive. 2003 "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set. Acceptable values are 0 to 86399, inclusive. 2004 }, 2005 "accountId": "A String", # Account ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types. 2006 "studioTraffickedCreativeId": "A String", # Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 2007 "archived": True or False, # Whether the creative is archived. Applicable to all creative types. 2008 "overrideCss": "A String", # Override CSS value for rich media creatives. Applicable to the following creative types: all RICH_MEDIA. 2009 "authoringSource": "A String", # Source application where creative was authored. Presently, only DBM authored creatives will have this field set. Applicable to all creative types. 2010 "requiredFlashVersion": 42, # The internal Flash version for this creative as calculated by Studio. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2011 "exitCustomEvents": [ # List of exit events configured for the creative. For DISPLAY and DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags, For DISPLAY, an event is also created from the backupImageReportingLabel. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2012 { # Creative Custom Event. 2013 "targetType": "A String", # Target type used by the event. 2014 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 2015 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 2016 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 2017 # - If landingPageId is specified then that landing page's URL is assigned to this field. 2018 # - Otherwise, the customClickThroughUrl is assigned to this field. 2019 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 2020 "landingPageId": "A String", # ID of the landing page for the click-through URL. 2021 }, 2022 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 2023 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 2024 "showStatusBar": True or False, # Whether to display the browser status bar. 2025 "showScrollBar": True or False, # Whether to display the browser scroll bar. 2026 "showAddressBar": True or False, # Whether to display the browser address bar. 2027 "showMenuBar": True or False, # Whether to display the browser menu bar. 2028 "title": "A String", # Title of popup window. 2029 "showToolBar": True or False, # Whether to display the browser tool bar. 2030 "positionType": "A String", # Popup window position either centered or at specific coordinate. 2031 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 2032 "top": 42, # Offset distance from top side of an asset or a window. 2033 "left": 42, # Offset distance from left side of an asset or a window. 2034 }, 2035 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 2036 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 2037 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 2038 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 2039 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 2040 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 2041 }, 2042 }, 2043 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 2044 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 2045 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 2046 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 2047 "advertiserCustomEventName": "A String", # User-entered name for the event. 2048 }, 2049 ], 2050 "renderingId": "A String", # ID of current rendering version. This is a read-only field. Applicable to all creative types. 2051 "counterCustomEvents": [ # List of counter events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. 2052 { # Creative Custom Event. 2053 "targetType": "A String", # Target type used by the event. 2054 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 2055 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 2056 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 2057 # - If landingPageId is specified then that landing page's URL is assigned to this field. 2058 # - Otherwise, the customClickThroughUrl is assigned to this field. 2059 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 2060 "landingPageId": "A String", # ID of the landing page for the click-through URL. 2061 }, 2062 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 2063 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 2064 "showStatusBar": True or False, # Whether to display the browser status bar. 2065 "showScrollBar": True or False, # Whether to display the browser scroll bar. 2066 "showAddressBar": True or False, # Whether to display the browser address bar. 2067 "showMenuBar": True or False, # Whether to display the browser menu bar. 2068 "title": "A String", # Title of popup window. 2069 "showToolBar": True or False, # Whether to display the browser tool bar. 2070 "positionType": "A String", # Popup window position either centered or at specific coordinate. 2071 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 2072 "top": 42, # Offset distance from top side of an asset or a window. 2073 "left": 42, # Offset distance from left side of an asset or a window. 2074 }, 2075 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 2076 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 2077 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 2078 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 2079 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 2080 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 2081 }, 2082 }, 2083 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 2084 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 2085 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 2086 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 2087 "advertiserCustomEventName": "A String", # User-entered name for the event. 2088 }, 2089 ], 2090 "skipOffset": { # Video Offset # Amount of time to play the video before the skip button appears. Applicable to the following creative types: all INSTREAM_VIDEO. 2091 "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set. Acceptable values are 0 to 100, inclusive. 2092 "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set. Acceptable values are 0 to 86399, inclusive. 2093 }, 2094 "backupImageReportingLabel": "A String", # Reporting label used for HTML5 banner backup image. Applicable to the following creative types: DISPLAY when the primary asset type is not HTML_IMAGE. 2095 "version": 42, # The version number helps you keep track of multiple versions of your creative in your reports. The version number will always be auto-generated during insert operations to start at 1. For tracking creatives the version cannot be incremented and will always remain at 1. For all other creative types the version can be incremented only by 1 during update operations. In addition, the version will be automatically incremented by 1 when undergoing Rich Media creative merging. Applicable to all creative types. 2096 "creativeFieldAssignments": [ # Creative field assignments for this creative. Applicable to all creative types. 2097 { # Creative Field Assignment. 2098 "creativeFieldId": "A String", # ID of the creative field. 2099 "creativeFieldValueId": "A String", # ID of the creative field value. 2100 }, 2101 ], 2102 "backgroundColor": "A String", # The 6-character HTML color code, beginning with #, for the background of the window area where the Flash file is displayed. Default is white. Applicable to the following creative types: FLASH_INPAGE. 2103 "customKeyValues": [ # Custom key-values for a Rich Media creative. Key-values let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use key-values to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 2104 "A String", 2105 ], 2106 "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this creative. This is a read-only field. Applicable to all creative types. 2107 "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue. 2108 "value": "A String", # The value of the dimension. 2109 "dimensionName": "A String", # The name of the dimension. 2110 "etag": "A String", # The eTag of this response for caching purposes. 2111 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2112 "id": "A String", # The ID associated with the value if available. 2113 }, 2114 "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. This is a required field when applicable; however for IMAGE, FLASH_INPAGE creatives, and for DISPLAY creatives with a primary asset of type HTML_IMAGE, if left blank, this field will be automatically set using the actual size of the associated image assets. Applicable to the following creative types: DISPLAY, DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA. 2115 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 2116 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 2117 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 2118 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 2119 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 2120 }, 2121 "type": "A String", # Type of this creative. This is a required field. Applicable to all creative types. 2122 # 2123 # Note: FLASH_INPAGE, HTML5_BANNER, and IMAGE are only used for existing creatives. New creatives should use DISPLAY as a replacement for these types. 2124 "totalFileSize": "A String", # Combined size of all creative assets. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 2125 "mediaDuration": 3.14, # Creative audio or video duration in seconds. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO, INSTREAM_AUDIO, all RICH_MEDIA, and all VPAID. 2126 "thirdPartyRichMediaImpressionsUrl": "A String", # Third-party URL used to record rich media impressions. Applicable to the following creative types: all RICH_MEDIA. 2127 "studioAdvertiserId": "A String", # Studio advertiser ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 2128 "creativeAssets": [ # Assets associated with a creative. Applicable to all but the following creative types: INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and REDIRECT 2129 { # Creative Asset. 2130 "mimeType": "A String", # Detected MIME type for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 2131 "artworkType": "A String", # Artwork type of rich media creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 2132 "positionLeftUnit": "A String", # Offset left unit for an asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 2133 "collapsedSize": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size of an asset when collapsed. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN. 2134 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 2135 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 2136 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 2137 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 2138 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 2139 }, 2140 "flashVersion": 42, # Flash version of the asset. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2141 "additionalSizes": [ # Additional sizes associated with this creative asset. HTML5 asset generated by compatible software such as GWD will be able to support more sizes this creative asset can render. 2142 { # Represents the dimensions of ads, placements, creatives, or creative assets. 2143 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 2144 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 2145 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 2146 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 2147 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 2148 }, 2149 ], 2150 "hideFlashObjects": True or False, # Whether to hide Flash objects flag for an asset. Applicable to the following creative types: all RICH_MEDIA. 2151 "detectedFeatures": [ # List of feature dependencies for the creative asset that are detected by Campaign Manager. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative correctly. This is a read-only, auto-generated field. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2152 "A String", 2153 ], 2154 "originalBackup": True or False, # Whether the backup asset is original or changed by the user in Campaign Manager. Applicable to the following creative types: all RICH_MEDIA. 2155 "duration": 42, # Duration in seconds for which an asset will be displayed. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and VPAID_LINEAR_VIDEO. Value must be greater than or equal to 1. 2156 "positionTopUnit": "A String", # Offset top unit for an asset. This is a read-only field if the asset displayType is ASSET_DISPLAY_TYPE_OVERLAY. Applicable to the following creative types: all RICH_MEDIA. 2157 "id": "A String", # Numeric ID of this creative asset. This is a required field and should not be modified. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 2158 "alignment": "A String", # Possible alignments for an asset. This is a read-only field. Applicable to the following creative types: RICH_MEDIA_DISPLAY_MULTI_FLOATING_INTERSTITIAL. 2159 "orientation": "A String", # Orientation of video asset. This is a read-only, auto-generated field. 2160 "position": { # Offset Position. # Offset position for an asset. Applicable to the following creative types: all RICH_MEDIA. 2161 "top": 42, # Offset distance from top side of an asset or a window. 2162 "left": 42, # Offset distance from left side of an asset or a window. 2163 }, 2164 "horizontallyLocked": True or False, # Whether the asset is horizontally locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 2165 "startTimeType": "A String", # Initial wait time type before making the asset visible. Applicable to the following creative types: all RICH_MEDIA. 2166 "displayType": "A String", # Type of rich media asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 2167 "expandedDimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Detected expanded dimension for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID. 2168 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 2169 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 2170 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 2171 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 2172 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 2173 }, 2174 "verticallyLocked": True or False, # Whether the asset is vertically locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 2175 "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the asset. This is a read-only, auto-generated field. 2176 "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue. 2177 "value": "A String", # The value of the dimension. 2178 "dimensionName": "A String", # The name of the dimension. 2179 "etag": "A String", # The eTag of this response for caching purposes. 2180 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2181 "id": "A String", # The ID associated with the value if available. 2182 }, 2183 "role": "A String", # Role of the asset in relation to creative. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. This is a required field. 2184 # PRIMARY applies to DISPLAY, FLASH_INPAGE, HTML5_BANNER, IMAGE, DISPLAY_IMAGE_GALLERY, all RICH_MEDIA (which may contain multiple primary assets), and all VPAID creatives. 2185 # BACKUP_IMAGE applies to FLASH_INPAGE, HTML5_BANNER, all RICH_MEDIA, and all VPAID creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2186 # ADDITIONAL_IMAGE and ADDITIONAL_FLASH apply to FLASH_INPAGE creatives. 2187 # OTHER refers to assets from sources other than Campaign Manager, such as Studio uploaded assets, applicable to all RICH_MEDIA and all VPAID creatives. 2188 # PARENT_VIDEO refers to videos uploaded by the user in Campaign Manager and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives. 2189 # TRANSCODED_VIDEO refers to videos transcoded by Campaign Manager from PARENT_VIDEO assets and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives. 2190 # ALTERNATE_VIDEO refers to the Campaign Manager representation of child asset videos from Studio, and is applicable to VPAID_LINEAR_VIDEO creatives. These cannot be added or removed within Campaign Manager. 2191 # For VPAID_LINEAR_VIDEO creatives, PARENT_VIDEO, TRANSCODED_VIDEO and ALTERNATE_VIDEO assets that are marked active serve as backup in case the VPAID creative cannot be served. Only PARENT_VIDEO assets can be added or removed for an INSTREAM_VIDEO or VPAID_LINEAR_VIDEO creative. 2192 # PARENT_AUDIO refers to audios uploaded by the user in Campaign Manager and is applicable to INSTREAM_AUDIO creatives. 2193 # TRANSCODED_AUDIO refers to audios transcoded by Campaign Manager from PARENT_AUDIO assets and is applicable to INSTREAM_AUDIO creatives. 2194 "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative asset. This is a required field when applicable; however for IMAGE and FLASH_INPAGE, creatives if left blank, this field will be automatically set using the actual size of the associated image asset. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2195 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 2196 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 2197 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 2198 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 2199 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 2200 }, 2201 "bitRate": 42, # Detected bit-rate for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 2202 "windowMode": "A String", # Window mode options for flash assets. Applicable to the following creative types: FLASH_INPAGE, RICH_MEDIA_DISPLAY_EXPANDING, RICH_MEDIA_IM_EXPAND, RICH_MEDIA_DISPLAY_BANNER, and RICH_MEDIA_INPAGE_FLOATING. 2203 "pushdown": True or False, # Whether the asset pushes down other content. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable when the asset offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height. 2204 "progressiveServingUrl": "A String", # Progressive URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID. 2205 "durationType": "A String", # Duration type for which an asset will be displayed. Applicable to the following creative types: all RICH_MEDIA. 2206 "zIndex": 42, # zIndex value of an asset. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable to assets whose displayType is NOT one of the following types: ASSET_DISPLAY_TYPE_INPAGE or ASSET_DISPLAY_TYPE_OVERLAY. Acceptable values are -999999999 to 999999999, inclusive. 2207 "fileSize": "A String", # File size associated with this creative asset. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 2208 "zipFilename": "A String", # File name of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER. 2209 "offset": { # Offset Position. # Offset position for an asset in collapsed mode. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, only applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN. 2210 "top": 42, # Offset distance from top side of an asset or a window. 2211 "left": 42, # Offset distance from left side of an asset or a window. 2212 }, 2213 "active": True or False, # Whether the video or audio asset is active. This is a read-only field for VPAID_NON_LINEAR_VIDEO assets. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 2214 "companionCreativeIds": [ # List of companion creatives assigned to an in-stream video creative asset. Acceptable values include IDs of existing flash and image creatives. Applicable to INSTREAM_VIDEO creative type with dynamicAssetSelection set to true. 2215 "A String", 2216 ], 2217 "hideSelectionBoxes": True or False, # Whether to hide selection boxes flag for an asset. Applicable to the following creative types: all RICH_MEDIA. 2218 "streamingServingUrl": "A String", # Streaming URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID. 2219 "zipFilesize": "A String", # Size of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER. 2220 "childAssetType": "A String", # Rich media child asset type. This is a read-only field. Applicable to the following creative types: all VPAID. 2221 "backupImageExit": { # Creative Custom Event. # Exit event configured for the backup image. Applicable to the following creative types: all RICH_MEDIA. 2222 "targetType": "A String", # Target type used by the event. 2223 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 2224 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 2225 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 2226 # - If landingPageId is specified then that landing page's URL is assigned to this field. 2227 # - Otherwise, the customClickThroughUrl is assigned to this field. 2228 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 2229 "landingPageId": "A String", # ID of the landing page for the click-through URL. 2230 }, 2231 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 2232 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 2233 "showStatusBar": True or False, # Whether to display the browser status bar. 2234 "showScrollBar": True or False, # Whether to display the browser scroll bar. 2235 "showAddressBar": True or False, # Whether to display the browser address bar. 2236 "showMenuBar": True or False, # Whether to display the browser menu bar. 2237 "title": "A String", # Title of popup window. 2238 "showToolBar": True or False, # Whether to display the browser tool bar. 2239 "positionType": "A String", # Popup window position either centered or at specific coordinate. 2240 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 2241 "top": 42, # Offset distance from top side of an asset or a window. 2242 "left": 42, # Offset distance from left side of an asset or a window. 2243 }, 2244 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 2245 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 2246 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 2247 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 2248 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 2249 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 2250 }, 2251 }, 2252 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 2253 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 2254 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 2255 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 2256 "advertiserCustomEventName": "A String", # User-entered name for the event. 2257 }, 2258 "actionScript3": True or False, # Whether ActionScript3 is enabled for the flash asset. This is a read-only field. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2259 "pushdownDuration": 3.14, # Pushdown duration in seconds for an asset. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable when the asset pushdown field is true, the offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height. Acceptable values are 0 to 9.99, inclusive. 2260 "assetIdentifier": { # Creative Asset ID. # Identifier of this asset. This is the same identifier returned during creative asset insert operation. This is a required field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 2261 "type": "A String", # Type of asset to upload. This is a required field. FLASH and IMAGE are no longer supported for new uploads. All image assets should use HTML_IMAGE. 2262 "name": "A String", # Name of the creative asset. This is a required field while inserting an asset. After insertion, this assetIdentifier is used to identify the uploaded asset. Characters in the name must be alphanumeric or one of the following: ".-_ ". Spaces are allowed. 2263 }, 2264 "transparency": True or False, # Whether the asset is transparent. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable to HTML5 assets. 2265 "sslCompliant": True or False, # Whether the asset is SSL-compliant. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 2266 "mediaDuration": 3.14, # Detected duration for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 2267 "customStartTimeValue": 42, # Custom start time in seconds for making the asset visible. Applicable to the following creative types: all RICH_MEDIA. Value must be greater than or equal to 0. 2268 }, 2269 ], 2270 "redirectUrl": "A String", # URL of hosted image or hosted video or another ad tag. For INSTREAM_VIDEO_REDIRECT creatives this is the in-stream video redirect URL. The standard for a VAST (Video Ad Serving Template) ad response allows for a redirect link to another VAST 2.0 or 3.0 call. This is a required field when applicable. Applicable to the following creative types: DISPLAY_REDIRECT, INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO_REDIRECT 2271 "autoAdvanceImages": True or False, # Whether images are automatically advanced for image gallery creatives. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY. 2272 "htmlCodeLocked": True or False, # Whether HTML code is generated by Campaign Manager or manually entered. Set to true to ignore changes to htmlCode. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. 2273 "convertFlashToHtml5": True or False, # Whether Flash assets associated with the creative need to be automatically converted to HTML5. This flag is enabled by default and users can choose to disable it if they don't want the system to generate and use HTML5 asset for this creative. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2274 "clickTags": [ # Click tags of the creative. For DISPLAY, FLASH_INPAGE, and HTML5_BANNER creatives, this is a subset of detected click tags for the assets associated with this creative. After creating a flash asset, detected click tags will be returned in the creativeAssetMetadata. When inserting the creative, populate the creative clickTags field using the creativeAssetMetadata.clickTags field. For DISPLAY_IMAGE_GALLERY creatives, there should be exactly one entry in this list for each image creative asset. A click tag is matched with a corresponding creative asset by matching the clickTag.name field with the creativeAsset.assetIdentifier.name field. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2275 { # Creative Click Tag. 2276 "eventName": "A String", # Advertiser event name associated with the click tag. This field is used by DISPLAY_IMAGE_GALLERY and HTML5_BANNER creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2277 "clickThroughUrl": { # Click-through URL # Parameter value for the specified click tag. This field contains a click-through url. 2278 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 2279 # - If landingPageId is specified then that landing page's URL is assigned to this field. 2280 # - Otherwise, the customClickThroughUrl is assigned to this field. 2281 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 2282 "landingPageId": "A String", # ID of the landing page for the click-through URL. 2283 }, 2284 "name": "A String", # Parameter name for the specified click tag. For DISPLAY_IMAGE_GALLERY creative assets, this field must match the value of the creative asset's creativeAssetId.name field. 2285 }, 2286 ], 2287 "commercialId": "A String", # Industry standard ID assigned to creative for reach and frequency. Applicable to INSTREAM_VIDEO_REDIRECT creatives. 2288 "active": True or False, # Whether the creative is active. Applicable to all creative types. 2289 "compatibility": [ # Compatibilities associated with this creative. This is a read-only field. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering either on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are for rendering in mobile apps. Only pre-existing creatives may have these compatibilities since new creatives will either be assigned DISPLAY or DISPLAY_INTERSTITIAL instead. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. IN_STREAM_AUDIO refers to rendering in in-stream audio ads developed with the VAST standard. Applicable to all creative types. 2290 # 2291 # Acceptable values are: 2292 # - "APP" 2293 # - "APP_INTERSTITIAL" 2294 # - "IN_STREAM_VIDEO" 2295 # - "IN_STREAM_AUDIO" 2296 # - "DISPLAY" 2297 # - "DISPLAY_INTERSTITIAL" 2298 "A String", 2299 ], 2300 "universalAdId": { # A Universal Ad ID as per the VAST 4.0 spec. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and VPAID. # A Universal Ad ID as per the VAST 4.0 spec. Applicable to the following creative types: INSTREAM_AUDIO and INSTREAM_VIDEO and VPAID. 2301 "registry": "A String", # Registry used for the Ad ID value. 2302 "value": "A String", # ID value for this creative. Only alphanumeric characters and the following symbols are valid: "_/\-". Maximum length is 64 characters. Read only when registry is DCM. 2303 }, 2304 "adParameters": "A String", # Ad parameters user for VPAID creative. This is a read-only field. Applicable to the following creative types: all VPAID. 2305 "adTagKeys": [ # Keywords for a Rich Media creative. Keywords let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use keywords to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 2306 "A String", 2307 ], 2308 "kind": "dfareporting#creative", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creative". 2309 "subaccountId": "A String", # Subaccount ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types. 2310 "name": "A String", # Name of the creative. This is a required field and must be less than 256 characters long. Applicable to all creative types. 2311 "sslOverride": True or False, # Whether creative should be treated as SSL compliant even if the system scan shows it's not. Applicable to all creative types. 2312 "lastModifiedInfo": { # Modification timestamp. # Creative last modification information. This is a read-only field. Applicable to all creative types. 2313 "time": "A String", # Timestamp of the last change in milliseconds since epoch. 2314 }, 2315 "backupImageClickThroughUrl": { # Click-through URL # Click-through URL for backup image. Applicable to ENHANCED_BANNER when the primary asset type is not HTML_IMAGE. 2316 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 2317 # - If landingPageId is specified then that landing page's URL is assigned to this field. 2318 # - Otherwise, the customClickThroughUrl is assigned to this field. 2319 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 2320 "landingPageId": "A String", # ID of the landing page for the click-through URL. 2321 }, 2322 "sslCompliant": True or False, # Whether the creative is SSL-compliant. This is a read-only field. Applicable to all creative types. 2323 "studioCreativeId": "A String", # Studio creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 2324 "authoringTool": "A String", # Authoring tool for HTML5 banner creatives. This is a read-only field. Applicable to the following creative types: HTML5_BANNER. 2325 "allowScriptAccess": True or False, # Whether script access is allowed for this creative. This is a read-only and deprecated field which will automatically be set to true on update. Applicable to the following creative types: FLASH_INPAGE. 2326 "companionCreatives": [ # List of companion creatives assigned to an in-Stream video creative. Acceptable values include IDs of existing flash and image creatives. Applicable to the following creative types: all VPAID, all INSTREAM_AUDIO and all INSTREAM_VIDEO with dynamicAssetSelection set to false. 2327 "A String", 2328 ], 2329 "creativeAssetSelection": { # Encapsulates the list of rules for asset selection and a default asset in case none of the rules match. Applicable to INSTREAM_VIDEO creatives. # Required if dynamicAssetSelection is true. 2330 "rules": [ # Rules determine which asset will be served to a viewer. Rules will be evaluated in the order in which they are stored in this list. This list must contain at least one rule. Applicable to INSTREAM_VIDEO creatives. 2331 { # A rule associates an asset with a targeting template for asset-level targeting. Applicable to INSTREAM_VIDEO creatives. 2332 "assetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative. This is a required field. 2333 "targetingTemplateId": "A String", # A targeting template ID. The targeting from the targeting template will be used to determine whether this asset should be served. This is a required field. 2334 "name": "A String", # A user-friendly name for this rule. This is a required field. 2335 }, 2336 ], 2337 "defaultAssetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative, and will be served if none of the rules match. This is a required field. 2338 }, 2339 "htmlCode": "A String", # HTML code for the creative. This is a required field when applicable. This field is ignored if htmlCodeLocked is true. Applicable to the following creative types: all CUSTOM, FLASH_INPAGE, and HTML5_BANNER, and all RICH_MEDIA. 2340 "backupImageFeatures": [ # List of feature dependencies that will cause a backup image to be served if the browser that serves the ad does not support them. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative asset correctly. This field is initially auto-generated to contain all features detected by Campaign Manager for all the assets of this creative and can then be modified by the client. To reset this field, copy over all the creativeAssets' detected features. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2341 "A String", 2342 ], 2343 "backupImageTargetWindow": { # Target Window. # Target window for backup image. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2344 "customHtml": "A String", # User-entered value. 2345 "targetWindowOption": "A String", # Type of browser window for which the backup image of the flash creative can be displayed. 2346 }, 2347 "mediaDescription": "A String", # Description of the audio or video ad. Applicable to the following creative types: all INSTREAM_VIDEO, INSTREAM_AUDIO, and all VPAID. 2348 "skippable": True or False, # Whether the user can choose to skip the creative. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID. 2349 } 2350 2351 2352Returns: 2353 An object of the form: 2354 2355 { # Contains properties of a Creative. 2356 "thirdPartyUrls": [ # Third-party URLs for tracking in-stream creative events. Applicable to the following creative types: all INSTREAM_VIDEO, all INSTREAM_AUDIO, and all VPAID. 2357 { # Third-party Tracking URL. 2358 "url": "A String", # URL for the specified third-party URL type. 2359 "thirdPartyUrlType": "A String", # Third-party URL type for in-stream video and in-stream audio creatives. 2360 }, 2361 ], 2362 "artworkType": "A String", # Type of artwork used for the creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 2363 "latestTraffickedCreativeId": "A String", # Latest Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 2364 "politeLoadAssetId": "A String", # The asset ID of the polite load image asset. Applicable to the creative type: DISPLAY. 2365 "advertiserId": "A String", # Advertiser ID of this creative. This is a required field. Applicable to all creative types. 2366 "requiredFlashPluginVersion": "A String", # The minimum required Flash plugin version for this creative. For example, 11.2.202.235. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 2367 "thirdPartyBackupImageImpressionsUrl": "A String", # Third-party URL used to record backup image impressions. Applicable to the following creative types: all RICH_MEDIA. 2368 "timerCustomEvents": [ # List of timer events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset is not HTML_IMAGE. 2369 { # Creative Custom Event. 2370 "targetType": "A String", # Target type used by the event. 2371 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 2372 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 2373 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 2374 # - If landingPageId is specified then that landing page's URL is assigned to this field. 2375 # - Otherwise, the customClickThroughUrl is assigned to this field. 2376 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 2377 "landingPageId": "A String", # ID of the landing page for the click-through URL. 2378 }, 2379 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 2380 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 2381 "showStatusBar": True or False, # Whether to display the browser status bar. 2382 "showScrollBar": True or False, # Whether to display the browser scroll bar. 2383 "showAddressBar": True or False, # Whether to display the browser address bar. 2384 "showMenuBar": True or False, # Whether to display the browser menu bar. 2385 "title": "A String", # Title of popup window. 2386 "showToolBar": True or False, # Whether to display the browser tool bar. 2387 "positionType": "A String", # Popup window position either centered or at specific coordinate. 2388 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 2389 "top": 42, # Offset distance from top side of an asset or a window. 2390 "left": 42, # Offset distance from left side of an asset or a window. 2391 }, 2392 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 2393 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 2394 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 2395 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 2396 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 2397 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 2398 }, 2399 }, 2400 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 2401 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 2402 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 2403 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 2404 "advertiserCustomEventName": "A String", # User-entered name for the event. 2405 }, 2406 ], 2407 "renderingIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the rendering ID of this creative. This is a read-only field. Applicable to all creative types. 2408 "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue. 2409 "value": "A String", # The value of the dimension. 2410 "dimensionName": "A String", # The name of the dimension. 2411 "etag": "A String", # The eTag of this response for caching purposes. 2412 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2413 "id": "A String", # The ID associated with the value if available. 2414 }, 2415 "additionalSizes": [ # Additional sizes associated with a responsive creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. Applicable to DISPLAY creatives when the primary asset type is HTML_IMAGE. 2416 { # Represents the dimensions of ads, placements, creatives, or creative assets. 2417 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 2418 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 2419 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 2420 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 2421 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 2422 }, 2423 ], 2424 "fsCommand": { # FsCommand. # OpenWindow FSCommand of this creative. This lets the SWF file communicate with either Flash Player or the program hosting Flash Player, such as a web browser. This is only triggered if allowScriptAccess field is true. Applicable to the following creative types: FLASH_INPAGE. 2425 "windowHeight": 42, # Height of the window. 2426 "top": 42, # Distance from the top of the browser. Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER. 2427 "windowWidth": 42, # Width of the window. 2428 "positionOption": "A String", # Position in the browser where the window will open. 2429 "left": 42, # Distance from the left of the browser.Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER. 2430 }, 2431 "dynamicAssetSelection": True or False, # Set this to true to enable the use of rules to target individual assets in this creative. When set to true creativeAssetSelection must be set. This also controls asset-level companions. When this is true, companion creatives should be assigned to creative assets. Learn more. Applicable to INSTREAM_VIDEO creatives. 2432 "id": "A String", # ID of this creative. This is a read-only, auto-generated field. Applicable to all creative types. 2433 "progressOffset": { # Video Offset # Amount of time to play the video before counting a view. Applicable to the following creative types: all INSTREAM_VIDEO. 2434 "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set. Acceptable values are 0 to 100, inclusive. 2435 "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set. Acceptable values are 0 to 86399, inclusive. 2436 }, 2437 "accountId": "A String", # Account ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types. 2438 "studioTraffickedCreativeId": "A String", # Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 2439 "archived": True or False, # Whether the creative is archived. Applicable to all creative types. 2440 "overrideCss": "A String", # Override CSS value for rich media creatives. Applicable to the following creative types: all RICH_MEDIA. 2441 "authoringSource": "A String", # Source application where creative was authored. Presently, only DBM authored creatives will have this field set. Applicable to all creative types. 2442 "requiredFlashVersion": 42, # The internal Flash version for this creative as calculated by Studio. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2443 "exitCustomEvents": [ # List of exit events configured for the creative. For DISPLAY and DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags, For DISPLAY, an event is also created from the backupImageReportingLabel. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2444 { # Creative Custom Event. 2445 "targetType": "A String", # Target type used by the event. 2446 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 2447 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 2448 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 2449 # - If landingPageId is specified then that landing page's URL is assigned to this field. 2450 # - Otherwise, the customClickThroughUrl is assigned to this field. 2451 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 2452 "landingPageId": "A String", # ID of the landing page for the click-through URL. 2453 }, 2454 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 2455 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 2456 "showStatusBar": True or False, # Whether to display the browser status bar. 2457 "showScrollBar": True or False, # Whether to display the browser scroll bar. 2458 "showAddressBar": True or False, # Whether to display the browser address bar. 2459 "showMenuBar": True or False, # Whether to display the browser menu bar. 2460 "title": "A String", # Title of popup window. 2461 "showToolBar": True or False, # Whether to display the browser tool bar. 2462 "positionType": "A String", # Popup window position either centered or at specific coordinate. 2463 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 2464 "top": 42, # Offset distance from top side of an asset or a window. 2465 "left": 42, # Offset distance from left side of an asset or a window. 2466 }, 2467 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 2468 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 2469 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 2470 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 2471 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 2472 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 2473 }, 2474 }, 2475 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 2476 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 2477 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 2478 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 2479 "advertiserCustomEventName": "A String", # User-entered name for the event. 2480 }, 2481 ], 2482 "renderingId": "A String", # ID of current rendering version. This is a read-only field. Applicable to all creative types. 2483 "counterCustomEvents": [ # List of counter events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. 2484 { # Creative Custom Event. 2485 "targetType": "A String", # Target type used by the event. 2486 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 2487 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 2488 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 2489 # - If landingPageId is specified then that landing page's URL is assigned to this field. 2490 # - Otherwise, the customClickThroughUrl is assigned to this field. 2491 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 2492 "landingPageId": "A String", # ID of the landing page for the click-through URL. 2493 }, 2494 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 2495 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 2496 "showStatusBar": True or False, # Whether to display the browser status bar. 2497 "showScrollBar": True or False, # Whether to display the browser scroll bar. 2498 "showAddressBar": True or False, # Whether to display the browser address bar. 2499 "showMenuBar": True or False, # Whether to display the browser menu bar. 2500 "title": "A String", # Title of popup window. 2501 "showToolBar": True or False, # Whether to display the browser tool bar. 2502 "positionType": "A String", # Popup window position either centered or at specific coordinate. 2503 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 2504 "top": 42, # Offset distance from top side of an asset or a window. 2505 "left": 42, # Offset distance from left side of an asset or a window. 2506 }, 2507 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 2508 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 2509 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 2510 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 2511 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 2512 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 2513 }, 2514 }, 2515 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 2516 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 2517 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 2518 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 2519 "advertiserCustomEventName": "A String", # User-entered name for the event. 2520 }, 2521 ], 2522 "skipOffset": { # Video Offset # Amount of time to play the video before the skip button appears. Applicable to the following creative types: all INSTREAM_VIDEO. 2523 "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set. Acceptable values are 0 to 100, inclusive. 2524 "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set. Acceptable values are 0 to 86399, inclusive. 2525 }, 2526 "backupImageReportingLabel": "A String", # Reporting label used for HTML5 banner backup image. Applicable to the following creative types: DISPLAY when the primary asset type is not HTML_IMAGE. 2527 "version": 42, # The version number helps you keep track of multiple versions of your creative in your reports. The version number will always be auto-generated during insert operations to start at 1. For tracking creatives the version cannot be incremented and will always remain at 1. For all other creative types the version can be incremented only by 1 during update operations. In addition, the version will be automatically incremented by 1 when undergoing Rich Media creative merging. Applicable to all creative types. 2528 "creativeFieldAssignments": [ # Creative field assignments for this creative. Applicable to all creative types. 2529 { # Creative Field Assignment. 2530 "creativeFieldId": "A String", # ID of the creative field. 2531 "creativeFieldValueId": "A String", # ID of the creative field value. 2532 }, 2533 ], 2534 "backgroundColor": "A String", # The 6-character HTML color code, beginning with #, for the background of the window area where the Flash file is displayed. Default is white. Applicable to the following creative types: FLASH_INPAGE. 2535 "customKeyValues": [ # Custom key-values for a Rich Media creative. Key-values let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use key-values to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 2536 "A String", 2537 ], 2538 "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this creative. This is a read-only field. Applicable to all creative types. 2539 "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue. 2540 "value": "A String", # The value of the dimension. 2541 "dimensionName": "A String", # The name of the dimension. 2542 "etag": "A String", # The eTag of this response for caching purposes. 2543 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2544 "id": "A String", # The ID associated with the value if available. 2545 }, 2546 "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. This is a required field when applicable; however for IMAGE, FLASH_INPAGE creatives, and for DISPLAY creatives with a primary asset of type HTML_IMAGE, if left blank, this field will be automatically set using the actual size of the associated image assets. Applicable to the following creative types: DISPLAY, DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA. 2547 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 2548 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 2549 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 2550 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 2551 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 2552 }, 2553 "type": "A String", # Type of this creative. This is a required field. Applicable to all creative types. 2554 # 2555 # Note: FLASH_INPAGE, HTML5_BANNER, and IMAGE are only used for existing creatives. New creatives should use DISPLAY as a replacement for these types. 2556 "totalFileSize": "A String", # Combined size of all creative assets. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 2557 "mediaDuration": 3.14, # Creative audio or video duration in seconds. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO, INSTREAM_AUDIO, all RICH_MEDIA, and all VPAID. 2558 "thirdPartyRichMediaImpressionsUrl": "A String", # Third-party URL used to record rich media impressions. Applicable to the following creative types: all RICH_MEDIA. 2559 "studioAdvertiserId": "A String", # Studio advertiser ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 2560 "creativeAssets": [ # Assets associated with a creative. Applicable to all but the following creative types: INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and REDIRECT 2561 { # Creative Asset. 2562 "mimeType": "A String", # Detected MIME type for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 2563 "artworkType": "A String", # Artwork type of rich media creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 2564 "positionLeftUnit": "A String", # Offset left unit for an asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 2565 "collapsedSize": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size of an asset when collapsed. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN. 2566 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 2567 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 2568 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 2569 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 2570 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 2571 }, 2572 "flashVersion": 42, # Flash version of the asset. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2573 "additionalSizes": [ # Additional sizes associated with this creative asset. HTML5 asset generated by compatible software such as GWD will be able to support more sizes this creative asset can render. 2574 { # Represents the dimensions of ads, placements, creatives, or creative assets. 2575 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 2576 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 2577 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 2578 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 2579 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 2580 }, 2581 ], 2582 "hideFlashObjects": True or False, # Whether to hide Flash objects flag for an asset. Applicable to the following creative types: all RICH_MEDIA. 2583 "detectedFeatures": [ # List of feature dependencies for the creative asset that are detected by Campaign Manager. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative correctly. This is a read-only, auto-generated field. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2584 "A String", 2585 ], 2586 "originalBackup": True or False, # Whether the backup asset is original or changed by the user in Campaign Manager. Applicable to the following creative types: all RICH_MEDIA. 2587 "duration": 42, # Duration in seconds for which an asset will be displayed. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and VPAID_LINEAR_VIDEO. Value must be greater than or equal to 1. 2588 "positionTopUnit": "A String", # Offset top unit for an asset. This is a read-only field if the asset displayType is ASSET_DISPLAY_TYPE_OVERLAY. Applicable to the following creative types: all RICH_MEDIA. 2589 "id": "A String", # Numeric ID of this creative asset. This is a required field and should not be modified. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 2590 "alignment": "A String", # Possible alignments for an asset. This is a read-only field. Applicable to the following creative types: RICH_MEDIA_DISPLAY_MULTI_FLOATING_INTERSTITIAL. 2591 "orientation": "A String", # Orientation of video asset. This is a read-only, auto-generated field. 2592 "position": { # Offset Position. # Offset position for an asset. Applicable to the following creative types: all RICH_MEDIA. 2593 "top": 42, # Offset distance from top side of an asset or a window. 2594 "left": 42, # Offset distance from left side of an asset or a window. 2595 }, 2596 "horizontallyLocked": True or False, # Whether the asset is horizontally locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 2597 "startTimeType": "A String", # Initial wait time type before making the asset visible. Applicable to the following creative types: all RICH_MEDIA. 2598 "displayType": "A String", # Type of rich media asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 2599 "expandedDimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Detected expanded dimension for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID. 2600 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 2601 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 2602 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 2603 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 2604 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 2605 }, 2606 "verticallyLocked": True or False, # Whether the asset is vertically locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 2607 "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the asset. This is a read-only, auto-generated field. 2608 "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue. 2609 "value": "A String", # The value of the dimension. 2610 "dimensionName": "A String", # The name of the dimension. 2611 "etag": "A String", # The eTag of this response for caching purposes. 2612 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2613 "id": "A String", # The ID associated with the value if available. 2614 }, 2615 "role": "A String", # Role of the asset in relation to creative. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. This is a required field. 2616 # PRIMARY applies to DISPLAY, FLASH_INPAGE, HTML5_BANNER, IMAGE, DISPLAY_IMAGE_GALLERY, all RICH_MEDIA (which may contain multiple primary assets), and all VPAID creatives. 2617 # BACKUP_IMAGE applies to FLASH_INPAGE, HTML5_BANNER, all RICH_MEDIA, and all VPAID creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2618 # ADDITIONAL_IMAGE and ADDITIONAL_FLASH apply to FLASH_INPAGE creatives. 2619 # OTHER refers to assets from sources other than Campaign Manager, such as Studio uploaded assets, applicable to all RICH_MEDIA and all VPAID creatives. 2620 # PARENT_VIDEO refers to videos uploaded by the user in Campaign Manager and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives. 2621 # TRANSCODED_VIDEO refers to videos transcoded by Campaign Manager from PARENT_VIDEO assets and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives. 2622 # ALTERNATE_VIDEO refers to the Campaign Manager representation of child asset videos from Studio, and is applicable to VPAID_LINEAR_VIDEO creatives. These cannot be added or removed within Campaign Manager. 2623 # For VPAID_LINEAR_VIDEO creatives, PARENT_VIDEO, TRANSCODED_VIDEO and ALTERNATE_VIDEO assets that are marked active serve as backup in case the VPAID creative cannot be served. Only PARENT_VIDEO assets can be added or removed for an INSTREAM_VIDEO or VPAID_LINEAR_VIDEO creative. 2624 # PARENT_AUDIO refers to audios uploaded by the user in Campaign Manager and is applicable to INSTREAM_AUDIO creatives. 2625 # TRANSCODED_AUDIO refers to audios transcoded by Campaign Manager from PARENT_AUDIO assets and is applicable to INSTREAM_AUDIO creatives. 2626 "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative asset. This is a required field when applicable; however for IMAGE and FLASH_INPAGE, creatives if left blank, this field will be automatically set using the actual size of the associated image asset. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2627 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 2628 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 2629 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 2630 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 2631 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 2632 }, 2633 "bitRate": 42, # Detected bit-rate for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 2634 "windowMode": "A String", # Window mode options for flash assets. Applicable to the following creative types: FLASH_INPAGE, RICH_MEDIA_DISPLAY_EXPANDING, RICH_MEDIA_IM_EXPAND, RICH_MEDIA_DISPLAY_BANNER, and RICH_MEDIA_INPAGE_FLOATING. 2635 "pushdown": True or False, # Whether the asset pushes down other content. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable when the asset offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height. 2636 "progressiveServingUrl": "A String", # Progressive URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID. 2637 "durationType": "A String", # Duration type for which an asset will be displayed. Applicable to the following creative types: all RICH_MEDIA. 2638 "zIndex": 42, # zIndex value of an asset. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable to assets whose displayType is NOT one of the following types: ASSET_DISPLAY_TYPE_INPAGE or ASSET_DISPLAY_TYPE_OVERLAY. Acceptable values are -999999999 to 999999999, inclusive. 2639 "fileSize": "A String", # File size associated with this creative asset. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 2640 "zipFilename": "A String", # File name of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER. 2641 "offset": { # Offset Position. # Offset position for an asset in collapsed mode. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, only applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN. 2642 "top": 42, # Offset distance from top side of an asset or a window. 2643 "left": 42, # Offset distance from left side of an asset or a window. 2644 }, 2645 "active": True or False, # Whether the video or audio asset is active. This is a read-only field for VPAID_NON_LINEAR_VIDEO assets. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 2646 "companionCreativeIds": [ # List of companion creatives assigned to an in-stream video creative asset. Acceptable values include IDs of existing flash and image creatives. Applicable to INSTREAM_VIDEO creative type with dynamicAssetSelection set to true. 2647 "A String", 2648 ], 2649 "hideSelectionBoxes": True or False, # Whether to hide selection boxes flag for an asset. Applicable to the following creative types: all RICH_MEDIA. 2650 "streamingServingUrl": "A String", # Streaming URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID. 2651 "zipFilesize": "A String", # Size of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER. 2652 "childAssetType": "A String", # Rich media child asset type. This is a read-only field. Applicable to the following creative types: all VPAID. 2653 "backupImageExit": { # Creative Custom Event. # Exit event configured for the backup image. Applicable to the following creative types: all RICH_MEDIA. 2654 "targetType": "A String", # Target type used by the event. 2655 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 2656 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 2657 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 2658 # - If landingPageId is specified then that landing page's URL is assigned to this field. 2659 # - Otherwise, the customClickThroughUrl is assigned to this field. 2660 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 2661 "landingPageId": "A String", # ID of the landing page for the click-through URL. 2662 }, 2663 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 2664 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 2665 "showStatusBar": True or False, # Whether to display the browser status bar. 2666 "showScrollBar": True or False, # Whether to display the browser scroll bar. 2667 "showAddressBar": True or False, # Whether to display the browser address bar. 2668 "showMenuBar": True or False, # Whether to display the browser menu bar. 2669 "title": "A String", # Title of popup window. 2670 "showToolBar": True or False, # Whether to display the browser tool bar. 2671 "positionType": "A String", # Popup window position either centered or at specific coordinate. 2672 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 2673 "top": 42, # Offset distance from top side of an asset or a window. 2674 "left": 42, # Offset distance from left side of an asset or a window. 2675 }, 2676 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 2677 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 2678 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 2679 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 2680 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 2681 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 2682 }, 2683 }, 2684 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 2685 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 2686 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 2687 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 2688 "advertiserCustomEventName": "A String", # User-entered name for the event. 2689 }, 2690 "actionScript3": True or False, # Whether ActionScript3 is enabled for the flash asset. This is a read-only field. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2691 "pushdownDuration": 3.14, # Pushdown duration in seconds for an asset. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable when the asset pushdown field is true, the offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height. Acceptable values are 0 to 9.99, inclusive. 2692 "assetIdentifier": { # Creative Asset ID. # Identifier of this asset. This is the same identifier returned during creative asset insert operation. This is a required field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 2693 "type": "A String", # Type of asset to upload. This is a required field. FLASH and IMAGE are no longer supported for new uploads. All image assets should use HTML_IMAGE. 2694 "name": "A String", # Name of the creative asset. This is a required field while inserting an asset. After insertion, this assetIdentifier is used to identify the uploaded asset. Characters in the name must be alphanumeric or one of the following: ".-_ ". Spaces are allowed. 2695 }, 2696 "transparency": True or False, # Whether the asset is transparent. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable to HTML5 assets. 2697 "sslCompliant": True or False, # Whether the asset is SSL-compliant. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 2698 "mediaDuration": 3.14, # Detected duration for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 2699 "customStartTimeValue": 42, # Custom start time in seconds for making the asset visible. Applicable to the following creative types: all RICH_MEDIA. Value must be greater than or equal to 0. 2700 }, 2701 ], 2702 "redirectUrl": "A String", # URL of hosted image or hosted video or another ad tag. For INSTREAM_VIDEO_REDIRECT creatives this is the in-stream video redirect URL. The standard for a VAST (Video Ad Serving Template) ad response allows for a redirect link to another VAST 2.0 or 3.0 call. This is a required field when applicable. Applicable to the following creative types: DISPLAY_REDIRECT, INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO_REDIRECT 2703 "autoAdvanceImages": True or False, # Whether images are automatically advanced for image gallery creatives. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY. 2704 "htmlCodeLocked": True or False, # Whether HTML code is generated by Campaign Manager or manually entered. Set to true to ignore changes to htmlCode. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. 2705 "convertFlashToHtml5": True or False, # Whether Flash assets associated with the creative need to be automatically converted to HTML5. This flag is enabled by default and users can choose to disable it if they don't want the system to generate and use HTML5 asset for this creative. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2706 "clickTags": [ # Click tags of the creative. For DISPLAY, FLASH_INPAGE, and HTML5_BANNER creatives, this is a subset of detected click tags for the assets associated with this creative. After creating a flash asset, detected click tags will be returned in the creativeAssetMetadata. When inserting the creative, populate the creative clickTags field using the creativeAssetMetadata.clickTags field. For DISPLAY_IMAGE_GALLERY creatives, there should be exactly one entry in this list for each image creative asset. A click tag is matched with a corresponding creative asset by matching the clickTag.name field with the creativeAsset.assetIdentifier.name field. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2707 { # Creative Click Tag. 2708 "eventName": "A String", # Advertiser event name associated with the click tag. This field is used by DISPLAY_IMAGE_GALLERY and HTML5_BANNER creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2709 "clickThroughUrl": { # Click-through URL # Parameter value for the specified click tag. This field contains a click-through url. 2710 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 2711 # - If landingPageId is specified then that landing page's URL is assigned to this field. 2712 # - Otherwise, the customClickThroughUrl is assigned to this field. 2713 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 2714 "landingPageId": "A String", # ID of the landing page for the click-through URL. 2715 }, 2716 "name": "A String", # Parameter name for the specified click tag. For DISPLAY_IMAGE_GALLERY creative assets, this field must match the value of the creative asset's creativeAssetId.name field. 2717 }, 2718 ], 2719 "commercialId": "A String", # Industry standard ID assigned to creative for reach and frequency. Applicable to INSTREAM_VIDEO_REDIRECT creatives. 2720 "active": True or False, # Whether the creative is active. Applicable to all creative types. 2721 "compatibility": [ # Compatibilities associated with this creative. This is a read-only field. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering either on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are for rendering in mobile apps. Only pre-existing creatives may have these compatibilities since new creatives will either be assigned DISPLAY or DISPLAY_INTERSTITIAL instead. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. IN_STREAM_AUDIO refers to rendering in in-stream audio ads developed with the VAST standard. Applicable to all creative types. 2722 # 2723 # Acceptable values are: 2724 # - "APP" 2725 # - "APP_INTERSTITIAL" 2726 # - "IN_STREAM_VIDEO" 2727 # - "IN_STREAM_AUDIO" 2728 # - "DISPLAY" 2729 # - "DISPLAY_INTERSTITIAL" 2730 "A String", 2731 ], 2732 "universalAdId": { # A Universal Ad ID as per the VAST 4.0 spec. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and VPAID. # A Universal Ad ID as per the VAST 4.0 spec. Applicable to the following creative types: INSTREAM_AUDIO and INSTREAM_VIDEO and VPAID. 2733 "registry": "A String", # Registry used for the Ad ID value. 2734 "value": "A String", # ID value for this creative. Only alphanumeric characters and the following symbols are valid: "_/\-". Maximum length is 64 characters. Read only when registry is DCM. 2735 }, 2736 "adParameters": "A String", # Ad parameters user for VPAID creative. This is a read-only field. Applicable to the following creative types: all VPAID. 2737 "adTagKeys": [ # Keywords for a Rich Media creative. Keywords let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use keywords to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 2738 "A String", 2739 ], 2740 "kind": "dfareporting#creative", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creative". 2741 "subaccountId": "A String", # Subaccount ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types. 2742 "name": "A String", # Name of the creative. This is a required field and must be less than 256 characters long. Applicable to all creative types. 2743 "sslOverride": True or False, # Whether creative should be treated as SSL compliant even if the system scan shows it's not. Applicable to all creative types. 2744 "lastModifiedInfo": { # Modification timestamp. # Creative last modification information. This is a read-only field. Applicable to all creative types. 2745 "time": "A String", # Timestamp of the last change in milliseconds since epoch. 2746 }, 2747 "backupImageClickThroughUrl": { # Click-through URL # Click-through URL for backup image. Applicable to ENHANCED_BANNER when the primary asset type is not HTML_IMAGE. 2748 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 2749 # - If landingPageId is specified then that landing page's URL is assigned to this field. 2750 # - Otherwise, the customClickThroughUrl is assigned to this field. 2751 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 2752 "landingPageId": "A String", # ID of the landing page for the click-through URL. 2753 }, 2754 "sslCompliant": True or False, # Whether the creative is SSL-compliant. This is a read-only field. Applicable to all creative types. 2755 "studioCreativeId": "A String", # Studio creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 2756 "authoringTool": "A String", # Authoring tool for HTML5 banner creatives. This is a read-only field. Applicable to the following creative types: HTML5_BANNER. 2757 "allowScriptAccess": True or False, # Whether script access is allowed for this creative. This is a read-only and deprecated field which will automatically be set to true on update. Applicable to the following creative types: FLASH_INPAGE. 2758 "companionCreatives": [ # List of companion creatives assigned to an in-Stream video creative. Acceptable values include IDs of existing flash and image creatives. Applicable to the following creative types: all VPAID, all INSTREAM_AUDIO and all INSTREAM_VIDEO with dynamicAssetSelection set to false. 2759 "A String", 2760 ], 2761 "creativeAssetSelection": { # Encapsulates the list of rules for asset selection and a default asset in case none of the rules match. Applicable to INSTREAM_VIDEO creatives. # Required if dynamicAssetSelection is true. 2762 "rules": [ # Rules determine which asset will be served to a viewer. Rules will be evaluated in the order in which they are stored in this list. This list must contain at least one rule. Applicable to INSTREAM_VIDEO creatives. 2763 { # A rule associates an asset with a targeting template for asset-level targeting. Applicable to INSTREAM_VIDEO creatives. 2764 "assetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative. This is a required field. 2765 "targetingTemplateId": "A String", # A targeting template ID. The targeting from the targeting template will be used to determine whether this asset should be served. This is a required field. 2766 "name": "A String", # A user-friendly name for this rule. This is a required field. 2767 }, 2768 ], 2769 "defaultAssetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative, and will be served if none of the rules match. This is a required field. 2770 }, 2771 "htmlCode": "A String", # HTML code for the creative. This is a required field when applicable. This field is ignored if htmlCodeLocked is true. Applicable to the following creative types: all CUSTOM, FLASH_INPAGE, and HTML5_BANNER, and all RICH_MEDIA. 2772 "backupImageFeatures": [ # List of feature dependencies that will cause a backup image to be served if the browser that serves the ad does not support them. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative asset correctly. This field is initially auto-generated to contain all features detected by Campaign Manager for all the assets of this creative and can then be modified by the client. To reset this field, copy over all the creativeAssets' detected features. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2773 "A String", 2774 ], 2775 "backupImageTargetWindow": { # Target Window. # Target window for backup image. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2776 "customHtml": "A String", # User-entered value. 2777 "targetWindowOption": "A String", # Type of browser window for which the backup image of the flash creative can be displayed. 2778 }, 2779 "mediaDescription": "A String", # Description of the audio or video ad. Applicable to the following creative types: all INSTREAM_VIDEO, INSTREAM_AUDIO, and all VPAID. 2780 "skippable": True or False, # Whether the user can choose to skip the creative. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID. 2781 }</pre> 2782</div> 2783 2784<div class="method"> 2785 <code class="details" id="update">update(profileId, body)</code> 2786 <pre>Updates an existing creative. 2787 2788Args: 2789 profileId: string, User profile ID associated with this request. (required) 2790 body: object, The request body. (required) 2791 The object takes the form of: 2792 2793{ # Contains properties of a Creative. 2794 "thirdPartyUrls": [ # Third-party URLs for tracking in-stream creative events. Applicable to the following creative types: all INSTREAM_VIDEO, all INSTREAM_AUDIO, and all VPAID. 2795 { # Third-party Tracking URL. 2796 "url": "A String", # URL for the specified third-party URL type. 2797 "thirdPartyUrlType": "A String", # Third-party URL type for in-stream video and in-stream audio creatives. 2798 }, 2799 ], 2800 "artworkType": "A String", # Type of artwork used for the creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 2801 "latestTraffickedCreativeId": "A String", # Latest Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 2802 "politeLoadAssetId": "A String", # The asset ID of the polite load image asset. Applicable to the creative type: DISPLAY. 2803 "advertiserId": "A String", # Advertiser ID of this creative. This is a required field. Applicable to all creative types. 2804 "requiredFlashPluginVersion": "A String", # The minimum required Flash plugin version for this creative. For example, 11.2.202.235. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 2805 "thirdPartyBackupImageImpressionsUrl": "A String", # Third-party URL used to record backup image impressions. Applicable to the following creative types: all RICH_MEDIA. 2806 "timerCustomEvents": [ # List of timer events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset is not HTML_IMAGE. 2807 { # Creative Custom Event. 2808 "targetType": "A String", # Target type used by the event. 2809 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 2810 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 2811 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 2812 # - If landingPageId is specified then that landing page's URL is assigned to this field. 2813 # - Otherwise, the customClickThroughUrl is assigned to this field. 2814 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 2815 "landingPageId": "A String", # ID of the landing page for the click-through URL. 2816 }, 2817 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 2818 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 2819 "showStatusBar": True or False, # Whether to display the browser status bar. 2820 "showScrollBar": True or False, # Whether to display the browser scroll bar. 2821 "showAddressBar": True or False, # Whether to display the browser address bar. 2822 "showMenuBar": True or False, # Whether to display the browser menu bar. 2823 "title": "A String", # Title of popup window. 2824 "showToolBar": True or False, # Whether to display the browser tool bar. 2825 "positionType": "A String", # Popup window position either centered or at specific coordinate. 2826 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 2827 "top": 42, # Offset distance from top side of an asset or a window. 2828 "left": 42, # Offset distance from left side of an asset or a window. 2829 }, 2830 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 2831 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 2832 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 2833 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 2834 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 2835 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 2836 }, 2837 }, 2838 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 2839 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 2840 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 2841 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 2842 "advertiserCustomEventName": "A String", # User-entered name for the event. 2843 }, 2844 ], 2845 "renderingIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the rendering ID of this creative. This is a read-only field. Applicable to all creative types. 2846 "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue. 2847 "value": "A String", # The value of the dimension. 2848 "dimensionName": "A String", # The name of the dimension. 2849 "etag": "A String", # The eTag of this response for caching purposes. 2850 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2851 "id": "A String", # The ID associated with the value if available. 2852 }, 2853 "additionalSizes": [ # Additional sizes associated with a responsive creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. Applicable to DISPLAY creatives when the primary asset type is HTML_IMAGE. 2854 { # Represents the dimensions of ads, placements, creatives, or creative assets. 2855 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 2856 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 2857 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 2858 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 2859 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 2860 }, 2861 ], 2862 "fsCommand": { # FsCommand. # OpenWindow FSCommand of this creative. This lets the SWF file communicate with either Flash Player or the program hosting Flash Player, such as a web browser. This is only triggered if allowScriptAccess field is true. Applicable to the following creative types: FLASH_INPAGE. 2863 "windowHeight": 42, # Height of the window. 2864 "top": 42, # Distance from the top of the browser. Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER. 2865 "windowWidth": 42, # Width of the window. 2866 "positionOption": "A String", # Position in the browser where the window will open. 2867 "left": 42, # Distance from the left of the browser.Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER. 2868 }, 2869 "dynamicAssetSelection": True or False, # Set this to true to enable the use of rules to target individual assets in this creative. When set to true creativeAssetSelection must be set. This also controls asset-level companions. When this is true, companion creatives should be assigned to creative assets. Learn more. Applicable to INSTREAM_VIDEO creatives. 2870 "id": "A String", # ID of this creative. This is a read-only, auto-generated field. Applicable to all creative types. 2871 "progressOffset": { # Video Offset # Amount of time to play the video before counting a view. Applicable to the following creative types: all INSTREAM_VIDEO. 2872 "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set. Acceptable values are 0 to 100, inclusive. 2873 "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set. Acceptable values are 0 to 86399, inclusive. 2874 }, 2875 "accountId": "A String", # Account ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types. 2876 "studioTraffickedCreativeId": "A String", # Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 2877 "archived": True or False, # Whether the creative is archived. Applicable to all creative types. 2878 "overrideCss": "A String", # Override CSS value for rich media creatives. Applicable to the following creative types: all RICH_MEDIA. 2879 "authoringSource": "A String", # Source application where creative was authored. Presently, only DBM authored creatives will have this field set. Applicable to all creative types. 2880 "requiredFlashVersion": 42, # The internal Flash version for this creative as calculated by Studio. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2881 "exitCustomEvents": [ # List of exit events configured for the creative. For DISPLAY and DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags, For DISPLAY, an event is also created from the backupImageReportingLabel. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 2882 { # Creative Custom Event. 2883 "targetType": "A String", # Target type used by the event. 2884 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 2885 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 2886 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 2887 # - If landingPageId is specified then that landing page's URL is assigned to this field. 2888 # - Otherwise, the customClickThroughUrl is assigned to this field. 2889 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 2890 "landingPageId": "A String", # ID of the landing page for the click-through URL. 2891 }, 2892 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 2893 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 2894 "showStatusBar": True or False, # Whether to display the browser status bar. 2895 "showScrollBar": True or False, # Whether to display the browser scroll bar. 2896 "showAddressBar": True or False, # Whether to display the browser address bar. 2897 "showMenuBar": True or False, # Whether to display the browser menu bar. 2898 "title": "A String", # Title of popup window. 2899 "showToolBar": True or False, # Whether to display the browser tool bar. 2900 "positionType": "A String", # Popup window position either centered or at specific coordinate. 2901 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 2902 "top": 42, # Offset distance from top side of an asset or a window. 2903 "left": 42, # Offset distance from left side of an asset or a window. 2904 }, 2905 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 2906 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 2907 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 2908 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 2909 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 2910 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 2911 }, 2912 }, 2913 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 2914 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 2915 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 2916 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 2917 "advertiserCustomEventName": "A String", # User-entered name for the event. 2918 }, 2919 ], 2920 "renderingId": "A String", # ID of current rendering version. This is a read-only field. Applicable to all creative types. 2921 "counterCustomEvents": [ # List of counter events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. 2922 { # Creative Custom Event. 2923 "targetType": "A String", # Target type used by the event. 2924 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 2925 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 2926 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 2927 # - If landingPageId is specified then that landing page's URL is assigned to this field. 2928 # - Otherwise, the customClickThroughUrl is assigned to this field. 2929 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 2930 "landingPageId": "A String", # ID of the landing page for the click-through URL. 2931 }, 2932 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 2933 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 2934 "showStatusBar": True or False, # Whether to display the browser status bar. 2935 "showScrollBar": True or False, # Whether to display the browser scroll bar. 2936 "showAddressBar": True or False, # Whether to display the browser address bar. 2937 "showMenuBar": True or False, # Whether to display the browser menu bar. 2938 "title": "A String", # Title of popup window. 2939 "showToolBar": True or False, # Whether to display the browser tool bar. 2940 "positionType": "A String", # Popup window position either centered or at specific coordinate. 2941 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 2942 "top": 42, # Offset distance from top side of an asset or a window. 2943 "left": 42, # Offset distance from left side of an asset or a window. 2944 }, 2945 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 2946 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 2947 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 2948 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 2949 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 2950 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 2951 }, 2952 }, 2953 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 2954 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 2955 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 2956 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 2957 "advertiserCustomEventName": "A String", # User-entered name for the event. 2958 }, 2959 ], 2960 "skipOffset": { # Video Offset # Amount of time to play the video before the skip button appears. Applicable to the following creative types: all INSTREAM_VIDEO. 2961 "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set. Acceptable values are 0 to 100, inclusive. 2962 "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set. Acceptable values are 0 to 86399, inclusive. 2963 }, 2964 "backupImageReportingLabel": "A String", # Reporting label used for HTML5 banner backup image. Applicable to the following creative types: DISPLAY when the primary asset type is not HTML_IMAGE. 2965 "version": 42, # The version number helps you keep track of multiple versions of your creative in your reports. The version number will always be auto-generated during insert operations to start at 1. For tracking creatives the version cannot be incremented and will always remain at 1. For all other creative types the version can be incremented only by 1 during update operations. In addition, the version will be automatically incremented by 1 when undergoing Rich Media creative merging. Applicable to all creative types. 2966 "creativeFieldAssignments": [ # Creative field assignments for this creative. Applicable to all creative types. 2967 { # Creative Field Assignment. 2968 "creativeFieldId": "A String", # ID of the creative field. 2969 "creativeFieldValueId": "A String", # ID of the creative field value. 2970 }, 2971 ], 2972 "backgroundColor": "A String", # The 6-character HTML color code, beginning with #, for the background of the window area where the Flash file is displayed. Default is white. Applicable to the following creative types: FLASH_INPAGE. 2973 "customKeyValues": [ # Custom key-values for a Rich Media creative. Key-values let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use key-values to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 2974 "A String", 2975 ], 2976 "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this creative. This is a read-only field. Applicable to all creative types. 2977 "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue. 2978 "value": "A String", # The value of the dimension. 2979 "dimensionName": "A String", # The name of the dimension. 2980 "etag": "A String", # The eTag of this response for caching purposes. 2981 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2982 "id": "A String", # The ID associated with the value if available. 2983 }, 2984 "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. This is a required field when applicable; however for IMAGE, FLASH_INPAGE creatives, and for DISPLAY creatives with a primary asset of type HTML_IMAGE, if left blank, this field will be automatically set using the actual size of the associated image assets. Applicable to the following creative types: DISPLAY, DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA. 2985 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 2986 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 2987 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 2988 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 2989 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 2990 }, 2991 "type": "A String", # Type of this creative. This is a required field. Applicable to all creative types. 2992 # 2993 # Note: FLASH_INPAGE, HTML5_BANNER, and IMAGE are only used for existing creatives. New creatives should use DISPLAY as a replacement for these types. 2994 "totalFileSize": "A String", # Combined size of all creative assets. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 2995 "mediaDuration": 3.14, # Creative audio or video duration in seconds. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO, INSTREAM_AUDIO, all RICH_MEDIA, and all VPAID. 2996 "thirdPartyRichMediaImpressionsUrl": "A String", # Third-party URL used to record rich media impressions. Applicable to the following creative types: all RICH_MEDIA. 2997 "studioAdvertiserId": "A String", # Studio advertiser ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 2998 "creativeAssets": [ # Assets associated with a creative. Applicable to all but the following creative types: INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and REDIRECT 2999 { # Creative Asset. 3000 "mimeType": "A String", # Detected MIME type for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 3001 "artworkType": "A String", # Artwork type of rich media creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 3002 "positionLeftUnit": "A String", # Offset left unit for an asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 3003 "collapsedSize": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size of an asset when collapsed. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN. 3004 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 3005 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 3006 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 3007 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 3008 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 3009 }, 3010 "flashVersion": 42, # Flash version of the asset. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 3011 "additionalSizes": [ # Additional sizes associated with this creative asset. HTML5 asset generated by compatible software such as GWD will be able to support more sizes this creative asset can render. 3012 { # Represents the dimensions of ads, placements, creatives, or creative assets. 3013 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 3014 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 3015 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 3016 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 3017 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 3018 }, 3019 ], 3020 "hideFlashObjects": True or False, # Whether to hide Flash objects flag for an asset. Applicable to the following creative types: all RICH_MEDIA. 3021 "detectedFeatures": [ # List of feature dependencies for the creative asset that are detected by Campaign Manager. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative correctly. This is a read-only, auto-generated field. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 3022 "A String", 3023 ], 3024 "originalBackup": True or False, # Whether the backup asset is original or changed by the user in Campaign Manager. Applicable to the following creative types: all RICH_MEDIA. 3025 "duration": 42, # Duration in seconds for which an asset will be displayed. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and VPAID_LINEAR_VIDEO. Value must be greater than or equal to 1. 3026 "positionTopUnit": "A String", # Offset top unit for an asset. This is a read-only field if the asset displayType is ASSET_DISPLAY_TYPE_OVERLAY. Applicable to the following creative types: all RICH_MEDIA. 3027 "id": "A String", # Numeric ID of this creative asset. This is a required field and should not be modified. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 3028 "alignment": "A String", # Possible alignments for an asset. This is a read-only field. Applicable to the following creative types: RICH_MEDIA_DISPLAY_MULTI_FLOATING_INTERSTITIAL. 3029 "orientation": "A String", # Orientation of video asset. This is a read-only, auto-generated field. 3030 "position": { # Offset Position. # Offset position for an asset. Applicable to the following creative types: all RICH_MEDIA. 3031 "top": 42, # Offset distance from top side of an asset or a window. 3032 "left": 42, # Offset distance from left side of an asset or a window. 3033 }, 3034 "horizontallyLocked": True or False, # Whether the asset is horizontally locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 3035 "startTimeType": "A String", # Initial wait time type before making the asset visible. Applicable to the following creative types: all RICH_MEDIA. 3036 "displayType": "A String", # Type of rich media asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 3037 "expandedDimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Detected expanded dimension for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID. 3038 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 3039 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 3040 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 3041 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 3042 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 3043 }, 3044 "verticallyLocked": True or False, # Whether the asset is vertically locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 3045 "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the asset. This is a read-only, auto-generated field. 3046 "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue. 3047 "value": "A String", # The value of the dimension. 3048 "dimensionName": "A String", # The name of the dimension. 3049 "etag": "A String", # The eTag of this response for caching purposes. 3050 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 3051 "id": "A String", # The ID associated with the value if available. 3052 }, 3053 "role": "A String", # Role of the asset in relation to creative. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. This is a required field. 3054 # PRIMARY applies to DISPLAY, FLASH_INPAGE, HTML5_BANNER, IMAGE, DISPLAY_IMAGE_GALLERY, all RICH_MEDIA (which may contain multiple primary assets), and all VPAID creatives. 3055 # BACKUP_IMAGE applies to FLASH_INPAGE, HTML5_BANNER, all RICH_MEDIA, and all VPAID creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 3056 # ADDITIONAL_IMAGE and ADDITIONAL_FLASH apply to FLASH_INPAGE creatives. 3057 # OTHER refers to assets from sources other than Campaign Manager, such as Studio uploaded assets, applicable to all RICH_MEDIA and all VPAID creatives. 3058 # PARENT_VIDEO refers to videos uploaded by the user in Campaign Manager and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives. 3059 # TRANSCODED_VIDEO refers to videos transcoded by Campaign Manager from PARENT_VIDEO assets and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives. 3060 # ALTERNATE_VIDEO refers to the Campaign Manager representation of child asset videos from Studio, and is applicable to VPAID_LINEAR_VIDEO creatives. These cannot be added or removed within Campaign Manager. 3061 # For VPAID_LINEAR_VIDEO creatives, PARENT_VIDEO, TRANSCODED_VIDEO and ALTERNATE_VIDEO assets that are marked active serve as backup in case the VPAID creative cannot be served. Only PARENT_VIDEO assets can be added or removed for an INSTREAM_VIDEO or VPAID_LINEAR_VIDEO creative. 3062 # PARENT_AUDIO refers to audios uploaded by the user in Campaign Manager and is applicable to INSTREAM_AUDIO creatives. 3063 # TRANSCODED_AUDIO refers to audios transcoded by Campaign Manager from PARENT_AUDIO assets and is applicable to INSTREAM_AUDIO creatives. 3064 "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative asset. This is a required field when applicable; however for IMAGE and FLASH_INPAGE, creatives if left blank, this field will be automatically set using the actual size of the associated image asset. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 3065 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 3066 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 3067 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 3068 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 3069 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 3070 }, 3071 "bitRate": 42, # Detected bit-rate for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 3072 "windowMode": "A String", # Window mode options for flash assets. Applicable to the following creative types: FLASH_INPAGE, RICH_MEDIA_DISPLAY_EXPANDING, RICH_MEDIA_IM_EXPAND, RICH_MEDIA_DISPLAY_BANNER, and RICH_MEDIA_INPAGE_FLOATING. 3073 "pushdown": True or False, # Whether the asset pushes down other content. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable when the asset offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height. 3074 "progressiveServingUrl": "A String", # Progressive URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID. 3075 "durationType": "A String", # Duration type for which an asset will be displayed. Applicable to the following creative types: all RICH_MEDIA. 3076 "zIndex": 42, # zIndex value of an asset. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable to assets whose displayType is NOT one of the following types: ASSET_DISPLAY_TYPE_INPAGE or ASSET_DISPLAY_TYPE_OVERLAY. Acceptable values are -999999999 to 999999999, inclusive. 3077 "fileSize": "A String", # File size associated with this creative asset. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 3078 "zipFilename": "A String", # File name of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER. 3079 "offset": { # Offset Position. # Offset position for an asset in collapsed mode. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, only applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN. 3080 "top": 42, # Offset distance from top side of an asset or a window. 3081 "left": 42, # Offset distance from left side of an asset or a window. 3082 }, 3083 "active": True or False, # Whether the video or audio asset is active. This is a read-only field for VPAID_NON_LINEAR_VIDEO assets. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 3084 "companionCreativeIds": [ # List of companion creatives assigned to an in-stream video creative asset. Acceptable values include IDs of existing flash and image creatives. Applicable to INSTREAM_VIDEO creative type with dynamicAssetSelection set to true. 3085 "A String", 3086 ], 3087 "hideSelectionBoxes": True or False, # Whether to hide selection boxes flag for an asset. Applicable to the following creative types: all RICH_MEDIA. 3088 "streamingServingUrl": "A String", # Streaming URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID. 3089 "zipFilesize": "A String", # Size of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER. 3090 "childAssetType": "A String", # Rich media child asset type. This is a read-only field. Applicable to the following creative types: all VPAID. 3091 "backupImageExit": { # Creative Custom Event. # Exit event configured for the backup image. Applicable to the following creative types: all RICH_MEDIA. 3092 "targetType": "A String", # Target type used by the event. 3093 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 3094 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 3095 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 3096 # - If landingPageId is specified then that landing page's URL is assigned to this field. 3097 # - Otherwise, the customClickThroughUrl is assigned to this field. 3098 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 3099 "landingPageId": "A String", # ID of the landing page for the click-through URL. 3100 }, 3101 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 3102 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 3103 "showStatusBar": True or False, # Whether to display the browser status bar. 3104 "showScrollBar": True or False, # Whether to display the browser scroll bar. 3105 "showAddressBar": True or False, # Whether to display the browser address bar. 3106 "showMenuBar": True or False, # Whether to display the browser menu bar. 3107 "title": "A String", # Title of popup window. 3108 "showToolBar": True or False, # Whether to display the browser tool bar. 3109 "positionType": "A String", # Popup window position either centered or at specific coordinate. 3110 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 3111 "top": 42, # Offset distance from top side of an asset or a window. 3112 "left": 42, # Offset distance from left side of an asset or a window. 3113 }, 3114 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 3115 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 3116 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 3117 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 3118 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 3119 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 3120 }, 3121 }, 3122 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 3123 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 3124 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 3125 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 3126 "advertiserCustomEventName": "A String", # User-entered name for the event. 3127 }, 3128 "actionScript3": True or False, # Whether ActionScript3 is enabled for the flash asset. This is a read-only field. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 3129 "pushdownDuration": 3.14, # Pushdown duration in seconds for an asset. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable when the asset pushdown field is true, the offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height. Acceptable values are 0 to 9.99, inclusive. 3130 "assetIdentifier": { # Creative Asset ID. # Identifier of this asset. This is the same identifier returned during creative asset insert operation. This is a required field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 3131 "type": "A String", # Type of asset to upload. This is a required field. FLASH and IMAGE are no longer supported for new uploads. All image assets should use HTML_IMAGE. 3132 "name": "A String", # Name of the creative asset. This is a required field while inserting an asset. After insertion, this assetIdentifier is used to identify the uploaded asset. Characters in the name must be alphanumeric or one of the following: ".-_ ". Spaces are allowed. 3133 }, 3134 "transparency": True or False, # Whether the asset is transparent. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable to HTML5 assets. 3135 "sslCompliant": True or False, # Whether the asset is SSL-compliant. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 3136 "mediaDuration": 3.14, # Detected duration for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 3137 "customStartTimeValue": 42, # Custom start time in seconds for making the asset visible. Applicable to the following creative types: all RICH_MEDIA. Value must be greater than or equal to 0. 3138 }, 3139 ], 3140 "redirectUrl": "A String", # URL of hosted image or hosted video or another ad tag. For INSTREAM_VIDEO_REDIRECT creatives this is the in-stream video redirect URL. The standard for a VAST (Video Ad Serving Template) ad response allows for a redirect link to another VAST 2.0 or 3.0 call. This is a required field when applicable. Applicable to the following creative types: DISPLAY_REDIRECT, INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO_REDIRECT 3141 "autoAdvanceImages": True or False, # Whether images are automatically advanced for image gallery creatives. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY. 3142 "htmlCodeLocked": True or False, # Whether HTML code is generated by Campaign Manager or manually entered. Set to true to ignore changes to htmlCode. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. 3143 "convertFlashToHtml5": True or False, # Whether Flash assets associated with the creative need to be automatically converted to HTML5. This flag is enabled by default and users can choose to disable it if they don't want the system to generate and use HTML5 asset for this creative. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 3144 "clickTags": [ # Click tags of the creative. For DISPLAY, FLASH_INPAGE, and HTML5_BANNER creatives, this is a subset of detected click tags for the assets associated with this creative. After creating a flash asset, detected click tags will be returned in the creativeAssetMetadata. When inserting the creative, populate the creative clickTags field using the creativeAssetMetadata.clickTags field. For DISPLAY_IMAGE_GALLERY creatives, there should be exactly one entry in this list for each image creative asset. A click tag is matched with a corresponding creative asset by matching the clickTag.name field with the creativeAsset.assetIdentifier.name field. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 3145 { # Creative Click Tag. 3146 "eventName": "A String", # Advertiser event name associated with the click tag. This field is used by DISPLAY_IMAGE_GALLERY and HTML5_BANNER creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 3147 "clickThroughUrl": { # Click-through URL # Parameter value for the specified click tag. This field contains a click-through url. 3148 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 3149 # - If landingPageId is specified then that landing page's URL is assigned to this field. 3150 # - Otherwise, the customClickThroughUrl is assigned to this field. 3151 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 3152 "landingPageId": "A String", # ID of the landing page for the click-through URL. 3153 }, 3154 "name": "A String", # Parameter name for the specified click tag. For DISPLAY_IMAGE_GALLERY creative assets, this field must match the value of the creative asset's creativeAssetId.name field. 3155 }, 3156 ], 3157 "commercialId": "A String", # Industry standard ID assigned to creative for reach and frequency. Applicable to INSTREAM_VIDEO_REDIRECT creatives. 3158 "active": True or False, # Whether the creative is active. Applicable to all creative types. 3159 "compatibility": [ # Compatibilities associated with this creative. This is a read-only field. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering either on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are for rendering in mobile apps. Only pre-existing creatives may have these compatibilities since new creatives will either be assigned DISPLAY or DISPLAY_INTERSTITIAL instead. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. IN_STREAM_AUDIO refers to rendering in in-stream audio ads developed with the VAST standard. Applicable to all creative types. 3160 # 3161 # Acceptable values are: 3162 # - "APP" 3163 # - "APP_INTERSTITIAL" 3164 # - "IN_STREAM_VIDEO" 3165 # - "IN_STREAM_AUDIO" 3166 # - "DISPLAY" 3167 # - "DISPLAY_INTERSTITIAL" 3168 "A String", 3169 ], 3170 "universalAdId": { # A Universal Ad ID as per the VAST 4.0 spec. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and VPAID. # A Universal Ad ID as per the VAST 4.0 spec. Applicable to the following creative types: INSTREAM_AUDIO and INSTREAM_VIDEO and VPAID. 3171 "registry": "A String", # Registry used for the Ad ID value. 3172 "value": "A String", # ID value for this creative. Only alphanumeric characters and the following symbols are valid: "_/\-". Maximum length is 64 characters. Read only when registry is DCM. 3173 }, 3174 "adParameters": "A String", # Ad parameters user for VPAID creative. This is a read-only field. Applicable to the following creative types: all VPAID. 3175 "adTagKeys": [ # Keywords for a Rich Media creative. Keywords let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use keywords to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 3176 "A String", 3177 ], 3178 "kind": "dfareporting#creative", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creative". 3179 "subaccountId": "A String", # Subaccount ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types. 3180 "name": "A String", # Name of the creative. This is a required field and must be less than 256 characters long. Applicable to all creative types. 3181 "sslOverride": True or False, # Whether creative should be treated as SSL compliant even if the system scan shows it's not. Applicable to all creative types. 3182 "lastModifiedInfo": { # Modification timestamp. # Creative last modification information. This is a read-only field. Applicable to all creative types. 3183 "time": "A String", # Timestamp of the last change in milliseconds since epoch. 3184 }, 3185 "backupImageClickThroughUrl": { # Click-through URL # Click-through URL for backup image. Applicable to ENHANCED_BANNER when the primary asset type is not HTML_IMAGE. 3186 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 3187 # - If landingPageId is specified then that landing page's URL is assigned to this field. 3188 # - Otherwise, the customClickThroughUrl is assigned to this field. 3189 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 3190 "landingPageId": "A String", # ID of the landing page for the click-through URL. 3191 }, 3192 "sslCompliant": True or False, # Whether the creative is SSL-compliant. This is a read-only field. Applicable to all creative types. 3193 "studioCreativeId": "A String", # Studio creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 3194 "authoringTool": "A String", # Authoring tool for HTML5 banner creatives. This is a read-only field. Applicable to the following creative types: HTML5_BANNER. 3195 "allowScriptAccess": True or False, # Whether script access is allowed for this creative. This is a read-only and deprecated field which will automatically be set to true on update. Applicable to the following creative types: FLASH_INPAGE. 3196 "companionCreatives": [ # List of companion creatives assigned to an in-Stream video creative. Acceptable values include IDs of existing flash and image creatives. Applicable to the following creative types: all VPAID, all INSTREAM_AUDIO and all INSTREAM_VIDEO with dynamicAssetSelection set to false. 3197 "A String", 3198 ], 3199 "creativeAssetSelection": { # Encapsulates the list of rules for asset selection and a default asset in case none of the rules match. Applicable to INSTREAM_VIDEO creatives. # Required if dynamicAssetSelection is true. 3200 "rules": [ # Rules determine which asset will be served to a viewer. Rules will be evaluated in the order in which they are stored in this list. This list must contain at least one rule. Applicable to INSTREAM_VIDEO creatives. 3201 { # A rule associates an asset with a targeting template for asset-level targeting. Applicable to INSTREAM_VIDEO creatives. 3202 "assetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative. This is a required field. 3203 "targetingTemplateId": "A String", # A targeting template ID. The targeting from the targeting template will be used to determine whether this asset should be served. This is a required field. 3204 "name": "A String", # A user-friendly name for this rule. This is a required field. 3205 }, 3206 ], 3207 "defaultAssetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative, and will be served if none of the rules match. This is a required field. 3208 }, 3209 "htmlCode": "A String", # HTML code for the creative. This is a required field when applicable. This field is ignored if htmlCodeLocked is true. Applicable to the following creative types: all CUSTOM, FLASH_INPAGE, and HTML5_BANNER, and all RICH_MEDIA. 3210 "backupImageFeatures": [ # List of feature dependencies that will cause a backup image to be served if the browser that serves the ad does not support them. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative asset correctly. This field is initially auto-generated to contain all features detected by Campaign Manager for all the assets of this creative and can then be modified by the client. To reset this field, copy over all the creativeAssets' detected features. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 3211 "A String", 3212 ], 3213 "backupImageTargetWindow": { # Target Window. # Target window for backup image. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 3214 "customHtml": "A String", # User-entered value. 3215 "targetWindowOption": "A String", # Type of browser window for which the backup image of the flash creative can be displayed. 3216 }, 3217 "mediaDescription": "A String", # Description of the audio or video ad. Applicable to the following creative types: all INSTREAM_VIDEO, INSTREAM_AUDIO, and all VPAID. 3218 "skippable": True or False, # Whether the user can choose to skip the creative. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID. 3219 } 3220 3221 3222Returns: 3223 An object of the form: 3224 3225 { # Contains properties of a Creative. 3226 "thirdPartyUrls": [ # Third-party URLs for tracking in-stream creative events. Applicable to the following creative types: all INSTREAM_VIDEO, all INSTREAM_AUDIO, and all VPAID. 3227 { # Third-party Tracking URL. 3228 "url": "A String", # URL for the specified third-party URL type. 3229 "thirdPartyUrlType": "A String", # Third-party URL type for in-stream video and in-stream audio creatives. 3230 }, 3231 ], 3232 "artworkType": "A String", # Type of artwork used for the creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 3233 "latestTraffickedCreativeId": "A String", # Latest Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 3234 "politeLoadAssetId": "A String", # The asset ID of the polite load image asset. Applicable to the creative type: DISPLAY. 3235 "advertiserId": "A String", # Advertiser ID of this creative. This is a required field. Applicable to all creative types. 3236 "requiredFlashPluginVersion": "A String", # The minimum required Flash plugin version for this creative. For example, 11.2.202.235. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 3237 "thirdPartyBackupImageImpressionsUrl": "A String", # Third-party URL used to record backup image impressions. Applicable to the following creative types: all RICH_MEDIA. 3238 "timerCustomEvents": [ # List of timer events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset is not HTML_IMAGE. 3239 { # Creative Custom Event. 3240 "targetType": "A String", # Target type used by the event. 3241 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 3242 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 3243 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 3244 # - If landingPageId is specified then that landing page's URL is assigned to this field. 3245 # - Otherwise, the customClickThroughUrl is assigned to this field. 3246 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 3247 "landingPageId": "A String", # ID of the landing page for the click-through URL. 3248 }, 3249 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 3250 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 3251 "showStatusBar": True or False, # Whether to display the browser status bar. 3252 "showScrollBar": True or False, # Whether to display the browser scroll bar. 3253 "showAddressBar": True or False, # Whether to display the browser address bar. 3254 "showMenuBar": True or False, # Whether to display the browser menu bar. 3255 "title": "A String", # Title of popup window. 3256 "showToolBar": True or False, # Whether to display the browser tool bar. 3257 "positionType": "A String", # Popup window position either centered or at specific coordinate. 3258 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 3259 "top": 42, # Offset distance from top side of an asset or a window. 3260 "left": 42, # Offset distance from left side of an asset or a window. 3261 }, 3262 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 3263 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 3264 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 3265 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 3266 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 3267 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 3268 }, 3269 }, 3270 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 3271 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 3272 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 3273 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 3274 "advertiserCustomEventName": "A String", # User-entered name for the event. 3275 }, 3276 ], 3277 "renderingIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the rendering ID of this creative. This is a read-only field. Applicable to all creative types. 3278 "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue. 3279 "value": "A String", # The value of the dimension. 3280 "dimensionName": "A String", # The name of the dimension. 3281 "etag": "A String", # The eTag of this response for caching purposes. 3282 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 3283 "id": "A String", # The ID associated with the value if available. 3284 }, 3285 "additionalSizes": [ # Additional sizes associated with a responsive creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. Applicable to DISPLAY creatives when the primary asset type is HTML_IMAGE. 3286 { # Represents the dimensions of ads, placements, creatives, or creative assets. 3287 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 3288 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 3289 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 3290 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 3291 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 3292 }, 3293 ], 3294 "fsCommand": { # FsCommand. # OpenWindow FSCommand of this creative. This lets the SWF file communicate with either Flash Player or the program hosting Flash Player, such as a web browser. This is only triggered if allowScriptAccess field is true. Applicable to the following creative types: FLASH_INPAGE. 3295 "windowHeight": 42, # Height of the window. 3296 "top": 42, # Distance from the top of the browser. Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER. 3297 "windowWidth": 42, # Width of the window. 3298 "positionOption": "A String", # Position in the browser where the window will open. 3299 "left": 42, # Distance from the left of the browser.Applicable when positionOption is DISTANCE_FROM_TOP_LEFT_CORNER. 3300 }, 3301 "dynamicAssetSelection": True or False, # Set this to true to enable the use of rules to target individual assets in this creative. When set to true creativeAssetSelection must be set. This also controls asset-level companions. When this is true, companion creatives should be assigned to creative assets. Learn more. Applicable to INSTREAM_VIDEO creatives. 3302 "id": "A String", # ID of this creative. This is a read-only, auto-generated field. Applicable to all creative types. 3303 "progressOffset": { # Video Offset # Amount of time to play the video before counting a view. Applicable to the following creative types: all INSTREAM_VIDEO. 3304 "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set. Acceptable values are 0 to 100, inclusive. 3305 "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set. Acceptable values are 0 to 86399, inclusive. 3306 }, 3307 "accountId": "A String", # Account ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types. 3308 "studioTraffickedCreativeId": "A String", # Studio trafficked creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 3309 "archived": True or False, # Whether the creative is archived. Applicable to all creative types. 3310 "overrideCss": "A String", # Override CSS value for rich media creatives. Applicable to the following creative types: all RICH_MEDIA. 3311 "authoringSource": "A String", # Source application where creative was authored. Presently, only DBM authored creatives will have this field set. Applicable to all creative types. 3312 "requiredFlashVersion": 42, # The internal Flash version for this creative as calculated by Studio. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 3313 "exitCustomEvents": [ # List of exit events configured for the creative. For DISPLAY and DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags, For DISPLAY, an event is also created from the backupImageReportingLabel. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 3314 { # Creative Custom Event. 3315 "targetType": "A String", # Target type used by the event. 3316 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 3317 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 3318 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 3319 # - If landingPageId is specified then that landing page's URL is assigned to this field. 3320 # - Otherwise, the customClickThroughUrl is assigned to this field. 3321 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 3322 "landingPageId": "A String", # ID of the landing page for the click-through URL. 3323 }, 3324 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 3325 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 3326 "showStatusBar": True or False, # Whether to display the browser status bar. 3327 "showScrollBar": True or False, # Whether to display the browser scroll bar. 3328 "showAddressBar": True or False, # Whether to display the browser address bar. 3329 "showMenuBar": True or False, # Whether to display the browser menu bar. 3330 "title": "A String", # Title of popup window. 3331 "showToolBar": True or False, # Whether to display the browser tool bar. 3332 "positionType": "A String", # Popup window position either centered or at specific coordinate. 3333 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 3334 "top": 42, # Offset distance from top side of an asset or a window. 3335 "left": 42, # Offset distance from left side of an asset or a window. 3336 }, 3337 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 3338 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 3339 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 3340 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 3341 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 3342 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 3343 }, 3344 }, 3345 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 3346 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 3347 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 3348 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 3349 "advertiserCustomEventName": "A String", # User-entered name for the event. 3350 }, 3351 ], 3352 "renderingId": "A String", # ID of current rendering version. This is a read-only field. Applicable to all creative types. 3353 "counterCustomEvents": [ # List of counter events configured for the creative. For DISPLAY_IMAGE_GALLERY creatives, these are read-only and auto-generated from clickTags. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, all RICH_MEDIA, and all VPAID. 3354 { # Creative Custom Event. 3355 "targetType": "A String", # Target type used by the event. 3356 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 3357 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 3358 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 3359 # - If landingPageId is specified then that landing page's URL is assigned to this field. 3360 # - Otherwise, the customClickThroughUrl is assigned to this field. 3361 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 3362 "landingPageId": "A String", # ID of the landing page for the click-through URL. 3363 }, 3364 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 3365 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 3366 "showStatusBar": True or False, # Whether to display the browser status bar. 3367 "showScrollBar": True or False, # Whether to display the browser scroll bar. 3368 "showAddressBar": True or False, # Whether to display the browser address bar. 3369 "showMenuBar": True or False, # Whether to display the browser menu bar. 3370 "title": "A String", # Title of popup window. 3371 "showToolBar": True or False, # Whether to display the browser tool bar. 3372 "positionType": "A String", # Popup window position either centered or at specific coordinate. 3373 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 3374 "top": 42, # Offset distance from top side of an asset or a window. 3375 "left": 42, # Offset distance from left side of an asset or a window. 3376 }, 3377 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 3378 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 3379 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 3380 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 3381 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 3382 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 3383 }, 3384 }, 3385 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 3386 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 3387 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 3388 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 3389 "advertiserCustomEventName": "A String", # User-entered name for the event. 3390 }, 3391 ], 3392 "skipOffset": { # Video Offset # Amount of time to play the video before the skip button appears. Applicable to the following creative types: all INSTREAM_VIDEO. 3393 "offsetPercentage": 42, # Duration, as a percentage of video duration. Do not set when offsetSeconds is set. Acceptable values are 0 to 100, inclusive. 3394 "offsetSeconds": 42, # Duration, in seconds. Do not set when offsetPercentage is set. Acceptable values are 0 to 86399, inclusive. 3395 }, 3396 "backupImageReportingLabel": "A String", # Reporting label used for HTML5 banner backup image. Applicable to the following creative types: DISPLAY when the primary asset type is not HTML_IMAGE. 3397 "version": 42, # The version number helps you keep track of multiple versions of your creative in your reports. The version number will always be auto-generated during insert operations to start at 1. For tracking creatives the version cannot be incremented and will always remain at 1. For all other creative types the version can be incremented only by 1 during update operations. In addition, the version will be automatically incremented by 1 when undergoing Rich Media creative merging. Applicable to all creative types. 3398 "creativeFieldAssignments": [ # Creative field assignments for this creative. Applicable to all creative types. 3399 { # Creative Field Assignment. 3400 "creativeFieldId": "A String", # ID of the creative field. 3401 "creativeFieldValueId": "A String", # ID of the creative field value. 3402 }, 3403 ], 3404 "backgroundColor": "A String", # The 6-character HTML color code, beginning with #, for the background of the window area where the Flash file is displayed. Default is white. Applicable to the following creative types: FLASH_INPAGE. 3405 "customKeyValues": [ # Custom key-values for a Rich Media creative. Key-values let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use key-values to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 3406 "A String", 3407 ], 3408 "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this creative. This is a read-only field. Applicable to all creative types. 3409 "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue. 3410 "value": "A String", # The value of the dimension. 3411 "dimensionName": "A String", # The name of the dimension. 3412 "etag": "A String", # The eTag of this response for caching purposes. 3413 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 3414 "id": "A String", # The ID associated with the value if available. 3415 }, 3416 "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative. When inserting or updating a creative either the size ID field or size width and height fields can be used. This is a required field when applicable; however for IMAGE, FLASH_INPAGE creatives, and for DISPLAY creatives with a primary asset of type HTML_IMAGE, if left blank, this field will be automatically set using the actual size of the associated image assets. Applicable to the following creative types: DISPLAY, DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA. 3417 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 3418 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 3419 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 3420 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 3421 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 3422 }, 3423 "type": "A String", # Type of this creative. This is a required field. Applicable to all creative types. 3424 # 3425 # Note: FLASH_INPAGE, HTML5_BANNER, and IMAGE are only used for existing creatives. New creatives should use DISPLAY as a replacement for these types. 3426 "totalFileSize": "A String", # Combined size of all creative assets. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 3427 "mediaDuration": 3.14, # Creative audio or video duration in seconds. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO, INSTREAM_AUDIO, all RICH_MEDIA, and all VPAID. 3428 "thirdPartyRichMediaImpressionsUrl": "A String", # Third-party URL used to record rich media impressions. Applicable to the following creative types: all RICH_MEDIA. 3429 "studioAdvertiserId": "A String", # Studio advertiser ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 3430 "creativeAssets": [ # Assets associated with a creative. Applicable to all but the following creative types: INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and REDIRECT 3431 { # Creative Asset. 3432 "mimeType": "A String", # Detected MIME type for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 3433 "artworkType": "A String", # Artwork type of rich media creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 3434 "positionLeftUnit": "A String", # Offset left unit for an asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 3435 "collapsedSize": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size of an asset when collapsed. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN. 3436 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 3437 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 3438 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 3439 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 3440 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 3441 }, 3442 "flashVersion": 42, # Flash version of the asset. This is a read-only field. Applicable to the following creative types: FLASH_INPAGE, all RICH_MEDIA, and all VPAID. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 3443 "additionalSizes": [ # Additional sizes associated with this creative asset. HTML5 asset generated by compatible software such as GWD will be able to support more sizes this creative asset can render. 3444 { # Represents the dimensions of ads, placements, creatives, or creative assets. 3445 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 3446 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 3447 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 3448 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 3449 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 3450 }, 3451 ], 3452 "hideFlashObjects": True or False, # Whether to hide Flash objects flag for an asset. Applicable to the following creative types: all RICH_MEDIA. 3453 "detectedFeatures": [ # List of feature dependencies for the creative asset that are detected by Campaign Manager. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative correctly. This is a read-only, auto-generated field. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 3454 "A String", 3455 ], 3456 "originalBackup": True or False, # Whether the backup asset is original or changed by the user in Campaign Manager. Applicable to the following creative types: all RICH_MEDIA. 3457 "duration": 42, # Duration in seconds for which an asset will be displayed. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and VPAID_LINEAR_VIDEO. Value must be greater than or equal to 1. 3458 "positionTopUnit": "A String", # Offset top unit for an asset. This is a read-only field if the asset displayType is ASSET_DISPLAY_TYPE_OVERLAY. Applicable to the following creative types: all RICH_MEDIA. 3459 "id": "A String", # Numeric ID of this creative asset. This is a required field and should not be modified. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 3460 "alignment": "A String", # Possible alignments for an asset. This is a read-only field. Applicable to the following creative types: RICH_MEDIA_DISPLAY_MULTI_FLOATING_INTERSTITIAL. 3461 "orientation": "A String", # Orientation of video asset. This is a read-only, auto-generated field. 3462 "position": { # Offset Position. # Offset position for an asset. Applicable to the following creative types: all RICH_MEDIA. 3463 "top": 42, # Offset distance from top side of an asset or a window. 3464 "left": 42, # Offset distance from left side of an asset or a window. 3465 }, 3466 "horizontallyLocked": True or False, # Whether the asset is horizontally locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 3467 "startTimeType": "A String", # Initial wait time type before making the asset visible. Applicable to the following creative types: all RICH_MEDIA. 3468 "displayType": "A String", # Type of rich media asset. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 3469 "expandedDimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Detected expanded dimension for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID. 3470 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 3471 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 3472 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 3473 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 3474 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 3475 }, 3476 "verticallyLocked": True or False, # Whether the asset is vertically locked. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA. 3477 "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the asset. This is a read-only, auto-generated field. 3478 "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue. 3479 "value": "A String", # The value of the dimension. 3480 "dimensionName": "A String", # The name of the dimension. 3481 "etag": "A String", # The eTag of this response for caching purposes. 3482 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 3483 "id": "A String", # The ID associated with the value if available. 3484 }, 3485 "role": "A String", # Role of the asset in relation to creative. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. This is a required field. 3486 # PRIMARY applies to DISPLAY, FLASH_INPAGE, HTML5_BANNER, IMAGE, DISPLAY_IMAGE_GALLERY, all RICH_MEDIA (which may contain multiple primary assets), and all VPAID creatives. 3487 # BACKUP_IMAGE applies to FLASH_INPAGE, HTML5_BANNER, all RICH_MEDIA, and all VPAID creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 3488 # ADDITIONAL_IMAGE and ADDITIONAL_FLASH apply to FLASH_INPAGE creatives. 3489 # OTHER refers to assets from sources other than Campaign Manager, such as Studio uploaded assets, applicable to all RICH_MEDIA and all VPAID creatives. 3490 # PARENT_VIDEO refers to videos uploaded by the user in Campaign Manager and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives. 3491 # TRANSCODED_VIDEO refers to videos transcoded by Campaign Manager from PARENT_VIDEO assets and is applicable to INSTREAM_VIDEO and VPAID_LINEAR_VIDEO creatives. 3492 # ALTERNATE_VIDEO refers to the Campaign Manager representation of child asset videos from Studio, and is applicable to VPAID_LINEAR_VIDEO creatives. These cannot be added or removed within Campaign Manager. 3493 # For VPAID_LINEAR_VIDEO creatives, PARENT_VIDEO, TRANSCODED_VIDEO and ALTERNATE_VIDEO assets that are marked active serve as backup in case the VPAID creative cannot be served. Only PARENT_VIDEO assets can be added or removed for an INSTREAM_VIDEO or VPAID_LINEAR_VIDEO creative. 3494 # PARENT_AUDIO refers to audios uploaded by the user in Campaign Manager and is applicable to INSTREAM_AUDIO creatives. 3495 # TRANSCODED_AUDIO refers to audios transcoded by Campaign Manager from PARENT_AUDIO assets and is applicable to INSTREAM_AUDIO creatives. 3496 "size": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Size associated with this creative asset. This is a required field when applicable; however for IMAGE and FLASH_INPAGE, creatives if left blank, this field will be automatically set using the actual size of the associated image asset. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER, IMAGE, and all RICH_MEDIA. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 3497 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 3498 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 3499 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 3500 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 3501 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 3502 }, 3503 "bitRate": 42, # Detected bit-rate for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 3504 "windowMode": "A String", # Window mode options for flash assets. Applicable to the following creative types: FLASH_INPAGE, RICH_MEDIA_DISPLAY_EXPANDING, RICH_MEDIA_IM_EXPAND, RICH_MEDIA_DISPLAY_BANNER, and RICH_MEDIA_INPAGE_FLOATING. 3505 "pushdown": True or False, # Whether the asset pushes down other content. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable when the asset offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height. 3506 "progressiveServingUrl": "A String", # Progressive URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID. 3507 "durationType": "A String", # Duration type for which an asset will be displayed. Applicable to the following creative types: all RICH_MEDIA. 3508 "zIndex": 42, # zIndex value of an asset. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable to assets whose displayType is NOT one of the following types: ASSET_DISPLAY_TYPE_INPAGE or ASSET_DISPLAY_TYPE_OVERLAY. Acceptable values are -999999999 to 999999999, inclusive. 3509 "fileSize": "A String", # File size associated with this creative asset. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 3510 "zipFilename": "A String", # File name of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER. 3511 "offset": { # Offset Position. # Offset position for an asset in collapsed mode. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID. Additionally, only applicable to assets whose displayType is ASSET_DISPLAY_TYPE_EXPANDING or ASSET_DISPLAY_TYPE_PEEL_DOWN. 3512 "top": 42, # Offset distance from top side of an asset or a window. 3513 "left": 42, # Offset distance from left side of an asset or a window. 3514 }, 3515 "active": True or False, # Whether the video or audio asset is active. This is a read-only field for VPAID_NON_LINEAR_VIDEO assets. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 3516 "companionCreativeIds": [ # List of companion creatives assigned to an in-stream video creative asset. Acceptable values include IDs of existing flash and image creatives. Applicable to INSTREAM_VIDEO creative type with dynamicAssetSelection set to true. 3517 "A String", 3518 ], 3519 "hideSelectionBoxes": True or False, # Whether to hide selection boxes flag for an asset. Applicable to the following creative types: all RICH_MEDIA. 3520 "streamingServingUrl": "A String", # Streaming URL for video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_VIDEO and all VPAID. 3521 "zipFilesize": "A String", # Size of zip file. This is a read-only field. Applicable to the following creative types: HTML5_BANNER. 3522 "childAssetType": "A String", # Rich media child asset type. This is a read-only field. Applicable to the following creative types: all VPAID. 3523 "backupImageExit": { # Creative Custom Event. # Exit event configured for the backup image. Applicable to the following creative types: all RICH_MEDIA. 3524 "targetType": "A String", # Target type used by the event. 3525 "artworkType": "A String", # Artwork type used by the creative.This is a read-only field. 3526 "exitClickThroughUrl": { # Click-through URL # Exit click-through URL for the event. This field is used only for exit events. 3527 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 3528 # - If landingPageId is specified then that landing page's URL is assigned to this field. 3529 # - Otherwise, the customClickThroughUrl is assigned to this field. 3530 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 3531 "landingPageId": "A String", # ID of the landing page for the click-through URL. 3532 }, 3533 "videoReportingId": "A String", # Video reporting ID, used to differentiate multiple videos in a single creative. This is a read-only field. 3534 "popupWindowProperties": { # Popup Window Properties. # Properties for rich media popup windows. This field is used only for exit events. 3535 "showStatusBar": True or False, # Whether to display the browser status bar. 3536 "showScrollBar": True or False, # Whether to display the browser scroll bar. 3537 "showAddressBar": True or False, # Whether to display the browser address bar. 3538 "showMenuBar": True or False, # Whether to display the browser menu bar. 3539 "title": "A String", # Title of popup window. 3540 "showToolBar": True or False, # Whether to display the browser tool bar. 3541 "positionType": "A String", # Popup window position either centered or at specific coordinate. 3542 "offset": { # Offset Position. # Upper-left corner coordinates of the popup window. Applicable if positionType is COORDINATES. 3543 "top": 42, # Offset distance from top side of an asset or a window. 3544 "left": 42, # Offset distance from left side of an asset or a window. 3545 }, 3546 "dimension": { # Represents the dimensions of ads, placements, creatives, or creative assets. # Popup dimension for a creative. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA and all VPAID 3547 "width": 42, # Width of this size. Acceptable values are 0 to 32767, inclusive. 3548 "kind": "dfareporting#size", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#size". 3549 "iab": True or False, # IAB standard size. This is a read-only, auto-generated field. 3550 "id": "A String", # ID of this size. This is a read-only, auto-generated field. 3551 "height": 42, # Height of this size. Acceptable values are 0 to 32767, inclusive. 3552 }, 3553 }, 3554 "advertiserCustomEventId": "A String", # Unique ID of this event used by Reporting and Data Transfer. This is a read-only field. 3555 "artworkLabel": "A String", # Artwork label column, used to link events in Campaign Manager back to events in Studio. This is a required field and should not be modified after insertion. 3556 "advertiserCustomEventType": "A String", # Type of the event. This is a read-only field. 3557 "id": "A String", # ID of this event. This is a required field and should not be modified after insertion. 3558 "advertiserCustomEventName": "A String", # User-entered name for the event. 3559 }, 3560 "actionScript3": True or False, # Whether ActionScript3 is enabled for the flash asset. This is a read-only field. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 3561 "pushdownDuration": 3.14, # Pushdown duration in seconds for an asset. Applicable to the following creative types: all RICH_MEDIA.Additionally, only applicable when the asset pushdown field is true, the offsets are 0, the collapsedSize.width matches size.width, and the collapsedSize.height is less than size.height. Acceptable values are 0 to 9.99, inclusive. 3562 "assetIdentifier": { # Creative Asset ID. # Identifier of this asset. This is the same identifier returned during creative asset insert operation. This is a required field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 3563 "type": "A String", # Type of asset to upload. This is a required field. FLASH and IMAGE are no longer supported for new uploads. All image assets should use HTML_IMAGE. 3564 "name": "A String", # Name of the creative asset. This is a required field while inserting an asset. After insertion, this assetIdentifier is used to identify the uploaded asset. Characters in the name must be alphanumeric or one of the following: ".-_ ". Spaces are allowed. 3565 }, 3566 "transparency": True or False, # Whether the asset is transparent. Applicable to the following creative types: all RICH_MEDIA. Additionally, only applicable to HTML5 assets. 3567 "sslCompliant": True or False, # Whether the asset is SSL-compliant. This is a read-only field. Applicable to all but the following creative types: all REDIRECT and TRACKING_TEXT. 3568 "mediaDuration": 3.14, # Detected duration for audio or video asset. This is a read-only field. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and all VPAID. 3569 "customStartTimeValue": 42, # Custom start time in seconds for making the asset visible. Applicable to the following creative types: all RICH_MEDIA. Value must be greater than or equal to 0. 3570 }, 3571 ], 3572 "redirectUrl": "A String", # URL of hosted image or hosted video or another ad tag. For INSTREAM_VIDEO_REDIRECT creatives this is the in-stream video redirect URL. The standard for a VAST (Video Ad Serving Template) ad response allows for a redirect link to another VAST 2.0 or 3.0 call. This is a required field when applicable. Applicable to the following creative types: DISPLAY_REDIRECT, INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT, and INSTREAM_VIDEO_REDIRECT 3573 "autoAdvanceImages": True or False, # Whether images are automatically advanced for image gallery creatives. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY. 3574 "htmlCodeLocked": True or False, # Whether HTML code is generated by Campaign Manager or manually entered. Set to true to ignore changes to htmlCode. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. 3575 "convertFlashToHtml5": True or False, # Whether Flash assets associated with the creative need to be automatically converted to HTML5. This flag is enabled by default and users can choose to disable it if they don't want the system to generate and use HTML5 asset for this creative. Applicable to the following creative type: FLASH_INPAGE. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 3576 "clickTags": [ # Click tags of the creative. For DISPLAY, FLASH_INPAGE, and HTML5_BANNER creatives, this is a subset of detected click tags for the assets associated with this creative. After creating a flash asset, detected click tags will be returned in the creativeAssetMetadata. When inserting the creative, populate the creative clickTags field using the creativeAssetMetadata.clickTags field. For DISPLAY_IMAGE_GALLERY creatives, there should be exactly one entry in this list for each image creative asset. A click tag is matched with a corresponding creative asset by matching the clickTag.name field with the creativeAsset.assetIdentifier.name field. Applicable to the following creative types: DISPLAY_IMAGE_GALLERY, FLASH_INPAGE, HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 3577 { # Creative Click Tag. 3578 "eventName": "A String", # Advertiser event name associated with the click tag. This field is used by DISPLAY_IMAGE_GALLERY and HTML5_BANNER creatives. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 3579 "clickThroughUrl": { # Click-through URL # Parameter value for the specified click tag. This field contains a click-through url. 3580 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 3581 # - If landingPageId is specified then that landing page's URL is assigned to this field. 3582 # - Otherwise, the customClickThroughUrl is assigned to this field. 3583 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 3584 "landingPageId": "A String", # ID of the landing page for the click-through URL. 3585 }, 3586 "name": "A String", # Parameter name for the specified click tag. For DISPLAY_IMAGE_GALLERY creative assets, this field must match the value of the creative asset's creativeAssetId.name field. 3587 }, 3588 ], 3589 "commercialId": "A String", # Industry standard ID assigned to creative for reach and frequency. Applicable to INSTREAM_VIDEO_REDIRECT creatives. 3590 "active": True or False, # Whether the creative is active. Applicable to all creative types. 3591 "compatibility": [ # Compatibilities associated with this creative. This is a read-only field. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering either on desktop or on mobile devices or in mobile apps for regular or interstitial ads, respectively. APP and APP_INTERSTITIAL are for rendering in mobile apps. Only pre-existing creatives may have these compatibilities since new creatives will either be assigned DISPLAY or DISPLAY_INTERSTITIAL instead. IN_STREAM_VIDEO refers to rendering in in-stream video ads developed with the VAST standard. IN_STREAM_AUDIO refers to rendering in in-stream audio ads developed with the VAST standard. Applicable to all creative types. 3592 # 3593 # Acceptable values are: 3594 # - "APP" 3595 # - "APP_INTERSTITIAL" 3596 # - "IN_STREAM_VIDEO" 3597 # - "IN_STREAM_AUDIO" 3598 # - "DISPLAY" 3599 # - "DISPLAY_INTERSTITIAL" 3600 "A String", 3601 ], 3602 "universalAdId": { # A Universal Ad ID as per the VAST 4.0 spec. Applicable to the following creative types: INSTREAM_AUDIO, INSTREAM_VIDEO and VPAID. # A Universal Ad ID as per the VAST 4.0 spec. Applicable to the following creative types: INSTREAM_AUDIO and INSTREAM_VIDEO and VPAID. 3603 "registry": "A String", # Registry used for the Ad ID value. 3604 "value": "A String", # ID value for this creative. Only alphanumeric characters and the following symbols are valid: "_/\-". Maximum length is 64 characters. Read only when registry is DCM. 3605 }, 3606 "adParameters": "A String", # Ad parameters user for VPAID creative. This is a read-only field. Applicable to the following creative types: all VPAID. 3607 "adTagKeys": [ # Keywords for a Rich Media creative. Keywords let you customize the creative settings of a Rich Media ad running on your site without having to contact the advertiser. You can use keywords to dynamically change the look or functionality of a creative. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 3608 "A String", 3609 ], 3610 "kind": "dfareporting#creative", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#creative". 3611 "subaccountId": "A String", # Subaccount ID of this creative. This field, if left unset, will be auto-generated for both insert and update operations. Applicable to all creative types. 3612 "name": "A String", # Name of the creative. This is a required field and must be less than 256 characters long. Applicable to all creative types. 3613 "sslOverride": True or False, # Whether creative should be treated as SSL compliant even if the system scan shows it's not. Applicable to all creative types. 3614 "lastModifiedInfo": { # Modification timestamp. # Creative last modification information. This is a read-only field. Applicable to all creative types. 3615 "time": "A String", # Timestamp of the last change in milliseconds since epoch. 3616 }, 3617 "backupImageClickThroughUrl": { # Click-through URL # Click-through URL for backup image. Applicable to ENHANCED_BANNER when the primary asset type is not HTML_IMAGE. 3618 "computedClickThroughUrl": "A String", # Read-only convenience field representing the actual URL that will be used for this click-through. The URL is computed as follows: 3619 # - If landingPageId is specified then that landing page's URL is assigned to this field. 3620 # - Otherwise, the customClickThroughUrl is assigned to this field. 3621 "customClickThroughUrl": "A String", # Custom click-through URL. Applicable if the landingPageId field is left unset. 3622 "landingPageId": "A String", # ID of the landing page for the click-through URL. 3623 }, 3624 "sslCompliant": True or False, # Whether the creative is SSL-compliant. This is a read-only field. Applicable to all creative types. 3625 "studioCreativeId": "A String", # Studio creative ID associated with rich media and VPAID creatives. This is a read-only field. Applicable to the following creative types: all RICH_MEDIA, and all VPAID. 3626 "authoringTool": "A String", # Authoring tool for HTML5 banner creatives. This is a read-only field. Applicable to the following creative types: HTML5_BANNER. 3627 "allowScriptAccess": True or False, # Whether script access is allowed for this creative. This is a read-only and deprecated field which will automatically be set to true on update. Applicable to the following creative types: FLASH_INPAGE. 3628 "companionCreatives": [ # List of companion creatives assigned to an in-Stream video creative. Acceptable values include IDs of existing flash and image creatives. Applicable to the following creative types: all VPAID, all INSTREAM_AUDIO and all INSTREAM_VIDEO with dynamicAssetSelection set to false. 3629 "A String", 3630 ], 3631 "creativeAssetSelection": { # Encapsulates the list of rules for asset selection and a default asset in case none of the rules match. Applicable to INSTREAM_VIDEO creatives. # Required if dynamicAssetSelection is true. 3632 "rules": [ # Rules determine which asset will be served to a viewer. Rules will be evaluated in the order in which they are stored in this list. This list must contain at least one rule. Applicable to INSTREAM_VIDEO creatives. 3633 { # A rule associates an asset with a targeting template for asset-level targeting. Applicable to INSTREAM_VIDEO creatives. 3634 "assetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative. This is a required field. 3635 "targetingTemplateId": "A String", # A targeting template ID. The targeting from the targeting template will be used to determine whether this asset should be served. This is a required field. 3636 "name": "A String", # A user-friendly name for this rule. This is a required field. 3637 }, 3638 ], 3639 "defaultAssetId": "A String", # A creativeAssets[].id. This should refer to one of the parent assets in this creative, and will be served if none of the rules match. This is a required field. 3640 }, 3641 "htmlCode": "A String", # HTML code for the creative. This is a required field when applicable. This field is ignored if htmlCodeLocked is true. Applicable to the following creative types: all CUSTOM, FLASH_INPAGE, and HTML5_BANNER, and all RICH_MEDIA. 3642 "backupImageFeatures": [ # List of feature dependencies that will cause a backup image to be served if the browser that serves the ad does not support them. Feature dependencies are features that a browser must be able to support in order to render your HTML5 creative asset correctly. This field is initially auto-generated to contain all features detected by Campaign Manager for all the assets of this creative and can then be modified by the client. To reset this field, copy over all the creativeAssets' detected features. Applicable to the following creative types: HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 3643 "A String", 3644 ], 3645 "backupImageTargetWindow": { # Target Window. # Target window for backup image. Applicable to the following creative types: FLASH_INPAGE and HTML5_BANNER. Applicable to DISPLAY when the primary asset type is not HTML_IMAGE. 3646 "customHtml": "A String", # User-entered value. 3647 "targetWindowOption": "A String", # Type of browser window for which the backup image of the flash creative can be displayed. 3648 }, 3649 "mediaDescription": "A String", # Description of the audio or video ad. Applicable to the following creative types: all INSTREAM_VIDEO, INSTREAM_AUDIO, and all VPAID. 3650 "skippable": True or False, # Whether the user can choose to skip the creative. Applicable to the following creative types: all INSTREAM_VIDEO and all VPAID. 3651 }</pre> 3652</div> 3653 3654</body></html>