Custom Metrics: update

Autorisierung erforderlich

Aktualisiert einen vorhandenen benutzerdefinierten Messwert. Probieren Sie es gleich aus oder sehen Sie sich ein Beispiel an.

Anfragen

HTTP-Anfrage

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

Parameter

Parametername	Wert	Beschreibung
Pfadparameter
`accountId`	`string`	Konto-ID für den benutzerdefinierten Messwert, der aktualisiert werden soll
`customMetricId`	`string`	Die ID des benutzerdefinierten Messwerts, der aktualisiert werden soll.
`webPropertyId`	`string`	Web-Property-ID für den benutzerdefinierten Messwert, der aktualisiert werden soll
Optionale Abfrageparameter
`ignoreCustomDataSourceLinks`	`boolean`	Erzwingen Sie die Aktualisierung und ignorieren Sie alle Warnungen im Zusammenhang mit dem benutzerdefinierten Messwert, der mit einer benutzerdefinierten Datenquelle bzw. einem benutzerdefinierten Datensatz verknüpft ist. (Standard: `false`)

Autorisierung

Für diese Anfrage ist eine Autorisierung im folgenden Bereich erforderlich. Weitere Informationen zur Authentifizierung und Autorisierung

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

Anfragetext

Geben Sie im Anfragetext eine Ressource vom Typ „management.customMetric“ an.

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Ressource vom Typ „management.customMetric“ im Antworttext zurückgegeben.

Beispiele

Hinweis: Bei den für diese Methode verfügbaren Codebeispielen sind nicht alle unterstützten Programmiersprachen vertreten. Eine Liste der unterstützten Sprachen finden Sie auf der Seite für Clientbibliotheken.

Java

Verwendet die Java-Clientbibliothek.

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

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

Verwendet die Python-Clientbibliothek.

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

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

Jetzt testen

Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen. Probieren Sie alternativ den eigenständigen Explorer aus.