Custom Dimensions: patch

Richiede l'autorizzazione

Aggiorna una dimensione personalizzata esistente. Questo metodo supporta la semantica della patch. Prova subito o visualizza un esempio.

Richiesta

Richiesta HTTP

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

Parametri

Nome del parametro	Valore	Descrizione
Parametri del percorso
`accountId`	`string`	ID account per la dimensione personalizzata da aggiornare.
`customDimensionId`	`string`	ID dimensione personalizzata da aggiornare.
`webPropertyId`	`string`	ID proprietà web per la dimensione personalizzata da aggiornare.
Parametri di query facoltativi
`ignoreCustomDataSourceLinks`	`boolean`	Forza l'aggiornamento e ignora eventuali avvisi relativi al collegamento della dimensione personalizzata a un'origine dati o a un set di dati personalizzati. (valore predefinito: `false`)

Autorizzazione

Questa richiesta richiede l'autorizzazione con il seguente ambito (scopri di più su autenticazione e autorizzazione).

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

Corpo della richiesta

Nel corpo della richiesta, fornisci le parti pertinenti di una risorsa management.customDimensione, in base alle regole della semantica della patch.

Risposta

Se l'operazione ha esito positivo, questo metodo restituisce una risorsa management.customDimensione nel corpo della risposta.

Esempi

Nota: gli esempi di codice disponibili per questo metodo non rappresentano tutti i linguaggi di programmazione supportati (consulta la pagina relativa alle librerie client per un elenco dei linguaggi supportati).

Java

Utilizza la libreria client Java.

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

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

Utilizza la libreria client Python.

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

# This request patches an existing custom dimension.
try:
  analytics.management().customDimensions().patch(
      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))

Prova.

Utilizza Explorer API di seguito per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta. In alternativa, prova a utilizzare Explorer in modalità autonoma.