Container Versions: create

Requiere autorización

Crea un recurso Container Version. Pruébalo ahora o consulta un ejemplo.

Solicitud

Solicitud HTTP

POST https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/versions

Parámetros

Nombre de parámetro Valor Descripción
Parámetros de ruta
accountId string ID de recurso Account de GTM.
containerId string ID de recurso Container de GTM.

Autorización

Esta solicitud requiere autorización con el siguiente ámbito. Consulta más información sobre la autenticación y la autorización.

Ámbito
https://www.googleapis.com/auth/tagmanager.edit.containerversions

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporciona datos con la siguiente estructura:

{
  "quickPreview": boolean,
  "name": string,
  "notes": string
}
Nombre de propiedad Valor Descripción Notas
quickPreview boolean La creación de esta versión puede ser para una vista previa rápida y no debe guardarse.
name string Nombre del recurso Container Version que se creará.
notes string Notas del recurso Container Version que se creará.

Respuesta

Si este método se realiza correctamente, el cuerpo de respuesta tendrá la siguiente estructura:

{
  "containerVersion": accounts.containers.versions Resource,
  "compilerError": boolean
}
Nombre de propiedad Valor Descripción Notas
containerVersion nested object Recurso Container Version creado.
compilerError boolean Indica si hay errores de compilador.

Ejemplos

Nota: Los ejemplos de código disponibles para este método no representan todos los lenguajes de programación admitidos (consulta la página de bibliotecas de cliente para obtener una lista de los lenguajes admitidos).

Java

Utiliza la biblioteca de cliente Java.

/*
 * Note: This code assumes you have an authorized tagmanager service object.
 */

/*
 * This request creates a new container version.
 */

// Create the container versions options object.
CreateContainerVersionRequestVersionOptions options =
    new  CreateContainerVersionRequestVersionOptions();
options.setName("Container Version");
options.setNotes("Sample Container Version");
options.setQuickPreview(false);

try {
  CreateContainerVersionResponse response = tagmanager.accounts().
      containers().versions().create("123456", "54321", options).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

/*
 * The results of the create method are stored in the response object.
 * The following code shows how to access the created id and fingerprint.
 */
System.out.println("Compiler Error = " + response.getCompilerError());
ContainerVersion version = response.getContainerVersion();
if (version != null) {
  System.out.println("Container Version Id = "
      + version.getContainerVersionId());
  System.out.println("Container Version Fingerprint = "
      + version.getFingerprint());
}

Python

Utiliza la biblioteca de cliente Python.

# Note: This code assumes you have an authorized tagmanager service object.

# This request creates a new container version.
try:
  response = tagmanager.accounts().containers().versions().create(
      accountId='123456',
      containerId='54321',
      body={
          'name': 'Container Version',
          'notes': 'Sample Container Version',
          'quickPreview': True
      }
  ).execute()

except TypeError, error:
  # Handle errors in constructing a query.
  print 'There was an error in constructing your query : %s' % error

except HttpError, error:
  # Handle API errors.
  print ('There was an API error : %s : %s' %
         (error.resp.status, error.resp.reason))

# The results of the create method are stored in response object.
# The following code shows how to access the created id and fingerprint.
version = response.get('containerVersion', {})
print 'Container Version Id = %s' % version.get('containerVersionId')
print 'Container Version Fingerprint = %s' % version.get('fingerprint')

Pruébalo

Utiliza el siguiente explorador de APIs para llamar a este método con datos en tiempo real y ver la respuesta.