Custom Metrics: insert

Autorisierung erforderlich

Erstellen Sie einen neuen benutzerdefinierten Messwert. Probieren Sie es gleich aus oder sehen Sie sich ein Beispiel an.

Anfragen

HTTP-Anfrage

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

Parameter

Parametername	Wert	Beschreibung
Pfadparameter
`accountId`	`string`	Konto-ID für den benutzerdefinierten Messwert, der erstellt werden soll.
`webPropertyId`	`string`	Web-Property-ID für die zu erstellende benutzerdefinierte Dimension.

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 creates a new 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()
      .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

Verwendet die Python-Clientbibliothek.

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

# This request creates a new custom metric.
try:
  analytics.management().customMetrics().insert(
      accountId='123456',
      webPropertyId='UA-123456-1',
      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.