Autorisation requise
Met à jour une dimension personnalisée existante. Essayez maintenant ou consultez un exemple.
Requête
Requête HTTP
PUT https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId
Paramètres
Nom du paramètre | Valeur | Description |
---|---|---|
Paramètres de chemin d'accès | ||
accountId |
string |
ID du compte de la dimension personnalisée à mettre à jour. |
customDimensionId |
string |
ID de la dimension personnalisée à mettre à jour. |
webPropertyId |
string |
ID de propriété Web de la dimension personnalisée à mettre à jour. |
Paramètres de requête facultatifs | ||
ignoreCustomDataSourceLinks |
boolean |
Forcez la mise à jour et ignorez les avertissements concernant la dimension personnalisée associée à une source de données / ensemble de données personnalisé.
(Par défaut : false )
|
Autorisation
Une autorisation est requise pour cette requête. Celle-ci doit inclure le champ d'application suivant (en savoir plus sur le processus d'authentification et d'autorisation).
Champ d'application |
---|
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 utiliser la version autonome de l'explorateur.