Sign in
ads
creative

Update a creative

put/ads/{connection_id}/creative/{id}

Path parameters

connection_idstring required

ID of the connection

idstring required

ID of the Creative

Query parameters

fieldsstring[]

Fields to return

rawstring

Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar

Request body

idstring
created_atstring date-time
updated_atstring date-time
namestring
campaign_idstring
group_idstring
item_idstring
organization_idstring
status'UNSPECIFIED' | 'ACTIVE' | 'PAUSED' | 'ARCHIVED' | 'DRAFT' | 'SCHEDULED_FOR_DELETION' | 'PROCESSING' | 'PROCESSING_FAILED'
creative_type'UNSPECIFIED' | 'STANDARD' | 'EXPANDABLE' | 'VIDEO' | 'NATIVE' | 'AUDIO' | 'PUBLISHER_HOSTED' | 'ASSET_BASED' | 'IMAGE' | 'DOCUMENT' | 'SHARE'
hosting_source'UNSPECIFIED' | 'CM' | 'THIRD_PARTY' | 'HOSTED' | 'RICH_MEDIA' | 'PUBLISHER_HOSTED'
widthnumber
heightnumber
asset_urlsstring[]

Hosted asset mode (best-effort, provider-specific

link_urlstring
url_tagsstring
bodystring
titlestring
ctastring
third_party_tagstring
vast_tag_urlstring
external_creative_referencestring
external_placement_referencestring
external_ad_referencestring
path1string
path2string
datastring
labelsstring[]
rawobject

Response

Successful

idstring
created_atstring date-time
updated_atstring date-time
namestring
campaign_idstring
group_idstring
item_idstring
organization_idstring
status'UNSPECIFIED' | 'ACTIVE' | 'PAUSED' | 'ARCHIVED' | 'DRAFT' | 'SCHEDULED_FOR_DELETION' | 'PROCESSING' | 'PROCESSING_FAILED'
creative_type'UNSPECIFIED' | 'STANDARD' | 'EXPANDABLE' | 'VIDEO' | 'NATIVE' | 'AUDIO' | 'PUBLISHER_HOSTED' | 'ASSET_BASED' | 'IMAGE' | 'DOCUMENT' | 'SHARE'
hosting_source'UNSPECIFIED' | 'CM' | 'THIRD_PARTY' | 'HOSTED' | 'RICH_MEDIA' | 'PUBLISHER_HOSTED'
widthnumber
heightnumber
asset_urlsstring[]

Hosted asset mode (best-effort, provider-specific

link_urlstring
url_tagsstring
bodystring
titlestring
ctastring
third_party_tagstring
vast_tag_urlstring
external_creative_referencestring
external_placement_referencestring
external_ad_referencestring
path1string
path2string
datastring
labelsstring[]
rawobject

Changes

Changed in 2 of the 25 revisions of this API.17

  • 6c78736a6d4211See the full diff
    • ●

      added the new SHARE enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      added the new SHARE enum value to the request property

      request-property-enum-value-added

  • 1f72720916e46See the full diff
    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the enum value labels to the property items/ of the query request parameter fields

      request-parameter-property-enum-value-added

    • ○

      added the enum value url_tags to the property items/ of the query request parameter fields

      request-parameter-property-enum-value-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added