GOgoogle
dynamicTargetingKeys

POST /userprofiles/{userprofilesId}/dynamicTargetingKeys

Inserts a new dynamic targeting key. Keys must be created at the advertiser level before being assigned to the advertiser's ads, creatives, or placements. There is a maximum of 1000 keys per advertiser, out of which a maximum of 20 keys can be assigned per ad, creative, or placement.

Request

  • Base URL
    https://dfareporting.googleapis.com/dfareporting/v5
  • Auth
    OAuth 2 and OAuth 2
    Implicithttps://accounts.google.com/o/oauth2/auth
    Scopeshttps://www.googleapis.com/auth/dfatrafficking
    Authorization codehttps://accounts.google.com/o/oauth2/auth
    Token URLhttps://accounts.google.com/o/oauth2/token
    Scopeshttps://www.googleapis.com/auth/dfatrafficking
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Path parameters

userprofilesIdstring required

Request body

kindstring

Identifies what kind of resource this is. Value: the fixed string "dfareporting#dynamicTargetingKey".

namestring

Name of this dynamic targeting key. This is a required field. Must be less than 256 characters long and cannot contain commas. All characters are converted to lowercase.

objectIdstring int64

ID of the object of this dynamic targeting key. This is a required field.

objectType'OBJECT_ADVERTISER' | 'OBJECT_AD' | 'OBJECT_CREATIVE' | 'OBJECT_PLACEMENT'

Type of the object of this dynamic targeting key. This is a required field.

Response

Successful response

kindstring

Identifies what kind of resource this is. Value: the fixed string "dfareporting#dynamicTargetingKey".

namestring

Name of this dynamic targeting key. This is a required field. Must be less than 256 characters long and cannot contain commas. All characters are converted to lowercase.

objectIdstring int64

ID of the object of this dynamic targeting key. This is a required field.

objectType'OBJECT_ADVERTISER' | 'OBJECT_AD' | 'OBJECT_CREATIVE' | 'OBJECT_PLACEMENT'

Type of the object of this dynamic targeting key. This is a required field.

Changes

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