Ads · Ad Campaigns

Link or unlink asset group assets

Links or unlinks asset group assets. Works with Google Ads.

POSThttps://api.pozy.ai/v1/ads/campaigns/{campaignId}/asset-groups/{assetGroupId}/assets
Google WorkspaceeditGoogleAssetGroupAssets

Guide: Google Ads

Request

Send your API key as Authorization: Bearer pz_live_.... Read-only keys cannot call it. Keys with the ads resource group disabled get 403 resource_group_disabled. Authentication

Path parameters

NameTypeNotes
campaignIdrequiredstringMatches ^\d+$
assetGroupIdrequiredstringMatches ^\d+$

Request body

application/json, required

  • linkarray of object

    Up to 100 items.

    • fieldTypestringrequired
    • assetstring
    • textstring

      Up to 90 characters.

    • imageUrlstring (URL)
    • youtubeVideoIdstring

      Matches ^[A-Za-z0-9_-]{11}$.

  • unlinkarray of object

    Up to 100 items.

    • fieldTypestringrequired
    • assetstringrequired
  • validateOnlyboolean

    Default false.

Example

curl -X POST "https://api.pozy.ai/v1/ads/campaigns/65a3737dd8b11ea61f199e6e/asset-groups/65c774748dcac8ef3c031319/assets" \
  -H "Authorization: Bearer $POZY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "link": [
    {
      "fieldType": "string"
    }
  ],
  "unlink": [
    {
      "fieldType": "string",
      "asset": "string"
    }
  ],
  "validateOnly": false
}'

Response

200 on success

  • assetGroupIdstring
  • linkedinteger
  • unlinkedinteger
  • validateOnlyboolean
200 response
{
  "assetGroupId": "65c774748dcac8ef3c031319",
  "linked": 1,
  "unlinked": 1,
  "validateOnly": true
}

Errors

Errors use one shape: { error, type, code, param?, details? }. The ones you are most likely to see here:

400invalid_request_errorA parameter or body field is missing or invalid. param names it.
401authentication_errorThe API key is missing, revoked or expired.
403permission_errorThe key is read-only, scoped to other profiles, or has this resource group disabled.
404not_foundNothing with that id exists in your workspace.
429rate_limit_errorToo many requests this minute. Wait for Retry-After seconds.

Every code is listed in Errors.

More in Ad Campaigns

GETList adsGETList Google Ads recommendationsPOSTApply Google Ads recommendationsPOSTDismiss Google Ads recommendationsGETList portfolio bid strategiesPOSTCreate portfolio bid strategyPATCHUpdate portfolio bid strategyGETList shared budgetsPOSTCreate a shared budgetGETList Search keywordsPOSTAdd Search ad-group keywordsPATCHPause or enable a Search keywordDELRemove a Search keywordGETList campaignsPOSTCreate a standalone campaignPUTPause or resume a campaignGETRead a campaign's ad schedule (dayparting)PUTReplace a campaign's ad schedule (dayparting)GETRead a campaign's current biddingGETGet live campaign detailsPUTUpdate a campaignDELDelete a campaignGETList campaign-level negative keywordsPUTReplace campaign-level negative keywordsPOSTPause or resume many campaignsPOSTDuplicate a campaignGETRead a Google campaign's device, location, excluded location, and language targetingPUTEdit a Google campaign's device, location, excluded location, or language targetingGETList ad setsPOSTCreate a standalone ad groupPOSTDuplicate an ad setPOSTDuplicate an adGETGet live ad-set detailsPUTUpdate an ad setDELDelete an ad setGETRead a Reddit ad group's targeting and schedulePUTPause or resume a single ad setGETGet campaign treeGETGet daily account metricsGETGet ad detailsPUTUpdate adDELCancel an adPUTPause or resume a single adGETList campaign assetsPOSTAttach campaign assetsPUTUpdate campaign assetsDELRemove campaign assetsGETList ad-group assetsPOSTAttach ad-group assetsPUTUpdate ad-group assetsDELRemove ad-group assetsGETRead the platform's review verdict for an adGETReview status of each creative in a TikTok Smart+ adGETList ads that need attentionPOSTDismiss an ads alertGETReview status of every TikTok Smart+ ad of an advertiserGETList campaign negative listsPUTReplace campaign negative listsPOSTBoost post as adGETList Performance Max asset groupsPOSTCreate a Performance Max asset groupGETGet a Performance Max asset groupPATCHUpdate a Performance Max asset groupDELRemove a Performance Max asset groupPUTReplace an asset group's listing-group treePOSTCreate standalone adGETGet campaign conversion goalsPATCHUpdate campaign conversion goals