Ads · Ad Campaigns

Create a Performance Max asset group

Creates a Performance Max asset group. Works with Google Ads.

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

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+$

Request body

application/json, required

  • namestringrequired

    1 to 128 characters.

  • finalUrlsarray of string (URL)required

    At least 1 item. Up to 10 items.

  • finalMobileUrlsarray of string (URL)

    At least 1 item. Up to 10 items.

  • path1string

    Up to 15 characters.

  • path2string

    Up to 15 characters.

  • statusstring

    One of ENABLED, PAUSED. Default PAUSED.

  • assetsarray of object

    Up to 100 items.

    • fieldTypestringrequired
    • assetstring
    • textstring

      Up to 90 characters.

    • imageUrlstring (URL)
    • youtubeVideoIdstring

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

  • listingGroupFilterobject
    • childrenarray of object

      At least 2 items.

      3 child fields
      • dimensionobjectrequired
        7 child fields
        • productBrandobject
          1 child field
          • valuestring
        • productCategoryobject
          2 child fields
          • categoryIdstring
          • levelstringrequired

            One of LEVEL1, LEVEL2, LEVEL3, LEVEL4, LEVEL5.

        • productTypeobject
          2 child fields
          • valuestring
          • levelstringrequired

            One of LEVEL1, LEVEL2, LEVEL3, LEVEL4, LEVEL5.

        • productItemIdobject
          1 child field
          • valuestring
        • productConditionobject
          1 child field
          • conditionstring

            One of NEW, REFURBISHED, USED.

        • productChannelobject
          1 child field
          • channelstring

            One of ONLINE, LOCAL.

        • productCustomAttributeobject
          2 child fields
          • valuestring
          • indexstringrequired

            One of INDEX0, INDEX1, INDEX2, INDEX3, INDEX4.

      • excludedboolean
      • childrenarray of object

        At least 2 items.

  • validateOnlyboolean

    Default false.

Example

curl -X POST "https://api.pozy.ai/v1/ads/campaigns/65a3737dd8b11ea61f199e6e/asset-groups" \
  -H "Authorization: Bearer $POZY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Acme",
  "finalUrls": [
    "https://pozy.ai/media/example-1.jpg"
  ]
}'

Response

200 on success

  • validateOnlyboolean
  • messagestring
200 response
{
  "validateOnly": true,
  "message": "Hello from Pozy"
}

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 groupsGETGet a Performance Max asset groupPATCHUpdate a Performance Max asset groupDELRemove a Performance Max asset groupPOSTLink or unlink asset group assetsPUTReplace an asset group's listing-group treePOSTCreate standalone adGETGet campaign conversion goalsPATCHUpdate campaign conversion goals