Custom Dimensions: insert

Autorisation requise

Créez une dimension personnalisée. Essayer maintenant ou voir un exemple

Demande

Requête HTTP

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

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 à créer.
webPropertyId	string	ID de la propriété Web pour la dimension personnalisée à créer.

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 creates a new 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()
      .insert("123456", "UA-123456-1", 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 creates a new custom dimension.
try:
  analytics.management().customDimensions().insert(
      accountId='123456',
      webPropertyId='UA-123456-1',
      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.