get

Returns the parameters of creatives that match the specified criteria.

  1. Restrictions
  2. Request
  3. Response

Restrictions

The method returns a maximum of 10,000 objects.

Request

Request structure in JSON format:

{
  "method": "get",
  "params": {
    "SelectionCriteria": { /* CreativesSelectionCriteria */ 
      "Ids": [(long), ... ],
      "Types": [( "IMAGE_CREATIVE" | "HTML5_CREATIVE" | "VIDEO_EXTENSION_CREATIVE" | "CPC_VIDEO_CREATIVE" | "CPM_VIDEO_CREATIVE" | "SMART_CREATIVE" ), ... ]
    }, /* required */
    "FieldNames": [( "Id" | "Type" | "Name" | "PreviewUrl" | "Width" | "Height" | "ThumbnailUrl" | "Associated" | "IsAdaptive" ), ... ], /* required */ 
    "VideoExtensionCreativeFieldNames": [( "Duration" ), ... ],
    "CpcVideoCreativeFieldNames": [( "Duration" ), ... ],
    "CpmVideoCreativeFieldNames": [( "Duration" ), ... ],
    "SmartCreativeFieldNames" : [( "CreativeGroupId" | "CreativeGroupName" | "BusinessType" ), ... ],
    "Page": {  /* LimitOffset */
      "Limit": (long),
      "Offset": (long)
    }
  }
}

Parameters are described below.

Parameter Type Description Required
Params structure (for JSON) / GetRequest (for SOAP)
SelectionCriteria CreativesSelectionCriteria

Criteria for selecting creatives.

To get all of an advertiser's creatives, leave SelectionCriteria empty.

Yes
FieldNames array of AdFieldEnum

Names of top-level parameters to get.

Yes
VideoExtensionCreativeFieldNames array of VideoExtensionCreativeFieldNames The names of the parameters for video extension creatives to get. See Type of creative.
Note. If a different type of creative was selected using SelectionCriteria, parameters from VideoExtensionCreativeFieldNames are not returned.
No
CpcVideoCreativeFieldNames array of CpcVideoCreativeFieldEnum Names of parameters to get for video ad creatives in “Text & Image Ads” campaigns.
Note. If a different type of creative was selected using SelectionCriteria, parameters from CpcVideoCreativeFieldNames are not returned.
No
CpmVideoCreativeFieldNames array of CpmVideoCreativeFieldEnum Names of the parameters to get for video ad creatives in “Display campaigns”.
Note. If a different type of creative was selected using SelectionCriteria, parameters from CpmVideoCreativeFieldNames are not returned.
No
SmartCreativeFieldNames array of SmartCreativeFieldEnum The names of parameters for smart banner creatives to get.
Note. If a different type of creative was selected using SelectionCriteria, parameters from SmartCreativeCreativeFieldNames are not returned.
No
Page LimitOffset

Structure that defines the page for paginated selection of data.

No
CreativesSelectionCriteria structure
Ids array of long Selects creatives with the specified IDs. From 1 to 10,000 items in the array. No
Types array of CreativeTypeEnum

Selects creatives of the specified types. See Type of creative.

No
Parameter Type Description Required
Params structure (for JSON) / GetRequest (for SOAP)
SelectionCriteria CreativesSelectionCriteria

Criteria for selecting creatives.

To get all of an advertiser's creatives, leave SelectionCriteria empty.

Yes
FieldNames array of AdFieldEnum

Names of top-level parameters to get.

Yes
VideoExtensionCreativeFieldNames array of VideoExtensionCreativeFieldNames The names of the parameters for video extension creatives to get. See Type of creative.
Note. If a different type of creative was selected using SelectionCriteria, parameters from VideoExtensionCreativeFieldNames are not returned.
No
CpcVideoCreativeFieldNames array of CpcVideoCreativeFieldEnum Names of parameters to get for video ad creatives in “Text & Image Ads” campaigns.
Note. If a different type of creative was selected using SelectionCriteria, parameters from CpcVideoCreativeFieldNames are not returned.
No
CpmVideoCreativeFieldNames array of CpmVideoCreativeFieldEnum Names of the parameters to get for video ad creatives in “Display campaigns”.
Note. If a different type of creative was selected using SelectionCriteria, parameters from CpmVideoCreativeFieldNames are not returned.
No
SmartCreativeFieldNames array of SmartCreativeFieldEnum The names of parameters for smart banner creatives to get.
Note. If a different type of creative was selected using SelectionCriteria, parameters from SmartCreativeCreativeFieldNames are not returned.
No
Page LimitOffset

Structure that defines the page for paginated selection of data.

No
CreativesSelectionCriteria structure
Ids array of long Selects creatives with the specified IDs. From 1 to 10,000 items in the array. No
Types array of CreativeTypeEnum

Selects creatives of the specified types. See Type of creative.

No

Response

Response structure in JSON format:

{
  "result": { /* result */
    "Creatives": [{  /* CreativeGetItem */
      "Id": (long),
      "Type": ( "IMAGE_CREATIVE" | "HTML5_CREATIVE" | "VIDEO_EXTENSION_CREATIVE" | "CPC_VIDEO_CREATIVE" | "CPM_VIDEO_CREATIVE" | "SMART_CREATIVE" ),
      "Name": (string),
      "PreviewUrl": (string),
      "Width": (int),
      "Height": (int),
      "ThumbnailUrl": (string),
      "Associated": ( "YES" | "NO" ),
      "IsAdaptive": ( "YES" | "NO" ),
      "VideoExtensionCreative": {  /* VideoExtensionCreativeGet */
        "Duration": (int) /* required */
      },
      "CpcVideoCreative": {  /* CpcVideoCreativeGet */
        "Duration": (int) /* required */
      },
      "CpmVideoCreative": {  /* CpmVideoCreativeGet */
        "Duration": (int) /* required */
      },
      "SmartCreative" : {  /* SmartCreativeGet */
        "CreativeGroupId" : (long),
        "CreativeGroupName" : (string),
        "BusinessType" : ( "RETAIL" | "HOTELS" | "REALTY" | "AUTOMOBILES" | "FLIGHTS" | "CLOTHES" | "OTHER" )
      }
    }, ... ],
    "LimitedBy": (long)
  }
}

Parameters are described below.

Parameter Type Description
Result structure (for JSON) / GetResponse (for SOAP)
Creatives array of CreativeGetItem Creatives.
LimitedBy long Sequential number of the last object returned. It is included if there was a limit on the number of objects in the response. See the section Paginated data selection.
CreativeGetItem structure
Id long ID of the creative.
Type CreativeTypeEnum Type of creative. See Type of creative.
Name string Name of the video creative or group of image creatives.
PreviewUrl string Link for previewing.
Width int Width of the creative.
Height int Height of the creative.
ThumbnailUrl string URL for the preview thumbnail.
Associated YesNoEnum Whether the creative is assigned to at least one of the client's ads.
IsAdaptive YesNoEnum Whether the creative is adaptive.
VideoExtensionCreative VideoExtensionCreativeGet Parameters of the video extension creative.
CpcVideoCreative CpcVideoCreativeGet Parameters for video ad creatives in “Text & Image Ads” campaigns.
CpmVideoCreative CpmVideoCreativeGet Parameters of a video ad creative in “Display campaigns”.
SmartCreative SmartCreativeGet Parameters of a smart banner creative (in “Smart banners” campaigns).
VideoExtensionCreativeGet structure
Duration int The length of the video in seconds.
CpcVideoCreativeGet structure
Duration int The length of the video in seconds.
CpmVideoCreativeGet structure
Duration int The length of the video in seconds.
SmartCreativeGet structure
CreativeGroupId long ID of the group of creatives.
CreativeGroupName string Name of the group of creatives.
BusinessType BusinessTypeEnum The subject of the creative, which matches the type of business feed.
Parameter Type Description
Result structure (for JSON) / GetResponse (for SOAP)
Creatives array of CreativeGetItem Creatives.
LimitedBy long Sequential number of the last object returned. It is included if there was a limit on the number of objects in the response. See the section Paginated data selection.
CreativeGetItem structure
Id long ID of the creative.
Type CreativeTypeEnum Type of creative. See Type of creative.
Name string Name of the video creative or group of image creatives.
PreviewUrl string Link for previewing.
Width int Width of the creative.
Height int Height of the creative.
ThumbnailUrl string URL for the preview thumbnail.
Associated YesNoEnum Whether the creative is assigned to at least one of the client's ads.
IsAdaptive YesNoEnum Whether the creative is adaptive.
VideoExtensionCreative VideoExtensionCreativeGet Parameters of the video extension creative.
CpcVideoCreative CpcVideoCreativeGet Parameters for video ad creatives in “Text & Image Ads” campaigns.
CpmVideoCreative CpmVideoCreativeGet Parameters of a video ad creative in “Display campaigns”.
SmartCreative SmartCreativeGet Parameters of a smart banner creative (in “Smart banners” campaigns).
VideoExtensionCreativeGet structure
Duration int The length of the video in seconds.
CpcVideoCreativeGet structure
Duration int The length of the video in seconds.
CpmVideoCreativeGet structure
Duration int The length of the video in seconds.
SmartCreativeGet structure
CreativeGroupId long ID of the group of creatives.
CreativeGroupName string Name of the group of creatives.
BusinessType BusinessTypeEnum The subject of the creative, which matches the type of business feed.