Custom Metrics: patch

Autorisation requise

Met à jour une métrique personnalisée existante. Cette méthode est compatible avec la sémantique "patch". Essayez maintenant ou consultez un exemple.

Requête

Requête HTTP

PATCH https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId

Paramètres

Nom du paramètre Valeur Description
Paramètres de chemin d'accès
accountId string ID de compte de la métrique personnalisée à mettre à jour.
customMetricId string ID de la métrique personnalisée à mettre à jour.
webPropertyId string ID de propriété Web de la métrique personnalisée à mettre à jour.
Paramètres de requête facultatifs

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).

Définition du champ d'application
https://www.googleapis.com/auth/analytics.edit

Corps de la requête

Dans le corps de la requête, fournissez les parties pertinentes d'une ressource management.customMetric, conformément aux règles de la sémantique "patch".

Réponse

Lorsque cette méthode fonctionne, elle renvoie une ressource management.customMetric 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 patches an existing custom metric.
 */

// Construct the body of the request and set its properties.
CustomMetric body = new CustomMetric();
body.setName("Level Completions");
body.setScope("HIT");
body.setType("INTEGER");
body.setActive(true);

try {
  analytics.management().customMetrics()
      .patch("123456", "UA-123456-1", "ga:metric2", 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 patches an existing custom metric.
try:
  analytics.management().customMetrics().patch(
      accountId='123456',
      webPropertyId='UA-123456-1',
      customMetricId='ga:metric2',
      body={
          'name': 'Level Completions',
          'scope': 'HIT',
          'type': 'INTEGER',
          '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 l'explorateur autonome.