Custom Dimensions: patch

Requiere autorización

Actualiza una dimensión personalizada existente. Este método es compatible con la semántica de parches. Pruébalo ahora y ve un ejemplo.

Solicitud

Solicitud HTTP

PATCH https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId

Parámetros

Nombre del parámetro	Valor	Descripción
Parámetros de ruta de acceso
`accountId`	`string`	Es el ID de la cuenta de la dimensión personalizada que se actualizará.
`customDimensionId`	`string`	Es el ID de la dimensión personalizada que se actualizará.
`webPropertyId`	`string`	Es el ID de propiedad web de la dimensión personalizada que se actualizará.
Parámetros de consulta opcionales
`ignoreCustomDataSourceLinks`	`boolean`	Fuerza la actualización y omite cualquier advertencia relacionada con la dimensión personalizada que se vincula a una fuente de datos o un conjunto de datos personalizados. (Predeterminado: `false`)

Autorización

Esta solicitud requiere autorización con el siguiente alcance (obtén más información sobre la autenticación y la autorización).

Alcance
`https://www.googleapis.com/auth/analytics.edit`

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporciona las partes relevantes de un recurso management.customDimension, de acuerdo con las reglas de semántica de parches.

Respuesta

Si se aplica correctamente, este método muestra un recurso management.customDimension en el cuerpo de la respuesta.

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 cliente para consultar una lista de lenguajes admitidos).

Java

Usa la biblioteca cliente de Java.

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

/*
 * This request patches an existing custom dimension.
 */

// Construct the body of the request and set its properties.
CustomDimension body = new CustomDimension();
body.setName("Campaign Group");
body.setScope("SESSION");
body.setActive(true);

try {
  analytics.management().customDimensions()
      .patch("123456", "UA-123456-1", "ga:dimension2", body).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

Python

Usa la biblioteca cliente de Python.

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

# This request patches an existing custom dimension.
try:
  analytics.management().customDimensions().patch(
      accountId='123456',
      webPropertyId='UA-123456-1',
      customDimensionId='ga:dimension2',
      body={
          'name': 'Campaign Group',
          'scope': 'SESSION',
          'active': 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))

Pruébalo

Usa el Explorador de APIs que aparece a continuación para llamar a este método con los datos en tiempo real y ver la respuesta. También puedes probar el Explorador independiente.