Filters: update

Richiede l'autorizzazione

Aggiorna un filtro esistente. Prova subito o visualizza un esempio.

Richiesta

Richiesta HTTP

PUT https://www.googleapis.com/analytics/v3/management/accounts/accountId/filters/filterId

Parametri

Nome del parametro Valore Descrizione
Parametri del percorso
accountId string ID account a cui appartiene il filtro.
filterId string ID del filtro da aggiornare.

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 una risorsa management.filter con le seguenti proprietà:

Nome proprietà Valore Descrizione Note
Proprietà obbligatorie
name string Il nome di questo filtro. scrivibile
type string Tipo di questo filtro. I valori possibili sono INCLUDE, EXCLUDE, LOWERCASE, UPPERCASE, SEARCH_AND_REPLACE e ADVANCED. scrivibile
Proprietà facoltative
advancedDetails.caseSensitive boolean Indica se le espressioni di filtro sono sensibili alle maiuscole. scrivibile
advancedDetails.extractA string Espressione da estrarre dal campo A. scrivibile
advancedDetails.extractB string Espressione da estrarre dal campo B. scrivibile
advancedDetails.fieldA string Campo A. scrivibile
advancedDetails.fieldAIndex integer L'indice della dimensione personalizzata. Obbligatorio se il campo è CUSTOM_DIMENSION. scrivibile
advancedDetails.fieldARequired boolean Indica se il campo A deve corrispondere. scrivibile
advancedDetails.fieldB string Campo B. scrivibile
advancedDetails.fieldBIndex integer L'indice della dimensione personalizzata. Obbligatorio se il campo è CUSTOM_DIMENSION. scrivibile
advancedDetails.fieldBRequired boolean Indica se il campo B deve corrispondere. scrivibile
advancedDetails.outputConstructor string Espressione utilizzata per creare il valore di output. scrivibile
advancedDetails.outputToField string Campo di output. scrivibile
advancedDetails.outputToFieldIndex integer L'indice della dimensione personalizzata. Obbligatorio se il campo è CUSTOM_DIMENSION. scrivibile
advancedDetails.overrideOutputField boolean Indica se il valore esistente del campo di output, se presente, deve essere sostituito dall'espressione di output. scrivibile
excludeDetails.caseSensitive boolean Determina se il filtro è sensibile alle maiuscole. scrivibile
excludeDetails.expressionValue string Valore espressione di filtro scrivibile
excludeDetails.field string Campo da filtrare. Valori possibili:
  • Contenuti e traffico
    • PAGE_REQUEST_URI,
    • PAGE_HOSTNAME,
    • PAGE_TITLE,
    • REFERRAL,
    • COST_DATA_URI (URL target della campagna),
    • TIPO_HIT,
    • INTERNAL_SEARCH_TERM,
    • INTERNAL_SEARCH_TYPE,
    • SOURCE_PROPERTY_TRACKING_ID,
  • Campagna o gruppo di annunci
    • CAMPAIGN_SOURCE,
    • CAMPAIGN_MEDIUM,
    • CAMPAIGN_NAME
    • CAMPAIGN_AD_GROUP,
    • CAMPAIGN_TERM,
    • CAMPAIGN_CONTENT,
    • CAMPAIGN_CODE,
    • CAMPAIGN_REFERRAL_PATH
  • E-commerce
    • TRANSACTION_COUNTRY,
    • TRANSACTION_REGION,
    • TRANSACTION_CITY,
    • TRANSACTION_AFFILIATION (negozio o località dell'ordine),
    • ITEM_NAME,
    • ITEM_CODE,
    • ITEM_VARIATION,
    • TRANSACTION_ID,
    • TRANSACTION_CURRENCY_CODE,
    • PRODUCT_ACTION_TYPE,
  • Pubblico/Utenti
    • BROWSER,
    • BROWSER_VERSION,
    • BROWSER_SIZE,
    • PIATTAFORMA,
    • PLATFORM_VERSION,
    • LINGUA,
    • SCREEN_RESOLUTION,
    • SCREEN_COLORS,
    • JAVA_ENABLED (campo booleano),
    • FLASH_VERSION,
    • GEO_SPEED (velocità di connessione),
    • VISITOR_TYPE,
    • GEO_ORGANIZZAZIONE (organizzazione ISP),
    • GEO_DOMAIN,
    • GEO_IP_ADDRESS,
    • GEO_IP_VERSION,
  • Posizione
    • GEO_COUNTRY,
    • GEO_REGION,
    • GEO_CITY,
  • Evento
    • EVENT_CATEGORY,
    • EVENT_ACTION,
    • EVENT_LABEL,
  • Altro
    • CUSTOM_FIELD_1,
    • CUSTOM_FIELD_2,
    • USER_DEFINED_VALUE,
  • Applicazione
    • APP_ID,
    • APP_INSTALLER_ID,
    • APP_NAME,
    • APP_VERSION,
    • SCHERMO,
    • IS_APP (campo booleano),
    • IS_FATAL_EXCEPTION (campo booleano),
    • EXCEPTION_DESCRIPTION,
  • Dispositivo mobile
    • IS_MOBILE (Campo booleano, obsoleto. Utilizza DEVICE_CATEGORY=dispositivi mobili),
    • IS_TABLET (Campo booleano, Deprecato. Utilizza DEVICE_CATEGORY=tablet),
    • DEVICE_CATEGORY,
    • MOBILE_HAS_QWERTY_KEYBOARD (Campo booleano),
    • MOBILE_HAS_NFC_SUPPORT (campo booleano),
    • MOBILE_HAS_cellULAR_RADIO (campo booleano),
    • MOBILE_HAS_WIFI_SUPPORT (Campo booleano),
    • MOBILE_BRAND_NAME,
    • MOBILE_MODEL_NAME,
    • MOBILE_MARKETING_NAME,
    • MOBILE_POINTING_method,
  • Social
    • SOCIAL_NETWORK,
    • SOCIAL_ACTION,
    • TARGET_AZIONE_SOCIALE,
 scrivibile
excludeDetails.fieldIndex integer L'indice della dimensione personalizzata. Da impostare solo se il campo è CUSTOM_DIMENSION. scrivibile
excludeDetails.matchType string Tipo di corrispondenza per questo filtro. I valori possibili sono BEGINS_WITH, EQUAL, ENDS_WITH, CONTAINS o MATCHES. I filtri GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI o PAGE_HOSTNAME possono utilizzare qualsiasi tipo di corrispondenza; tutti gli altri filtri devono utilizzare MATCHES. scrivibile
includeDetails.caseSensitive boolean Determina se il filtro è sensibile alle maiuscole. scrivibile
includeDetails.expressionValue string Valore espressione di filtro scrivibile
includeDetails.field string Campo da filtrare. Valori possibili:
  • Contenuti e traffico
    • PAGE_REQUEST_URI,
    • PAGE_HOSTNAME,
    • PAGE_TITLE,
    • REFERRAL,
    • COST_DATA_URI (URL target della campagna),
    • TIPO_HIT,
    • INTERNAL_SEARCH_TERM,
    • INTERNAL_SEARCH_TYPE,
    • SOURCE_PROPERTY_TRACKING_ID,
  • Campagna o gruppo di annunci
    • CAMPAIGN_SOURCE,
    • CAMPAIGN_MEDIUM,
    • CAMPAIGN_NAME
    • CAMPAIGN_AD_GROUP,
    • CAMPAIGN_TERM,
    • CAMPAIGN_CONTENT,
    • CAMPAIGN_CODE,
    • CAMPAIGN_REFERRAL_PATH
  • E-commerce
    • TRANSACTION_COUNTRY,
    • TRANSACTION_REGION,
    • TRANSACTION_CITY,
    • TRANSACTION_AFFILIATION (negozio o località dell'ordine),
    • ITEM_NAME,
    • ITEM_CODE,
    • ITEM_VARIATION,
    • TRANSACTION_ID,
    • TRANSACTION_CURRENCY_CODE,
    • PRODUCT_ACTION_TYPE,
  • Pubblico/Utenti
    • BROWSER,
    • BROWSER_VERSION,
    • BROWSER_SIZE,
    • PIATTAFORMA,
    • PLATFORM_VERSION,
    • LINGUA,
    • SCREEN_RESOLUTION,
    • SCREEN_COLORS,
    • JAVA_ENABLED (campo booleano),
    • FLASH_VERSION,
    • GEO_SPEED (velocità di connessione),
    • VISITOR_TYPE,
    • GEO_ORGANIZZAZIONE (organizzazione ISP),
    • GEO_DOMAIN,
    • GEO_IP_ADDRESS,
    • GEO_IP_VERSION,
  • Posizione
    • GEO_COUNTRY,
    • GEO_REGION,
    • GEO_CITY,
  • Evento
    • EVENT_CATEGORY,
    • EVENT_ACTION,
    • EVENT_LABEL,
  • Altro
    • CUSTOM_FIELD_1,
    • CUSTOM_FIELD_2,
    • USER_DEFINED_VALUE,
  • Applicazione
    • APP_ID,
    • APP_INSTALLER_ID,
    • APP_NAME,
    • APP_VERSION,
    • SCHERMO,
    • IS_APP (campo booleano),
    • IS_FATAL_EXCEPTION (campo booleano),
    • EXCEPTION_DESCRIPTION,
  • Dispositivo mobile
    • IS_MOBILE (Campo booleano, obsoleto. Utilizza DEVICE_CATEGORY=dispositivi mobili),
    • IS_TABLET (Campo booleano, Deprecato. Utilizza DEVICE_CATEGORY=tablet),
    • DEVICE_CATEGORY,
    • MOBILE_HAS_QWERTY_KEYBOARD (Campo booleano),
    • MOBILE_HAS_NFC_SUPPORT (campo booleano),
    • MOBILE_HAS_cellULAR_RADIO (campo booleano),
    • MOBILE_HAS_WIFI_SUPPORT (Campo booleano),
    • MOBILE_BRAND_NAME,
    • MOBILE_MODEL_NAME,
    • MOBILE_MARKETING_NAME,
    • MOBILE_POINTING_method,
  • Social
    • SOCIAL_NETWORK,
    • SOCIAL_ACTION,
    • TARGET_AZIONE_SOCIALE,
 scrivibile
includeDetails.fieldIndex integer L'indice della dimensione personalizzata. Da impostare solo se il campo è CUSTOM_DIMENSION. scrivibile
includeDetails.matchType string Tipo di corrispondenza per questo filtro. I valori possibili sono BEGINS_WITH, EQUAL, ENDS_WITH, CONTAINS o MATCHES. I filtri GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI o PAGE_HOSTNAME possono utilizzare qualsiasi tipo di corrispondenza; tutti gli altri filtri devono utilizzare MATCHES. scrivibile
lowercaseDetails.field string Campo da utilizzare nel filtro. scrivibile
lowercaseDetails.fieldIndex integer L'indice della dimensione personalizzata. Obbligatorio se il campo è CUSTOM_DIMENSION. scrivibile
searchAndReplaceDetails.caseSensitive boolean Determina se il filtro è sensibile alle maiuscole. scrivibile
searchAndReplaceDetails.field string Campo da utilizzare nel filtro. scrivibile
searchAndReplaceDetails.fieldIndex integer L'indice della dimensione personalizzata. Obbligatorio se il campo è CUSTOM_DIMENSION. scrivibile
searchAndReplaceDetails.replaceString string Termine con cui sostituire il termine di ricerca. scrivibile
searchAndReplaceDetails.searchString string Termine da cercare. scrivibile
uppercaseDetails.field string Campo da utilizzare nel filtro. scrivibile
uppercaseDetails.fieldIndex integer L'indice della dimensione personalizzata. Obbligatorio se il campo è CUSTOM_DIMENSION. scrivibile

Risposta

In caso di esito positivo, questo metodo restituisce una risorsa management.filter 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.
 * See the Filters Developer Guide for details.
 */

/*
 * This example updates an existing filter.
 */

// Construct the filter Expression object.
AnalyticsManagementFiltersFilterExpression details = new
    AnalyticsManagementFiltersFilterExpression();
details.setField("GEO_DOMAIN");
details.setMatchType("EQUAL");
details.setExpressionValue("example.com");
details.setCaseSensitive(false);

// Construct the body of the request.
Filter body = new Filter();
body.setName("My Domain Filter");
body.setType("EXCLUDE");
body.setExcludeDetails(details);

try {
  analytics.management().filters().update("123456", "1223334444", body).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

PHP

Utilizza la libreria client PHP.

/**
 * Note: This code assumes you have an authorized Analytics service object.
 * See the Filters Developer Guide for details.
 */

/**
 * This request updates an existing filter.
 */
try {

  // Construct the filter expression object.
  $details = new Google_Service_Analytics_FilterExpression();
  $details->setField('GEO_DOMAIN');
  $details->setMatchType('EQUAL');
  $details->setExpressionValue('example.com');
  $details->setCaseSensitive(false);

  // Construct the filter and set the details.
  $filter = new Google_Service_Analytics_Filter();
  $filter->setName('My Domain Filter');
  $filter->setType('EXCLUDE');
  $filter->setId('7654321');
  $filter->setExcludeDetails($details);
  $analytics->management_filters->update('123456', '7654321', $filter);
} catch (apiServiceException $e) {
  print 'There was an Analytics API service error '
      . $e->getCode() . ':' . $e->getMessage();
} catch (apiException $e) {
  print 'There was a general API error '
      . $e->getCode() . ':' . $e->getMessage();
}

Python

Utilizza la libreria client Python.

# Note: This code assumes you have an authorized Analytics service object.
# See the Filters Developer Guide for details.

# This request updates an existing filter.
try:
  analytics.management().filters().update(
      accountId='123456',
      filterId='1223334444',
      body={
          'name': 'My Domain Filter',
          'type': 'EXCLUDE',
          'excludeDetails': {
              'field': 'GEO_DOMAIN',
              'matchType': 'EQUAL',
              'expressionValue': 'example.com',
              'caseSensitive': False
              }
      }
  ).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))

JavaScript

Utilizza la libreria client JavaScript.

/*
 * Note: This code assumes you have an authorized Analytics client object.
 * See the Filters Developer Guide for details.
 */

/*
 * This request updates an existing filter.
 */
function updateFilter() {
  var request = gapi.client.analytics.management.filters.update(
    {
      'accountId': '123456',
      'filterId': '1223334444',
      'resource': {
        'id': '1223334444',
        'name': 'My Domain Filter',
        'type': 'EXCLUDE',
        'excludeDetails': {
          'field': 'GEO_DOMAIN',
          'matchType': 'EQUAL',
          'expressionValue': 'example.com',
          'caseSensitive': false
        }
      }
    });
  request.execute(function (response) { // Handle the response. });
}

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.