ZEzernio
Ad Accounts

Attach a Google Ads label

Changed on

Attaches a Google Ads label to campaigns, ad groups, ads and keywords in one call, skipping any that already have it.

The label goes to campaigns, ad groups, ads and keywords (Google CampaignLabel, AdGroupLabel, AdGroupAdLabel and AdGroupCriterionLabel) in one mutate.

Idempotent: a target that already carries the label is counted in unchanged instead of failing the call.

Ids

All ids are Google's own. Ads and keywords use the composite id Google puts in their resource names:

  • Ads: {adGroupId}~{adId}
  • Keywords: {adGroupId}~{criterionId} (the tail of resourceName on GET /v1/ads/keywords)
post/v1/ads/labels/{labelId}/assignments

Request

Path parameters

labelIdstring required

Google label id

Request body

accountIdstring required

Zernio SocialAccount id (Google Ads)

adAccountIdstring

Google customer id. Required when the connection has multiple customers.

customerIdstring

Alias of adAccountId

campaignIdsstring[]

Google campaign ids

adSetIdsstring[]

Google ad group ids

adIdsstring[]

Google ad group ad ids, {adGroupId}~{adId}

keywordIdsstring[]

Google keyword criterion ids, {adGroupId}~{criterionId}

Response

Label attached

customerIdstring
labelIdstring
attachedinteger

Links created by this call

unchangedinteger

Targets that already carried the label

Changes

  • d568bb00ed73Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 450ec6ec5b0eRevision changes
    • info

      added the non-success response with the status