Method: placements.generatetags
Stay organized with collections
Save and categorize content based on your preferences.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-09-02 UTC.
[null,null,["Last updated 2025-09-02 UTC."],[],[],null,["- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.PlacementsGenerateTagsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [PlacementTag](#PlacementTag)\n - [JSON representation](#PlacementTag.SCHEMA_REPRESENTATION)\n- [TagData](#TagData)\n - [JSON representation](#TagData.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nGenerates tags for a placement.\n\nHTTP request\n\n`POST https://dfareporting.googleapis.com/dfareporting/v5/userprofiles/{profileId}/placements/generatetags`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\nPath parameters\n\n| Parameters ||\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------|\n| `profileId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` User profile ID associated with this request. |\n\nQuery parameters\n\n| Parameters ||\n|------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `body` | `object` Empty body |\n| `placementIds[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Generate tags for these placements. |\n| `campaignId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Generate placements belonging to this campaign. This is a required field. |\n| `tagFormats[]` | `enum (`[PlacementTagFormat](/doubleclick-advertisers/rest/v5/placements#PlacementTagFormat)`)` Tag formats to generate for these placements. **Note:** `PLACEMENT_TAG_STANDARD` can only be generated for 1x1 placements. |\n\nRequest body\n\nThe request body must be empty.\n\nResponse body Placement GenerateTags Response\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"placementTags\": [ { object (/doubleclick-advertisers/rest/v5/placements/generatetags#PlacementTag) } ], \"kind\": string } ``` |\n\n| Fields ||\n|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `placementTags[]` | `object (`[PlacementTag](/doubleclick-advertisers/rest/v5/placements/generatetags#PlacementTag)`)` Set of generated tags for the specified placements. |\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string `\"dfareporting#placementsGenerateTagsResponse\"` . |\n\nAuthorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/dfatrafficking`\n\nPlacementTag Placement Tag\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"placementId\": string, \"tagDatas\": [ { object (/doubleclick-advertisers/rest/v5/placements/generatetags#TagData) } ] } ``` |\n\n| Fields ||\n|---------------|-----------------------------------------------------------------------------------------------------------------------------|\n| `placementId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Placement ID |\n| `tagDatas[]` | `object (`[TagData](/doubleclick-advertisers/rest/v5/placements/generatetags#TagData)`)` Tags generated for this placement. |\n\nTagData Placement Tag Data\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"format\": enum (/doubleclick-advertisers/rest/v5/placements#PlacementTagFormat), \"impressionTag\": string, \"clickTag\": string, \"adId\": string, \"creativeId\": string } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `format` | `enum (`[PlacementTagFormat](/doubleclick-advertisers/rest/v5/placements#PlacementTagFormat)`)` TagData tag format of this tag. |\n| `impressionTag` | `string` Tag string for serving an ad. |\n| `clickTag` | `string` Tag string to record a click. |\n| `adId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Ad associated with this placement tag. Applicable only when `format` is `PLACEMENT_TAG_TRACKING` . |\n| `creativeId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Creative associated with this placement tag. Applicable only when `format` is `PLACEMENT_TAG_TRACKING` . |"]]