Filters: update

Yetkilendirme gerektirir

Mevcut bir filtreyi günceller. Hemen deneyin veya bir örneğe göz atın.

İstek

HTTP isteği

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

Parametreler

Parametre adı Değer Açıklama
Yol parametreleri
accountId string Filtrenin ait olduğu hesabın kimliği.
filterId string Güncellenecek filtrenin kimliği.

Yetkilendirme

Bu istek, aşağıdaki kapsamla yetkilendirme gerektirir (kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinin).

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

İstek içeriği

İstek gövdesinde, aşağıdaki özelliklere sahip bir management.filter kaynağı sağlayın:

Mülk adı Değer Açıklama Notlar
Zorunlu mülkler
name string Bu filtrenin adı. yazılabilir
type string Bu filtrenin türü. Olası değerler: include, EXCLUDE, LOWERCASE, UPPERCASE, SEARCH_AND_REPLACE ve ADVANCED. yazılabilir
İsteğe Bağlı Özellikler
advancedDetails.caseSensitive boolean Filtre ifadelerinin büyük/küçük harfe duyarlı olup olmadığını belirtir. yazılabilir
advancedDetails.extractA string A alanından ayıklanacak ifade. yazılabilir
advancedDetails.extractB string B alanından çıkarılacak ifade. yazılabilir
advancedDetails.fieldA string A Alanı. yazılabilir
advancedDetails.fieldAIndex integer Özel boyutun dizini. Alan bir CUSTOM_DIMENSION ise gereklidir. yazılabilir
advancedDetails.fieldARequired boolean A alanının eşleşmesi gerekip gerekmediğini belirtir. yazılabilir
advancedDetails.fieldB string B Alanı. yazılabilir
advancedDetails.fieldBIndex integer Özel boyutun dizini. Alan bir CUSTOM_DIMENSION ise gereklidir. yazılabilir
advancedDetails.fieldBRequired boolean B alanının eşleşmesi gerekip gerekmediğini belirtir. yazılabilir
advancedDetails.outputConstructor string Çıkış değerini oluşturmak için kullanılan ifade. yazılabilir
advancedDetails.outputToField string Çıkış alanı. yazılabilir
advancedDetails.outputToFieldIndex integer Özel boyutun dizini. Alan bir CUSTOM_DIMENSION ise gereklidir. yazılabilir
advancedDetails.overrideOutputField boolean Çıkış alanının mevcut değerinin (varsa) çıkış ifadesi tarafından geçersiz kılınıp kılınmayacağını belirtir. yazılabilir
excludeDetails.caseSensitive boolean Filtrenin büyük/küçük harfe duyarlı olup olmadığını belirler. yazılabilir
excludeDetails.expressionValue string Filtre ifadesi değeri yazılabilir
excludeDetails.field string Filtrelenecek alan. Olası değerler:
  • İçerik ve Trafik
    • PAGE_REQUEST_URI,
    • PAGE_HOSTNAME,
    • PAGE_TITLE,
    • YÖNLENDİRME,
    • COST_DATA_URI (Kampanya hedef URL'si),
    • HIT_TYPE,
    • INTERNAL_SEARCH_TERM,
    • INTERNAL_SEARCH_TYPE,
    • SOURCE_PROPERTY_TRACKING_ID,
  • Kampanya veya Reklam Grubu
    • CAMPAIGN_SOURCE,
    • CAMPAIGN_ORTA
    • CAMPAIGN_NAME,
    • CAMPAIGN_AD_GROUP,
    • CAMPAIGN_TERM,
    • CAMPAIGN_CONTENT
    • CAMPAIGN_CODE,
    • CAMPAIGN_REFERRAL_PATH,
  • E-Ticaret
    • TRANSACTION_COUNTRY,
    • TRANSACTION_REGION,
    • TRANSACTION_ŞEY,
    • TRANSACTION_AFFILIATION (Mağaza veya sipariş konumu),
    • ITEM_NAME,
    • ÖĞE_KODU,
    • ITEM_VARIATION,
    • TRANSACTION_ID
    • TRANSACTION_CURRENCY_CODE,
    • PRODUCT_ACTION_TYPE,
  • Kitle/Kullanıcılar
    • TARAYICI,
    • BROWSER_VERSION,
    • BROWSER_SIZE,
    • PLATFORM,
    • PLATFORM_VERSION,
    • DİL,
    • SCREEN_RESOLUTION,
    • SCREEN_COLORS,
    • JAVA_ENABLED (Boole Alanı),
    • FLASH_VERSION,
    • GEO_SPEED (Bağlantı hızı),
    • VISITOR_TYPE,
    • GEO_Organization (İSS kuruluşu),
    • GEO_DOMAIN,
    • GEO_IP_ADDRESS,
    • GEO_IP_VERSION,
  • Konum
    • GEO_COUNTRY,
    • GEO_BÖLGE,
    • GEO_ŞEHİR,
  • Etkinlik
    • EVENT_CATEGORY,
    • EVENT_ACTION,
    • EVENT_LABEL,
  • Diğer
    • ÖZEL_ALAN_1
    • ÖZEL_ALAN_2,
    • USER_DEFINED_VALUE,
    • uygulaması
    • APP_ID,
    • APP_INSTALLER_ID,
    • APP_NAME,
    • APP_VERSION,
    • EKRAN,
    • IS_APP (Boole Alanı),
    • IS_FATAL_EXCEPTION (Boole Alanı),
    • EXCEPTION_DESCRIPTION,
  • Mobil cihaz
    • IS_MOBILE (Boole Alanı, Kullanımdan kaldırıldı. DEVICE_CATEGORY=mobile adresini kullanın),
    • IS_TABLET (Boole Alanı, Kullanımdan kaldırıldı. DEVICE_CATEGORY=tableti kullanın),
    • DEVICE_CATEGORY,
    • MOBILE_HAS_QWERTY_KEYBOARD (Boole Alanı),
    • MOBILE_HAS_NFC_SUPPORT (Boole Alanı),
    • MOBILE_HAS_CELLULAR_RADIO (Boole Alanı),
    • MOBILE_HAS_WIFI_SUPPORT (Boole Alanı),
    • MOBILE_BRAND_NAME,
    • MOBILE_MODEL_NAME,
    • MOBILE_MARKETING_NAME,
    • MOBILE_POINTING_METHOD,
  • Sosyal
    • SOSYAL_AĞ,
    • SOCIAL_ACTION,
    • SOCIAL_ACTION_TARGET,
yazılabilir
excludeDetails.fieldIndex integer Özel boyutun dizini. Yalnızca alan CUSTOM_DIMENSION ise ayarlayın. yazılabilir
excludeDetails.matchType string Bu filtrenin eşleme türü. Olası değerler: BEGINS_WITH, EQUAL, ENDS_WITH, CONTAINS veya MATCHES. GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI veya PAGE_HOSTNAME filtreleri herhangi bir eşleme türünü kullanabilir. Diğer tüm filtreler MATCHES kullanmalıdır. yazılabilir
includeDetails.caseSensitive boolean Filtrenin büyük/küçük harfe duyarlı olup olmadığını belirler. yazılabilir
includeDetails.expressionValue string Filtre ifadesi değeri yazılabilir
includeDetails.field string Filtrelenecek alan. Olası değerler:
  • İçerik ve Trafik
    • PAGE_REQUEST_URI,
    • PAGE_HOSTNAME,
    • PAGE_TITLE,
    • YÖNLENDİRME,
    • COST_DATA_URI (Kampanya hedef URL'si),
    • HIT_TYPE,
    • INTERNAL_SEARCH_TERM,
    • INTERNAL_SEARCH_TYPE,
    • SOURCE_PROPERTY_TRACKING_ID,
  • Kampanya veya Reklam Grubu
    • CAMPAIGN_SOURCE,
    • CAMPAIGN_ORTA
    • CAMPAIGN_NAME,
    • CAMPAIGN_AD_GROUP,
    • CAMPAIGN_TERM,
    • CAMPAIGN_CONTENT
    • CAMPAIGN_CODE,
    • CAMPAIGN_REFERRAL_PATH,
  • E-Ticaret
    • TRANSACTION_COUNTRY,
    • TRANSACTION_REGION,
    • TRANSACTION_ŞEY,
    • TRANSACTION_AFFILIATION (Mağaza veya sipariş konumu),
    • ITEM_NAME,
    • ÖĞE_KODU,
    • ITEM_VARIATION,
    • TRANSACTION_ID
    • TRANSACTION_CURRENCY_CODE,
    • PRODUCT_ACTION_TYPE,
  • Kitle/Kullanıcılar
    • TARAYICI,
    • BROWSER_VERSION,
    • BROWSER_SIZE,
    • PLATFORM,
    • PLATFORM_VERSION,
    • DİL,
    • SCREEN_RESOLUTION,
    • SCREEN_COLORS,
    • JAVA_ENABLED (Boole Alanı),
    • FLASH_VERSION,
    • GEO_SPEED (Bağlantı hızı),
    • VISITOR_TYPE,
    • GEO_Organization (İSS kuruluşu),
    • GEO_DOMAIN,
    • GEO_IP_ADDRESS,
    • GEO_IP_VERSION,
  • Konum
    • GEO_COUNTRY,
    • GEO_BÖLGE,
    • GEO_ŞEHİR,
  • Etkinlik
    • EVENT_CATEGORY,
    • EVENT_ACTION,
    • EVENT_LABEL,
  • Diğer
    • ÖZEL_ALAN_1
    • ÖZEL_ALAN_2,
    • USER_DEFINED_VALUE,
    • uygulaması
    • APP_ID,
    • APP_INSTALLER_ID,
    • APP_NAME,
    • APP_VERSION,
    • EKRAN,
    • IS_APP (Boole Alanı),
    • IS_FATAL_EXCEPTION (Boole Alanı),
    • EXCEPTION_DESCRIPTION,
  • Mobil cihaz
    • IS_MOBILE (Boole Alanı, Kullanımdan kaldırıldı. DEVICE_CATEGORY=mobile adresini kullanın),
    • IS_TABLET (Boole Alanı, Kullanımdan kaldırıldı. DEVICE_CATEGORY=tableti kullanın),
    • DEVICE_CATEGORY,
    • MOBILE_HAS_QWERTY_KEYBOARD (Boole Alanı),
    • MOBILE_HAS_NFC_SUPPORT (Boole Alanı),
    • MOBILE_HAS_CELLULAR_RADIO (Boole Alanı),
    • MOBILE_HAS_WIFI_SUPPORT (Boole Alanı),
    • MOBILE_BRAND_NAME,
    • MOBILE_MODEL_NAME,
    • MOBILE_MARKETING_NAME,
    • MOBILE_POINTING_METHOD,
  • Sosyal
    • SOSYAL_AĞ,
    • SOCIAL_ACTION,
    • SOCIAL_ACTION_TARGET,
yazılabilir
includeDetails.fieldIndex integer Özel boyutun dizini. Yalnızca alan CUSTOM_DIMENSION ise ayarlayın. yazılabilir
includeDetails.matchType string Bu filtrenin eşleme türü. Olası değerler: BEGINS_WITH, EQUAL, ENDS_WITH, CONTAINS veya MATCHES. GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI veya PAGE_HOSTNAME filtreleri herhangi bir eşleme türünü kullanabilir. Diğer tüm filtreler MATCHES kullanmalıdır. yazılabilir
lowercaseDetails.field string Filtrede kullanılacak alan. yazılabilir
lowercaseDetails.fieldIndex integer Özel boyutun dizini. Alan bir CUSTOM_DIMENSION ise gereklidir. yazılabilir
searchAndReplaceDetails.caseSensitive boolean Filtrenin büyük/küçük harfe duyarlı olup olmadığını belirler. yazılabilir
searchAndReplaceDetails.field string Filtrede kullanılacak alan. yazılabilir
searchAndReplaceDetails.fieldIndex integer Özel boyutun dizini. Alan bir CUSTOM_DIMENSION ise gereklidir. yazılabilir
searchAndReplaceDetails.replaceString string Arama teriminin yerini alacak terim. yazılabilir
searchAndReplaceDetails.searchString string Aranacak terim. yazılabilir
uppercaseDetails.field string Filtrede kullanılacak alan. yazılabilir
uppercaseDetails.fieldIndex integer Özel boyutun dizini. Alan bir CUSTOM_DIMENSION ise gereklidir. yazılabilir

Yanıt

Başarılı olursa bu yöntem, yanıt gövdesinde bir management.filter kaynağı döndürür.

Örnekler

Not: Bu yöntem için kullanıma sunulan kod örnekleri, desteklenen tüm programlama dillerini kapsamaz (Desteklenen dillerin listesi için istemci kitaplıkları sayfasını inceleyin).

Java

Java istemci kitaplığı'nı kullanmalıdır.

/*
 * 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

PHP istemci kitaplığını kullanır.

/**
 * 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

Python istemci kitaplığı'nı kullanır.

# 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

JavaScript istemci kitaplığını kullanır.

/*
 * 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. });
}

Deneyin.

Aşağıdaki API Gezgini'ni kullanarak canlı verilerde bu yöntemi çağırın ve yanıtı görün. Alternatif olarak, bağımsız Gezgin'i deneyin.