Filters: update

Memerlukan otorisasi

Memperbarui filter yang ada. Coba sekarang atau lihat contohnya.

Permintaan

Permintaan HTTP

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

Parameter

Nama parameter Nilai Deskripsi
Parameter jalur
accountId string ID akun yang mencakup filter.
filterId string ID filter yang akan diperbarui.

Otorisasi

Permintaan ini memerlukan otorisasi dengan cakupan berikut (baca selengkapnya tentang autentikasi dan otorisasi).

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

Isi permintaan

Dalam isi permintaan, berikan resource management.filter dengan properti berikut:

Nama properti Nilai Deskripsi Catatan
Properti yang Diperlukan
name string Nama filter ini. dapat ditulis
type string Jenis filter ini. Nilai yang mungkin adalah Include, Exclude, LOWERCASE, UPPERCASE, SEARCH_AND_REPLACE, dan ADVANCED. dapat ditulis
Properti Opsional
advancedDetails.caseSensitive boolean Menunjukkan apakah ekspresi filter peka huruf besar/kecil. dapat ditulis
advancedDetails.extractA string Ekspresi yang akan diekstrak dari kolom A. dapat ditulis
advancedDetails.extractB string Ekspresi yang akan diekstrak dari kolom B. dapat ditulis
advancedDetails.fieldA string Kolom A. dapat ditulis
advancedDetails.fieldAIndex integer Indeks dimensi kustom. Wajib jika kolom berupa CUSTOM_DIMENSION. dapat ditulis
advancedDetails.fieldARequired boolean Menunjukkan apakah kolom A harus dicocokkan. dapat ditulis
advancedDetails.fieldB string Kolom B. dapat ditulis
advancedDetails.fieldBIndex integer Indeks dimensi kustom. Wajib jika kolom berupa CUSTOM_DIMENSION. dapat ditulis
advancedDetails.fieldBRequired boolean Menunjukkan apakah kolom B harus dicocokkan. dapat ditulis
advancedDetails.outputConstructor string Ekspresi yang digunakan untuk membuat nilai output. dapat ditulis
advancedDetails.outputToField string Kolom output. dapat ditulis
advancedDetails.outputToFieldIndex integer Indeks dimensi kustom. Wajib jika kolom berupa CUSTOM_DIMENSION. dapat ditulis
advancedDetails.overrideOutputField boolean Menunjukkan apakah nilai kolom output yang ada, jika ada, harus diganti oleh ekspresi output. dapat ditulis
excludeDetails.caseSensitive boolean Menentukan apakah filter peka huruf besar/kecil. dapat ditulis
excludeDetails.expressionValue string Nilai ekspresi filter dapat ditulis
excludeDetails.field string Kolom untuk memfilter. Nilai yang mungkin:
  • Konten dan Lalu Lintas
    • PAGE_REQUEST_URI,
    • PAGE_HOSTNAME,
    • PAGE_TITLE,
    • RUJUKAN,
    • Cost_DATA_URI (URL target kampanye),
    • {i>HIT_TYPE<i},
    • INTERNAL_SEARCH_TERM,
    • INTERNAL_SEARCH_TYPE,
    • SOURCE_PROPERTY_TRACKING_ID,
  • Kampanye atau Grup Iklan
    • CAMPAIGN_SOURCE,
    • CAMPAIGN_MEDIUM,
    • CAMPAIGN_NAME,
    • CAMPAIGN_AD_GROUP,
    • CAMPAIGN_TERM,
    • KONTEN_KAMPANYE,
    • CAMPAIGN_CODE,
    • CAMPAIGN_REFERRAL_PATH,
  • E-Commerce
    • TRANSACTION_COUNTRY,
    • TRANSACTION_REGION,
    • TRANSAKSI_CITY,
    • TRANSACTION_AFFILIATION (Lokasi toko atau pesanan),
    • ITEM_NAME,
    • ITEM_CODE,
    • ITEM_VARIATION,
    • TRANSACTION_ID,
    • TRANSAKSI_CURRENCY_CODE,
    • PRODUCT_ACTION_TYPE,
  • Audiens/Pengguna
    • BROWSER,
    • BROWSER_VERSION,
    • BROWSER_SIZE,
    • PLATFORM,
    • PLATFORM_VERSION,
    • LANGUAGE,
    • SCREEN_RESOLUTION,
    • SCREEN_COLORS,
    • JAVA_ENABLED (Kolom Boolean),
    • FLASH_VERSION,
    • GEO_SPEED (Kecepatan koneksi),
    • VISITOR_TYPE,
    • GEO_Organizational (organisasi ISP),
    • GEO_DOMAIN
    • GEO_IP_ADDRESS,
    • GEO_IP_VERSION,
  • Lokasi
    • GEO_COUNTRY,
    • GEO_REGION,
    • GEO_CITY,
  • Peristiwa
    • EVENT_CATEGORY,
    • EVENT_ACTION,
    • EVENT_LABEL,
  • Lainnya
    • CUSTOM_FIELD_1,
    • CUSTOM_FIELD_2,
    • USER_DEFINED_VALUE,
  • Aplikasi
    • APP_ID,
    • APP_INSTALLER_ID,
    • APP_NAME,
    • APP_VERSION,
    • LAYAR,
    • IS_APP (Kolom Boolean),
    • IS_FATAL_EXCEPTION (Kolom Boolean),
    • EXCEPTION_DESCRIPTION,
  • Perangkat seluler
    • IS_MOBILE (Kolom Boolean, Tidak Digunakan Lagi. Gunakan DEVICE_CATEGORY=mobile),
    • IS_TABLET (Kolom Boolean, Tidak Digunakan Lagi. Gunakan DEVICE_CATEGORY=tablet),
    • DEVICE_CATEGORY,
    • MOBILE_HAS_QWERTY_KEYBoard (Kolom Boolean),
    • MOBILE_HAS_NFC_SUPPORT (Kolom Boolean),
    • MOBILE_HAS_cellULAR_Radio (Kolom Boolean),
    • MOBILE_HAS_wifi_SUPPORT (Kolom Boolean),
    • MOBILE_BRAND_NAME,
    • MOBILE_MODEL_NAME,
    • MOBILE_MARKETING_NAME,
    • MOBILE_POINTING_METHOD,
  • Sosial
    • SOCIAL_NETWORK,
    • SOCIAL_ACTION,
    • SOCIAL_ACTION_TARGET,
dapat ditulis
excludeDetails.fieldIndex integer Indeks dimensi kustom. Tetapkan hanya jika kolom adalah CUSTOM_DIMENSION. dapat ditulis
excludeDetails.matchType string Jenis pencocokan untuk filter ini. Nilai yang mungkin adalah BEGINS_WITH, EQUAL, ENDS_WITH, CONTAINS, atau MATCHES. Filter GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI, atau PAGE_HOSTNAME dapat menggunakan jenis pencocokan apa pun; semua filter lainnya harus menggunakan MATCHES. dapat ditulis
includeDetails.caseSensitive boolean Menentukan apakah filter peka huruf besar/kecil. dapat ditulis
includeDetails.expressionValue string Nilai ekspresi filter dapat ditulis
includeDetails.field string Kolom untuk memfilter. Nilai yang mungkin:
  • Konten dan Lalu Lintas
    • PAGE_REQUEST_URI,
    • PAGE_HOSTNAME,
    • PAGE_TITLE,
    • RUJUKAN,
    • Cost_DATA_URI (URL target kampanye),
    • {i>HIT_TYPE<i},
    • INTERNAL_SEARCH_TERM,
    • INTERNAL_SEARCH_TYPE,
    • SOURCE_PROPERTY_TRACKING_ID,
  • Kampanye atau Grup Iklan
    • CAMPAIGN_SOURCE,
    • CAMPAIGN_MEDIUM,
    • CAMPAIGN_NAME,
    • CAMPAIGN_AD_GROUP,
    • CAMPAIGN_TERM,
    • KONTEN_KAMPANYE,
    • CAMPAIGN_CODE,
    • CAMPAIGN_REFERRAL_PATH,
  • E-Commerce
    • TRANSACTION_COUNTRY,
    • TRANSACTION_REGION,
    • TRANSAKSI_CITY,
    • TRANSACTION_AFFILIATION (Lokasi toko atau pesanan),
    • ITEM_NAME,
    • ITEM_CODE,
    • ITEM_VARIATION,
    • TRANSACTION_ID,
    • TRANSAKSI_CURRENCY_CODE,
    • PRODUCT_ACTION_TYPE,
  • Audiens/Pengguna
    • BROWSER,
    • BROWSER_VERSION,
    • BROWSER_SIZE,
    • PLATFORM,
    • PLATFORM_VERSION,
    • LANGUAGE,
    • SCREEN_RESOLUTION,
    • SCREEN_COLORS,
    • JAVA_ENABLED (Kolom Boolean),
    • FLASH_VERSION,
    • GEO_SPEED (Kecepatan koneksi),
    • VISITOR_TYPE,
    • GEO_Organizational (organisasi ISP),
    • GEO_DOMAIN
    • GEO_IP_ADDRESS,
    • GEO_IP_VERSION,
  • Lokasi
    • GEO_COUNTRY,
    • GEO_REGION,
    • GEO_CITY,
  • Peristiwa
    • EVENT_CATEGORY,
    • EVENT_ACTION,
    • EVENT_LABEL,
  • Lainnya
    • CUSTOM_FIELD_1,
    • CUSTOM_FIELD_2,
    • USER_DEFINED_VALUE,
  • Aplikasi
    • APP_ID,
    • APP_INSTALLER_ID,
    • APP_NAME,
    • APP_VERSION,
    • LAYAR,
    • IS_APP (Kolom Boolean),
    • IS_FATAL_EXCEPTION (Kolom Boolean),
    • EXCEPTION_DESCRIPTION,
  • Perangkat seluler
    • IS_MOBILE (Kolom Boolean, Tidak Digunakan Lagi. Gunakan DEVICE_CATEGORY=mobile),
    • IS_TABLET (Kolom Boolean, Tidak Digunakan Lagi. Gunakan DEVICE_CATEGORY=tablet),
    • DEVICE_CATEGORY,
    • MOBILE_HAS_QWERTY_KEYBoard (Kolom Boolean),
    • MOBILE_HAS_NFC_SUPPORT (Kolom Boolean),
    • MOBILE_HAS_cellULAR_Radio (Kolom Boolean),
    • MOBILE_HAS_wifi_SUPPORT (Kolom Boolean),
    • MOBILE_BRAND_NAME,
    • MOBILE_MODEL_NAME,
    • MOBILE_MARKETING_NAME,
    • MOBILE_POINTING_METHOD,
  • Sosial
    • SOCIAL_NETWORK,
    • SOCIAL_ACTION,
    • SOCIAL_ACTION_TARGET,
dapat ditulis
includeDetails.fieldIndex integer Indeks dimensi kustom. Tetapkan hanya jika kolom adalah CUSTOM_DIMENSION. dapat ditulis
includeDetails.matchType string Jenis pencocokan untuk filter ini. Nilai yang mungkin adalah BEGINS_WITH, EQUAL, ENDS_WITH, CONTAINS, atau MATCHES. Filter GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI, atau PAGE_HOSTNAME dapat menggunakan jenis pencocokan apa pun; semua filter lainnya harus menggunakan MATCHES. dapat ditulis
lowercaseDetails.field string Kolom yang akan digunakan di filter. dapat ditulis
lowercaseDetails.fieldIndex integer Indeks dimensi kustom. Wajib jika kolom berupa CUSTOM_DIMENSION. dapat ditulis
searchAndReplaceDetails.caseSensitive boolean Menentukan apakah filter peka huruf besar/kecil. dapat ditulis
searchAndReplaceDetails.field string Kolom yang akan digunakan di filter. dapat ditulis
searchAndReplaceDetails.fieldIndex integer Indeks dimensi kustom. Wajib jika kolom berupa CUSTOM_DIMENSION. dapat ditulis
searchAndReplaceDetails.replaceString string Istilah yang akan menggantikan istilah penelusuran. dapat ditulis
searchAndReplaceDetails.searchString string Istilah yang akan ditelusuri. dapat ditulis
uppercaseDetails.field string Kolom yang akan digunakan di filter. dapat ditulis
uppercaseDetails.fieldIndex integer Indeks dimensi kustom. Wajib jika kolom berupa CUSTOM_DIMENSION. dapat ditulis

Respons

Jika berhasil, metode ini akan menampilkan resource management.filter dalam isi respons.

Contoh

Catatan: Contoh kode yang tersedia untuk metode ini tidak merepresentasikan semua bahasa pemrograman yang didukung (lihat halaman library klien untuk mengetahui daftar bahasa yang didukung).

Java

Menggunakan library klien 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

Menggunakan library klien 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

Menggunakan library klien 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

Menggunakan library klien 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. });
}

Cobalah!

Gunakan APIs Explorer di bawah untuk memanggil metode ini pada data live dan melihat respons. Atau, coba Explorer mandiri.