ads
asset

List all assets

Changed on
get/ads/{connection_id}/asset

Request

  • Base URL: https://api.unified.to
  • URL: https://api.unified.to/ads/{connection_id}/asset
  • Auth: API key in header authorization

Path parameters

connection_idstring required

ID of the connection

Query parameters

limitnumber
offsetnumber
updated_gtestring

Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

sortstring
orderstring
querystring

Query string to search. eg. email address or name

org_idstring

The org ID to filter by (reference to AdsOrganization)

typestring
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

Response

Successful

idstring

provider asset resource name/id (e.g. Google Ads customers/{cid}/assets/{id}, TikTok image/video id, DV360 mediaId)

created_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

updated_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

organization_idstring
namestring
type'IMAGE' | 'VIDEO' | 'YOUTUBE_VIDEO' | 'MEDIA_BUNDLE' | 'TEXT'
urlstring

outbound: public asset URL; inbound (create): source URL to fetch bytes from when content is not supplied

contentstring

inbound create-only: base64-encoded image/media bytes to upload

mime_typestring
widthnumber
heightnumber
file_sizenumber
rawobject

Changes

  • 39502239a975Revision changes
    • info

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

    • info

      added the optional property / to the response with the status

  • a29ffd62ac71Revision changes
    • breaking

      the response's body type changed from no type to array for status