Filters: update

Wymaga autoryzacji

Aktualizuje istniejący filtr. Wypróbuj teraz lub zobacz przykład.

Prośba

Żądanie HTTP

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

Parametry

Nazwa parametru Wartość Opis
Parametry ścieżki
accountId string Identyfikator konta, do którego należy filtr.
filterId string Identyfikator filtra do zaktualizowania.

Upoważnienie

To żądanie wymaga autoryzacji z tego zakresu (więcej informacji o uwierzytelnianiu i autoryzacji).

Zakres
https://www.googleapis.com/auth/analytics.edit

Treść żądania

W treści żądania podaj zasób management.filter z tymi właściwościami:

nazwa usługi, Wartość Opis Uwagi
Właściwości wymagane
name string Nazwa tego filtra. z możliwością zapisu
type string Typ filtra. Możliwe wartości to INCLUDE, EXCLUDE, LOWERCASE, WIELKA LITERA, SEARCH_AND_REPLACE i ADVANCED. z możliwością zapisu
Właściwości opcjonalne
advancedDetails.caseSensitive boolean Wskazuje, czy w wyrażeniach filtra jest rozróżniana wielkość liter. z możliwością zapisu
advancedDetails.extractA string Wyrażenie do wyodrębnienia z pola A. z możliwością zapisu
advancedDetails.extractB string Wyrażenie do wyodrębnienia z pola B. z możliwością zapisu
advancedDetails.fieldA string Pole A. z możliwością zapisu
advancedDetails.fieldAIndex integer Indeks wymiaru niestandardowego. Wymagane, jeśli pole to CUSTOM_DIMENSION. z możliwością zapisu
advancedDetails.fieldARequired boolean Wskazuje, czy pole A musi być zgodne. z możliwością zapisu
advancedDetails.fieldB string Pole B. z możliwością zapisu
advancedDetails.fieldBIndex integer Indeks wymiaru niestandardowego. Wymagane, jeśli pole to CUSTOM_DIMENSION. z możliwością zapisu
advancedDetails.fieldBRequired boolean Wskazuje, czy pole B musi być zgodne. z możliwością zapisu
advancedDetails.outputConstructor string Wyrażenie użyte do utworzenia wartości wyjściowej. z możliwością zapisu
advancedDetails.outputToField string Pole wyjściowe. z możliwością zapisu
advancedDetails.outputToFieldIndex integer Indeks wymiaru niestandardowego. Wymagane, jeśli pole to CUSTOM_DIMENSION. z możliwością zapisu
advancedDetails.overrideOutputField boolean Wskazuje, czy obecna wartość pola wyjściowego (jeśli taka istnieje) powinna zostać zastąpiona wyrażeniem wyjściowym. z możliwością zapisu
excludeDetails.caseSensitive boolean Określa, czy w filtrze rozróżniana jest wielkość liter. z możliwością zapisu
excludeDetails.expressionValue string Wartość wyrażenia filtra z możliwością zapisu
excludeDetails.field string Pole do filtrowania. Możliwe wartości:
  • Treść i ruch
    • PAGE_REQUEST_uri,
    • PAGE_HOSTNAME,
    • PAGE_TITLE
    • REFERRAL,
    • COST_DATA_UID (docelowy adres URL kampanii),
    • HIT_TYPE,
    • INTERNAL_SEARCH_TERM,
    • INTERNAL_SEARCH_TYPE,
    • SOURCE_PROPERTY_TRACKING_ID,
  • Kampania lub grupa reklam
    • 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 (Miejsce sklepu lub zamówienia)
    • ITEM_NAME
    • ITEM_CODE
    • ITEM_VARIATION
    • TRANSACTION_ID
    • TRANSACTION_CURRENCY_CODE,
    • PRODUCT_ACTION_TYPE,
  • Odbiorcy/użytkownicy
    • PRZEGLĄDARKA,
    • BROWSER_VERSION
    • BROWSER_SIZE,
    • PLATFORMA,
    • PLATFORM_VERSION
    • LANGUAGE,
    • SCREEN_RESOLUTION,
    • SCREEN_COLORS,
    • JAVA_ENABLED (pole wartości logicznej),
    • FLASH_VERSION
    • GEO_SPEED (szybkość połączenia),
    • VISITOR_TYPE,
    • GEO_ORG (organizacja dostawcy usług internetowych),
    • GEO_DOMAIN,
    • GEO_IP_ADDRESS,
    • GEO_IP_VERSION,
  • Lokalizacja
    • GEO_COUNTRY.
    • GEO_REGION,
    • GEO_CITY,
  • Wydarzenie
    • EVENT_CATEGORY,
    • EVENT_ACTION,
    • EVENT_LABEL,
  • Inne
    • CUSTOM_FIELD_1,
    • CUSTOM_FIELD_2,
    • USER_DEFINED_VALUE
  • Aplikacja
    • APP_ID
    • Identyfikator aplikacji APP_INSTALLER_ID
    • APP_NAME
    • APP_VERSION
    • SCREEN,
    • IS_APP (pole wartości logicznej),
    • IS_FATAL_EXCEPTION (pole wartości logicznej),
    • EXCEPTION_DESCRIPTION,
  • Urządzenie mobilne
    • IS_MOBILE (pole wartości logicznej, wycofane. użyj kategorii DEVICE_CATEGORY=mobile),
    • IS_TABLET (pole wartości logicznej, wycofane. Użyj kategorii DEVICE_CATEGORY=tablet),
    • DEVICE_CATEGORY,
    • MOBILE_HAS_QWERTY_KEYCARD (pole wartości logicznej),
    • MOBILE_HAS_NFC_SUPPORT (pole wartości logicznej),
    • MOBILE_HAS_CELLULAR_RADIO (pole wartości logicznej),
    • MOBILE_HAS_WIFI_SUPPORT (pole wartości logicznej),
    • MOBILE_BRAND_NAME,
    • MOBILE_MODEL_NAME,
    • MOBILE_MARKETING_NAME
    • MOBILE_POINTING_method,
  • Społecznościowe
    • SOCIAL_NETWORK,
    • SOCIAL_ACTION
    • SOCIAL_ACTION_TARGET,
 z możliwością zapisu
excludeDetails.fieldIndex integer Indeks wymiaru niestandardowego. Ustaw tylko wtedy, gdy pole to CUSTOM_DIMENSION. z możliwością zapisu
excludeDetails.matchType string Typ dopasowania dla tego filtra. Możliwe wartości to BEGINS_WITH, EQUAL, ENDS_WITH, CONTAINS oraz MATCHES. Filtry GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI i PAGE_HOSTNAME mogą korzystać z dowolnego typu dopasowania; wszystkie pozostałe filtry muszą używać typu MATCHES. z możliwością zapisu
includeDetails.caseSensitive boolean Określa, czy w filtrze rozróżniana jest wielkość liter. z możliwością zapisu
includeDetails.expressionValue string Wartość wyrażenia filtra z możliwością zapisu
includeDetails.field string Pole do filtrowania. Możliwe wartości:
  • Treść i ruch
    • PAGE_REQUEST_uri,
    • PAGE_HOSTNAME,
    • PAGE_TITLE
    • REFERRAL,
    • COST_DATA_UID (docelowy adres URL kampanii),
    • HIT_TYPE,
    • INTERNAL_SEARCH_TERM,
    • INTERNAL_SEARCH_TYPE,
    • SOURCE_PROPERTY_TRACKING_ID,
  • Kampania lub grupa reklam
    • 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 (Miejsce sklepu lub zamówienia)
    • ITEM_NAME
    • ITEM_CODE
    • ITEM_VARIATION
    • TRANSACTION_ID
    • TRANSACTION_CURRENCY_CODE,
    • PRODUCT_ACTION_TYPE,
  • Odbiorcy/użytkownicy
    • PRZEGLĄDARKA,
    • BROWSER_VERSION
    • BROWSER_SIZE,
    • PLATFORMA,
    • PLATFORM_VERSION
    • LANGUAGE,
    • SCREEN_RESOLUTION,
    • SCREEN_COLORS,
    • JAVA_ENABLED (pole wartości logicznej),
    • FLASH_VERSION
    • GEO_SPEED (szybkość połączenia),
    • VISITOR_TYPE,
    • GEO_ORG (organizacja dostawcy usług internetowych),
    • GEO_DOMAIN,
    • GEO_IP_ADDRESS,
    • GEO_IP_VERSION,
  • Lokalizacja
    • GEO_COUNTRY.
    • GEO_REGION,
    • GEO_CITY,
  • Wydarzenie
    • EVENT_CATEGORY,
    • EVENT_ACTION,
    • EVENT_LABEL,
  • Inne
    • CUSTOM_FIELD_1,
    • CUSTOM_FIELD_2,
    • USER_DEFINED_VALUE
  • Aplikacja
    • APP_ID
    • Identyfikator aplikacji APP_INSTALLER_ID
    • APP_NAME
    • APP_VERSION
    • SCREEN,
    • IS_APP (pole wartości logicznej),
    • IS_FATAL_EXCEPTION (pole wartości logicznej),
    • EXCEPTION_DESCRIPTION,
  • Urządzenie mobilne
    • IS_MOBILE (pole wartości logicznej, wycofane. użyj kategorii DEVICE_CATEGORY=mobile),
    • IS_TABLET (pole wartości logicznej, wycofane. Użyj kategorii DEVICE_CATEGORY=tablet),
    • DEVICE_CATEGORY,
    • MOBILE_HAS_QWERTY_KEYCARD (pole wartości logicznej),
    • MOBILE_HAS_NFC_SUPPORT (pole wartości logicznej),
    • MOBILE_HAS_CELLULAR_RADIO (pole wartości logicznej),
    • MOBILE_HAS_WIFI_SUPPORT (pole wartości logicznej),
    • MOBILE_BRAND_NAME,
    • MOBILE_MODEL_NAME,
    • MOBILE_MARKETING_NAME
    • MOBILE_POINTING_method,
  • Społecznościowe
    • SOCIAL_NETWORK,
    • SOCIAL_ACTION
    • SOCIAL_ACTION_TARGET,
 z możliwością zapisu
includeDetails.fieldIndex integer Indeks wymiaru niestandardowego. Ustaw tylko wtedy, gdy pole to CUSTOM_DIMENSION. z możliwością zapisu
includeDetails.matchType string Typ dopasowania dla tego filtra. Możliwe wartości to BEGINS_WITH, EQUAL, ENDS_WITH, CONTAINS oraz MATCHES. Filtry GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI i PAGE_HOSTNAME mogą korzystać z dowolnego typu dopasowania; wszystkie pozostałe filtry muszą używać typu MATCHES. z możliwością zapisu
lowercaseDetails.field string Pole do użycia w filtrze. z możliwością zapisu
lowercaseDetails.fieldIndex integer Indeks wymiaru niestandardowego. Wymagane, jeśli pole to CUSTOM_DIMENSION. z możliwością zapisu
searchAndReplaceDetails.caseSensitive boolean Określa, czy w filtrze rozróżniana jest wielkość liter. z możliwością zapisu
searchAndReplaceDetails.field string Pole do użycia w filtrze. z możliwością zapisu
searchAndReplaceDetails.fieldIndex integer Indeks wymiaru niestandardowego. Wymagane, jeśli pole to CUSTOM_DIMENSION. z możliwością zapisu
searchAndReplaceDetails.replaceString string Hasło, które ma zastąpić wyszukiwane hasło. z możliwością zapisu
searchAndReplaceDetails.searchString string Wyszukiwane hasło. z możliwością zapisu
uppercaseDetails.field string Pole do użycia w filtrze. z możliwością zapisu
uppercaseDetails.fieldIndex integer Indeks wymiaru niestandardowego. Wymagane, jeśli pole to CUSTOM_DIMENSION. z możliwością zapisu

Odpowiedź

Jeśli operacja się uda, ta metoda zwróci w treści odpowiedzi zasób zarządzania.filter.

Przykłady

Uwaga: dostępne dla tej metody przykłady kodu nie odzwierciedlają wszystkich obsługiwanych języków programowania. Listę obsługiwanych języków znajdziesz na stronie z bibliotekami klienta.

Java

Używa biblioteki klienta 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

Wykorzystuje bibliotekę klienta 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

Używa biblioteki klienta Pythona.

# 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

Używa biblioteki klienta 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. });
}

Wypróbuj

Użyj eksploratora interfejsów API poniżej, aby wywołać tę metodę na aktywnych danych i zobaczyć odpowiedź. Możesz też wypróbować samodzielny eksplorator.