Version Headers: list

Lists all Container Versions of a GTM Container. Try it now.

Request

HTTP request

GET https://www.googleapis.com/tagmanager/v2/+parent/version_headers

Parameters

Parameter name	Value	Description
Path parameters
`parent`	`string`	GTM Container's API relative path. Example: accounts/{account_id}/containers/{container_id}
Optional query parameters
`includeDeleted`	`boolean`	Also retrieve deleted (archived) versions when true.
`pageToken`	`string`	Continuation token for fetching the next page of results.

Authorization

This request requires authorization with at least one of the following scopes:

Scope
`https://www.googleapis.com/auth/tagmanager.readonly`
`https://www.googleapis.com/auth/tagmanager.edit.containers`
`https://www.googleapis.com/auth/tagmanager.edit.containerversions`

For more information, see the authentication and authorization page.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a response body with the following structure:

{
  "containerVersionHeader": [
    {
      "path": string,
      "accountId": string,
      "containerId": string,
      "containerVersionId": string,
      "name": string,
      "numMacros": string,
      "numRules": string,
      "numTags": string,
      "numTriggers": string,
      "deleted": boolean,
      "numVariables": string,
      "numZones": string,
      "numCustomTemplates": string,
      "numClients": string,
      "numGtagConfigs": string,
      "numTransformations": string
    }
  ],
  "nextPageToken": string
}

Property name	Value	Description
`containerVersionHeader[]`	`list`	All container version headers of a GTM Container.
`containerVersionHeader[].path`	`string`	GTM Container Version's API relative path.
`containerVersionHeader[].accountId`	`string`	GTM Account ID.
`containerVersionHeader[].containerId`	`string`	GTM Container ID.
`containerVersionHeader[].containerVersionId`	`string`	The Container Version ID uniquely identifies the GTM Container Version.
`containerVersionHeader[].name`	`string`	Container version display name.
`containerVersionHeader[].numMacros`	`string`	Number of macros in the container version.
`containerVersionHeader[].numRules`	`string`	Number of rules in the container version.
`containerVersionHeader[].numTags`	`string`	Number of tags in the container version.
`containerVersionHeader[].numTriggers`	`string`	Number of triggers in the container version.
`containerVersionHeader[].deleted`	`boolean`	A value of true indicates this container version has been deleted.
`containerVersionHeader[].numVariables`	`string`	Number of variables in the container version.
`nextPageToken`	`string`	Continuation token for fetching the next page of results.
`containerVersionHeader[].numZones`	`string`	Number of zones in the container version.
`containerVersionHeader[].numCustomTemplates`	`string`	Number of custom templates in the container version.
`containerVersionHeader[].numClients`	`string`	Number of clients in the container version.
`containerVersionHeader[].numGtagConfigs`	`string`	Number of Google tag configs in the container version.
`containerVersionHeader[].numTransformations`	`string`	Number of transformations in the container version.

Try it!

Use the APIs Explorer below to call this method on live data and see the response.