Custom Dimensions: update

Autorisierung erforderlich

Aktualisiert eine vorhandene benutzerdefinierte Dimension. 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/customDimensions/customDimensionId

Parameter

Parametername	Wert	Beschreibung
Pfadparameter
`accountId`	`string`	Konto-ID für die benutzerdefinierte Dimension, die aktualisiert werden soll.
`customDimensionId`	`string`	ID der benutzerdefinierten Dimension für die zu aktualisierende benutzerdefinierte Dimension.
`webPropertyId`	`string`	Web-Property-ID für die zu aktualisierende benutzerdefinierte Dimension.
Optionale Abfrageparameter
`ignoreCustomDataSourceLinks`	`boolean`	Erzwingen Sie die Aktualisierung und ignorieren Sie alle Warnungen im Zusammenhang mit der benutzerdefinierten Dimension, die mit einer benutzerdefinierten Datenquelle bzw. einem benutzerdefinierten Datensatz verknüpft wird. (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.customDimension“ an.

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Ressource vom Typ "management.customDimension" 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 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

Verwendet die Python-Clientbibliothek.

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

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.