Cette page a été traduite par l'API Cloud Translation.

Custom Dimensions: update

Met à jour une dimension personnalisée existante. Essayer maintenant ou voir un exemple

Demande

Requête HTTP

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

Paramètres

Nom du paramètre	Value	Description
Paramètres de chemin d'accès
`accountId`	`string`	Identifiant du compte pour la dimension personnalisée à mettre à jour.
`customDimensionId`	`string`	ID de la dimension personnalisée à mettre à jour.
`webPropertyId`	`string`	ID de propriété Web pour la dimension personnalisée à mettre à jour.
Paramètres de requête facultatifs
`ignoreCustomDataSourceLinks`	`boolean`	Forcez la mise à jour et ignorez les avertissements liés à la dimension personnalisée associée à une source de données ou à un ensemble de données personnalisés. (Par défaut : `false`)

Autorisation

Cette requête nécessite une autorisation ayant le champ d'application suivant (en savoir plus sur l'authentification et l'autorisation).

Portée
`https://www.googleapis.com/auth/analytics.edit`

Corps de la requête

Dans le corps de la requête, indiquez une ressource management.customDimension.

Réponse

Lorsque cette méthode fonctionne, elle renvoie une ressource management.customDimension dans le corps de la réponse.

Exemples

Remarque : Les langages de programmation compatibles ne figurent pas tous dans les exemples de code présentés pour cette méthode (consultez la page Bibliothèques clientes pour obtenir la liste des langages compatibles).

Java

Utilise la bibliothèque cliente Java.

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

/*
 * This request updates 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()
      .update("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

Utilise la bibliothèque cliente Python.

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

# This request updates an existing custom dimension.
try:
  analytics.management().customDimensions().update(
      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))

Essayer

Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse. Vous pouvez également essayer l'explorateur autonome.