ad-assets

Attach an asset to an ad

Attaches an asset to an ad (scope: AD) or to an ad group (scope: AD_GROUP) in a role such as MARKETING_IMAGE or VIDEO. Changes reach the ad platforms on the next sync.

Errors

  • 400 VALIDATION_ERROR: the body failed validation; details.issues[] names each field.
post/api/v1/ad-assets

Request

  • Base URL: https://api.growomat.com
  • URL: https://api.growomat.com/api/v1/ad-assets
  • Auth: HTTP bearer

Headers

X-Space-Idstring

The Space to work in, for example spc_8f3aK2. Omit it to use your personal Space. List your Spaces returns the ids. A Space that does not exist returns 404 SPACE_NOT_FOUND; one you are not a member of returns 403 NOT_A_MEMBER.

Request body

scope'AD' | 'AD_GROUP' required

Whether the asset attaches to one ad or to the whole ad group.

adIdstring

The ad. Required when scope is AD.

adGroupIdstring

The ad group. Required when scope is AD_GROUP.

campaignIdstring

The campaign. Optional; derived from the ad or ad group when omitted.

assetIdstring required

The asset.

role'MARKETING_IMAGE' | 'SQUARE_MARKETING_IMAGE' | 'PORTRAIT_MARKETING_IMAGE' | 'LOGO' | 'LANDSCAPE_LOGO' | 'YOUTUBE_VIDEO' | 'VIDEO' required

What the asset is used as.

Response

OK. The result is in data. List responses also carry meta with nextCursor and total.

dataunknown required

Changes

No recorded changes to this operation across all 2 revisions of this API.